EU Markets: Introducing VAT Calculation Service (VCS) — New Product and Order API Fields

TikTok Shop has introduced the VAT Calculation Service (VCS), a feature that automatically calculates the correct VAT on every sale made to customers in the European Union.

When a seller enables VCS, two areas of the API are affected:

1. Product listing — Product Tax Code (PTC)

A new product attribute has been added to support PTC. Use the Get Attributes endpoint to retrieve the available Product Tax Code (PTC) options by category.

• PTC can be set at the shop level (default) or overridden at the product level.
• Product-level PTC takes precedence over shop-level PTC.
• Shop Level PTC can only be configured and viewed in the TikTok Shop Seller Center.

1. Orders — VAT fields

The following fields will return VAT values in the Get Order Detail endpoint when VCS is enabled:

Seller configuration requirements: For VCS to work, sellers must configure it in Seller Center. For requirements and setup instructions, refer to the guides by market:

• Ireland TikTok Shop Academy
• Germany TikTok Shop Academy
• France TikTok Shop Academy
• Spain TikTok Shop Academy
• Italy TikTok Shop Academy

This change applies to EU markets: DE, ES, FR, IE, IT.

Developers with applications that are used for product catalog and order management.

1. Product listing and management
2. Add a PTC selector field in your product listing UI
3. Populate available PTC options using the Get Attributes endpoint (attribute ID: 103356)
4. Order management

Update your order handling logic to read and display the new fields and values:

• item_tax
• shipping_tax_amount
• shipping_tax_rate
• Seller guidance

Guide sellers to complete the following steps in Seller Center before using VCS:

• Configure VCS: set a default PTC and shipping tax rate.
• Review the PTC reference table in TikTok Shop Academy to understand applicable tax rates per PTC.