> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequencehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Numeral

> Integrate with Numeral to automatically calculate sales tax for invoices.

![Numeral](https://mintcdn.com/sequence/0nBP-PoGqjN4crzr/images/integrations/covers/numeral.png?fit=max\&auto=format\&n=0nBP-PoGqjN4crzr\&q=85\&s=928f01a2b7f227fb700181ec5f172852)

Connect Numeral to your Sequence account and automate sales tax calculations, ensuring compliance with tax regulations across all jurisdictions where you do business.

### Capabilities

 **Automated tax calculations**: Calculate precise tax rates based on customer addresses and product categories\

 **Tax return filing**: Automatically handle tax return filing after sales clear through the platform\

 **Product management**: Manage product tax categories and handle refunds seamlessly\

 **Exempt customer handling**: Efficiently manage tax-exempt customers across multiple jurisdictions\


### Connector setup

> [!NOTE]
>
> Before integrating with Numeral you must ensure that your customers in Sequence have unique email addresses.

**1. Connect to Numeral**

> [tab] View connector
>
> Navigate to "Browse integrations", locate Numeral in the Tax section, and click "Manage integration".
>
> ![Connector setup](https://mintcdn.com/sequence/0nBP-PoGqjN4crzr/images/integrations/numeral/numeral-view-connector.png?fit=max\&auto=format\&n=0nBP-PoGqjN4crzr\&q=85\&s=7e90ea6f1dbf2add35a558aff63c2856)

> [tab] Store API Key
>
> Paste your Numeral API key into the field provided and click "Test credentials" to verify the connection. Once validated, click "Save changes" to activate the connector. Your API key can be found in the [Developers tab](https://dashboard.numeralhq.com/developers) of your Numeral dashboard.
>
> ![Enter Numeral API key](https://mintcdn.com/sequence/8zbJ1F1pATf6M77j/images/integrations/numeral/numeral_2.png?fit=max\&auto=format\&n=8zbJ1F1pATf6M77j\&q=85\&s=376adcbde5e662ca96251f781da96ca2)

**2. Add Numeral product categories**

> [tab] View tax categories
>
> Navigate to Settings > Sales Tax to view your existing Sequence tax categories. With Numeral connected, these categories will now be managed through Numeral product categories rather than custom rates.
>
> ![Tax categories](https://mintcdn.com/sequence/8zbJ1F1pATf6M77j/images/integrations/numeral/numeral_3.png?fit=max\&auto=format\&n=8zbJ1F1pATf6M77j\&q=85\&s=84c244df68622a30a301212f778cef8a)

> [tab] Create mapping
>
> Click the "+ Add Numeral mapping" button for each active tax category to map it to the appropriate Numeral product category.
>
> ![Numeral categories](https://mintcdn.com/sequence/8zbJ1F1pATf6M77j/images/integrations/numeral/numeral_4.png?fit=max\&auto=format\&n=8zbJ1F1pATf6M77j\&q=85\&s=5ffc7216f9fe79b58a73bba7f949b672)

**3. Add tax categories to products**

Navigate to your Products catalog and assign tax categories to each product. For automatic tax calculation to work on a product, its tax category must have a corresponding Numeral product category mapping.

![Assign tax category](https://mintcdn.com/sequence/8zbJ1F1pATf6M77j/images/integrations/numeral/numeral_5.png?fit=max\&auto=format\&n=8zbJ1F1pATf6M77j\&q=85\&s=3ae1a58e7885513279e51b6e20c91054)

 Your Numeral connector is now active and ready to calculate sales tax automatically.\\

### Calculating sales tax with Numeral

With Numeral connected, sales tax will be calculated automatically for all draft invoices. The tax amount is determined by several key factors:

* The origin address configured in Settings > Merchant > Address
* Your customer's billing location and their tax exemption status
* Which Numeral product category is mapped to each line item's tax category

> [tab] Invoice calculation
>
> Sales tax is computed automatically and appears as a line item on your invoices, based on the Numeral product categories you've configured.
>
> ![Invoice with Numeral tax calculation](https://mintcdn.com/sequence/iQa9J-0upeaqL5Lr/images/integrations/numeral/numeral_6.png?fit=max\&auto=format\&n=iQa9J-0upeaqL5Lr\&q=85\&s=6a90a01e8e07b714ca454b7cf3a0ff1b)

> [tab] Invoice PDF
>
> Tax calculations appear clearly on the PDF invoices your customers receive.
>
> ![Invoice PDF with tax](https://mintcdn.com/sequence/iQa9J-0upeaqL5Lr/images/integrations/numeral/numeral_7.png?fit=max\&auto=format\&n=iQa9J-0upeaqL5Lr\&q=85\&s=7599510e677ca9880a290536f0ab3e6d)

### Troubleshooting

> [accordion] Invalid API key format
>
> Verify that your API key follows the correct format. Test environment keys begin with `sk_test_` while production keys start with `sk_prod_`. Retrieve your API key from the [Developers tab](https://dashboard.numeralhq.com/developers) in your Numeral dashboard.

> [accordion] Incorrect merchant address
>
> Double-check your merchant address configuration at Settings > Merchant > Address. This location serves as the point of origin for all tax calculations.
>
> ![Merchant address in Sequence](https://mintcdn.com/sequence/iQa9J-0upeaqL5Lr/images/integrations/numeral/numeral_8.png?fit=max\&auto=format\&n=iQa9J-0upeaqL5Lr\&q=85\&s=c281934d2055ffc50a7c39922954fc76)

> [accordion] Failed to load Numeral product categories
>
> If product categories fail to load when adding mappings, check the following:
>
> * Confirm your API key is saved correctly
> * Verify you have an active Numeral subscription
> * Check your network connectivity
>
> Still having issues? Try disconnecting and reconnecting the connector, or contact our support team for assistance.

### Frequently asked questions (FAQ)

> [accordion] Do Sequence products need to be synced with Numeral?
>
> Not at all. The connector works by mapping your Sequence tax categories to Numeral product categories. When an invoice is generated, Numeral uses the product category associated with each line item's tax category to calculate the appropriate tax.

> [accordion] What Numeral product categories are available?
>
> Numeral provides comprehensive coverage across many product types:
>
> * **SaaS & Digital**: SAAS\_GENERAL, SOFTWARE\_DOWNLOAD, DIGITAL\_AUDIO\_STREAMED, DIGITAL\_VIDEO\_STREAMED
> * **Clothing**: CLOTHING\_GENERAL, CLOTHING\_ATHLETIC, CLOTHING\_JEWELRY
> * **Food & Beverage**: FOOD\_GENERAL, BEVERAGE\_SOFT\_DRINK, BEER
> * **Books & Media**: BOOKS, MAGAZINE, NEWSPAPER
> * **General**: GENERAL\_MERCHANDISE, EXEMPT, SHIPPING
>
> The full catalog of available categories appears when you create a new mapping in Settings > Sales Tax.

> [accordion] How do I handle tax-exempt customers?
>
> Simply set a customer's tax status to "Exempt" in their customer profile. Numeral will then apply the appropriate tax exemptions when calculating their invoices, based on their status and geographic location.

> [accordion] Can I use Numeral for international tax calculations?
>
> Absolutely. Numeral handles tax calculations across many different jurisdictions worldwide. Just make sure both your merchant address and customer addresses are accurately entered for precise tax computation.

> [accordion] What happens if I disconnect the Numeral connector?
>
> Disconnecting Numeral returns your account to manual tax management mode with custom tax rates. Your existing tax category mappings remain intact, but automatic tax calculation via Numeral will stop.

> [accordion] How do I test the Numeral connector?
>
> Connect a Numeral test API key (beginning with `sk_test_`) to your Sequence Sandbox. Then create sample invoices using various product categories and customer addresses to confirm calculations are working correctly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.