Landed costs

Understand how landed costs work and how to apply them to orders.

The following page explains landed costs, the Digital River landed cost feature, how to apply them to orders, and what attributes represent them in the API.

What are landed costs?

Landed costs, sometimes called fully landed costs, represent the entire cost a customer must pay to purchase a physical product from one country and have it shipped to an address in another country. It includes shipping, taxes, and duties.

Not all of these costs are present in every order. The landed cost calculation only supports products in a tax-exclusive price list.

When are landed costs applicable?

Landed costs occur whenever you ship an order containing physical products from one country to another. The exception is the European Union, where shipments between countries are exempt from duties.

What is Digital River’s landed cost feature?

Digital River provides an estimated landed cost for you to display to the customer and adds the cost to the order total. Digital River remits those landed costs to you.

What happens next?

Your fulfiller relays the order to your carrier, who completes the customs paperwork, ships the package to the destination country, pays the duties and taxes on behalf of your customer, and invoices you for performing the service.

How to take advantage of the landed cost feature?

To take advantage of the landed cost feature, you'll need to complete the following steps:

Once you configure and set up a product for landed costs, we calculate, collect, and apply landed costs to orders that contain physical goods and are shipped cross border to approved countries.

Step 1: Provide information to Digital River

  1. Verify your fulfiller ships packages outside their country (not all fulfillers provide this service).

  2. Verify your carrier offers this service. In other words, does the carrier prepay the landed costs on behalf of the customer and send the invoice to you.

  3. Provide your Account Manager with a list of the ship from and ship to countries for which you want to enable the collection of landed costs.

  4. Sign an addendum in your Digital River contract to enable landed costs.

  5. Define the cross-border patterns (that is, the ship-to or ship-from countries) where you want to collect landed costs.

  6. Provide samples of completed customs forms to Digital River's Compliance department for approval.

  7. Ask your Account Manager to enable landed costs. Before you use the Landed Costs resource, Digital River must enable landed costs. If the landed cost is not enabled, the Landed Cost Shipment Method won't appear in Global Commerce.

Step 2: Enable landed costs in Global Commerce

To enable landed costs from Global Commerce:

You need the Account Manager role in Global Commerce to perform this task.

  1. Sign in to Global Commerce.

  2. If your company has more than one site, select the site from the Sites field. If your company has only one site, Global Commerce automatically populates the Site field.

  3. Select Administration, select Site, and click Configure Site Settings.

  4. Click the Fulfillment tab and scroll down to Landed Cost Shipment Methods.

  5. Select Enabled and then click Save.

Step 3: Set the price list to tax exclusive

To use the landed costs feature, you must set the price list to tax exclusive. When you set the price list to tax-exclusive, the shippingAndHandling value is also tax exclusive.

You need the Pricing Manager role to perform this task.

  1. From Global Commerce, select Catalog, select Pricing & Plans, and click Manage Price Lists. The Price Lists page appears.

  2. Complete the search fields under the Search and Filters tab and then click Search Search to locate the specific price lists. The results appear in the Price Lists list.

  3. Click the link for the price list under the Name column. The Price List Details page appears.

  4. Scroll down to Currencies and click Edit. The Edit Price List Currency page appears.

  5. Select the currency you want to modify from the Currency dropdown list.

  6. Select No from the Prices Include value Added Tax (VAT) dropdown list. When you select No, the price does not include VAT (tax exclusive).

  7. Click Save.

Step 4: Create a product for landed costs

When creating a product for landed costs in Global Commerce, from the Product Settings step, you must:

  1. Select the appropriate product classification from the list.

  2. Complete the physical settings under Physical.

  3. Select the Enable Landed Cost check box.

  4. Complete the fields under Product Fulfillers.

How are landed costs represented in the API?

The following tables list the landed costs parameters. Note that you are responsible for remitting the duty and the importer of record tax on behalf of the customer.

Cart or Order level





The state of landed cost.



The sum of import taxes and duties for all line items.


The sum of import taxes and duties in locale currency format (for example, USD 19.14).



When the price list is tax inclusive, the shipping and handling fee is tax exclusive and applied against the product and the shipping cost.

Line-item level






VAT or other sales tax accessed on the transaction.


The VAT or other sales tax accessed on the transaction in locale currency format (for example, USD 7.56)



When a customer purchases products online, one or more of the products may not originate in the country the customer resides in, and therefore are subject to a customs duty when importing transported across international borders.

When goods are not shipped domestically (within the customer’s country) or within a single customs union, such as the European Union, the customer is liable to pay any inbound duties which the customer’s local customs authority deems appropriate.


The sum of duties in a locale currency format (for example, USD 5.29).

Landed cost state

A Cart or an Order has a landedCostState attribute, which provides information about the status of landed cost.

The customer must prepay the landed costs.

Digital River automatically calculates the landed cost and includes it in the Cart or Order when the landed cost is PREPAID.

Landed cost state enumerations for the Cart API

The landedCostState of the Cart is enumerated by the following values:

  • NOT_ELIGIBLE–The current cart is not eligible for landed cost calculation.

  • PREPAID–The current cart is eligible for landed cost calculation, and the landed cost will be prepaid.

  • VIEWED_NOT_ELIGIBLE–The landed cost state was ELIGIBLE or PREPAID, then became not eligible due to a change in the order that triggered the status to change to VIEWED_NOT_ELIGIBLE. For example, the customer changed their shipping address, added a line item, or removed a line item.

  • ERROR–Failed to calculate landed cost. This occurs when the integration service is unavailable.

Landed cost state enumerations for the Order API

The landedCostState of the Order is enumerated by the following values:

  • NOT_ELIGIBLE–The landed cost for the requisition is not prepaid.

  • PREPAID–The landed cost for the requisition was prepaid.

  • VIEWED_NOT_ELIGIBLE–The landed cost for the requisition is not prepaid.

  • ERROR–The landed cost for the requisition is not prepaid.