Introduction
This guide outlines the process for linking your Chargebee account with Anrok. This will allow you to automatically synchronize transactions and update sales tax to your Chargebee invoices.
Step 1 — Create a Chargebee API key
In order to import your product pricing catalog and ingest your historical transactions, Anrok requires you to create and provide a Chargebee API key.
Try creating a Chargebee API key in the demo above ☝️
- In the Chargebee app
, go to Settings > Configure Chargebee > API keys.
- Click + Add API Key, then select Read-Only Key.
- Select All, then under Name the API Key, enter
Anrok
. - When you are finished, click Create Key.
Step 2 — Locate your Chargebee site name
In order to connect to your Chargebee instance, Anrok requires the site name (subdomain) of your Chargebee account.
- In the Chargebee app
, go to Home.
- In the URL, locate your site name (subdomain). It will look like the following example:
support-demo.chargebee.com
.
Step 3 — Connect to Chargebee
The first step of integrating with Chargebee will be connected directly to your account within Anrok. During this process, you will be required to align your accounting time zone and provide the necessary credentials associated with your Chargebee account.
Try connecting with Chargebee in the demo above ☝️
- In the Anrok app
, go to Data sources. Take me there!
- Select Integrate system, then under Accounting time zone, select the time zone that matches your Chargebee account (or select UTC if you don't know which time zone to select).
- Under Data source, select Chargebee, then enter your Chargebee API key and Site name.
- When you are finished, click Connect.
Step 4 — Add your Chargebee products as product IDs
In Anrok, your Chargebee products will be called product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product.. These product IDs are the key driver for calculating taxability. It's important that you add your current and previous Chargebee products into Anrok. See What are product IDs?
Try adding your Chargebee products in the demo above ☝️
- Under New products detected, select a corresponding Product type and Tax category for each product detected. See Select a tax configuration.
- If you'd like to assign a Product type and Tax category to multiple products at once, click the checkbox
next to each product, then select Batch assign.
- When you are finished, scroll down and click Add products.
Step 5 — Import your Chargebee transactions
Now that you've assigned all of your product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product., you can now begin importing your historical transaction from Chargebee into Anrok.
Try importing your Chargebee transactions in the demo above ☝️
- Under Select transactions to import, select one of the following options:
- Import all past transactions — all transactions will be imported into Anrok. This will result in a complete picture of your economic nexus exposure.
- Import transactions from a specific date — some past transactions will not be imported into Anrok. This may result in an incomplete picture of your economic nexus exposure to date.
- Continue without importing past transactions — none of your historical transactions will be imported into Anrok. This may result in an incomplete picture of your economic nexus exposure.
- Select Import transactions (or Mark as finished depending on your previous selection).
- When your transactions have finished importing, select Mark complete.
Step 6 — Set a default product ID (Optional)
If you have an automated workflow that can generate new product IDsProduct ID
They describe the specific product or service that was sold to your customer. Product IDs are passed to Anrok from your billing system as the product(s) you are including on the invoice.
Each product ID you sell must be mapped to a corresponding tax configuration in Anrok, which signals what taxability ruleset to apply to the product. in Chargebee (i.e. Chargebee’s “Quick Charge'' feature), we recommend creating a default product ID. When a default product ID has been set, Anrok will apply its tax configuration whenever a Chargebee product hasn't been configured into Anrok. See Set up default Product ID.
Note : Setting a default product ID is only recommended to sellers that have the same product type and tax category across all of their products.
Try setting a default product ID in the demo above ☝️
- In the Anrok app
, go to Data sources. Take me there!
- Under Integration sources, click the options menu button
next to Chargebee, then select Configure new products.
- Under Default product, click Set default product.
- Select a corresponding Product type and Tax category for each product detected. See Select a tax configuration.
- When you are finished, click Add products.
Step 7 — Generate an Anrok API key
To enable Chargebee to automatically send live transaction data to Anrok for tax calculation, you will need to enable Anrok tax on your Chargebee account. As part of the setup, they will request your Anrok API key.
Try generating an Anrok API key in the demo above ☝️
- In the Anrok app
, go to Data sources. Take me there!
- Under Integration sources, click the option menu button
next to Chargebee, then select Manage Anrok API key.
- Select Generate Anrok API key, then copy
the API key.
- When you are finished, click Done.
Step 8 — Enable Anrok tax
Once you’ve generated an Anrok API key, you can begin the process of enabling Anrok tax in your Chargebee account.
Try enabling Anrok tax in the demo above ☝️
- In the Chargebee app
, go to Apps > Go to Marketplace.
- Select Tax Management, then click Anrok.
- Click Connect, then click Get Started.
- Under Anrok API Key, enter the previously generated API key, then click Authenticate.
- Click Proceed, then turn on the toggle
to post invoices & credit notes to Anrok.
- Click Proceed, then select Go to Taxes.
- Under Regions, select United States. If you have not created a taxable region, you can add one by clicking + Add region.
- Under Pick a mode of configuration, select Anrok.
Before you begin creating and editing invoices, you will need to make sure your Chargebee account has been properly configured for tax calculation. Check out how to configure your Chargebee account.