Product Pricing

Below API can be natively integrated into any international product pricing service (e.g ERP or PIM) to estimate and consider the applicable customs duty and taxes per market.

Get duty & taxes estimate for a product

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

Header parameters

Body

application/jsonapplication/xml

args*object

condsobject

wantsobject

Response

200

OK

Body

application/jsonapplication/xml

resultobject

Result (if request was successful)

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

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_product', {
  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",
      "products": [
        {
          "hs_code": "330310",
          "unitprice": 19.99,
          "description": "Paul Mitchell Tea Tree Special (10.1 Oz) Shampoo & Conditioner Duo Set"
        }
      ]
    }
  }),
});
const data = await response.json();

Response

200

{
  "result": {
    "from_country_id": "FR",
    "to_country_id": "US",
    "to_state_id": "CA",
    "to_post_code": 90210,
    "duty_calculation_rule": "CIF",
    "tax_calculation_rule": "CIF",
    "is_duty_deminimis_applied": 1,
    "is_tax_deminimis_applied": 1,
    "products": [
      {
        "hs_code": 330310,
        "country_id_of_origin": "FR",
        "currency": "USD",
        "dutiable_value": 84.75,
        "duty_rate": 8.25,
        "duty_charge": 15.25,
        "duty_charges": [
          {
            "name": "General",
            "code": "general",
            "rate": 9.975,
            "type": "duty_charge",
            "base": 121.5,
            "value": 12.12
          }
        ],
        "duty_deminimis": 125,
        "preference_applied": 0,
        "preference_source": "Free trade agreement",
        "tax_rate": 20.25,
        "tax_charge": 15.25,
        "tax_charges": [
          {
            "name": "Value Added Tax",
            "code": "vat",
            "rate": 9.975,
            "type": "tax_charge",
            "base": 121.5,
            "value": 12.12
          }
        ],
        "tax_deminimis": 25,
        "prohibition_id": "W12",
        "prohibition_note": "Warning for product type importing to destination country",
        "merchant_sku": 1234567890,
        "weight": 1,
        "weight_unit": "kg"
      }
    ]
  },
  "error": 0,
  "errors": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ],
  "warnings": [
    {
      "code": "ISSUE_CODE",
      "details": "Issue description",
      "field": "field"
    }
  ]
}