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.
Country | ISO Code | Non-alcoholic beverages (HS codes 2201-2202) | Vinegars (HS codes 2209) | Beer, Wine, Vermouth, Fermented beverages, Spirits and Liquors (HS codes 2203-2208) |
---|---|---|---|---|
![]() | AT | Volume | Volume | Volume, ABV |
![]() | BE | Volume | Volume | Volume, ABV |
![]() | BG | Volume | Volume | Volume, ABV |
![]() | BQ | Volume | Volume | Volume, ABV |
![]() | CA | Volume | Volume | Volume, ABV |
![]() | CY | Volume | Volume | Volume, ABV |
![]() | CZ | Volume | Volume | Volume, ABV |
![]() | DE | Volume | Volume | Volume, ABV |
![]() | EE | Volume, Weight | Volume | Volume, ABV |
![]() | ES | Volume | Volume | Volume, ABV |
![]() | FI | Volume | Volume | Volume, ABV |
![]() | FR | Volume | Volume | Volume, ABV |
![]() | GF | Volume | Volume | Volume, ABV |
![]() | GP | Volume | Volume | Volume, ABV |
![]() | GR | Volume | Volume | Volume, ABV |
![]() | HR | Volume | Volume | Volume, ABV |
![]() | HU | Volume | Volume | Volume, ABV |
![]() | IE | Volume, Weight | Volume | Volume, ABV |
![]() | IT | Volume | Volume | Volume, ABV |
![]() | LT | Volume | Volume | Volume, ABV |
![]() | LU | Volume | Volume | Volume, ABV |
![]() | LV | Volume, Weight | Volume | Volume, ABV |
![]() | MT | Volume | Volume | Volume, ABV |
![]() | NL | Volume | Volume | Volume, ABV |
![]() | PL | Volume | Volume | Volume, ABV |
![]() | PT | Volume | Volume | Volume, ABV |
![]() | RE | Volume | Volume | Volume, ABV |
![]() | RO | Volume, Weight | Volume | Volume, ABV |
![]() | SE | Volume | Volume | Volume, ABV |
![]() | SI | Volume | Volume | Volume, ABV |
![]() | SK | Volume | Volume | Volume, ABV |
![]() | YT | Volume | Volume | Volume, 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 enum | Value type | CSV header | Description |
---|---|---|---|
unitOfMeasure | itemUnitOfMeasure! | Volumetric unit | Unit for volume measurement |
volume | value | Volume | Volume amount |
alcohol_by_volume | PERCENTAGE | Alcohol by volume | ABV 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
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
{
"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
}
]
}
}
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.