Shipping Data and Dangerous Goods
Every stock item can carry four shipping fields: the HS code, the country of origin, a customs description and a dangerous-goods class. With dangerous-goods rules you decide which class may ship with which carrier and shipping method. The pack station then stops an order that breaks a rule before a label is printed.
Who It Is For
Shops that ship abroad and want their customs data in one place.
Shops and warehouses that sell batteries, aerosols, perfume, paint or other goods that not every carrier accepts.
Both parts are available as soon as warehouse stock is switched on, at every level.
Where to Find It
The stock item (Warehouse > Stock, Open item), General tab: the card Shipping data.
Settings > Warehouse > Stock, card Dangerous goods: the rules (https://portal.qr-x.app/settings/stock/dangerous-goods).
Warehouse > Pack station: the warning and the block while packing.
The Four Shipping Fields
HS code: the customs commodity code, 6 to 12 digits. Dots and spaces are fine, for example 8507.60.00.
Country of origin: where the item was made. Choose it from the country list (search by code or name).
Dangerous goods: None, Lithium battery, Limited quantity, Aerosol or Flammable. This class is what the pack station checks.
Customs description: what the goods are, in plain words, up to 500 characters. For example "cotton T-shirt, knitted".
All four are optional and are saved with the item.
Dangerous-Goods Rules
Open Settings > Warehouse > Stock and click the card Dangerous goods. A rule says whether one class may ship with a carrier.
Click Add rule.
Choose the Dangerous-goods class and the Carrier.
Choose a Shipping method, or leave All methods so the rule counts for the whole carrier.
Switch Allowed on or off. Off means Blocked: the pack station stops orders with this class that ship this way.
A rule for one shipping method goes before the rule for the whole carrier. Example: block Lithium battery for a carrier, and allow it for that carrier's road service only.
Without a rule a class may ship. An empty list means nothing is blocked.
The list shows the class, carrier, shipping method, the rule (Allowed or Blocked) and when it was updated. Use the icons to edit, Copy to a new rule or delete.
There is one rule per class, carrier and shipping method. If it exists already, change that rule.
A change counts at the pack station within about half a minute.
When a fulfilment partner packs your orders, the rules of the partner that packs apply.
What the Packer Sees When an Order Is Blocked
While packing, a line whose class is not allowed shows a warning: not allowed with this carrier.
When the packer presses Complete, the order is refused: "... does not take these dangerous goods. Nothing was printed." A panel lists the lines. No label is bought and nothing is printed.
The way out: change the shipping method of the order in Transactions to one that is allowed and complete again, or ask someone with override rights.
Who Can Override, and What Is Logged
A user with the permission Pack without scanning sees Override in the panel. The dialog "Ship these dangerous goods anyway?" asks for a note: why may this order ship? For example "carrier confirmed by phone". The note is required. The note and the name of the user are logged with the order. After that, press Complete again and the label prints. The lines then show allowed by an override.
An override counts for that carrier and shipping method only. When the order moves to another carrier or method that is also blocked, a new override is needed.
The Warning When You Create a Pick List
After you create a pick list, QrX warns when orders on it hold dangerous goods that their carrier does not take: "... orders on this pick list hold dangerous goods their carrier does not take. They are picked, but the pack station blocks them until the shipping method changes or someone overrides it." It is a warning only: the pick list is created and the orders are picked. Use it to fix the shipping method before the parcel reaches the pack table.
Permissions
Manage stock settings: fill in the shipping fields of an item and add, change or delete rules.
View stock: see the fields and the rules.
Pack without scanning (together with Use the pack station): override a dangerous-goods block.
Limits
Without rules nothing is blocked. QrX does not know the conditions of your carrier: you set the rules yourself and you stay responsible for what you ship.
Only items with a dangerous-goods class are checked. An item with None is never blocked.
Only the pack station checks. Labels printed outside the pack station are not checked: a label printed from the Transactions list, by an automation rule or through the public API.
An order without a shipping method is checked against the rules for the whole carrier only.
The HS code, country of origin and customs description are stored with the item. QrX does not print them on carrier customs documents yet, and they cannot be imported by CSV yet.
Frequently Asked Questions
I gave an item the class Lithium battery but the order is not blocked. Why?
Check that a rule exists for that class and the carrier of the order, with Allowed switched off. Without a rule a class may ship. Also check that the label is printed at the pack station.
Can a packer override the block?
Only with the permission Pack without scanning. The override needs a note and is logged with the name of the user.
When to Contact Our Support Team
Contact QrX support directly when an order is blocked although your rule allows the class, when a carrier or shipping method is missing in the rule form, or when you need help reading who overrode a block. Mention the order number, the carrier and the item SKU.