Returned Tax Information
Learn about the tax information returned by the service.
The service returns tax and liability information in API responses. The information can vary depending on the type of tax, such as VAT or GST, and your configuration settings.
The following table lists some of the primary fields returned for each transaction line:
| Field | Description |
|---|---|
tax_amount | Specifies the amount of tax that is due for the transaction. |
tax_rule_applied | The name of the rule applied by the tax engine. |
tax_liability_owner_code | This code signifies the party who owns the liability. |
tax_supported | This indicates if tax calculation is supported for this transaction. |
If the tax_amount field is 0, the service does not return any tax information. This may indicate that the country is unsupported or that your configuration prevents the service from generating tax information.
Some countries and regions do not return tax information.
For more information, see Sellers Taxes Object Fields and Marketplace 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"
}
}Untaxed transactions
Transactions where no tax is charged can be created in a number of ways:
- If an entity such as a seller or country is not enabled in the settings.
- The goods are exempt from tax.
Updated 14 days ago
Did this page help you?