Duty & Tax Calculation
The Total Cost Calculator (TCC) is Glopal’s web service engine for calculating total landing costs for international deliveries, taking into account various landed cost components, including
Buyer-facing shipping fees
Customs duties: General, reciprocal, and preferential duties
Taxes: VAT or sales taxes, and excise tax
Ancillary fees: Optional customised surcharge to cover administrative fees
The engine supports both forward and reverse calculation, allowing to determine landed cost components either on the net or gross order value.
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:
Client username (set by Glopal)
usernamePattern: ^[a-z0-9\-]{3,255}$Optional system username to enable separation of authentication credentials by integrated client system. (set by Glopal)
alias-usernamePattern: ^[a-z0-9\-]{3,50}$The authentication signature is created by using the concatenation of the login, the ‘@’ sign and the timestamp, transformed into a HMAC_256 signature using your secret access key.
40b976b35a08bb951439ea7bbfa0a7bd73dab7c813399a31d9d1a157bc08929bPattern: ^[0-9a-f]{64}$The authentication timestamp must be a decimal numeric representing the current POSIX time, extended to microsecond accuracy. If the requesting system does not provide high-resolution time, it is advised to use a 6-digit random number. It is important to have the requesting system synchronised with a reliable time source (f.i. a stratum 2 NTP server) to avoid request rejection.
1680010295.775523Pattern: ^[12]\d{9}\.\d{6}$0.68Pattern: (^0\.\d{2}$|^[1-9]\d*\.\d{2}$)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": [
{
"qty": 2,
"unitprice": 19.99,
"description": "Paul Mitchell Tea Tree Special (10.1 Oz) Shampoo & Conditioner Duo Set"
}
]
}
]
}
}),
});
const data = await response.json();
{
"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"
}
}
]
}
]
}
Last updated