Taxes, Duties & Fees Setup Guide
Overview
The Tax API integrates taxes, duties, and fees (TDF) processing. The API provides tax quote processing for the consumer-facing webstore and order management system. The API also provides tax invoice and tax distribute processing for the order management system.
Two integration configurations are offered:
- Tax quote, invoice, and distribute processing are supported for a customer-hosted webstore and order management system.
- Tax quote processing is supported for a customer-hosted webstore. Subsequent tax quote, invoice, and distribute processing are supported for an order management system that is hosted by Radial.
Terminology
Taxes - All legal taxes applicable based on origin and destination information.
Duties - Any duty applicable on supported international shipments with applicable taxes.
Fees - Any fees applicable on the product or order with applicable taxes.
Life Cycle Flow
This flow covers the system interactions that occur for taxes, duties, and fees processing:
- A taxes, duties, and fees quote is requested during checkout from the webstore.
- The order is submitted to the order management system.
- The order management system requests a requote if issues occurred while processing tax on the webstore or if there are any changes on the order.
- The order management system submits an invoice request during shipment.
- The order management system submits a distribute request for any subsequent tax credits or customer appeasements.
The client can also receive specific or custom tax reports by working with the Radial tax team.
Domestic Taxes
Taxes
The following criteria are the main drivers for tax calculations:
- Destination address
- Origin address
- Tax class
Taxes are offered with detailed breakdown for all possible levels. Tax/VAT inclusive and tax/VAT exclusive pricing are supported. Detailed taxes are provided at the line-item level. The Radial tax team can help configure the correct tax nexus template or any special rules that are needed.
The tax class is an important input parameter for tax calculation. The tax class identifies specific taxability such as taxable, tax exempt, and non-taxable. There can be default behavior if a tax class is not present in the input. The customer tax ID is another input configuration that can help provide tax exempt orders output.
The Tax Service supports net or gross taxation pricing to account for any discounts:
- Net taxation, the preferred model for North America, offers taxes on the net amount (price minus any discounts). Discount output from the Tax Service has the same tax breakup as the parent line but shows EffectiveRate, TaxableAmount, ExemptAmount, NonTaxableAmount, and CalculatedTax as zero.
- Gross taxation provides separate tax break up on pricing and discounts.
The tax duty display preference code is an optional output configuration that can drive client-specific display logic for taxes and fees.
Fees
Partner-defined fees and service taxes can be sent in the input. Fees can be item-level, order-level, or both. The default item-level class for tax calculation is 89999. Any input values are ignored. The Radial tax team configures this tax class as tax exempt. Order-level fees can be taxable based on the input tax class.
The Tax Service also returns any additional legal fees such as the Environmental Handling Fee (EHF). The Radial tax team must configure specific requirements for legal fees. Some fees such as the California Electronic Waste Recycling, Advance Disposal Surcharge, Canada Recycling, and Product Care Eco can be offered. These fees are offered as taxable or non-taxable, based on legal requirements.
EHF calculation requires the following:
- Screen size
- Quantity
- Appropriate EHF-specific tax class
- Province or state information (for adjustments and promotions)
Any EHF fees sent in the input are ignored and recalculated real-time. EHF is not returned if the invoice type is CREDIT_MEMO.
International Duties and Taxes
International Duties and Taxes calculation allows partner to sell and ship their products internationally. The Tax Service classifies the partner catalog and provides APIs to calculate taxes and duties on the order.
The process to calculate taxes and duties on an order is performed in two stages:
- Catalog Classification
- Taxes and Duties Calculation
Catalog Classification
Items in the partner’s catalog must be classified before they can be sold online. Classification ensures that accurate taxes and duties are collected from the customer. Partners have the option of choosing which items in their catalog are available to be sold internationally. Some of the important attributes for classification of an item are listed below:
- Item Description
- Long Description
- Item Type
- Item URL
- Item Hierarchy
- Country of Origin
The process flow for Catalog Classification is shown below.
A partner can receive international shipping restrictions either by implementing the Shipping Restriction API or the iShip Restriction Feed. These provide country-level restrictions for countries supported by the International Shipping platform. Partners can use the international shipping restrictions information to prevent customers from placing orders for items in restricted countries, resulting in better customer experience.
Partners can work with the Radial international shipping platform and tax teams for setup, ratings, and configuration.
Taxes and Duties Calculation
After products are classified, a partner can use Tax Service APIs to calculate taxes and duties during the checkout process.
A partner can set up their nexus for Canadian provinces by working with Radial Tax team. This setup helps calculate correct taxes on items that are shipped to Canada.
APIs provide duties for each item. Taxes are available on the item amount, shipping amount, and duty of the item. If an item includes gift or custom features then the amount for those features is added to the merchandise amount, and taxes are present under that section.
The process flow for taxes and duties calculation is shown below.
Any discounts and promotions are subtracted from the merchandise amount, and only the net amount is considered for calculating duties and taxes. Discount output from the Tax Service has the same tax breakup as the parent line but shows EffectiveRate, TaxableAmount, ExemptAmount, NonTaxableAmount, and CalculatedTax as zero.
After an order is shipped, the partner must send shipment confirmation, using the Invoice API. If the partner is using Radial Order management system then the Invoice call is taken care of internally.
Tax Service API Operations
Taxes, duties, and fees processing uses the following API operations: