Duty & Tax Calculation

The Total Cost Calculator (TCC) is Glopal’s web service engine for calculating total landing costs for international shipping, including shipping costs, customs duties, as well as any additional taxes (VAT, excise taxes,..). The engine supports both forward and reverse calculation of shipping costs, duties, and taxes.

Total landed cost calculation for an EU order

The Total Cost Calculator (TCC) is pre-integrated into Glopal’s Checkout solution, and available for the most relevant e-commerce platforms:

• Shopify: Partner app for Shopify and Shopify Plus.

• Magento 2: Plugin

• Salesforce Cloud Commerce: B2C Commerce Cartridge listed on the Salesforce AppExchange, supporting SFRA, OpenCommerce API (OCAPI), and Site Genesis

The engine is also available as native API service:

Request quote for an order

POSThttps://ws.xport.glopalservice.com/tcc/calculate_order

Header parameters

Body

application/jsonapplication/xml

args*object

condsobject

wantsobject

Response

200

OK

Body

application/jsonapplication/xml

error*enum

Boolean defining call success

Example: 0

10

errorsarray of object

List of errors (if request was not successful)

warningsarray of object

List of warnings

resultarray of object

Results per delivery type calculation

Request

JSPy

const timestamp = String(Date.now() / 1000).padEnd(17, '0');
const username = "username";
const signature = CryptoJS.HmacSHA256(
  `${username}@${timestamp}`, "sharedsecret"
  ).toString(CryptoJS.digest)

const response = await fetch('https://ws.xport.glopalservice.com/tcc/calculate_order', {
  method: 'POST',
  headers: {
    "Content-Type": "application/json",
    "x-login": username,
    "x-timestamp": timestamp,
    "x-signature": signature
  },
  body: JSON.stringify({
    "args":{
      "from_country_id": "US",
      "to_country_id": "CA",
      "to_state_id": "QC",
      "delivery_type_id": "X",
      "shipments": [
        {
          "currency": "USD",
          "products": [
            {
              "product_class": "haircare product",
              "qty": 2,
              "unitprice": 19.99,
              "description": "Paul Mitchell Tea Tree Special (10.1 Oz) Shampoo & Conditioner Duo Set"
            }
          ]
        }
      ]
    }
  }),
});
const data = await response.json();

Response

200

{
  "error": 0,
  "errors": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ],
  "warnings": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ],
  "result": [
    {
      "from_country_id": "FR",
      "to_country_id": "US",
      "to_state_id": "CA",
      "to_post_code": 90210,
      "delivery_type_id": "X",
      "transaction_id": "642edad40de2f361ba4d1684aaf3c53a0afc687b",
      "dutiable_value": 84.75,
      "dutiable_value_discount": 10,
      "dutiable_value_discount_tax": 1.2,
      "dutiable_value_discount_duty": 1.23,
      "dutiable_value_discount_net": 8.02,
      "dutiable_value_tax_included": 100,
      "dutiable_value_tax_charge": 4.23,
      "duty_charge": 15.25,
      "duty_charge_included": 12.12,
      "duty_charge_tax": 2.23,
      "currency": "USD",
      "dead_weight": 12.34,
      "vol_weight": 15.22,
      "weight": 15.22,
      "weight_unit": "kg",
      "duty_calculation_rule": "CIF",
      "tax_calculation_rule": "CIF",
      "is_duty_deminimis_applied": 0,
      "is_tax_deminimis_applied": 0,
      "commission_fee": 0.12,
      "incoterms": "DDP",
      "reference": "test123",
      "tax_charge": 15.25,
      "tax_charges": [
        {
          "name": "Charge",
          "code": "charge_id",
          "rate": 9.975,
          "type": "dutiable_value",
          "base": 121.5,
          "value": 12.12
        }
      ],
      "tax_charge_included": 12.12,
      "product_tax_charge": 10.03,
      "calculus_shipping_charge": 15.33,
      "shipping_charge": 13.33,
      "shipping_charge_duty": 3.33,
      "shipping_charge_tax": 2.33,
      "shipping_charge_tax_included": 2.33,
      "shipping_charge_duty_tax": 0.33,
      "merchant_shipping_charge": {
        "currency": "USD",
        "value": 5
      },
      "discount": 10,
      "discounts": [
        {
          "name": "Charge",
          "code": "charge_id",
          "rate": 9.975,
          "type": "dutiable_value",
          "base": 121.5,
          "value": 12.12
        }
      ],
      "extra_charge": 33.23,
      "extra_charges": [
        {
          "name": "Charge",
          "code": "charge_id",
          "rate": 9.975,
          "type": "dutiable_value",
          "base": 121.5,
          "value": 12.12
        }
      ],
      "total_charge": 150.23,
      "transport": {
        "carrier": "DHL",
        "service": "DHL Express"
      },
      "products": [
        {
          "calculus_duty_charge": 5.33,
          "calculus_tax_charge": 3.49,
          "documentation_code": "CITES_2000_a",
          "dutiable_value": 84.75,
          "dutiable_value_tax_charge": 4.23,
          "dutiable_value_tax_included": 100,
          "duty_charge": 15.25,
          "duty_charges": [
            {
              "name": "Charge",
              "code": "charge_id",
              "rate": 9.975,
              "type": "dutiable_value",
              "base": 121.5,
              "value": 12.12
            }
          ],
          "duty_charge_included": 12.12,
          "duty_charge_tax": 2.23,
          "duty_deminimis": 125,
          "duty_rate": 8.25,
          "gtin": 1234567890,
          "hs_code": 330310,
          "merchant_sku": 1234567890,
          "alt_merchant_sku": "AMS1234567890",
          "preference_applied": 0,
          "preference_source": "Free trade agreement",
          "product_dutiable_value_discount": 10,
          "product_dutiable_value_discount_tax": 1.2,
          "product_dutiable_value_discount_duty": 1.23,
          "product_dutiable_value_discount_net": 8.02,
          "product_shipping_charge_duty": 3.33,
          "product_shipping_charge_tax": 2.33,
          "product_shipping_charge_duty_tax": 0.33,
          "prohibition_id": "W12",
          "prohibition_note": "Warning for product type importing to destination country",
          "quantity": 0,
          "shipment_id": 123456,
          "tax_charge": 15.25,
          "tax_charges": [
            {
              "name": "Charge",
              "code": "charge_id",
              "rate": 9.975,
              "type": "dutiable_value",
              "base": 121.5,
              "value": 12.12
            }
          ],
          "tax_charge_included": 12.12,
          "tax_deminimis": 25,
          "tax_rate": 20.25
        }
      ]
    }
  ]
}