Landed cost
Understand landed cost and learn how to use Digital River's landed cost feature
During checkouts, Digital River's landed cost feature allows you to present customers with a transaction's landed cost.
Once you set up the landed cost feature, it's triggered when the necessary preconditions are met. After the feature is activated, Digital River's landed cost service generates a calculation and we return that landed cost calculation in checkouts so you can display it to customers.
Landed cost represents the total amount your customer must pay to purchase a product from one country and have it shipped to another country. Landed cost consists of:
- The value of goods in a customer's cart
- Shipping costs
- Import duties
- Taxes
- Insurance, package handling, and signature requirement surcharges
- Regulatory fees
- Country and commodity specific clearance costs
In this option, customers do not pay the full landed cost during the checkout process. Instead, they pay product and shipping costs during checkouts, and then, upon an order's delivery, they're responsible for paying duties, fees, and import taxes.
You can use Digital River's standard landed cost feature to provide your customers with a landed cost estimate. However, if the estimate returned by our landed cost service is less than the actual importation costs assessed by a country's custom agency, then you're ultimately responsible for the difference.
With this feature, once an order is submitted, your fulfillment logistics provider typically relays an order's details to a shipper, who completes the customs paperwork, ships the package to the destination country, and pays the duties, fees and import taxes on behalf of your customer. The shipper then invoices you for these costs.
Digital River's guaranteed landed cost feature provides a guarantee to both you and the customer. You must be using the Global Logistics solution to take advantage of this feature.
How you handle the pre-deployment process depends on whether you're:
The standard landed cost feature is available to anyone who integrates with the Digital River APIs. It's not dependent on the version you're using, how you send product data in checkouts, or who acts as your fulfillment coordinator.
Prior to using this feature, you need to complete the following steps:
Step one: Verify your fulfiller ships products outside of their country (not all fulfillers provide this service).
Step two: Determine whether your shipper is willing and able to prepay landed cost on behalf of the customer and invoice you for these costs.
Step three: Define your cross-border patterns (in other words, where your products ship from and where they ship to).
The ship-to countries must be supported by Digital River and cannot include embargoed nations. For more information, refer to our Country Guide.
Step four: Provide your account manager with a list of ship from and ship to countries for which you want to enable landed cost collection.
Step five: Provide samples of completed customs forms, such as commercial invoices, to Digital River's compliance team for approval.
Step six: Sign an addendum in your Digital River contract to enable the landed cost feature (unless already specified in the order form).
Step seven: Associate a Harmonized System (HS) code with each of your physical products. To do this, you can (1) set
hsCode
on the SKU (2) associate a SKU group with the SKU or (3) reference a SKU group in productDetails
.For more information, refer to:
In this step, we recommend that you select either option two or three. These options allow you to:
- Simplify the process of assigning and managing your products' HS codes.
- Use country-specific HS tariff codes that are tailored to each transaction, thereby improving the accuracy of the landed cost calculation.
To get a guaranteed landed cost, you must be using Digital River's Global Logistics solution. For more information on how to access and set up this solution, refer to the pre-deployment section on the Global Logistics page.
Once you perform the pre-deployment configurations, landed cost is calculated during the checkout process. To successfully receive a landed cost calculation at run-time, the following preconditions must exist:
- The checkout's
shipFrom.address.country
andshipTo.address.country
are specified and the values are different. Since shipments between EU countries are exempt from duties, a checkout's ship from country and ship to country can't both be EU nations.
To calculate landed cost in applicable checkouts, Digital River sends an API request to a third-party service. Based on the data provided in the request, this service calculates taxes, duties, fees, and import taxes.
We use the values returned by this service to build a checkout's
totalAmount
. When you convert a checkout to an order, this is what the customer is ultimately chargedIf a customer attempts to ship a product to an embargoed country, then the checkout fails:
409 Conflict
{
"type": "conflict",
"errors": [
{
"code": "country_unsupported",
"parameter": "country",
"message": "Country 'KP' is not supported."
}
]
}
Additionally, on rare occasions, the third-party landed cost service may be unavailable or unable to generate a calculation. In these cases, no landed cost values are returned in the checkout.
In versions
2020-09-30
and earlier, landed cost is represented by totalDuty
and importerOfRecordTax
.In checkouts that trigger the landed cost feature, we provide you an itemized breakdown of taxes, duties, fees, and import taxes. Since your customers ultimately pay these costs, you should display them during the checkout process.
The full landed cost is contained in numerous attributes at both the checkout level and the line item level. You can use this data to determine import duties and distinguish between taxes Digital River remits and those remitted by the shipper.
A checkout's
totalAmount
is ultimately what the customer is charged when you convert a checkout to an order.The
totalAmount
however may not represent the full landed cost of a transaction. That depends on how you configure a checkout's shippingChoice.shippingTerms
.If a checkout triggers the landed cost feature, then
importerOfRecordTax
returns true
. In these cases, totalImporterTax
indicates the tax amount that the importer of record remits to the government and totalDuty
are duties levied on the products by the importing country.Sometimes products in a cross-border transaction don't incur any duties. As a result, in checkouts that trigger the landed cost feature,
totalDuty
is not always greater than zero.A checkout's
totalTax
represents taxes that Digital River remits to the government. Its value does not include totalImporterTax
. Those taxes are remitted to the government by your shipper.In checkouts that trigger the landed cost feature, each element in
items[]
contains three landed cost-related attributes:The
importerTax.amount
indicates the amount of taxes that the importer of record pays on all the products in this line item.The
duties.amount
indicates the amount of duty levied by an importing country on all the products in this line item.A
tariffCode
represents a product's country-specific Harmonized System code. This value is only returned if you're using SKU groups.Landed cost calculations are based on this
tariffCode
. As a result, it's often useful for troubleshooting purposes. For example, if cross-border duties presented to the customer during checkouts are later determined to be inaccurate, you can verify whether the correct code was applied to the product.Last modified 10mo ago