Returned Tax Information
The service returns information about tax and liability in the API responses. These responses can be individualized for different taxes like VAT or SUT. The information can also vary depending on your settings.
No tax information is generated for certain regions and countries. For more information, see Countries where No Tax Information is Returned.
If the tax_amount field is 0, this indicates that no tax information has been returned by the service. This can mean that the country is not supported or that the service has been configured to not generate tax information in this circumstance.
For a full list of the fields that are returned by the service, see Taxes Object Fields.
Example Response for VAT
The following response is an example sent by the service for VAT:
{
"transaction" : {
"update_timestamp" : 1591104250934,
"required_fields" : {
"storage_required_fields" : [],
"tax_required_fields" : [],
"audit_required_fields" : []
},
"invoice_timestamp" : "2020-05-20T01:59:59+04:00",
"tax_amount" : 20,
"ship_to_address" : {
"country_code" : "GB",
"street_name" : "30 Monmouth Street",
"city" : "Bath",
"postal_code" : "BA1 2AP"
},
"description" : "Example sale to GB.",
"currency_code" : "EUR",
"tax_liability_owner_codes" : "buyer,P1",
"invoice_place" : "VILLENEUVE D'ASCQ, 4 BD DE MONS",
"location_evidence" : {},
"invoice_address" : {
"country_code" : "GB",
"postal_code" : "BA1 2AP",
"city" : "Bath",
"street_name" : "30 Monmouth Street"
},
"product_classes" : "P",
"amount" : 300,
"total_amount" : 320,
"transaction_lines" : [
{
"deducted_tax_amount" : 0,
"reverse_charge" : false,
"carrier_id" : "DHL",
"tax_engine" : "taxamo",
"unit_price" : 200,
"kind" : "b2c",
"quantity" : 1,
"tax_country_code" : "GB",
"taxes" : [],
"product_reference_number" : "",
"description" : "Goods #1",
"tax_liability_owner_code" : "buyer",
"tax_liability_rule" : "physical-shipment-into-EU-goods-above-150-eur",
"amount" : 200,
"custom_id" : "line_1",
"tax_entity_name" : "United Kingdom",
"total_amount" : 200,
"product_cn_code" : "8504 31 80 15",
"parcel_reference" : "3897329872423",
"ship_from_address" : {
"country_code" : "CN"
},
"line_num" : 1,
"deducted_tax_rate" : 0,
"tax_address_kind" : "ship-to-address",
"seller_code" : "EU1M",
"tax_region" : "EU",
"product_class" : "P",
"tax_supported" : true,
"tax_number_service" : "vies",
"line_key" : "mpbZeqL1Dclo52tp"
},
{
"line_num" : 2,
"ship_from_address" : {
"country_code" : "PL"
},
"seller_code" : "CN1M",
"tax_region" : "EU",
"tax_address_kind" : "ship-to-address",
"tax_entity_name" : "United Kingdom",
"total_amount" : 120,
"product_cn_code" : "8504 31 80 15",
"parcel_reference" : "3897329872423",
"back_to_back_transaction_key" : "PUEp5agAAAAg3V1FBAAAAAEFBQVkAAA5pVFNPdlBKeWo3V1FBQUFBWVRTT3ZUQ21RTHBCdnM3S1JlMWxMNnYzR1NuUS5QLlBMLjg",
"line_key" : "5fdQ8TiVelhNXMrZ",
"tax_supported" : true,
"product_class" : "P",
"tax_number_service" : "vies",
"back_to_back_invoice_country_code" : "PL",
"tax_engine" : "taxamo",
"unit_price" : 100,
"quantity" : 1,
"kind" : "b2c",
"back_to_back_external_unique_id" : "PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ.P.PL.8",
"reverse_charge" : false,
"carrier_id" : "DHL",
"tax_amount" : 20,
"tax_liability_rule" : "physical-shipment-inside-EU-seller-outside-EU",
"tax_liability_owner_code" : "P1",
"custom_id" : "line_2",
"amount" : 100,
"tax_country_code" : "GB",
"product_reference_number" : "",
"taxes" : [
{
"amount_fraction_taxable" : 1,
"tax_name" : "European VAT physical",
"rate" : 20,
"rate_type" : "Standard"
}
],
"description" : "Goods #2"
}
],
"test" : false,
"buyer_name" : "Scenario #1 buyer",
"key" : "PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ",
"countries" : {},
"marketplace_code" : "P1",
"create_timestamp" : "2020-06-02T13:24:10Z",
"status" : "N",
"tax_country_codes" : "GB"
}
}
Example Response for SUT
The following is an example of a response for SUT:
{
"transaction": {
"ship_to_address": {
"country_subdivision_code": "UT",
"city": "Provo",
"country_code": "US",
"postal_code": "84601",
"street_name": "1200 Towne Centre Blvd",
"tax_region": "US"
},
"amount": 100.00,
"required_fields": {
"tax_required_fields": [],
"audit_required_fields": [],
"storage_required_fields": []
},
"tax_country_codes": "US",
"tax_amount": 6.45,
"invoice_timestamp": "2022-10-17T14:34:07Z",
"tax_liability_owner_codes": "",
"countries": {},
"transaction_lines": [
{
"reverse_charge": false,
"amount": 100.00,
"tax_rule_applied": "physical-tax",
"unit_price": 100.00,
"taxes": [
{
"tax_jurisdiction_code": "38270",
"tax_base_amount": 100,
"tax_jurisdiction_type": "STATE",
"tax_country_subdivision_code": "UT",
"rate": 4.85,
"tax_authority_name": "UTAH",
"tax_authority_id": "38270",
"tax_name": "Sales and Use Tax",
"amount_fraction_taxable": 1
},
{
"tax_jurisdiction_code": "38632",
"tax_base_amount": 100,
"tax_jurisdiction_type": "COUNTY",
"tax_country_subdivision_code": "UT",
"rate": 1.6,
"tax_authority_name": "WASHINGTON",
"tax_authority_id": "38632",
"tax_name": "Local Sales and Use Tax",
"amount_fraction_taxable": 1
}
],
"tax_amount": 6.45,
"tax_region": "US",
"tax_exempt": false,
"tax_country_code": "US",
"tax_country_subdivision_code": "UT",
"line_key": "cKIbbC3hlKjqyjKi",
"discounts": [],
"custom_id": "line_1",
"tax_address_kind": "ship_to_address",
"ship_from_address": {
"country_subdivision_code": "UT",
"city": "Salt Lake City",
"country_code": "US",
"postal_code": "84101",
"street_name": "122 W S Temple",
"tax_region": "US"
},
"tax_engine": "oseries",
"invoice_status": "F",
"kind": "b2c",
"product_class": "P",
"line_num": 1,
"is_seller_permanent": false,
"quantity": 1.000000000000,
"invoice_capable": false,
"total_amount": 106.45,
"seller_code": "seller-1",
"tax_entity_name": "US",
"tax_supported": true
}
],
"discounts": [],
"location_evidence": {},
"product_classes": "P",
"billing_address": {
"country_subdivision_code": "UT",
"city": "Provo",
"country_code": "US",
"postal_code": "84601",
"street_name": "1200 Towne Centre Blvd",
"tax_region": "US"
},
"sellers": [
{
"postal_address_line2": "Cedar City",
"settings": {
"countries": {
"US": {
"taxation": {
"physical": {
"is_seller_registered": true,
"is_physical_tax_enabled": true
}
},
"country_subdivisions": {
"UT": {
"taxation": {
"physical": {
"is_seller_registered": true,
"seller_tax_number": "SOME_US_TAX_NUMBER",
"has_physical_presence": true
}
}
}
}
}
},
"regions": {
"US": {
"taxation": {
"physical": {
"is_seller_located_within_region": true
}
}
}
}
},
"seller_code": "seller-1",
"postal_code": "84720",
"country": "US",
"postal_address_line1": "13 S 300 W"
}
],
"buyer_name": "Test buyer",
"tax_timestamp": "2022-10-17T14:34:07Z",
"total_amount": 106.45,
"currency_code": "USD"
}
}
Updated almost 2 years ago