Tax Items

Taxes differ by country and can differ within the country by region, state, or province. Each jurisdiction has a unique tax code and rate. If your store serves many jurisdictions, integrate a third-party tax generator to manage taxes. If your store serves a few jurisdictions, you can use the API to define the tax codes and rates in Composable Commerce.

Taxes are calculated after all promotional discounts have been applied. When calculating taxes on a cart or order, you can choose from the following methods for calculating taxes:

• Simple calculation method: Taxes are calculated at the unit level and are rounded to the nearest penny for the unit.
• Line calculation method: Default. Taxes are calculated at the line level and are rounded to the nearest penny for the line. For more information about calculation methods, see Calculate cart and order totals.

Tax values can be either rate or amount. Supplying both fields will result in an error.

• rate - Represents the tax as a percentage in decimal form.
• amount - Represents a tax amount.

Tax items can be added and removed using client_credentials access tokens. Only administrators with client-credentials access tokens are able to manage tax items.

📄️ Add Tax Item to Cart

Use this endpoint to add a tax item to a cart.

📄️ Bulk Add Tax Items to Cart

:::note

📄️ Bulk Delete Tax Items from Cart

Use this endpoint to bulk delete tax items from cart.

📄️ Update a Tax Item

Use this endpoint to update a tax item. To change tax value from `rate` to `amount`, set `rate` to `null`, then set `amount` value and vice versa.

📄️ Delete a Tax Item

Use this endpoint to delete a tax item.