DOCS

Excise duties

Calculate excise duties

Configure product measurements to accurately calculate excise duties.

BETA

When shipping alcoholic products internationally, you need to calculate excise duties, which are special taxes for products like alcohol and other regulated goods. Zonos automatically calculates these duties for shipments to Canada and most EU countries when you provide the required product measurements through our API or add them to your Zonos Catalog.

Overview 

Excise duties apply to products classified under Chapter 22 of the Harmonized System, covering HS code subheadings 2201–2202 for non-alcoholic beverages, HS codes 2203–2208 for alcoholic beverages, spirits, and fermented products, and HS code 2209 for vinegars.

Important: If you're using Zonos Landed Cost guarantee and request a quote for Chapter 22 products without the required measurement values, no quote will be returned. You must provide the necessary measurements either via API or by uploading them to Zonos Catalog.

Measurement requirements by country

Different countries require different measurements for calculating excise duties, depending on the product type. The table below shows which measurements are needed for each country and HS code category. Volume refers to the liquid volume of the product, while ABV (Alcohol by Volume) represents the percentage of alcohol content.

CountryISO CodeNon-alcoholic beverages (HS codes 2201-2202)Vinegars (HS codes 2209)Beer, Wine, Vermouth, Fermented beverages, Spirits and Liquors (HS codes 2203-2208)
🇦🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. AustriaATVolumeVolumeVolume, ABV
🇧🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. BelgiumBEVolumeVolumeVolume, ABV
🇧🇬 Attribution for Twitter Emojis: ©️ Twitter, Inc. BulgariaBGVolumeVolumeVolume, ABV
🇧🇶 Attribution for Twitter Emojis: ©️ Twitter, Inc. BonaireBQVolumeVolumeVolume, ABV
🇨🇦 Attribution for Twitter Emojis: ©️ Twitter, Inc. CanadaCAVolumeVolumeVolume, ABV
🇨🇾 Attribution for Twitter Emojis: ©️ Twitter, Inc. CyprusCYVolumeVolumeVolume, ABV
🇨🇿 Attribution for Twitter Emojis: ©️ Twitter, Inc. Czech RepublicCZVolumeVolumeVolume, ABV
🇩🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. GermanyDEVolumeVolumeVolume, ABV
🇪🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. EstoniaEEVolume, WeightVolumeVolume, ABV
🇪🇸 Attribution for Twitter Emojis: ©️ Twitter, Inc. SpainESVolumeVolumeVolume, ABV
🇫🇮 Attribution for Twitter Emojis: ©️ Twitter, Inc. FinlandFIVolumeVolumeVolume, ABV
🇫🇷 Attribution for Twitter Emojis: ©️ Twitter, Inc. FranceFRVolumeVolumeVolume, ABV
🇬🇫 Attribution for Twitter Emojis: ©️ Twitter, Inc. French GuianaGFVolumeVolumeVolume, ABV
🇬🇵 Attribution for Twitter Emojis: ©️ Twitter, Inc. GuadeloupeGPVolumeVolumeVolume, ABV
🇬🇷 Attribution for Twitter Emojis: ©️ Twitter, Inc. GreeceGRVolumeVolumeVolume, ABV
🇭🇷 Attribution for Twitter Emojis: ©️ Twitter, Inc. CroatiaHRVolumeVolumeVolume, ABV
🇭🇺 Attribution for Twitter Emojis: ©️ Twitter, Inc. HungaryHUVolumeVolumeVolume, ABV
🇮🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. IrelandIEVolume, WeightVolumeVolume, ABV
🇮🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. ItalyITVolumeVolumeVolume, ABV
🇱🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. LithuaniaLTVolumeVolumeVolume, ABV
🇱🇺 Attribution for Twitter Emojis: ©️ Twitter, Inc. LuxembourgLUVolumeVolumeVolume, ABV
🇱🇻 Attribution for Twitter Emojis: ©️ Twitter, Inc. LatviaLVVolume, WeightVolumeVolume, ABV
🇲🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. MaltaMTVolumeVolumeVolume, ABV
🇳🇱 Attribution for Twitter Emojis: ©️ Twitter, Inc. NetherlandsNLVolumeVolumeVolume, ABV
🇵🇱 Attribution for Twitter Emojis: ©️ Twitter, Inc. PolandPLVolumeVolumeVolume, ABV
🇵🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. PortugalPTVolumeVolumeVolume, ABV
🇷🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. RéunionREVolumeVolumeVolume, ABV
🇷🇴 Attribution for Twitter Emojis: ©️ Twitter, Inc. RomaniaROVolume, WeightVolumeVolume, ABV
🇸🇪 Attribution for Twitter Emojis: ©️ Twitter, Inc. SwedenSEVolumeVolumeVolume, ABV
🇸🇮 Attribution for Twitter Emojis: ©️ Twitter, Inc. SloveniaSIVolumeVolumeVolume, ABV
🇸🇰 Attribution for Twitter Emojis: ©️ Twitter, Inc. SlovakiaSKVolumeVolumeVolume, ABV
🇾🇹 Attribution for Twitter Emojis: ©️ Twitter, Inc. MayotteYTVolumeVolumeVolume, ABV

Provide required measurements 

When shipping alcohol or other Chapter 22 products subject to excise duties, you must include specific measurement inputs to ensure accurate calculations. The required measurements vary by destination country—for example, when shipping wine to Poland, you need to provide both VOLUME and ALCOHOL_BY_VOLUME.

This table shows how measurement fields correspond between API requests and CSV uploads:

API enumValue typeCSV headerDescription
unitOfMeasureitemUnitOfMeasure!Volumetric unitUnit for volume measurement
volumevalueVolumeVolume amount
alcohol_by_volumePERCENTAGEAlcohol by volumeABV percentage

View our API reference here for a complete list of API measurement values.

Add measurements via API or Catalog

You can add product measurements at the time of your landed cost request, or add measurements to your Zonos Catalog items so they automatically apply based on the product ID or SKU. Follow the mutation and steps below:

Include measurements directly via API using the measurements array in itemCreateWorkflow.

Mutation

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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
mutation {
  partyCreateWorkflow(
    input: [
      { location: { countryCode: US }, type: ORIGIN }
      {
        location: {
          countryCode: PL
          line1: "ul. Leonarda 87"
          locality: "Lublin"
          postalCode: "20-625"
        }
        person: {
          email: "test@gmail.com"
          firstName: "firstName"
          lastName: "lastName"
          phone: "5022303021"
          companyName: "goProTest"
          metadata: { key: "key", value: "value" }
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }

  itemCreateWorkflow(
    input: [
      {
        amount: 500
        currencyCode: USD
        countryOfOrigin: US
        quantity: 1
        description: "Red Wine Sparkling"
        sku: "15120"
        measurements: [
          { type: ALCOHOL_BY_VOLUME, value: 12, unitOfMeasure: PERCENTAGE }
          { type: VOLUME, value: 750, unitOfMeasure: MILLILITER }
        ]
      }
    ]
  ) {
    id
    name
    productId
    sku
    amount
    hsCode
    description
  }
  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCreateWorkflow(
    input: {
      amount: 15
      currencyCode: EUR
      serviceLevelCode: "ups.worldwide_expedited"
    }
  ) {
    id
    serviceLevelCode
    amount
  }
  landedCostCalculateWorkflow(
    input: {
      endUse: NOT_FOR_RESALE
      tariffRate: ZONOS_PREFERRED
      calculationMethod: DDP_PREFERRED
    }
  ) {
    id
    landedCostGuaranteeCode

    amountSubtotals {
      taxes
      items
      shipping
      fees
      duties
      landedCostTotal
    }
    shipmentRating {
      displayName
    }
    method
    duties {
      item {
        hsCode
        id
        sku
        amount
      }
      amount
      currency
      note
      description
      formula
    }
    taxes {
      item {
        id
        sku
        amount
        hsCode
      }
      amount
      currency
      description
      formula
      type
      note
    }
    fees {
      item {
        id
        sku
        amount
      }
      amount
      currency
      description
    }
  }
}

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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_0jey073qc25cx",
        "organization": "organization_af945052-68e5-4329-b9cc-b4496f8e98c0"
      },
      {
        "type": "DESTINATION",
        "id": "party_0jey073r825fz",
        "organization": "organization_af945052-68e5-4329-b9cc-b4496f8e98c0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_0jgw0sg3c417f",
        "sku": "",
        "amount": 500,
        "hsCode": "2204.10.9600",
        "description": "Red Wine Sparkling"
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_0jgw0sgy3sx60",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_0jgw0sg3c417f"
            }
          }
        ]
      }
    ],
    "shipmentRatingCreateWorkflow": {
      "id": "shipment_rating_0jgw0sgz45s5z",
      "serviceLevelCode": "ups.worldwide_expedited",
      "amount": 15
    },
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_fff1847f-d185-4f85-9956-139f4db4d2b1",
        "landedCostGuaranteeCode": "ZONOS",
        "amountSubtotals": {
          "taxes": 123.07,
          "items": 500.0,
          "shipping": 15.44,
          "fees": 53.41,
          "duties": 3.22,
          "landedCostTotal": 179.7
        },
        "shipmentRating": {
          "displayName": "UPS Worldwide Expedited"
        },
        "method": "DDP",
        "duties": [
          {
            "item": {
              "hsCode": "2204.10.9600",
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500
            },
            "amount": 0.247,
            "currency": "USD",
            "note": "General Rate",
            "description": "duty",
            "formula": "32 eur  * volume_in_hl"
          },
          {
            "item": {
              "hsCode": "2204.10.9600",
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500
            },
            "amount": 2.9722,
            "currency": "USD",
            "note": "General Rate",
            "description": "excise_duty",
            "formula": "385 eur  * volume_in_hl"
          }
        ],
        "taxes": [
          {
            "item": {
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500,
              "hsCode": "2204.10.9600"
            },
            "amount": 115.0,
            "currency": "USD",
            "description": "VAT (Value-added tax)",
            "formula": "23%",
            "type": "ITEM",
            "note": null
          },
          {
            "item": {
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500,
              "hsCode": "2204.10.9600"
            },
            "amount": 3.5512,
            "currency": "USD",
            "description": "VAT (Value-added tax)",
            "formula": "23%",
            "type": "SHIPPING",
            "note": null
          },
          {
            "item": {
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500,
              "hsCode": "2204.10.9600"
            },
            "amount": 0.0568,
            "currency": "USD",
            "description": "VAT (Value-added tax)",
            "formula": "23%",
            "type": "DUTY",
            "note": "VAT (Value-added tax) on the duty of the item"
          },
          {
            "item": {
              "id": "item_0jgw0sg3c417f",
              "sku": "",
              "amount": 500,
              "hsCode": "2204.10.9600"
            },
            "amount": 0.6836,
            "currency": "USD",
            "description": "VAT (Value-added tax)",
            "formula": "23%",
            "type": "DUTY",
            "note": "VAT (Value-added tax) on the duty of the item"
          },
          {
            "item": null,
            "amount": 3.78,
            "currency": "USD",
            "description": "VAT (Value-added tax)",
            "formula": "23%",
            "type": "ADVANCEMENT",
            "note": null
          }
        ],
        "fees": [
          {
            "item": null,
            "amount": 16.43,
            "currency": "USD",
            "description": "UPS Poland Disbursement Fee"
          },
          {
            "item": null,
            "amount": 5.71,
            "currency": "USD",
            "description": "FX forward premium"
          },
          {
            "item": null,
            "amount": 16.27,
            "currency": "USD",
            "description": "Landed Cost Guarantee"
          },
          {
            "item": null,
            "amount": 15.0,
            "currency": "USD",
            "description": "UPS United States Duty and Tax Forwarding Charge"
          }
        ],
        "remittance": [],
        "taxId": null
      }
    ]
  }
}

Was this page helpful?