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

Pre-Integrated Platforms

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

Native API Integration

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

resultarray of object

Results per delivery type calculation

error*enum

Operation success outcome

Example: 0

10

errorsarray of object

List of errors (if operation was not successful)

warningsarray of object

List of warnings

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,
  "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":0,
          "type":"dutiable_value",
          "value":0
        }
      ],
      "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_duty_included":1.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":0,
          "type":"dutiable_value",
          "value":0
        }
      ],
      "extra_charge":33.23,
      "extra_charges":[
        {
          "name":"Charge",
          "code":"charge_id",
          "rate":0,
          "type":"dutiable_value",
          "value":0
        }
      ],
      "transport":{
        "carrier":"DHL",
        "service":"DHL Express"
      },
      "products":[
        {
          "calculus_duty_charge":5.33,
          "calculus_tax_charge":3.49,
          "country_id_of_origin":"FR",
          "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_charge_included":12.12,
          "duty_charge_tax":2.23,
          "duty_deminimis":125,
          "duty_rate":8.25,
          "gtin":"1234567890",
          "hs_code":"429999",
          "merchant_sku":"1234567890",
          "alt_merchant_sku":"AMS1234567890",
          "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":100,
          "shipment_id":123456,
          "tax_charge":15.25,
          "tax_charges":[
            {
              "name":"Charge",
              "code":"charge_id",
              "rate":0,
              "type":"dutiable_value",
              "value":0
            }
          ],
          "tax_charge_included":12.12,
          "tax_deminimis":25,
          "tax_rate":20.25,
          "total_charge":150.23,
          "transport":{
            "carrier":"DHL",
            "service":"DHL Express"
          }
        }
      ]
    }
  ]
}