You can generate dangerous goods documents to print when shipping hazardous materials. The dangerous goods document automatically pulls data from the Hazardous Details section of product records in Mintsoft. Documents are generated at despatch and become available to view and print on the Scan Actions page.
Important: This feature requires the use of the Order Rules module, please speak to your Account Manager to learn more.
Understanding hazardous goods fields
Important: Two Different UN Number Fields
Mintsoft has TWO separate UN Number fields in the product data:
"Hazardous UN Number" (Hazardous Details tab) - Correct Field
Used for dangerous goods document generation.
Used in the ProductHazardousUNNumber order rule condition.
Must be populated for dangerous goods documents to generate.
"UN Number - 4 Digit Hazardous Materials" (Extra Details tab) - Not Used
Legacy field for reference only.
NOT used for dangerous goods documents.
NOT used in order rules.
Always use the "Hazardous UN Number" field on the Hazardous Details tab.
Dangerous goods document setup
The setup is split into three main sections:
Dangerous Goods Document Setup
Courier Service Setup
Order Rule Setup
Create the document
To create the dangerous goods document, follow the steps below:
Note: Download the attached template at the bottom of this guide if you want a document to build from. This template includes pre-configured merge fields for all available dangerous goods data, proper table structure with TableStart and TableEnd markers, example formatting and layout, and all standard merge fields.
Open Microsoft Word.
Create a table with two default rows and as many columns as you require.
The first row is the title of the attribute (UN Number, Packing Code, and so on).
The second row is the corresponding value from the Available Tags section below.
You can add the fields by clicking Insert then Quick Parts, then Fields.
From the list of field names select MergeField.
In Field Name, enter a value from the Available Tags section below.
The table needs to have TableStart:DangerousGoods first and end with TableEnd:DangerousGoods.
Choose the Format as (none).
Click OK.
Repeat steps 5-10 to add all required merge fields.
Then add any other additional tags from the Available Tags section below.
Images and logos can also be added.
Save the document as .docx (other formats like PDF are not supported).
Available tags
The following merge fields can be used in your dangerous goods document template:
Merge Field | Description | Product Field Location | Data Type | Example | Required |
UN_NUMBER | The 4-digit UN hazardous materials identification number | Hazardous Details tab > Hazardous UN Number | Text (4 digits) | 1203 | Yes |
CLASS | Hazardous goods classification | Hazardous Details tab > Class | Text (max 4 characters) | 3 | No |
PROPER_SHIPPING_NAME | Official shipping name for the hazardous material | Hazardous Details tab > Proper Shipping Name | Text (max 500 characters) | GASOLINE | Yes |
PACKING_CODE | Packing group code | Hazardous Details tab > Packing Code | Text | II | No |
TUNNEL_CODE | Tunnel restriction code | Hazardous Details tab > Tunnel Code | Text | E | No |
LIMITED_QTY | Limited quantity information | Hazardous Details tab > Limited Quantity | Text | 1L | No |
FULL_PROPER_SHIPPING_CODE | Full proper shipping code | Hazardous Details tab > Full Proper Shipping Code | Text | Auto-generated | No |
CONTENT_ID | Content identification | Hazardous Details tab > Content ID | Text | 3082 | No |
LITRES_IN_TOTAL | Total litres calculated from LitresPerUnit × Quantity | Hazardous Details tab > Litres Per Unit | Decimal | 5.5 | No |
PACKAGING_DESCRIPTION | Description of packaging | Hazardous Details tab > Packaging Description | Text | Steel drum | No |
PACKAGING_INSTRUCTIONS | Packaging instructions | Hazardous Details tab > Packaging Instructions | Text | P001 | No |
FREEZING_POINT | Freezing point temperature | Hazardous Details tab > Freezing Point | Decimal | -40 | No |
NET_MASS | Weight per unit from product | General tab > Weight | Decimal | 1.5 | No |
TOTAL_MASS | Total weight calculated from Weight × Quantity | Calculated | Decimal | 15.0 | No |
Additional tags
The following special tags can be used outside the DangerousGoods table:
#TOTALDANGEROUSWEIGHT#
This tag automatically calculates the total weight of all dangerous goods items in the order (sum of Weight × Quantity for all dangerous items). Use this tag outside the DangerousGoods table to display the aggregate weight.
HazardousNotes
Additional notes field from the Hazardous Details tab (not part of the merge table).
Upload the document
Once you've created the dangerous goods document, the next step is to upload it to Mintsoft.
To upload the document, follow the steps below:
Click Settings then Label / Document Templates.
Click Add New Label Template.
(3PL Only) Select the Client or keep as ALL.
Set the Type as DangerousGoods.
Set the Paper Size.
Click Choose File to upload the dangerous goods document.
In the Name field, enter either Road, Rail, Sea, or Air.
Click Add.
Note: The Name field must match the transport mode exactly and is case-sensitive. Road, Rail, Sea, and Air are the supported transport modes.
Client-specific templates (3PL only)
For 3PL operations, you can create different dangerous goods templates for different clients.
Global Template (Client = ALL)
Applies to all clients who don't have a specific template. Use this for standard dangerous goods documentation.
Client-Specific Template
Applies only to the selected client. Overrides the global template for that client. Use this when a client requires custom dangerous goods documentation format.
Template selection priority
System first looks for a client-specific template.
If not found, system uses the global template (Client = ALL).
If neither exists, document generation fails with an error.
Example use case
Client A requires dangerous goods documents in French. Client B requires dangerous goods documents in German. All other clients use English (global template).
Create three templates:
Name: Road, Client: Client A (French template).
Name: Road, Client: Client B (German template).
Name: Road, Client: ALL (English template).
Courier service setup
Any courier services you want to ship dangerous goods with must have the corresponding transport mode selected. To configure the courier service, follow the steps below:
Click Shipping Management then Couriers.
Click Manage Courier Services against the courier you want to manage.
Click Edit against the courier service you want to manage.
Select the correct Transport Mode.
Click Update to save changes.
Important: The transport mode must match the Name of the document you uploaded. Road, Rail, Sea, and Air are supported. The Name field is case-sensitive.
Tip: You can create separate dangerous goods templates for each transport mode. The system will automatically select the correct template based on the courier service's transport mode.
Order rule setup
To successfully generate the dangerous goods document when required, you must create an order rule.
To create the order rule, follow the steps below:
Click Settings then Order Rules.
Click Add New Rule.
(3PL Only) Set the Client.
Set the Warehouse and Channel.
Set the Action as AddTag.
Enter DangerousGoods in the Param field.
Click Update to save your configuration before adding conditions.
Within the Conditions section, set the Field to ProductHazardousUNNumber.
Set the Operator to IsNotEmpty.
Click Add.
Important:
This is how the system identifies the document is required to generate.
The order rule condition ProductHazardousUNNumber refers to the Hazardous UN Number on the Hazardous Details tab, NOT the UN Number – 4 Digit Hazardous Materials on the Extra Details tab of the product. Using the wrong field will prevent documents from generating.
When dangerous goods documents are generated
Dangerous goods documents are automatically generated during the order despatch process when the following conditions are met:
Order has the DangerousGoods tag (added by the order rule).
Order is being despatched (shipment is being created).
At least one order item has hazardous goods data (Hazardous UN Number is populated).
A dangerous goods template exists for the courier service's transport mode.
Important: Documents are NOT generated when orders are imported. Documents are generated AFTER the shipment is created. If a document has already been generated for an order, it won't be regenerated.
Viewing generated documents
Once generated, dangerous goods documents can be accessed:
Navigate to the order.
Click the Scan Actions page.
The dangerous goods document will be listed under Documents.
Click to view or print the document.
Document storage
Generated dangerous goods documents are:
Stored as PDF files in Mintsoft's document storage.
Linked to the specific order.
Accessible from the order's Scan Actions page.
Retained according to your account's document retention policy.
Available for reprinting at any time.
Documents are stored with the filename format: DangerousGoods-{TransportMode}-{CourierServiceId}-{OrderId}.pdf
Example: DangerousGoods-Road-123-456789.pdf
Automatic printing
Dangerous goods documents can be automatically sent to your configured printer during despatch. This is controlled by your despatch workflow settings.
To enable automatic printing:
Ensure your printer is configured in Mintsoft.
The document will be added to the print queue during despatch.
Check your print queue to verify the document was sent.
Multiple dangerous goods products
If an order contains multiple products with hazardous goods data:
Each product will appear as a separate row in the dangerous goods table.
The LITRES_IN_TOTAL field will calculate per product (LitresPerUnit × Quantity).
The TOTAL_MASS field will calculate per product (Weight × Quantity).
The #TOTALDANGEROUSWEIGHT# tag will show the sum of all dangerous goods weights in the order.
Example
Order contains:
Product A: UN 1203, Weight 2kg, Quantity 3 = 6kg total.
Product B: UN 1950, Weight 1.5kg, Quantity 2 = 3kg total.
#TOTALDANGEROUSWEIGHT# = 9kg.
Frequently asked questions
Is the dangerous goods paperwork sent electronically to the courier?
No, dangerous goods paperwork is not automatically sent electronically to the courier during the shipment creation process. The system generates dangerous goods documents as PDFs that are stored in Mintsoft and can be printed.
What you need to do
Print the dangerous goods document from the order's Scan Actions page.
Include the printed document with the physical shipment.
Ensure the document is visible on the outside of the package (if required by regulations).
Note: Some courier integrations may support electronic transmission of dangerous goods data as part of the shipment booking. Check with your specific courier provider for their requirements and capabilities.
Important: Always follow your local regulations and courier requirements for dangerous goods documentation. The printed document must accompany the shipment as required by law.