Taxes
This topic describes how to configure and manage taxes in Rebilly.
Tax ID numbers
It is a common requirement for tax identification numbers to be displayed on invoices. Rebilly supports tax ID numbers for organizations and customers, which are included on invoices.
When an invoice is created, the organization and customer tax ID numbers may be provided. If set, default tax ID numbers of the organization and customer are used on the invoice but they can be updated for each invoice.
For more information, see Manage the tax ID numbers of an organization and Manage a customer's tax ID numbers.
Validation
Rebilly validates customer and organization tax ID numbers when a TaxJar integration is set up. Validation is asynchronous, and the status is displayed in the list of tax ID numbers. Tax ID numbers are included on invoices regardless of their validation status.
Rebilly supports validation for European VATIN tax ID number types.
To receive real time validation result notifications, configure webhooks on the following events:
-
Customer Tax Number Validated
-
Organization Tax Number Validated
For more information see, see Create a webhook.
Automated tax calculations
Rebilly supports automated tax calculations internationally, using the location of your organization and the location of your customer. You may also manually adjust the taxes on an unpaid invoice. Taxes are calculated after an invoice is issued and taxes are recalculated on every invoice change. The shipping amount is added to tax calculations.
To use taxes in Rebilly:
-
Your organization must have an address configured. All required fields must be entered. The
Region
field is only required for US, Canada, and Australia. -
Each invoice must have a delivery address if the invoice includes taxable products. All required fields must be entered. The
Region
field is only required for US, Canada, and Australia.
Manage tax calculation errors
To receive notifications if a tax calculation fails for an invoice:
-
In the left navigation bar, click
.
- In the Rules engine section, click Rules engine .
- Click Billing events .
- Click Invoice tax calculation failed .
- Click Rule set , then in the top right of the screen, click Create rule .
- In the Rule name field, enter a unique name.
- Clear the Stop further processing checkbox.
- In the Actions section, click Add action and select Send email or Trigger webhook .
- Click Save .
If a tax calculation fails for an invoice, it will also be visible in the timeline on the invoice details page.
Manually adjusting taxes
To manually adjust taxes on an unpaid invoice or upcoming invoice:
-
In the left navigation bar, click
, then click Billing .
- Click Active subscriptions , or Unpaid subscriptions .
- In the Id or Invoice number column, click a subscription ID.
-
On the upcoming invoice, beside
Taxes
, click
.
- Complete the form, then click Save .
Third-party tax integrations
TaxJar
To use TaxJar for tax calculation and related features, see TaxJar integration.
Avalara
To use Avalara for tax calculation and related features, see Avalara integration.