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
Simple Order API
Use these fields to perform a tax calculation.
- billTo_country
- invoiceHeader_merchantVATRegistrationNumber
- item_#_unitPrice
- purchaseTotals_currency
- taxService
- Set totrue.
Optional Fields for an International Tax and VAT Calculation Using the Simple Order API
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