How tax calculations work
Worldwide tax calculations are based on your registered tax jurisdictions, the product details, and the location of your customer.
The following are the basic rules for tax calculation depending on the type of product sold:
- For sales of physical goods Quaderno calculates tax based on where a product is shipped from and where it is shipped to.
- For sales of services, it depends on the type of service:
- For
e-Service
,e-Book
, andSaaS
sales, Quaderno will apply tax rates based on your customer's location and your registered jurisdictions. - For
Consulting
services, Quaderno will apply the local tax rate where your business is based and no tax in any other tax jurisdiction. - For the rest of the services, Quaderno will apply your local tax rate on all sales worldwide.
- For
Configuring your Quaderno account
The Tax calculation API infer any parameter not explicitly set in the API call from your account configuration defaults. So it's key to set your account defaults correctly.
1. Registered tax jurisdictions
For Quaderno to calculate tax accurately, you first need to set up the tax jurisdictions where your business is currently registered for tax collection and has a local tax ID.
This registration is independent of the countries or regions where you sell your products or services. For instance, when a US company is selling products to Australian customers, they might NOT need to register there if it hasn’t surpassed the Australian annual threshold. Check our article about tax registration thresholds for more information.
You can configure your registered jurisdictions easily from your Quaderno dashboard. Please read this Support Center article in case you have any questions. To configure jurisdictions for Quaderno Connect custom accounts, follow these steps.
2. Default product type
Products can be either services or goods.
Select your default product type on the Preferences page, based on the products you sell most. The default product type will be used when we do not receive that information on a transaction basis.
3. Default tax code
Different tax codes identify different types of product, which in turn it's key to determine its tax rate.
Select your default tax code on the Preferences page, based on the products you sell most. The default tax code will be used when we do not receive that information on a transaction basis.
Once you have set up your account correctly, you are ready to use the Tax calculation API.
We always recommend developing and testing any new integration in Quaderno Sandbox.
Now, Quaderno lets you choose the best way to calculate taxes within your app:
📄️ On your backend
Calculating taxes shouldn't be hard and tedious. With Quaderno it's as easy as this:
📄️ On your frontend
This guide focuses on integrating Quaderno.js to calculate taxes from your frontend. You should also take a look at the backend guide to learn more about the different tax parameters, as well as the Tax Calculation OpenAPI reference and the Quaderno.js API reference.