Calculating International Tax and VAT

Before calculating international tax, make sure that the country is on the list of Supported Countries and Regions.
One tax service request should not include more than 50 line items. When you send a request with more than 50 line items, the request could time out.

VAT Number

When you include the or
field and VAT rules and rates are applicable, the service calculates a VAT tax, and the relevant tax amounts are returned in the response.
There are some countries where VAT registration is not required. More details are mentioned in Supported Countries and Regions.

Product Codes

If a product is subject to special tax considerations, provide the appropriate tax product code in the field in the request. To use a product code that is not listed in the available guides, contact customer support for information about how to proceed.

Tax Per Item

When the tax calculation service succeeds, the response includes a tax amount for each item and indicates whether the tax amount was calculated by the tax calculation service or provided by you.

Endpoint

Set the
taxService
field to
true
.
Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.

Required Fields for an International Tax and VAT Calculation Using the
Simple Order API

Use these fields to perform a tax calculation.
billTo_country
invoiceHeader_merchantVATRegistrationNumber
item_#_unitPrice
purchaseTotals_currency
taxService
Set to
true
.

Optional Fields for an International Tax and VAT Calculation Using the
Simple Order API

Select from these optional fields to perform a tax calculation.
merchantReferenceCode
ccAuthReply_requestAmount

Example: Processing an International Tax Calculation Using the SO API

Request
billTo_country=FR invoiceHeader_merchantVATRegistrationNumber=123456789 item_#_unitPrice=1200 purchaseTotals_currency=EUR taxService=true
Response
merchantReferenceCode=482046C3A7E94F5 requestID=4817605701820004775333 decision=ACCEPT reasonCode=100 purchaseTotals_currency=EUR taxReply_totalCountryTaxAmount=0.00 taxReply_reasonCode=100 taxReply_totalSpecialTaxAmount=73.20 taxReply_totalTaxableAmount=2440.00 taxReply_totalStateTaxAmount=152.50 taxReply_totalExemptAmount=0.00 taxReply_grandTotalAmount=2671.80 taxReply_totalCityTaxAmount=0.00 taxReply_totalTaxAmount=231.80 taxReply_item_0_taxableAmount=1200.00 taxReply_item_0_exemptAmount=0.00 taxReply_item_0_specialTaxAmount=36.00 taxReply_item_0_cityTaxAmount=0.00 taxReply_item_0_countyTaxAmount=3.00 taxReply_item_0_stateTaxAmount=75.00 taxReply_item_0_countryTaxAmount=0.00 taxReply_item_0_totalTaxAmount=114.00 taxReply_item_0_jurisdiction_0_country=FR taxReply_item_0_jurisdiction_0_region=FR taxReply_item_0_jurisdiction_0_type=Country taxReply_item_0_jurisdiction_0_code=06 taxReply_item_0_jurisdiction_0_taxable=1200.00 taxReply_item_0_jurisdiction_0_rate=0.062500 taxReply_item_0_jurisdiction_0_taxAmount=75.00 taxReply_item_0_jurisdiction_0_name=FR taxReply_item_0_jurisdiction_0_taxName=FR STATE TAX taxReply_item_0_jurisdiction_1_country=FR taxReply_item_0_jurisdiction_1_region=FR taxReply_item_0_jurisdiction_1_type=Country taxReply_item_0_jurisdiction_1_code=001 taxReply_item_0_jurisdiction_1_taxable=1200.00 taxReply_item_0_jurisdiction_1_rate=0.002500 taxReply_item_0_jurisdiction_1_taxAmount=3.00 taxReply_item_0_jurisdiction_1_name=ALAMEDA taxReply_item_0_jurisdiction_1_taxName=FR COUNTY TAX taxReply_item_0_jurisdiction_2_country=FR taxReply_item_0_jurisdiction_2_region=FR taxReply_item_0_jurisdiction_2_type=Special taxReply_item_0_jurisdiction_2_code=EMAK0 taxReply_item_0_jurisdiction_2_taxable=1200.00 taxReply_item_0_jurisdiction_2_rate=0.020000 taxReply_item_0_jurisdiction_2_taxAmount=24.00 taxReply_item_0_jurisdiction_2_name=ALAMEDA COUNTY DISTRICT TAX SP taxReply_item_0_jurisdiction_2_taxName=FR SPECIAL TAX taxReply_item_0_jurisdiction_3_country=FR taxReply_item_0_jurisdiction_3_region=FR taxReply_item_0_jurisdiction_3_type=Special taxReply_item_0_jurisdiction_3_code=EMSJ0 taxReply_item_0_jurisdiction_3_taxable=1200.00 taxReply_item_0_jurisdiction_3_rate=0.010000 taxReply_item_0_jurisdiction_3_taxAmount=12.00 taxReply_item_0_jurisdiction_3_name=ALAMEDA CO LOCAL TAX SL taxReply_item_0_jurisdiction_3_taxName=FR SPECIAL TAX