Introduction
This article explains how to set the Harmonized System (HS) code for a product so it is passed to GelatoConnect Logistics (GCL) and used for customs documentation and commercial invoices.
The HS code is not a standalone field. You define it as a property on a product attribute, fill in the value for each attribute value, and then map that property on the product model's Harmonized System Code definition under Shipping. There are three steps.
1. Add the HS Code property to the attribute
Open your product model and select the attribute that identifies the product type (for example Pick and Pack Type, attribute ID PickAndPackType).
Open the Attribute Properties tab.
Click + Add property and add:
HSCode — Type: String (Dot Case). This holds the HS code itself.
HSDescription (optional) — Type: String (Custom Case). This holds the customs description shown on shipping documents.
2. Define the HS code for every attribute value
In the same attribute, open the Attribute Values tab.
For each value, fill in the HSCode column (and HSDescription if you added it). For example, A3 Poster → 49119100, Apron → 6211.42.00 / "100% cotton apron".
To do this at scale, use Export Values to download the list, add the codes in the sheet, and Import Values to upload them back — rather than editing each value by hand.
Note: every value that can be selected should have a code. A blank value means no HS code is sent for products using it.
3. Map the property on the product model
On the product model, go to the Shipping group and locate Harmonized System Code.
[[IMAGE 2 — Shipping group: Harmonized System Code list item]]
Click to edit. The Edit Harmonized System Code dialog opens (Group: Shipping, Type: String).
In the HS Code field, enter the reference to the attribute property:
attributes.PickAndPackType.HSCode
Replace PickAndPackType with your attribute ID and HSCode with your property ID if they differ.
Click Save changes.
If you cannot find a matching value in the dropdown, use the "Could not find a matching HS Code? Add a custom one" link in the dialog to enter a custom reference.
Result
Once saved, each product UID resolves its HS code from the value selected for that attribute, and GCL reads it for customs and commercial invoice generation.