> ## 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.

# Orb

> Apply accurate sales tax to Orb invoices using Numeral's tax engine.

This guide walks you through connecting Orb to Numeral so that sales tax is automatically calculated and applied to your invoices.

***

## Getting Started

1. Work with your Onboarding Manager to make sure the **Developer** tab is enabled in your Numeral dashboard.

2. Navigate to **Developers > API Keys** and create a test API key. Save it — you'll need it to configure Orb.

3. In Orb, navigate to **Settings > Integrations > Taxes** and select **Connect to Numeral**.

   <img src="https://mintcdn.com/numeralhq/jSreg-ZXaGZL9XDo/images/integrations/orb/01-connect-to-numeral.png?fit=max&auto=format&n=jSreg-ZXaGZL9XDo&q=85&s=e04b874894061877e59a84d2bdcff64f" alt="Connect to Numeral from Orb's Taxes integrations page" width="3420" height="1736" data-path="images/integrations/orb/01-connect-to-numeral.png" />

4. In the pop-up window, enter your test API key from Numeral.

   <img src="https://mintcdn.com/numeralhq/jSreg-ZXaGZL9XDo/images/integrations/orb/02-enter-api-key.png?fit=max&auto=format&n=jSreg-ZXaGZL9XDo&q=85&s=40d34dbb61daecffb0d06f389c63c673" alt="Enter your Numeral API key in Orb" width="1458" height="640" data-path="images/integrations/orb/02-enter-api-key.png" />

5. Enable the tax engine. Your default product category will appear here — this is the fallback category used for any products that don't have a category assigned.

   <img src="https://mintcdn.com/numeralhq/jSreg-ZXaGZL9XDo/images/integrations/orb/03-enable-tax-engine.png?fit=max&auto=format&n=jSreg-ZXaGZL9XDo&q=85&s=51633bdc117c7e92ff9370fd9741542b" alt="Enable the Numeral tax integration in Orb" width="2940" height="1186" data-path="images/integrations/orb/03-enable-tax-engine.png" />

   <img src="https://mintcdn.com/numeralhq/jSreg-ZXaGZL9XDo/images/integrations/orb/04-default-product-category.png?fit=max&auto=format&n=jSreg-ZXaGZL9XDo&q=85&s=67bbca601306245c98b86751294f7b51" alt="Confirm the default product category" width="1444" height="630" data-path="images/integrations/orb/04-default-product-category.png" />

6. Confirm your Orb connection by entering your API key again and clicking **Confirm Connection**. The pop-up will close automatically and begin syncing.

   <img src="https://mintcdn.com/numeralhq/jSreg-ZXaGZL9XDo/images/integrations/orb/05-confirm-connection.png?fit=max&auto=format&n=jSreg-ZXaGZL9XDo&q=85&s=6d6dcf68ade06b01b7ba71a8b878daec" alt="Confirm the Orb connection from Numeral" width="1154" height="1832" data-path="images/integrations/orb/05-confirm-connection.png" />

<Tip>
  See Orb's [Enrich invoices with tax](https://docs.withorb.com/integrations-and-exports/tax#creating-a-numeral-account) guide for more detail on connecting Numeral from the Orb side.
</Tip>

***

## Timeline Considerations

If you're already using Orb to apply tax rates to invoices, coordinate with your Onboarding Manager to confirm your **go-live date** with Numeral.

For example, if Numeral will begin managing your sales tax registrations in **August**, meet with your Onboarding Manager on **August 1** to turn off Orb's tax calculations and activate Numeral's tax engine.

<Warning>
  * Numeral's tax engine will not collect tax before your confirmed start date.
  * Numeral only collects tax in states where your company is registered.

  Confirm your start date(s) and registered states by navigating to the [Jurisdictions](https://dashboard.numeralhq.com/jurisdictions) tab in your Numeral account.
</Warning>

***

## Confirming Your Configurations

On your go-live call, your Onboarding Manager will confirm that **Orb's tax calculations are disabled**. You can also verify this on your own:

**How to Turn Off Orb's Tax Calculations:**

1. Log in to your Orb account.
2. Navigate to **Settings > Integrations > Taxes**.
3. Click the menu next to **Stripe Tax** (or the relevant tax integration) and select **Disconnect Stripe Tax**.
4. Confirm the disconnection.

***

## Product Categorization

Product categories in Orb do **not** carry over to Numeral — categories must be set up directly within your Numeral account.

Work with your Onboarding Manager to set up product categories within Numeral. Once configured, Numeral's tax engine uses these categories to accurately determine taxability.

**How to review or update product categories in Numeral:**

1. Log into your Numeral dashboard.
2. Navigate to the [Developers tab](https://dashboard.numeralhq.com/developers). If this tab isn't visible, contact your Onboarding Manager.
3. Select **Products**.
4. Edit products individually or create new products as needed.

***

## Customer Exemptions

If a customer should be exempt from sales tax, mark them as exempt directly in Orb:

1. Navigate to **Customers** on the left-hand side.
2. Click on the customer's name to open their profile.
3. Scroll down to **Customer Details** and select **Edit**.
4. Scroll to the bottom and check the box next to **Exempt from automated tax**.
5. Click **Save**.
