Calculate Tax

To calculate tax, use the following URL and a POST method:

{Taxamo_A_URL}/api/v3/seller/tax/calculate

where {Taxamo_A_URL} is the URL of the sandbox or production environment.

For example:

https://seller-transaction-api.sandbox.marketplace.taxamo.com/api/v3/seller/tax/calculate

Details

TypeValue
Endpoint/api/v3/seller/tax/calculate
MethodPOST
Seller API Reference DocumentCalculate Tax

Fields

For a full list of fields, see Fields Reference Overview.

❗️

Warning

The following fields are inactive for this request and you cannot use them in your requests:

  • invoice_timestamp
  • external_unique_id

For more information, see Response-Only and Inactive Fields.

Request Example

When you use the Calculate Tax request, you can include transaction information. However, you do not need to specify any tax information. For example:

{
"transaction": {
    "currency_code": "EUR",
    "buyer_name": "Eric Papin",
    "ship_to_address": {
      "address_detail": "Palais de l'Élysée",
      "building_number": "55",
      "street_name": "Rue du Saint-Germain",
      "city": "Paris",
      "postal_code": "75008 ",
      "country_code": "FR"
    },
    "transaction_lines": [
      {
        "product_class": "P",
        "quantity": 1,
        "description": "Smoked herrings",
        "amount": "49.95",
        "custom_id": "51315A00-DC44-408E-A575-8CE42A32AE1B",
        "import_address":{
            "country_code": "FR"
        },
        "ship_from_address": {
            "building_number": "12",
            "street_name": "Wessex End Street",
            "city": "London",
          "postal_code": "SW1A 2AA",
          "country_code": "GB"
        },
        "product_cn_code": "0305420000"
      }
    ]
  }
}

Response Example

The following example shows the fields that are returned by the API:

{
    "transaction": {
        "ship_to_address": {
            "city": "Paris",
            "country_code": "FR",
            "postal_code": "75008 ",
            "street_name": "Rue du Saint-Germain",
            "address_detail": "Chateuax 12",
            "building_number": "55",
            "tax_region": "EU"
        },
        "amount": 49.95,
        "required_fields": {
            "tax_required_fields": [],
            "audit_required_fields": [],
            "storage_required_fields": []
        },
        "tax_country_codes": "FR",
        "tax_amount": 5,
        "invoice_timestamp": "2021-08-23T13:44:39Z",
        "tax_liability_owner_codes": "Taxamo",
        "countries": {},
        "transaction_lines": [
            {
                "description": "Smoked herrings",
                "reverse_charge": false,
                "amount": 49.95,
                "tax_rule_applied": "physical-tax",
                "unit_price": 49.95,
                "taxes": [
                    {
                        "rate": 10,
                        "tax_name": "European VAT",
                        "rate_type": "Reduced",
                        "amount_fraction_taxable": 1,
                        "tax_base_amount": 49.95
                    }
                ],
                "tax_amount": 5,
                "import_address": {
                    "country_code": "FR",
                    "tax_region": "EU"
                },
                "tax_liability_rule": "physical-shipment-into-EU-goods-below-150-eur-with-ioss-non-EU-supplier",
                "platform_liability_assumed_amount": 49.95,
                "seller_tax_number": "IE3764989CH",
                "tax_region": "EU",
                "tax_exempt": false,
                "additional_currencies": {
                    "consignment": {
                        "currency_code": "EUR",
                        "fx_date": "2021-08-23T13:44:39Z",
                        "fx_rate": 1,
                        "fx_source": "ECB"
                    }
                },
                "tax_country_code": "FR",
                "special_tax_scheme": "IOSS",
                "line_key": "CpkwPcoi9lnrOvGK",
                "custom_id": "51315A00-DC44-408E-A575-8CE42A32AE1B",
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "city": "London",
                    "country_code": "GB",
                    "postal_code": "SW1A 2AA",
                    "street_name": "Wessex End Street",
                    "building_number": "12",
                    "tax_region": "GB"
                },
                "tax_engine": "taxamo",
                "invoice_status": "R",
                "kind": "b2c",
                "tax_number_service": "vies",
                "product_class": "P",
                "tax_liability_owner_code": "Taxamo",
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1,
                "total_amount": 54.95,
                "seller_code": "seller_jftest_1",
                "product_cn_code": "0305420000",
                "tax_entity_name": "France",
                "tax_supported": true
            }
        ],
        "discounts": [],
        "location_evidence": {},
        "vouchers": [],
        "product_classes": "P",
        "billing_address": {
            "city": "Paris",
            "country_code": "FR",
            "postal_code": "75008 ",
            "street_name": "Rue du Saint-Germain",
            "address_detail": "Chateuax 12",
            "building_number": "55",
            "tax_region": "EU"
        },
        "buyer_name": "Eric Papin",
        "tax_timestamp": "2021-08-23T13:44:39Z",
        "total_amount": 54.95,
        "currency_code": "EUR"
    }
}