Sphere Tax Integration Troubleshooting

Last updated: October 20, 2026

Unmapped Product Error

Problem

You may see an Unmapped Product error if one or more products on an invoice do not have a valid tax code mapping in Sphere.

Resolution

  1. Log in to Sphere.

  2. Review your product tax mappings.

  3. Assign the appropriate tax code.

  4. Return to Tabs and regenerate the invoice.

Invalid Address Error

Problem

Sphere cannot determine the correct tax jurisdiction for the customer's address.

Resolution

  1. Open the customer or invoice in Tabs.

  2. Review the billing address.

  3. Correct any missing or invalid information.

  4. Retry the tax calculation.

Integration Disconnected

Problem

The Sphere connection is no longer active.

Resolution

  1. Open the Sphere integration in Tabs.

  2. Click Reconnect.

  3. Enter a valid Sphere API key.

  4. Save your changes.

Why Don't Invoices Appear in Sphere Immediately?

Sphere retrieves invoice data from Tabs on a scheduled basis.

As a result, invoices may not appear in Sphere immediately after being sent.

This does not impact tax calculations or tax filing workflows.

Can I Void or Reset an Invoice?

When Sphere is your active tax provider, sent invoices cannot be voided or reset to draft. Once an invoice is sent, its tax has been calculated and reported to Sphere, so changing the original invoice would put Tabs and Sphere out of sync.

To correct a sent invoice:

  1. Open the invoice in Tabs.

  2. Create a credit memo against the invoice for the amount you need to reverse.

  3. If needed, issue a new invoice with the correct details.

Sphere picks up the credit memo during its next scheduled sync and adjusts the tax.

Need Additional Help?

If you continue experiencing issues with the Sphere integration, contact Tabs Support and include:

  • The invoice number

  • The customer name

  • A description of the error

  • Screenshots of any error messages displayed