Measurement types and general requirements
| Measurement type | Description | Common usage |
|---|---|---|
| Volume | Physical volume of the product | Required for all beverages |
| ABV | Alcohol by volume percentage | Required for alcoholic beverages |
| Weight | Physical weight of the product | Required in specific countries for certain products |
Measurement requirements by country
| 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) |
|---|---|---|---|---|
 Austria | AT | Volume | Volume | Volume, ABV |
 Belgium | BE | Volume | Volume | Volume, ABV |
 Bulgaria | BG | Volume | Volume | Volume, ABV |
 Bonaire | BQ | Volume | Volume | Volume, ABV |
 Canada | CA | Volume | Volume | Volume, ABV |
 Cyprus | CY | Volume | Volume | Volume, ABV |
 Czech Republic | CZ | Volume | Volume | Volume, ABV |
 Germany | DE | Volume | Volume | Volume, ABV |
 Estonia | EE | Volume, Weight | Volume | Volume, ABV |
 Spain | ES | Volume | Volume | Volume, ABV |
 Finland | FI | Volume | Volume | Volume, ABV |
 France | FR | Volume | Volume | Volume, ABV |
 French Guiana | GF | Volume | Volume | Volume, ABV |
 Guadeloupe | GP | Volume | Volume | Volume, ABV |
 Greece | GR | Volume | Volume | Volume, ABV |
 Croatia | HR | Volume | Volume | Volume, ABV |
 Hungary | HU | Volume | Volume | Volume, ABV |
 Ireland | IE | Volume, Weight | Volume | Volume, ABV |
 Italy | IT | Volume | Volume | Volume, ABV |
 Lithuania | LT | Volume | Volume | Volume, ABV |
 Luxembourg | LU | Volume | Volume | Volume, ABV |
 Latvia | LV | Volume, Weight | Volume | Volume, ABV |
 Malta | MT | Volume | Volume | Volume, ABV |
 Netherlands | NL | Volume | Volume | Volume, ABV |
 Poland | PL | Volume | Volume | Volume, ABV |
 Portugal | PT | Volume | Volume | Volume, ABV |
 Réunion | RE | Volume | Volume | Volume, ABV |
 Romania | RO | Volume, Weight | Volume | Volume, ABV |
 Sweden | SE | Volume | Volume | Volume, ABV |
 Slovenia | SI | Volume | Volume | Volume, ABV |
 Slovakia | SK | Volume | Volume | Volume, ABV |
 Mayotte | YT | Volume | Volume | Volume, ABV |
Requesting a landed cost with required measurements
If you are shipping alcohol or other products in chapter 22 that are subject to excise duties, you must included specific inputs for proper calculations. For example, when shipping wine to Poland, you must pass VOLUME and ALCOHOL_BY_VOLUME in the 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
}
]
}
}
Calculate excise duties
Learn more about excise duty calculations and requirements.
Zonos now supports the calculation of excise duties for alcohol to Canada and most EU countries. These calculations are currently only available to customers who are integrated with Zonos via API.
When using our Landed Cost guarantee, and quoting for products in Chapter 22 (beverages, spirits, and vinegar), there will be specific units of measure required for each country.