> ## Documentation Index
> Fetch the complete documentation index at: https://docs.numeral.com/llms.txt
> Use this file to discover all available pages before exploring further.
# JustPaid
> Automate sales tax calculations and invoice processing on your JustPaid invoices using Numeral's tax engine.
## Overview
The JustPaid and Numeral integration enables automated sales tax compliance for your invoicing workflow. This integration automatically calculates and applies the correct sales tax rates to your JustPaid invoices based on customer location and product categorization.
**What you'll accomplish:**
* Connect Numeral to your JustPaid account
* Set up automated webhook communication
* Enable automatic sales tax calculations on invoices
* Track products and credit memos across both platforms
* Record transactions automatically when invoices are paid
Short video on how to set up a JustPaid connection
Short video on how invoice taxation works with JustPaid
***
## Prerequisites
Before you begin, ensure you have:
* An active JustPaid account with admin access
* A Numeral account
* Permissions to generate API keys in JustPaid
***
## Step 1: Connect Numeral to JustPaid
To establish the integration between Numeral and JustPaid, you'll need to generate and configure an API key.
### Generate a JustPaid API Key
1. Log in to your JustPaid account
2. Navigate to **Settings > Developer > API Keys** (or go directly to your JustPaid dashboard's API settings page)
3. Click **Create API Key**
4. Copy the API key (you'll need this in the next step)
### Add the API Key to Numeral
1. Log in to your Numeral account
2. Go to **Settings > Integrations**
3. Find **JustPaid** in the list of available integrations
4. Click **Connect** or **Configure**
5. Enter a name for your JustPaid connection (e.g., "Production JustPaid")
6. Paste your JustPaid API key into the appropriate field
7. Click **Connect**
You should see a confirmation that Numeral has validated your API key and proceed to the webhook setup step.
***
## Step 2: Set Up the Numeral Webhook in JustPaid
The webhook enables real-time data synchronization between Numeral and JustPaid, ensuring that invoice and product data flows seamlessly between both platforms.
### Configure the Webhook
1. After connecting your API key in Numeral, you'll be provided with a webhook URL
2. Click **Copy Numeral webhook URL** to copy the webhook URL to your clipboard
3. In your JustPaid account, navigate to **Settings > Webhooks**
4. Click **Add New Webhook** or **Create Webhook**
5. Paste the Numeral webhook URL into the webhook URL field
6. **Important:** Select **all events** to enable full integration functionality:
* **Invoice Events** - Created, Updated, Status Changed, Payment Status Changed
* **Product Events** - Created, Updated
* **Credit Memo Events** - Created, Updated, Status Changed
7. After saving the webhook in JustPaid, JustPaid will generate a **Webhook Secret**
8. Copy the webhook signing secret from JustPaid
9. Return to Numeral and paste the webhook secret into the **Webhook Secret** field
10. Click **Continue** to complete the setup
***
## Step 3: Automate Sales Tax on Invoices
Once the integration is complete, Numeral will automatically calculate and add sales tax to your invoices based on your configured tax rules and customer locations.
### How It Works
When you create or update an invoice in JustPaid:
1. JustPaid sends the invoice data to Numeral via the webhook
2. Numeral fetches the customer's address from JustPaid
3. The system identifies the applicable tax jurisdiction based on the customer's location
4. Appropriate sales tax rates are calculated for each line item
5. The tax rates are applied back to each line item in JustPaid
6. When the invoice is marked as paid, a transaction is automatically recorded in Numeral
### What You'll See
* **In JustPaid:** Invoices will display itemized sales tax amounts calculated by Numeral on each line item
* **In Numeral:** Transaction data will include detailed tax information for accounting and compliance purposes once invoices are paid
***
## Additional Features
### Product Synchronization
When you create or update products in JustPaid, they are automatically synced to Numeral:
* Products are created in Numeral using the product name as the identifier
* You can assign tax categories to products in Numeral for accurate tax calculation
### Credit Memo Tracking
Credit memos issued in JustPaid are automatically tracked in Numeral:
* Credit memos are linked to their original invoices when applicable
* Amounts are recorded for audit trail and compliance purposes
***
## Troubleshooting
### Common Issues
**Invoice tax is not being calculated:**
* Verify the webhook is active in JustPaid settings
* Ensure the invoice has line items (empty invoices are skipped)
* Check that the customer has a valid address on file
**Webhook events are not being received:**
* Confirm the webhook URL was copied correctly
* Verify the webhook secret matches between JustPaid and Numeral
* Check that all event types are selected in JustPaid webhook settings
**Connection shows as incomplete:**
* Return to Numeral and complete the setup wizard
* Ensure both the API key and webhook secret have been entered
### Getting Help
If you encounter issues with the integration, please contact Numeral support with:
* Your JustPaid account identifier
* The invoice or event that failed (if applicable)
* Any error messages displayed
***
## Security
The JustPaid integration uses industry-standard security practices:
* **API Key Encryption:** Your JustPaid API key is encrypted at rest
* **Webhook Verification:** All incoming webhooks are verified using HMAC-SHA256 signatures
* **Secure Communication:** All data is transmitted over HTTPS
