Freight Master Files

Before you create your first operation order, you need to define the building blocks every shipment is made of: which services you offer, in which containers, on which vessels, and to and from which ports. You'll find all of these master files under Freight Management System → Master Files, defined once and then reused across every document.

Service Items

Service items are the "items" of the freight module — but they're services, not goods. Each one represents a service you sell or buy: ocean freight, customs clearance, trucking, a refrigeration genset, courier, or another service.

When you define a service item you set its nature through a set of flags:

• Ocean Freight / Custom Clearance / Trucking / Genset / Courier / Other — classify the item under the right service type, so it appears in the correct section inside the operation order and price lists.
• Tax Plan — how tax is calculated on this service.
• Subsidiary Accounts — the revenue/cost accounts the item is recorded on.
• Default quantity and unit — to speed up line entry.

Fields related to e-invoicing

A service item carries three fields for e-invoicing: a Tax Authority Code to classify the service for the authority, an E-Invoice Item to send a substitute/consolidated item instead of the operational one, and a Commission Item to separate commission from cost in the agent model. Details are in the E-Invoicing page.

Containers, Types, and Sizes

A Container is defined by its type and size:

• Container Type — dry, reefer, open-top, tank, etc.
• Container Size — 20ft, 40ft, 40ft High Cube (HC), etc.

The container is later selected on the operation order, bill of lading, and service lines, and is used as one of the keys when matching sales lines to purchase lines for cost calculation.

Vessels, Ports, and Sailing Schedules

• Ocean Vessel — a simple file with a code and name for each ship you deal with.
• Shipping Port — loading, discharge, and final-destination ports, used on the operation order, bill of lading, and service lines. It is a shared file of the Basic module, so it is also reachable from Basic → Master Files → Shipping Port; both menu items open the same list.
• Sailing Schedule — a reference table whose lines gather the available sailings: country, loading and discharge ports, shipping line, vessel and voyage, estimated sailing and arrival dates, and transit time in weeks. It helps the sales team pick the fastest, most suitable sailing for the customer. Tick Selected on exactly one sailing line and press Create Operation Order: a new operation order opens in a pop-up with that line's ports, shipping line, vessel, voyage and remark already filled. The line must name a shipping line.

Commodities, Countries, and Locations

• Commodity — a description of the shipped goods (electronics, chilled foods, dangerous goods…); used on the operation order, bill of lading, and as one of the pricing keys.
• Country — origin and destination countries, appearing on sailing schedules and mail items.
• Locations (with sections, classes, and types) — places with a capacity where operation-order cargo and postal mail items are stored. See Storage Locations.

Bill of Lading Types and Units of Measure

• Bill of Lading Type — classifies bills of lading (Master B/L, House B/L, etc.).
• Shipping Type — a plain list (code and name) of the ways you ship, such as sea FCL, sea LCL or air; picked in the Shipping Type field of the operation order.
• FRM UOM — freight-specific units of measure (weight, volume/CBM, count…) used in line quantities.

Start small

You don't need to define everything up front. Start with the service items you actually sell and the container types you handle, and add vessels, ports, and commodities gradually as they appear in your shipments.

Messages you may see

Message	Why	What to do
You Must Select at least One Of Service Item Types — «يجب اختيار خدمة واحدة على الاقل من الخدمات الأربعة التالية(شحن بحري ـ نقل ـ تخليص ـ مولدات)»	A service item has none of its service flags ticked — ocean freight, custom clearance, trucking, genset or other — and no Tax Authority Code either, so nothing places it in a section.	Tick the flag for the service the item really is. An item that exists only for e-invoicing passes the check once it carries a Tax Authority Code.
Commission item {0} should not be the same e invoice item {1} — «بند خدمة (عمولة) {0} لا يجب ان يكون هو نفسه بند الفاتورة الالكترونية {1}»	The Commission Item and the E-Invoice Item on the service item point at the same record, which would make commission and cost indistinguishable on the submitted invoice.	Point them at two different service items, or clear the one you do not need.
Capacity {0} must be more than zero — «يجب ان تكون السعة أكبر من الصفر»	A Location is being saved with an empty, zero or negative Capacity.	Enter the location's capacity; storage consumption is measured against it.
You Must Select One Record — «يجب إختيار سطر واحد»	Create Operation Order on the sailing schedule was pressed with no line, or more than one line, ticked Selected.	Tick exactly one sailing line.
You Must Select Shipping Line — «لا يمكن ترك الخط الملاحى فارغاً»	The ticked sailing line has no shipping line.	Fill the line's shipping line, then press the button again.