--- title: "Quoted Landed Cost" method: POST path: "/v4/QuotedLandedCost" tags: ["Hurricane Services"] --- # Quoted Landed Cost `POST /v4/QuotedLandedCost` Calculate and provide a detailed breakdown of the landed costs associated with international shipments.
The landed cost includes not only the price of goods but also shipping charges, duties, taxes, and any additional costs for dutiable shipments.
This API is important to understand the total cost of shipping items internationally before proceeding with a transaction. ## Request body - QuotedLandedCostRequest — Quoted Landed Cost Request - `ShippingAccountId` string, nullable — A unique identifier for the shipping account, which can either be generated by the system or provided by you (alias) during shipping account creation.
This ID helps associate the request with a specific shipping account. - `Shipment` QuotedLandedCostShipment, required — A detailed object representing the shipment information required for calculating the landed cost. - `Reference` string, nullable — A reference string that is used to trace the response of the request.
This allows users to keep track of their requests and facilitates easier follow-up if needed. - `ConvertCurrency` boolean, nullable — A boolean indicating whether to convert costs to a different currency based on the user's requirements.

Note: If this field is set to true, then all the values provided will be assumed to be in the currency of the shipper's country; otherwise, they will be assumed to be in the currency of the destination country. - `Shipper` QuotedLandedCostShipper, required — An object that contains details about the shipper's location and currency, essential for accurate landing cost calculations. - `CountryCode` string, required — An abbreviation representing the shipper's country, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.
This is important for determining shipping regulations and applicable charges. - `Currency` string, nullable — An abbreviation representing the 3 letter ISO currency code in which the items value is expressed (for example, "GBP" for British pounds, "EUR" for euros).
This is essential for financial transactions and international trade.

Note: If the **ConvertCurrency** field is set to false, then this information is ignored. - `Postcode` string, nullable — The postal or ZIP code corresponding to the shipper's address, which plays a role in determining shipping rates and applicable taxes.

Note: This information is required for the United Kingdom. - `Destination` QuotedLandedCostDestination, required — An object containing details about the shipping destination, necessary for determining final delivery costs and applicable duties/taxes. - `CountryCode` string, required — An abbreviation representing the destination country, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.
This is important for determining shipping regulations and applicable charges - `Postcode` string, nullable — The postal or ZIP code corresponding to the destination address, which plays a role in determining shipping rates and applicable taxes.

Note: This information is required for the United Kingdom, USA, Canada, Brazil, and Spain. - `ShippingCharges` number, double, required — A total value reflecting all the shipping charges associated with the shipment, excluding duties and taxes. - `DeclaredWeight` number, double, nullable — The total weight declared for the items being shipped in the unit of measure specified in the WeightUnitOfMeasure field.
This information is used to assess shipping costs and compliance. - `WeightUnitOfMeasure` 'KG' | 'Grams' — The unit of measure used for all weight values in the shipment, expressed in grams and kilograms, for example, **DeclaredWeight**, **ItemWeight**. This is crucial for accurately describing shipment weight.

***Note:** By default, this field is set to KG.* - `Items` QuotedLandedCostItem[], required — A collection of items for which the user wants to receive calculated taxes and duties, facilitating detailed landed cost calculations.

Before sending the request, make sure of the following conditions:

Note: For better performance, it is recommended to send 10 items in a single request. - `SkuCode` string, nullable — A unique Stock Keeping Unit (SKU) code assigned to the item. This code is essential for tracking inventory, helping users identify specific items easily. - `HSCode` string, required — The Harmonized System (HS) code used by customs to determine potential duties and taxes for the product.
This code can be 6, 8, or 13 alphanumeric characters, depending on specific services or destinations.
Some countries may use HS codes with different character lengths, such as 10 or 12 characters.

Note: The HSCode or Description must be provided.
If both are supplied, and they do not match for the same product, then only the HSCode will take precedence.
Characters like space and dot are supported.

For more information on HS Codes see https://www.gov.uk/trade-tariff - `Description` string, required — A detailed description of the item being shipped, which helps verify that the HS code provided is appropriate for the nature of the item.

Note: The HSCode or Description must be provided.
If both are supplied, and they do not match for the same product, then only the **HSCode** will take precedence. - `CountryOfOrigin` string, nullable — An abbreviation representing the country where the item was produced/manufactured, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom, which influences the applicable duties and taxes during international trade. - `Value` number, double, required — The declared value of a single item in the currency used in the destination country, which is crucial for duty and tax calculations. - `Quantity` integer, nullable — The number of units for each item being shipped in the shipment, important for assessing total value and any bulk pricing considerations.

Note: By default, this field is set to 1. - `Weight` number, double, nullable — The weight of the specific item in the WeightUnitOfMeasure, aiding in calculating overall shipment weight and associated costs.

Note: By default, this field is set to KG. ## Response `200` Returns quoted landed cost response. - QuotedLandedCostResponse — Quoted Landed Cost Response - `ShippingAccountId` string, nullable — The unique identifier for the shipping account used in the request, returned for confirmation of the matched account.

Note: If an empty value was sent in the request, then this field will return as blank. - `Shipment` QuotedLandedCostShipmentResponse — The shipment object returned in the response, detailing the processed shipment information and related costs. - `Reference` string, nullable — A reference string that is used to trace the response of the request.
This allows users to keep track of their requests and facilitates easier follow-up if needed.

Note: If an empty value was sent in the request, then this field will return as blank. - `Shipper` QuotedLandedCostShipperResponse — Quoted Landed Cost Shipper Response - `CountryCode` string, nullable — An abbreviation representing the shipper's country, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.
This is important for determining shipping regulations and applicable charges. - `Currency` string, nullable — An abbreviation representing the 3 letter ISO currency code of the shipper country in which the items value is expressed (for example, "GBP" for British pounds, "EUR" for euros).
This is essential for financial transactions and international trade.

Note: This field is only populated if the ConvertCurrency field in the request was set to true.
Also, if the currency code was not set in the request, then Hurricane assumes the shipper currency code based on the default currency code for the shipper country. - `Postcode` string, nullable — The postal or ZIP code corresponding to the shipper's address, which plays a role in determining shipping rates and applicable taxes.

Note: This information is only populated if the postcode was provided in the request. - `ShippingCharges` number, double, nullable — The total shipping charges calculated for the shipment in the currency of the shipper's country, providing clear visibility into transportation costs.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `DeclaredValue` number, double, nullable — The total vale of the shipment in the currency of the shipper's country, which is crucial for duty and tax calculations.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `TotalDuty` number, double, nullable — The total amount of duties payable for the shipment in the currency of the shipper's country, which is part of the overall landed cost.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `TotalTax` number, double, nullable — The total amount of payable taxes calculated for the shipment in the currency of the shipper's country, providing transparency regarding final costs to be paid.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `TotalIncludingTaxes` number, double, nullable — The complete total cost for the shipment in the currency of the shipper's country that includes all shipping charges, duties, and taxes, allowing customers to understand the full financial commitment.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `Destination` QuotedLandedCostDestinationResponse — Quoted Landed Cost Destination Response - `CountryCode` string, nullable — An abbreviation representing the destination country, following the ISO 3166-1 alpha-2 standard, for example, "US" for the United States of America.
This is important for determining shipping regulations and applicable charges. - `Currency` string, nullable — An abbreviation representing the 3 letter ISO currency code in which the items value is expressed (for example, "GBP" for British pounds, "EUR" for euros).
This is essential for financial transactions and international trade. - `Postcode` string, nullable — The postal or ZIP code corresponding to the destination address, which plays a role in determining shipping rates and applicable taxes.

Note: This information is only populated if the postcode was provided in the request. - `ShippingCharges` number, double, nullable — The total shipping charges calculated for the shipment in the currency of the destination country, providing clear visibility into transportation costs.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `DeclaredValue` number, double, nullable — The total vale of the shipment in the currency of the destination country, which is crucial for duty and tax calculations.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `TotalDuty` number, double, nullable — The total amount of duties payable for the shipment in the currency of the destination country, which is part of the overall landed cost.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `TotalTax` number, double, nullable — The total amount of payable taxes calculated for the shipment in the currency of the destination country, providing transparency regarding final costs to be paid.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `TotalIncludingTaxes` number, double, nullable — The complete total cost for the shipment in the currency of the destination country that includes all shipping charges, duties, and taxes, allowing customers to understand the full financial commitment.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `Currency` QuotedLandedCostCurrency — An object containing details about the currency used in the shipment, necessary for financial clarity. - `ConvertCurrency` boolean, nullable — A boolean indicating whether currency conversion was applied to the quoted costs for both the shipper and destination countries.

Note: If set to true, all values will be returned in both shipper and destination country's currency.

By default, this value is set to false. - `CurrencyExchange` string, nullable — The currency of the shipper and destination country subjected to conversion. - `ExchangeRate` number, double, nullable — The rate used for currency conversion of the shipper and destination country currencies, providing clarity on how costs were calculated in relation to different currencies.

Note: The exchange rates used by Hurricane are sourced from XE. - `RateLastUpdated` string, nullable — The timestamp indicating when the exchange rate was last updated, crucial for ensuring transparency in calculations.

Note: The exchange rates are updated on a monthy basis by the customs authorities. - `Items` QuotedLandedCostItemResponse[], nullable — The collection of items returned in the response along with their respective cost, HS code and suitable description. - `HS6Code` string, nullable — The trimmed down 6-digit HS code used by Hurricane for classification, reflecting the higher-level categorisation of the item for validation. - `Description` string, nullable — The description of each item, reaffirming the information submitted in the request. - `10digitExportHsCode` string, nullable — The most likely 10-digit HS code that should be used for exporting the item from the source country, reflecting required customs codes. - `10digitImportHsCode` string, nullable — The most likely 10-digit HS code to be followed for importing the item into the destination country, which is essential for compliance with import regulations. - `CountryOfOrigin` string, nullable — An abbreviation representing the country where the item was produced/manufactured, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom, which influences the applicable duties and taxes during international trade. - `HurricaneDescription` string, nullable — The description provided by the Hurricane services for each item. This description may not match the product description; rather, it is the one matched to the returned HSCode. - `PercentageDutyRate` number, double, nullable — The percentage rate of duty applicable to each item in the destination country.

Note: If applicable, CountryOfOrigin will be used for accurate calculation of the landing costs. - `VolumetricDutyRate` number, double, nullable — The duty rate calculated based on the volumetric weight of each item in the destination country, which may affect overall costs.
If this rate is percentage or item-based, then the response value will be zero.

Note: If applicable, CountryOfOrigin will be used for accurate calculation of the landing costs. - `ItemDutyRate` number, double, nullable — The specific duty rate assigned to the item in the destination country, facilitating customs processing.
If this rate is weight/volume or percentage-based, then the response value will be zero.

Note: If applicable, CountryOfOrigin will be used for accurate calculation of the landing costs. - `AdditionalDutyRate` number, double, nullable — Any additional duty rates that might apply to specific items beyond the standard rates in the destination country.

Note: If applicable, CountryOfOrigin will be used for accurate calculation of the landing costs. - `TaxRate` number, double, nullable — The tax rate that applies to the items being shipped, which is crucial for calculating total costs. - `ShipperCurrencyValues` QuotedLandedCostShipperCurrencyValues — A collection of quoted currency values related to the shipper's transactions, aiding in financial assessment. - `ItemValue` number, double, nullable — The declared value of each item in the currency of the shipper's country, ensuring compliance and duty calculations. - `ItemDuty` number, double, nullable — The total duty payable for each item in the currency of the shipper's country , providing insight into costs related to compliance.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `ItemTax` number, double, nullable — The total tax assessed for each item in the currency of the shipper's country, ensuring clarity in overall financial obligations.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `ItemTotalIncludingTaxes` number, double, nullable — The total cost of each item including all applicable taxes and duties in the currency of the shipper's country, providing a complete financial picture for each product.

Note: This field is only populated if the ConvertCurrency field in the request was set to true. - `DestinationCurrencyValues` QuotedLandedCostDestinationCurrencyValues — A collection of quoted currency values related to the destination country, aiding in financial assessment. - `ItemValue` number, double, nullable — The declared value of each item in the currency of the destination country, ensuring compliance and duty calculations. - `ItemDuty` number, double, nullable — The total duty payable for each item in the currency of the destination country, providing insight into costs related to compliance.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `ItemTax` number, double, nullable — The total tax assessed for each item in the currency of the destination country, ensuring clarity in overall financial obligations.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `ItemTotalIncludingTaxes` number, double, nullable — The total cost of each item including all applicable taxes and duties in the currency of the destination country, providing a complete financial picture for each product.

***Note:** This field is only populated if the **ConvertCurrency** field in the request was set to true.* - `IsError` boolean — A boolean indicating whether an error occurred during item processing. It helps users quickly identify if there was an issue with the item.

Note: If the item is successfully processed by Hurricane, then this value is returned as false.
In case an error has been returned by Hurricane, then the information about the error will be provided in the ErrorDescription field. - `ErrorDescription` string, nullable — A description of the error associated with the item (if encountered), providing insights into what went wrong and how it can be addressed. - `IsError` boolean — A boolean indicating whether an error occurred during the request processing. It helps users quickly identify if there was an issue with their request.

Note: This field returns true only if the requested root elements generated an error, indicating that Hurricane cannot process the request. - `ErrorDescription` string, nullable — A description of the error during the request (if encountered), providing insights into what went wrong and how it can be addressed. - `Notes` string, nullable — Additional information returned by the system containing any notes or notifications, for example, further details on the error or notes about forthcoming changes on duty rates. - `GeneratedDate` string, nullable — A timestamp in Coordinated Universal Time (UTC) returned by Hurricane, indicating when the call was performed, aiding in tracking and logging activities. ## Other responses - `400` — Invalid request response. - `401` — Unauthorized - `403` — Forbidden - `500` — Internal Server Error --- [API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)