Rillet Tax Engine Integration Guide
Enable real-time sales tax calculation directly on your Rillet invoices using Kintsugi.Updated 8 days ago
This guide walks you through the step-by-step process of enabling real-time sales tax calculation on your Rillet invoices using Kintsugi. By integrating Kintsugi's tax engine with Rillet, you can automate sales tax computation directly within your existing invoicing workflow, covering 12,000+ U.S. tax jurisdictions without any manual intervention.
Prerequisites
Before enabling tax calculation, make sure all of the following are in place:
Rillet account read-only connection. This pulls the transactions in to enable sales tax automation compliance.
At least one physical presence is configured. Set this up under the Presence tab in Kintsugi.
At least one registration. Kintsugi will not calculate or insert sales tax for a jurisdiction where you do not yet have a registration, because you do not have the right to collect sales tax there.
Paid Kintsugi plan. Confirm your plan in Kintsugi under Configuration > Billing Details.
Step 1: Get the Web Hook URL
Log in to your Kintsugi account.
Navigate to Data Sources.
Click Enable Tax Collection.
Once you click "Enable Tax Collection," Kintsugi opens a Setup Checklist: your initial data import, organization details, and registered jurisdictions, and asks you to confirm that Rillet's native tax engine is turned off. You then complete a short webhook secret setup, after which tax collection turns on.
For a full walkthrough of each checklist item, see Enable Tax Collection on a Tax-Engine Integration
Copy the Webhook URL that appears in the pop-up, as you will need it in the next step.
Note: You will return to this screen once you retrieve your Webhook Token.
Step 2: Generate a Webhook Token in Rillet
Kintsugi uses a Rillet web hook token to import your invoice and customer data.
Log in to your Rillet account.
Click your organization’s name at the bottom and select Organization settings.
Navigate to Webhooks and click Create webhook.
Give the key a descriptive name, for example, Kintsugi.
Paste the webhook URL that you copied earlier from the Kintsugi app.
Under Entity, select the following subscriptions and set the following permissions:
Invoice: Created, Updated, and Deleted
Credit Memo: Deleted
Customer: Deleted
Click the Create button.
Step 3: Connect Rillet to Kintsugi
Paste the Webhook Token that you created from Step 2.
Click the Save & Enable button.
Kintsugi will begin importing your Rillet transaction and customer data. You will know your setup is ready when you see “Tax Engine” instead of “Read-Only” in your Rillet setup.
From this point forward, every invoice created or updated in Rillet will trigger an automatic tax calculation through Kintsugi.
Step 4: Test the Integration
Verify that Kintsugi is calculating tax on your Rillet invoices.
In Rillet, navigate to Accounts Receivable > Invoices.
Click Add Invoice to create a test invoice.
Select a customer and subscription for your new invoice.
Click the Save button.
⚠️ NOTE: Tax calculation runs asynchronously. After saving the invoice, wait a few moments and then refresh the page and taxes will be added automatically once Kintsugi processes the webhook event.
Click the invoice you just created to confirm that the sales tax has been calculated.
When you open the invoice you created, look for the Sales Tax section, and you should see that Kintsugi has already calculated the sales tax amount for the said invoice.
Need Help?
For further concerns, we're always here to help. If you can't find the answer you're looking for, please reach out to us using the chat bubble in the bottom-right corner of your Kintsugi account.