1. ShippyPro Help Center
  2. International Shipments

What are CN22 and CN23?

When do I use a CN22 and a CN23? Let's find out what they are and how to use them.

International shippings needs some measures to take care of, here we will talk about  CN22 and CN23. For some useful tips regarding these two documents, read along. ✨



  1. What are CN22 and CN23?

  2. How to get them?

  3. What is the HS Code?

  4. FAQs

1. What are CN22 and CN23?

CN22 and CN23 are mandatory custom documents that must be attached to parcels intended to be shipped to Extra UE countries. They contain information about the goods you are shipping such as their value, who the shipper and receiver are and which parties are involved in the shipping.

What's the difference between the two?

CN22 is for packages up to 2 kg with a value of up to €425

CN23 is for packages weighing from 2 to 20 kg with a value of €425 or more

Do I need to print these documents?

Yes, you need to print the CN22 and CN23 in order to attach them to the outside of the parcel to ship.

📌 In order for the net weight and gross weight to be correctly displayed on your shipping invoices, you must remember that the weight entered inside the CN22/CN23 field needs to be less than the weight entered inside the package. In fact, in the CN22/CN23 field, you must enter the net weight of the goods (i.e., without packaging).


ATTENTION: ShippyPro currently only allows the generation of the CN22 module, if you need a CN23 module you will have to generate it externally. 

2. How to get them?

  1. To obtain these documents access the the Shipped page where you can find all your shipped orders.

  2. Select which ones you need to include inside the document.

  3. Click on the button Carriers (or More Actions) > Create CN22.

    In the weight section you should insert the weight of each item (unit), not the total weight of the parcel. (e.g. if you're shipping 10 items that weigh 0.5 kg each, you will insert it like this: Weight: 0.5 / Qty: 10)

  4. Always write the description in English or in the language of the destination country.

  5. If you're shipping via APIs, you can add the following tag inside the Params field in the Ship API request (one row for every item in the order), e.g.:

"CustomInfoContentsType" : "merchandise",
"CN22Info": [
"Description": "test",
"Weight": 2,
"Quantity": 5,
"UnitValue": 10,
"OriginCountry": "IT",
"Currency": "USD",
"HSCode": "123456" }


"Description" is product's description.
"Weight" is referring to one single item's weight (Weight per item must be equal to Weight in Parcels),
"Quantity" is the quantity for this item that you are shipping into the parcel , if you have different product then click on the + to add a row.
"UnitValue" is the valor for a single item, "UnitValue" X"Quantity" should be equal to "TotalValue".
"OriginCountry" is the manufacturing country.
"Currency" is referring to the currency of "UnitValue", it should be equal to "Currency" of "TotatValue".
"HSCode" is the Harmonized Code referring to the specific product that you're shipping , check here what's your HScode.​

3. What's the HS Code?

The HS or commodity code is a code used by customs authorities around the world to categorize products. The HS Code is not a mandatory field, but you can decide to add it before creating the label, you can specify if the products have different HS Codes, just take into consideration that the total weight must correspond to the one previously declared.

ShippyPro can automatically import the HS Code from Shopify with every annual plan subscription so that you don't have to include it every time. Then open a chat with us by clicking on the chat logo on the right bottom of the platform to ask for HS code automatic import from Shopify.

4. FAQs

Do I need to do this operation for every Carrier?

DHL and Fedex allow you to skip these steps by directly including the ETD Documentation before creating the shipment. Here our complete guide to Manage ETD documents. 📝 

Can I edit multiple CN22/CN23 simultaneously?

It's only possible to edit one CN22/CN23 at a time.

Can I add a fixed value to my CN22/CN23?

No, it's not possible to attach a standard CN22/23 value, you need to add the real one for Customs purposes.

Can I leave my total value as 0?

By inserting value 0 for an item the order will not go through. That's because an item always needs to have a value above 0, even if free of charge.

Why do I get an error weight that must be greater than 0 in Commodity 1? (FedEx)

If you are shipping parcels with more than one product, pay attention to the weight. When filling in the weight in the section "Parcels" you can add the total weight of the package. On the CN22 section, however, you will need to fill in the unit weight and price of each product inside the package.

Why do I get the error: Hard validation error occurred. Die Gewichtsangabe ist kleiner als im CN23-Formular ?

In the weight, section makes sure to insert the weight of each item (unit), not the total weight of the parcel. E.g. if you're shipping 10 items that weigh 0.5 kg each, you will insert it like this: Weight: 0.5 / Qty: 10