Demo GulfGate Terminal: port and container day

Demo GulfGate Terminal LLC operates a container terminal at Jebel Ali. It earns quay, handling, storage, reefer, inspection, and demurrage revenue; pays shipping lines and contractors; and settles some contracts in USD. OSERP links vessel call, booking, container, gate event, yard location, customs release, service order, invoice, payment, and claims.

1. Configure customers, vessels, and service tariffs

Create legal company GGT, terminal JAFZA-T1, yards, gates, reefer plugs, inspection zones, and equipment pools. Customer masters include shipping line, freight forwarder, consignee, credit limit, currency, tax, and billing contact. Vessel and voyage records store IMO, operator, ETA, berth, service string, port call, and manifest reference.

Field	Demo value	Impact
Vessel call	GGT-VC-2026-0918	Port event and billing key
Voyage	OCEAN-742E	Manifest and customer reference
Container	TGHU0042810	Custody and event trace
Type	40-foot reefer	Handling, plug, and storage rule
Yard block	B12-04-08	Location and moves
Service	Discharge + gate delivery	Tariff and revenue
Free days	5	Demurrage start date
Reefer rate	USD 28 / day	Storage revenue
Customs status	Released	Gate eligibility
Currency	USD / AED	Settlement and FX

Tariffs are versioned by customer, service, container type, event date, currency, free days, and tax. A tariff amendment never rewrites an already-issued invoice.

2. Plan a vessel call and discharge

Create a vessel call with vessel, voyage, ETA, berth, agent, manifest, crane plan, discharge window, and safety status. Container detail includes number, ISO type, weight, seal, hazardous flag, reefer temperature, consignee, and discharge port.

The terminal work order records crane, operator, move type, start/end, container, yard destination, damage, and event sequence. A discharge event changes container status from onboard to discharged to yard. A duplicate event with the same container and timestamp is rejected or linked as a correction.

3. Customs, holds, and gate release

Each container has customs declaration, broker, release number, inspection flag, duty status, and hold reason. A container with customs hold cannot be gated out even if the customer has paid. Release updates status with authority, time, document, and user.

Create a gate appointment with truck, driver, plate, container, appointment time, pickup reference, and security check. Gate-in and gate-out record OCR or scan result, seal, condition, weight, and proof. A wrong container or expired appointment creates an exception and does not alter the yard balance.

4. Yard moves and reefer monitoring

Yard moves record source block, destination block, equipment, operator, move reason, container, and timestamps. A reefer plug assignment records plug ID, set point, actual temperature, alarm, inspection, and technician. Temperature excursions create a claim or maintenance work order with evidence.

Daily stock reports show containers by status: discharged, available, customs hold, inspection, damaged, gated, and departed. Counts reconcile to vessel manifest, gate events, and physical yard scans.

5. Storage and demurrage billing

The storage run calculates container-days after free time. Container TGHU0042810 remains 9 days: 5 free and 4 chargeable at USD 28/day, producing USD 112. Detail shows arrival, free-period dates, release, holidays, holds, and tariff version.

Demurrage is billed separately from quay and handling. A customs hold may pause the clock only when the contract supports it and an approved hold record exists. A disputed day references the exact event interval rather than a manual blanket credit.

6. Invoice terminal services

The invoice header records shipping line, vessel call, voyage, customer, currency, service period, tax date, due date, and billing account. Lines show discharge moves, gate moves, storage, reefer plugs, inspections, weighing, and demurrage. Posting debits receivable and credits each revenue stream and tax.

A service order for 120 crane moves at USD 95 and 30 gate moves at USD 22 creates transparent revenue. Contractor invoices match approved moves, equipment, and shift. Unperformed moves cannot be billed simply because they were planned.

7. Damage, claims, and equipment

At gate-out, a seal is broken and a dent is discovered. Create a damage report with container, event, condition code, photographs, surveyor, responsible party, claim amount, and approval. Settlement links to insurer or shipping line recovery. The original gate event remains immutable.

Crane maintenance records asset, meter, work order, parts, technician, downtime, safety isolation, and release test. Equipment fuel and contractor hours are allocated to vessel call or service category. A crane outage affects berth plan and KPI reporting.

8. Multi-currency and close

Shipping lines pay USD; local trucking suppliers invoice AED. Payments record bank rate, value date, currency, fees, and reference. Realised FX is separate from terminal margin. Month-end revaluation covers open USD receivables and payables.

Close reconciles vessel manifests to yard, gate events to containers, moves to invoices, storage snapshots to demurrage, reefer alarms to claims, contractor shifts, tax, bank, FX, and equipment downtime. A vessel call cannot close while a customs hold, open damage claim, or unbilled service exception remains unresolved.

KPI	Baseline	After OSERP discipline	Improvement
Container event trace	4 hours	8 minutes	97% faster
Invoice move accuracy	91%	99.1%	+8.1 points
Demurrage disputes	9.8%	2.1%	79% lower
Yard inventory accuracy	96.5%	99.7%	+3.2 points
Reefer alarm response	45 minutes	12 minutes	73% faster
Contractor billing variance	USD 140k/qtr	USD 25k	82% lower

Practice challenge

Create a vessel call, discharge containers, place one on customs hold, assign a reefer plug, perform yard moves, gate out a released container, calculate storage and demurrage, invoice terminal services, record damage, settle a USD customer and AED supplier, and close the call. Explain every event, status, tariff, journal, FX effect, permission, and evidence drill-down.

Related: Demo 3PL logistics day, Demo Air cargo day, Demo Trading & imports, Multi-currency settlement, and API library.