The unique identifier for the object. The id for the Landed Cost object will always be prefixed with ldct.
amount_subtotal HASH
Landed cost total. If using for an ecommerce checkout, we recommend using these totals to display to the end user. These totals allow for an easier integration without the need to sum duties, taxes or fees by item and shipment level. Additional details are available in the landed cost object.See child attributes below.
amount_subtotal.duties DECIMAL
Sum of all the duties in the duties array. Includes duties as levied on items, shipping, or any additional duties applied to the import. To understand how duties are calculated, see the import duty doc.
amount_subtotal.fees DECIMAL
Sum of the various fees in the fees array. Includes the clearance fees, country import fees, or other fees applied to the import. To understand more about import fees, see the import fees doc.
amount_subtotal.taxes DECIMAL
Sum of all the taxes in the taxes array. Includes taxes as applied to items, duty, shipping or fees. To understand more about import taxes, see the import taxes doc.
currency HASH
Hash providing information on the base currency sent in the request and other currencies with the exchange rate used at the time of the response. This is useful if you want to convert to the import country currency or to other currencies used in the landed cost calculation.See child attributes below.
The base currency as sent in the landed cost request, represented by a three-letter ISO code. All amounts in the landed cost object are listed in the base currency.
currency.date TIMESTAMP
The date in which the currency rate was pulled, in the ISO 8601 format: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASH
Hash containing the currencies and exchange rates needed for conversion from the base currency.
currency.rates.currency STRING
An exchange rate currency used in the landed cost calculation.
currency.rates.rate DECIMAL
The exchange rate at the time of the landed cost request for the specified currency.
customs HASH
Hash containing information used determine the landed cost as well as information needed for customs documentation and customs clearance. See child attributes below.
customs.delivery_duty_paid STRING
The ability to bill duties and taxes to someone other than the receiver (DDP - delivery duty paid) varies by shipping carrier, shipping service, or destination country.Possible values are available, unavailable, and unknown.If the landed cost is used for an ecommerce checkout, you should only allow the shopper to pay duties and taxes if the result is available.If the result is unknown, you may either present the shopper with an estimated amount of duty and tax they will have to pay upon delivery or you may not want to display the duty and tax at all for that carrier service level.If the result is unavailable, your account has been configured in the Zonos Dashboard to not allow DDP, even though it is an allowed service by the selected carrier.
customs.items LIST
The list of items sent in the request.See child attributes below.
customs.items.id STRING
The unique identifier sent in the request.
customs.items.amount DECIMAL
The item amount in the base currency. This is the amount sent in the request for this item.
customs.items.country_of_origin STRING
The country of manufacture where the item or article was produced. Represented by a two-letter ISO code. See the import duty doc to understand how the country of origin impacts the landed cost calculation.
customs.items.country_of_origin_source STRING
The source of the country of origin. Possible values are zonos_catalog, api_request, and account_defaultplatform.
customs.items.description_customs STRING
The suggested description of goods for the commercial invoice. This description will usually differ from a retail description and will typically include a general description of what it is, what it is made from, and what it is used for.
customs.items.description_retail STRING
The retail description of the item.
customs.items.detail STRING
Additional features, attributes, or descriptions of the item.
customs.items.dimensions LIST
The size of the shipment. hash
customs.items.dimensions.height DECIMAL
The height of the item.
customs.items.dimensions.length DECIMAL
The length of the item.
customs.items.dimensions.unit STRING
The unit of measurement for the item dimensions.Possible values are inch, centimeter, millimeter, and null.When null, inch will be used.
customs.items.dimensions.width DECIMAL
The width of the item.
customs.items.hs_code STRING
The harmonized tariff code used to determine the tariff rate in the landed cost calculation.
customs.items.hs_code_source STRING
The source of the harmonized tariff code used, which can be set by Zonos.Possible values are zonos_catalog, api_request, zonos_classified, account_default, and hs_correction.
customs.items.image_url STRING
The image URL.
customs.items.note STRING
Additional details on the item clearance or HS code, if applicable.An example for India is As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.
customs.items.quantity INTEGER
The quantity of the item as sent in the request.
customs.items.upc_code STRING
The UPC code of the item.
customs.items.weight DECIMAL
The weight of the item.
customs.items.weight_unit STRING
The unit of measurement for the weight. Possible values are pound, ounce, kilogram, and null.When null, pound will be used.
customs.ship_to_country STRING
The import country where duties and taxes are applied.
customs.shipping_amount DECIMAL
The shipping amount that should be listed on the customs documentation.
de_minimis HASH
Information about the country-specific threshold that determines when duties and taxes apply. The currency rates array will contain the conversion rate used to determine if the import was above or below duty and tax thresholds. See child attributes below.
de_minimis.formula STRING
The formula used to calculate the de minimis threshold eligibility.
de_minimis.method STRING
This is the method of calculation, such as cif, cifd, cifdt, fob, or fobd.
de_minimis.note STRING
Additional details on the de minimis, such as providing information if an item was not eligible for de minimis consideration, like wine.
de_minimis.threshold STRING
Whether or not the tax is under or over the tax threshold. Possible values include above or below.
de_minimis.type STRING
The de minimis applied to type. Possible values include tax and duty.
duties HASH
An array of duties applied to the import. The sum of the duty amounts are equal to the amount_subtotal.duties.See child attributes below.
duties.amount DECIMAL
The amount of duty on the item, shipping, or fee.
duties.description STRING
Varying descriptions of the duty such as duty, anti_dumping_duty, and more.
duties.formula STRING
The formula used to calculate the duty amount. For duty, this is typically the tariff for the import country and could be ad valorem or a specific duty rate.
duties.item_id STRING
The unique identifier sent in the request. The id is only provided when the type is item.
duties.note STRING
Additional details on the duty, including free trade agreements, reduced duty rates, anti-dumping duties, and more.
duties.type STRING
The duty is applied to the type.Possible values include item, shipping, and fee.
fees HASH
An array of fees applied to the import. The sum of the fee amounts are equal to the amount_subtotal.fees.See child attributes below.
fees.amount DECIMAL
The fee amount applied to the item, shipping, duty, service level, carrier, or country. This amount is in the base currency and may have been converted from the import country’s respective currency to the base currency sent in the request.
fees.description STRING
Varying descriptions of the duty such as UPS Disbursement Fee, FedEx Advancement Fee, and An Post Clearance Fee.
fees.formula STRING
The formula used to calculate the fee. For fees, this is typically a flat amount, a percentage of the duties and taxes, or another formula.
fees.item_id STRING
Your unique identifier sent in the landed cost request. The id is only provided when the type is item.
fees.note STRING
Additional details on the fee, if needed.
fees.type STRING
The fee is applied to the type.Possible values include advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country, and other.
messages HASH
A list of non-critical messages, e.g., The shipping amount in the request was null, this could impact the calculation.
messages.message STRING
A helpful message related to your Landed Cost request and what non-critical information was missing.
messages.type STRING
The message type.Possible values include price_adjustment, default_value_used, shipping_missing, and item_weight_missing
remittance HASH
An array containing the amount and details of what needs to be remitted to a specific country, e.g., Australia, New Zealand, Norway, or United Kingdom.
remittance.amount DECIMAL
The amount of money that needs to be remitted to a specific country.
remittance.description STRING
A description of what the remittance is for, e.g., UK VAT.
remittance.note STRING
A note about how the tax should be remitted, e.g., remit to HMRC quarterly.
removed_items LIST
The list of items removed from the request for the landed cost calculation. ItemsSee child attributes below.
removed_items.id STRING
The unique identifier sent in the request.
removed_items.amount DECIMAL
The item amount in the base currency. This is the amount sent in the request for this item.
removed_items.country_of_origin STRING
The country of manufacture where the item or article was produced. Represented by a two-letter ISO code. See the import duty doc to understand how the country of origin impacts the landed cost calculation.
removed_items.country_or_origin_source STRING
The source of the country of origin. Possible values are zonos_catalog, api_request, and account_defaultplatform.
removed_items.description_customs STRING
The suggested description of goods for the commercial invoice. This description will usually differ from a retail description and will typically include a general description of what it is, what it is made from, and what it is used for.
removed_items.description_retail STRING
The retail description of the item.
removed_items.hs_code STRING
The harmonized tariff code used to determine the tariff rate in the landed cost calculation.
removed_items.hs_code_source STRING
The source of the harmonized tariff code used, which can be set by Zonos.Possible values are zonos_catalog, api_request, platform, zonos_classified, account_default, and hs_correction.
removed_items.note STRING
Additional details on the item clearance or HS code, if applicable.An example for India is As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.
removed_items.quantity INTEGER
The quantity of the item as sent in the request.
taxes HASH
An array of taxes applied to the import. The sum of the tax amounts are equal to the amount_subtotal.taxes. See child attributes below.
taxes.amount DECIMAL
The amount of tax on the item, shipping, duty, or fee.
taxes.description STRING
Varying descriptions of the applied tax such as tax, VAT, GST, PST, HST, and more.
taxes.formula STRING
The formula used to calculate the tax amount typically includes the import country tax; however, this may also be a state (or provincial) tax or a reduced (or added) tax.
taxes.item_id STRING
The unique identifier sent in the landed cost request. The id is only provided when the type is item.
taxes.note STRING
Additional details on the tax, including reduced tax rates or other applicable information on the applied tax.
taxes.type STRING
The tax is applied to the type.Possible values include itemduty and shipping as well as the fees types of advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country, and other.
1{
2"id":"ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
3"amount_subtotal":{
4"duties":0,
5"fees":15,
6"taxes":12.25
7},
8"currency":{
9"id":"b5f06418-3",
10"base":"USD",
11"date":"2021-01-07T00:34:03.471+0000",
12"rates":[
13{
14"currency":"GBP",
15"rate":0.8117
16}
17]
18},
19"customs":{
20"delivery_duty_paid":"available",
21"items":[
22{
23"id":"294395",
24"amount":39.17,
25"country_of_origin":"FR",
26"country_of_origin_source":null,
27"description_customs":"Hoka One Running Shoe - Women's",
28"description_retail":"Hoka One Running Shoe - Women's",
29"hs_code":"6116.10",
30"hs_code_source":"api_request",
31"note":"Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
32"quantity":1
33},
34{
35"id":"294396",
36"amount":7.83,
37"country_of_origin":"CN",
38"country_of_origin_source":"account_default",
39"description_customs":"Galaxy Quest Men's Tee Blue",
40"description_retail":"Galaxy Quest Men's Tee Blue",
41"hs_code":"6217.10",
42"hs_code_source":"api_request",
43"note":"Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
44"quantity":1
45}
46],
47"shipping_amount":14.23,
48"ship_to_country":"GB"
49},
50"de_minimis":[
51{
52"formula":"(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
53"method":"FOB",
54"note":"Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
55"threshold":"below",
56"type":"duty"
57},
58{
59"formula":"(cost {'<='} 0 gbp)",
60"method":"FOB",
61"note":"Tax applies to all shipments",
62"threshold":"above",
63"type":"tax"
64}
65],
66"duties":[],
67"fees":[
68{
69"amount":15,
70"description":"UPS United States Duty and Tax Forwarding Charge",
Landed Cost object
Landed Cost object
Explore the capabilities and functions of the Landed Cost object.
The Landed Cost object provides a breakdown and total of import duties, taxes, and fees.
Attributes
idSTRINGldct.amount_subtotalHASHamount_subtotal.dutiesDECIMALamount_subtotal.feesDECIMALamount_subtotal.taxesDECIMALcurrencyHASHcurrency.idSTRINGcurrency.baseSTRINGcurrency.dateTIMESTAMPYYYY-MM-DDTHH:mm:ss.sssZcurrency.ratesHASHcurrency.rates.currencySTRINGcurrency.rates.rateDECIMALcustomsHASHcustoms.delivery_duty_paidSTRINGavailable,unavailable, andunknown.If the landed cost is used for an ecommerce checkout, you should only allow the shopper to pay duties and taxes if the result isavailable.If the result isunknown, you may either present the shopper with an estimated amount of duty and tax they will have to pay upon delivery or you may not want to display the duty and tax at all for that carrier service level.If the result isunavailable, your account has been configured in the Zonos Dashboard to not allow DDP, even though it is an allowed service by the selected carrier.customs.itemsLISTcustoms.items.idSTRINGcustoms.items.amountDECIMALcustoms.items.country_of_originSTRINGcustoms.items.country_of_origin_sourceSTRINGzonos_catalog,api_request, andaccount_defaultplatform.customs.items.description_customsSTRINGcustoms.items.description_retailSTRINGcustoms.items.detailSTRINGcustoms.items.dimensionsLISThashcustoms.items.dimensions.heightDECIMALcustoms.items.dimensions.lengthDECIMALcustoms.items.dimensions.unitSTRINGinch,centimeter,millimeter, andnull.Whennull,inchwill be used.customs.items.dimensions.widthDECIMALcustoms.items.hs_codeSTRINGcustoms.items.hs_code_sourceSTRINGzonos_catalog,api_request,zonos_classified,account_default, andhs_correction.customs.items.image_urlSTRINGcustoms.items.noteSTRINGAs per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.customs.items.quantityINTEGERcustoms.items.upc_codeSTRINGcustoms.items.weightDECIMALcustoms.items.weight_unitSTRINGpound,ounce,kilogram, andnull.Whennull,poundwill be used.customs.ship_to_countrySTRINGcustoms.shipping_amountDECIMALde_minimisHASHde_minimis.formulaSTRINGde_minimis.methodSTRINGcif,cifd,cifdt,fob, orfobd.de_minimis.noteSTRINGde_minimis.thresholdSTRINGaboveorbelow.de_minimis.typeSTRINGtype. Possible values includetaxandduty.dutiesHASHamount_subtotal.duties.See child attributes below.duties.amountDECIMALitem,shipping, orfee.duties.descriptionSTRINGduty,anti_dumping_duty, and more.duties.formulaSTRINGduties.item_idSTRINGitem.duties.noteSTRINGduties.typeSTRINGtype.Possible values includeitem,shipping, andfee.feesHASHamount_subtotal.fees.See child attributes below.fees.amountDECIMALfees.descriptionSTRINGUPS Disbursement Fee,FedEx Advancement Fee, andAn Post Clearance Fee.fees.formulaSTRINGfees.item_idSTRINGitem.fees.noteSTRINGfees.typeSTRINGtype.Possible values includeadvancement,additional_tariff_lines,ddp_service_fee,brokerage,cod,country, andother.messagesHASHmessages.messageSTRINGmessages.typeSTRINGprice_adjustment,default_value_used,shipping_missing, anditem_weight_missingremittanceHASHremittance.amountDECIMALremittance.descriptionSTRINGremittance.noteSTRINGremoved_itemsLISTremoved_items.idSTRINGremoved_items.amountDECIMALremoved_items.country_of_originSTRINGremoved_items.country_or_origin_sourceSTRINGzonos_catalog,api_request, andaccount_defaultplatform.removed_items.description_customsSTRINGremoved_items.description_retailSTRINGremoved_items.hs_codeSTRINGremoved_items.hs_code_sourceSTRINGzonos_catalog,api_request,platform,zonos_classified,account_default, andhs_correction.removed_items.noteSTRINGAs per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.removed_items.quantityINTEGERtaxesHASHamount_subtotal.taxes. See child attributes below.taxes.amountDECIMALtaxes.descriptionSTRINGtax,VAT,GST,PST,HST, and more.taxes.formulaSTRINGtaxes.item_idSTRINGitem.taxes.noteSTRINGtaxes.typeSTRINGtype.Possible values includeitemdutyandshippingas well as the fees types ofadvancement,additional_tariff_lines,ddp_service_fee,brokerage,cod,country, andother.{"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz","amount_subtotal": {"duties": 0,"fees": 15,"taxes": 12.25},"currency": {"id": "b5f06418-3","base": "USD","date": "2021-01-07T00:34:03.471+0000","rates": [{"currency": "GBP","rate": 0.8117}]},"customs": {"delivery_duty_paid": "available","items": [{"id": "294395","amount": 39.17,"country_of_origin": "FR","country_of_origin_source": null,"description_customs": "Hoka One Running Shoe - Women's","description_retail": "Hoka One Running Shoe - Women's","hs_code": "6116.10","hs_code_source": "api_request","note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD","quantity": 1},{"id": "294396","amount": 7.83,"country_of_origin": "CN","country_of_origin_source": "account_default","description_customs": "Galaxy Quest Men's Tee Blue","description_retail": "Galaxy Quest Men's Tee Blue","hs_code": "6217.10","hs_code_source": "api_request","note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD","quantity": 1}],"shipping_amount": 14.23,"ship_to_country": "GB"},"de_minimis": [{"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")","method": "FOB","note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items","threshold": "below","type": "duty"},{"formula": "(cost {'<='} 0 gbp)","method": "FOB","note": "Tax applies to all shipments","threshold": "above","type": "tax"}],"duties": [],"fees": [{"amount": 15,"description": "UPS United States Duty and Tax Forwarding Charge","item_id": null,"formula": "15 USD","note": null,"type": "ddp_service_fee"}],"remittance": [{"amount": 12.25,"description": "UK VAT","note": "remit to HMRC quarterly"}],"removed_items": [],"taxes": [{"amount": 7.83,"description": "VAT (Value-added tax)","item_id": "294395","formula": "20%","note": null,"type": "item"},{"amount": 2.3719,"description": "VAT (Value-added tax)","item_id": "294395","formula": "20%","note": null,"type": "shipping"},{"amount": 1.57,"description": "VAT (Value-added tax)","item_id": "294396","formula": "20%","note": null,"type": "item"},{"amount": 0.4741,"description": "VAT (Value-added tax)","item_id": "294396","formula": "20%","note": null,"type": "shipping"}]}Was this page helpful?