Zonos logo
DOCS

Calculating with discounts

/

Manage discounts with landed cost calculations 

Explore how discounts impact a landed cost calculation. 

If you offer discounts at checkout, there are a few different options to handle them.

  • Let the Zonos algorithm calculate the discount in the landed cost.
  • Use your own algorithm to calculate the discounts, then request a landed cost.
  • Obtain a landed cost request without applied discounts.

Your decision on how to manage discounts with a landed cost calculation will be based on the ability to modify the commercial invoice. See our document on how to apply discounts or free shipping to a commercial invoice to learn more.

Our Landed Cost product can automatically distribute discounts on your behalf. This lets you offer discounts to cross-border shoppers without over or undercharging duties and taxes.

Order level discounts

You can send an order-level discount, e.g. a promo code, using a landed cost request in the discounts array.

Request

1
2
3
4
5
6
7
8
9
{
    "discounts": [
        {
            "id": "SURRENDER",
            "amount": 10.00,
            "detail": null
        }
    ]
}

The discount amount will then be proportionately distributed between the items in the landed cost request up to the total discount value for the order. The item value change will be reflected in the note field in the response for each item. See the example in the promo code section of the discounts on commercial invoices document.

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
    "customs": {
        "amount_shipping": 20.00,
        "delivery_duty_paid": "unavailable",
        "items": [
            {
                "id": "294395",
                "amount": 15.00,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men's t-shirt 100% cotton",
                "description_retail": "Mars Attacks Men's Tee Black",
                "detail": null,
                "dimensions": {
                    "height": 1.0,
                    "length": 1.0,
                    "unit": "inches",
                    "width": 1.0
                },
                "hs_code": "6217.10",
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 25% from 20.00 USD to 15.00 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1,
                "weight_unit": "pound"
            },
            {
                "id": "294396",
                "amount": 11.25,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men’s 100% cotton costume for dress up",
                "description_retail": "Mars Attacks Martian Soldier Costume",
                "detail": null,
                "dimensions": {
                    "height": 1.0,
                    "length": 1.0,
                    "unit": "inches",
                    "width": 1.0
                },
                "hs_code": null,
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 25% from 15.00 USD to 11.25 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1,
                "weight_unit": "pound"
            },
            {
                "id": "294397",
                "amount": 3.75,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "100% cotton headband",
                "description_retail": "Mars Attacks Headband",
                "detail": null,
                "dimensions": {
                    "height": 1.0,
                    "length": 1.0,
                    "unit": "inches",
                    "width": 1.0
                },
                "hs_code": "6505.00.10",
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 25% from 5.00 USD to 3.75 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1,
                "weight_unit": "pound"
            }
        ],
        "ship_to_country": "FR"
    }
}

Free items

To send a free item, we recommend sending an amount_discount that equals the item amount. This will net the total amount to 0.00.

In cases when the items.amount is 0 and the amount_discount is not used, an account default of 5.00 will be used as an estimated value for the free item. The remaining 5.00 will be distributed between the remaining items. This default value can be changed inside Zonos Dashboard.

Request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
    "items": [
        {
            "id": "294395",
            "amount": 20.00,
            "amount_discount": null,
            "country_of_origin": "FR",
            "description_retail": "Mars Attacks Men's Tee Black",
            "hs_code": "6217.10",
            "quantity": 1,
            "weight": 1.0,
            "weight_unit": "pound"
        },
        {
            "id": "294395",
            "amount": 4.50,
            "amount_discount": 4.50,
            "country_of_origin": "FR",
            "description_retail": "Mars Attacks Men's Tee Black",
            "hs_code": "6217.10",
            "quantity": 1,
            "weight": 1.0,
            "weight_unit": "pound"
        }
    ]
}

When the landed cost request includes a free item (the discount of the item equals the total cost of the item), the discount will be applied the same way as order-level discounts: each item in the order will appear proportionately discounted up to the amount of that single item, rather than that particular item showing a 100% discount.

Below is an example response to the request shown above.

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
    "customs": {
        "amount_shipping": 12.50,
        "delivery_duty_paid": "unknown",
        "items": [
            {
                "id": "294395",
                "amount": 16.33,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men's t-shirt 100% cotton",
                "description_retail": "Mars Attacks Men's Tee Black",
                "detail": null,
                "dimensions": {
                    "height": 4.0,
                    "length": 6.0,
                    "unit": "inches",
                    "width": 11.0
                },
                "hs_code": "6217.10",
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 18.37% from 20.00 USD to 16.33 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1.0,
                "weight_unit": "pound"
            },
            {
                "id": "294396",
                "amount": 3.67,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men’s 100% cotton costume for dress up",
                "description_retail": "Mars Attacks Martian Soldier Costume",
                "detail": null,
                "dimensions": {
                    "height": 4.0,
                    "length": 6.0,
                    "unit": "inches",
                    "width": 11.0
                },
                "hs_code": null,
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 18.37% from 4.50 USD to 3.67 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1.0,
                "weight_unit": "pound"
            }
        ],
        "import_country": "FR"
    }
}

Free shipping

To request a landed cost with free shipping, we recommend adding the shipping as we did with the discount. Input the normal shipping amount, and then input the amount_discount as the same value as the shipping.

Request

1
2
3
4
5
6
7
{
    "shipping": {
        "amount": 7.00,
        "amount_discount": 7.00,
        "service_level": "ups_express_saver"
    }
}

The customs array will contain the adjusted amounts on the items in the same way that order-level discounts are applied. The note field will indicate what was changed.

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
    "customs": {
        "amount_shipping": 7.00,
        "delivery_duty_paid": "unknown",
        "items": [
            {
                "id": "294395",
                "amount": 16.00,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men's t-shirt 100% cotton",
                "description_retail": "Mars Attacks Men's Tee Black",
                "detail": null,
                "dimensions": {
                    "height": 4.0,
                    "length": 6.0,
                    "unit": "inches",
                    "width": 11.0
                },
                "hs_code": "6217.10",
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 20.00% from 20.00 USD to 16.00 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1.0,
                "weight_unit": "pound"
            },
            {
                "id": "294396",
                "amount": 12.00,
                "country_of_origin": "CN",
                "country_of_origin_source": "platform",
                "description_customs": "Men’s 100% cotton costume for dress up",
                "description_retail": "Mars Attacks Martian Soldier Costume",
                "detail": null,
                "dimensions": {
                    "height": 4.0,
                    "length": 6.0,
                    "unit": "inches",
                    "width": 11.0
                },
                "hs_code": null,
                "hs_code_source": "Account default HS code",
                "image_url": "https://zonos.com/images/handbag.png",
                "note": "Item was discounted by 20.00% from 15.00 USD to 12.00 USD",
                "quantity": 1,
                "upc_code": null,
                "weight": 1.0,
                "weight_unit": "pound"
            }
        ],
        "import_country": "FR"
    }
}

Manage applying discounts on your own

You can use your own formulas and rules to apply discounts across the items in a landed cost request. This allows you to remain in full control of how the landed cost is calculated.

For valid business reasons, a retailer may decide to exclude discounts in a landed cost calculation. For instance, if your commercial invoice amount is unreconcilable with the cart amount and applied discount, then it may be more practical to exclude the discount in the landed cost calculation. If you choose to exclude the discount, the landed cost amount will be higher, but it will match what is shown on the commercial invoice.

Next steps

  • Discounts on commercial invoices - Learn how to fill out a commercial invoice when offering a promo code, discount, or free shipping.
  • Accuracy - Read about Zonos' commitment to landed cost accuracy.
  • Landed CostAPI - Get an idea of how the Landed Cost API works.

Related Decoder Guides

FAQ

I am using the Duty and Tax app for Shopify. Will promo codes and discounts work with Zonos?

Promo codes will work as usual, but any discount or promo code that reduces shipping costs may also reduce the duties and taxes included in the shipping amount. Contact your Zonos support rep for more details.