Products

Products are the commodity master data of the Warehouse App: the liquids and goods you store in fixed tanks and carry in ISO tanks, flexitanks and road tankers, such as ethanol, caustic soda, palm oil or base oils. A product record holds its dangerous goods data (UN number, hazard class, packing group, proper shipping name, flash point), its density, the temperature it must be kept at, handling marks (dedicated equipment, food grade), cleaning notes and its colour on the live view. Storage tanks, units, gate-in, transport bookings, EDI messages and cleaning certificates all point to a product, so one correct record here is reused everywhere.

Where to find it: Workspace → Logistics → Warehouse → Products. The menu entry is always there, whichever modules are switched on, because depots, terminals and transport all use products.

Who can use it

• Anyone with a Warehouse permission (View sites, the live yard, units, tanks and movements) can see the list.
• To add, edit or delete a product you need Add and edit products, part of the group Add and edit units, tanks and products.
• A role with Cannot delete anything keeps editing but loses the delete button; Cannot use bulk actions removes row selection.
• Products can also be created and changed through the MCP tool warehouse.manage_product, with the same permission.

Where it sits in the operation

A product is entered once and then picked from a list wherever a cargo is named: when a loaded unit gates in, when a tank is set up or first receives product, when a transport booking is taken. What the App does with it depends on the field.

What you see

The header tile shows how many products you have. Add a product sits at the top right of the list card.

The list is sorted by name, searchable, and exports to Excel or print. Tick several rows to delete them at once.

Add a product

1. Click Add a product.
2. Type the Product name (up to 200 characters), for example "Ethanol 96%". Use the trade name your operators and clients recognise; the proper shipping name has its own field.
3. Pick a Colour on the live view (blue by default). Tanks with this product show it on their level bar, on the card's level chart and in the live yard.
4. Optional: a Linked item from the core Items list.
5. Under Dangerous goods (leave the block empty for products that are not dangerous goods):
   • UN number: only the digits are kept, so "UN1170" is stored as 1170 (up to 6 digits).
   • Hazard class: as written in the dangerous goods list, for example 3, 8 or 6.1 (up to 10 characters; a subsidiary risk can follow, e.g. "8 (6.1)").
   • Packing group: I, II or III, or none.
   • Proper shipping name, for example "ETHANOL SOLUTION".
   • Flash point (°C).
6. Optional: Density (kg/L) (for example 0.79) and Heat to (°C).
7. Tick Only in dedicated equipment or Food grade where it applies.
8. Optional: Cleaning notes, for example the cleaning procedure after this product.
9. Click Save the product. The row appears in the list straight away.

There is no separate tunnel code, ADR tank code, T-code or subsidiary-risk field. Put such details in the hazard class (subsidiary risk) or in the cleaning notes if your team needs them on screen; the App does not check them.

What each field does

Where products are used

• Gate in: a loaded unit gets a product and a quantity. Its last three cargoes are kept on the unit.
• Storage tanks: a tank holds one product at a time and keeps it when pumped empty. A unit can only be emptied into a tank of the same product; a transfer only goes into an empty tank or one with the same product; a tank's product cannot be changed while it holds product.
• Filling a unit from a tank: a loaded unit only takes more of the same product, and an empty unit marked dirty can only be filled with the product it last carried ("… is dirty from another product. Clean it first.").
• Weighbridge tickets: litres are worked out from the density. Without it: "To work out litres from a weight, the product needs a density. Add it to the product, or type the litres."
• Transport: a booking of a product with a UN number or hazard class counts as dangerous goods. When the trip runs on your own fleet (no subcontracted haulier), the trip warns when the truck or trailer is not marked ADR-equipped ("… carries dangerous goods but is not marked ADR-equipped.") or the driver has no valid ADR certificate (see Trips).
• EDI: IFTDGN dangerous goods notifications for partners with that message switched on (see EDI).
• Cleaning: the cleaning certificate (ECD) of a unit lists its last cargoes with UN number and hazard class.

Controls and exceptions

• Name is the only required field. Everything else can be added later; the dangerous goods features only work once the UN number and hazard class are filled in.
• Colour must be a full #RRGGBB value; anything else is saved as no colour.
• Editing a product changes it everywhere at once, including tanks and units that already hold it and past movements shown in reports. To record a genuinely different grade, add a new product instead of renaming an old one.
• Deleting moves the product to the trash and can be undone from the message. The App does not stop you deleting a product that tanks, units or bookings still use; they keep showing its name, but it can no longer be picked. Empty or reassign tanks first.
• Segregation and ADR are reminders, not a compliance check. The person in charge of dangerous goods remains responsible for segregation, documents and placarding.

For the manager

• Master data quality: sort the list on the Dangerous goods column now and then. A product you know to be dangerous that shows a dash will not trigger ADR warnings on trips, segregation reminders at the gate or IFTDGN messages to your partners.
• Density coverage: every product received or delivered by weighbridge needs a density. A missing density stops the operator at the tank, usually with a truck waiting.
• Colours: give products that must never be mixed clearly different colours, so a wrong line-up stands out on the live view.
• Reporting: products are the "product" dimension of the Warehouse entities in AI Reports ("All business data"): units by product, litres received and delivered by product, stock in tanks by product. Throughput is reported per client and product.

Glossary

UN number

The four-digit number of a dangerous substance in the UN Model Regulations, ADR and IMDG, e.g. 1170 for ethanol.

Hazard class

The ADR/IMDG class (1 to 9, with divisions such as 2.1, 5.1, 6.1); the main class drives the segregation reminder.

Packing group

I (high danger), II (medium) or III (low).

Proper shipping name

The official name of the dangerous goods entry used on transport documents.

Flash point

The lowest temperature at which the vapour can ignite, in °C.

Density

Mass per litre, in kg/L, used to convert weighbridge kilograms into litres.

ADR

The European agreement on the carriage of dangerous goods by road; covers vehicle equipment and driver certificates.

IMDG segregation

The rules for keeping incompatible dangerous goods apart in stowage; used here as a stacking reminder.

IFTDGN

The UN/EDIFACT dangerous goods notification message.

Last cargoes

The last three products a unit carried, used for the dirty-unit rule and the cleaning certificate.

Dedicated equipment

Tanks or units reserved for one product to avoid contamination.

Food grade

A product for human or animal consumption that needs food-grade equipment and cleaning.

Related screens

• Storage tanks: products in fixed tanks.
• Units: loaded units and their last cargoes.
• Bookings: bulk loads of a product.
• Trips: ADR checks for dangerous goods.
• EDI: the IFTDGN dangerous goods message.
• Services: cleaning orders and certificates.
• Throughput: volumes per client and product.
• All screens