Job state machine

آلة حالة ملف الشحن

draft → booked → in_transit → at_destination → delivered → closed (or cancelled). Direct writes blocked with [EHL-FRT-001]; transitions emit tracking events automatically.

مسار الحالات ‎draft → booked → in_transit → at_destination → delivered → closed‎ ‎(أو cancelled)‎ ، الكتابة المباشرة محجوبة بخطأ ‎[EHL-FRT-001]‎ ، والانتقالات ترسل أحداث تتبع تلقائيًا.

ISO 6346 container register

سجل الحاويات وفق ‎ISO 6346‎

Container number with checksum validation, ISO type code, seal numbers, gross / tare / payload, owner-operator partner, and lifecycle dates (gate-in, loaded, sailed, discharged, gate-out).

رقم الحاوية مع تحقق المجموع الاختباري ، رمز النوع وفق ‎ISO‎ ، أرقام الأقفال ، الوزن الإجمالي والصافي والحمولة ، شركة المالك ‎(operator)‎ ، وتواريخ دورة الحياة ‎(دخول البوابة ، شحن ، إبحار ، تفريغ ، خروج البوابة)‎.

Multi-mode bills of lading

وثائق شحن متعددة الأنواع

HBL / MBL for ocean, HAWB / MAWB for air. Carrier and shipper / consignee reference fields, plus the freight-prepaid / collect indicator. Renders to PDF via the integrity-checked report shell.

‎HBL / MBL‎ للبحري ، ‎HAWB / MAWB‎ للجوي. حقول الناقل والمرسل والمرسل إليه ، ومؤشر دفع الشحن ‎(مدفوع / تُحصَّل)‎. الإصدار بصيغة PDF عبر قالب التقارير المحمي بالتحقق.

Cost and revenue ledger

دفتر التكلفة والإيراد

Posts on the same sale order the quote lives on. Disbursements excluded from margin computation; live margin status reflects accruals as the job advances and supplier bills land.

يُسجَّل على نفس أمر البيع الذي يحمل العرض. ‎(الفوترة لمصاريف الغير ‎disbursements‎ مستثناة من حساب الهامش)‎. حالة الهامش لحظية وتعكس الاستحقاقات مع تقدّم الملف ودخول فواتير الموردين.

Milestone log

سجل المراحل

Per-job timestamped event log: NOR tendered, vessel arrived, discharge complete, customs released, container gate-out, POD signed. Append-only; every state transition logs.

سجل أحداث ملف الشحن مع طوابع زمنية: تقديم ‎NOR‎ ، وصول السفينة ، اكتمال التفريغ ، الإفراج الجمركي ، خروج الحاوية ، توقيع تسليم البضاعة. السجل إضافي فقط ، وكل انتقال حالة يُسجَّل.

Mode-aware UX

تجربة مستخدم بحسب وسيلة النقل

Sea / Air / Road / Rail / Multimodal. Mode selection drives the kanban grouping, the search filter chip set, and the BL form variant. Volumetric weight check fires at 1 cbm = 1000 kg.

البحري ، الجوي ، البري ، السكك الحديدية ، الانتقال متعدد الوسائط. اختيار الوسيلة يحرّك تجميع الكانبان ، وحزمة فلاتر البحث ، ونوع نموذج بوليصة الشحن. تنبيه الوزن الحجمي يُفعَّل عند ‎1 m³ = 1000 kg‎.

Lane-aware onchanges

تكييف الحقول حسب خط الشحن

Customer pick auto-defaults shipper / consignee per direction; party-country mismatch surfaces as a soft warning before customs declaration; same-country lane pings the operator unless cross-trade.

اختيار العميل يُعيِّن المرسل والمرسل إليه تلقائيًا حسب اتجاه الشحنة ، تعارض دولة الطرف يظهر تحذيرًا قبل إصدار الإقرار الجمركي ، ومسار محلي ‎(نفس الدولة)‎ يثير تنبيهًا إلا إذا كانت تجارة عبور.

Carrier-aware tracking

تتبع متوافق مع الناقلين

Inherits the trackable mixin. Every state transition emits a normalised tracking event; carrier IFTSTA inbound feeds map automatically. Public tracking page works without authentication.

يرث وحدة التتبع. كل انتقال حالة يرسل حدث تتبع موحّد ، رسائل IFTSTA الواردة من الناقلين تُربط تلقائيًا ، صفحة التتبع العامة تعمل دون مصادقة.

Customs hand-off

تسليم نظيف للجمارك

Spawns a customs declaration of the right type (import / export / transit) with the regulator of record from the destination country. The declaration carries every reference back.

يولّد إقرارًا جمركيًا من النوع الصحيح ‎(استيراد / تصدير / ترانزيت)‎ مع الجهة التنظيمية المختصة بحسب الدولة. الإقرار يحوي كل المراجع المتبادلة.

Mass-advance wizard

مساعد الترقية الجماعية

Operator picks N jobs from the list view and advances them all to the next state in one transaction. State machine still validates each; incompatible jobs are skipped and reported.

يختار المشغّل عدة ملفات من القائمة ويُقدّمها كلها للحالة التالية بمعاملة واحدة. آلة الحالة تتحقق من كل ملف ، والملفات غير المتوافقة تُتخطّى ويُبلَّغ عنها.

Polymorphic disputes / variations

منازعات وتعديلات متعددة الأشكال

Cargo damage claim, contested charge, scope change, all attach polymorphically. Stat buttons on the form open the existing cases pre-filtered.

مطالبة تضرّر بضاعة ، تكلفة متنازع عليها ، تعديل نطاق ، جميعها مرتبطة بشكل متعدد الأشكال. أزرار الإحصاء على النموذج تفتح القضايا القائمة مفلترة جاهزًا.

Profitability dashboard

لوحة معلومات الربحية

Dashboard tile + cross-suite pivot: revenue / cost / margin per customer, lane, mode, period. Drills down to the underlying jobs in two clicks.

بلاطة على لوحة المعلومات + Pivot عبر المنظومة: الإيرادات والتكاليف والهوامش حسب العميل والخط والوسيلة والفترة. التنقّل لتفاصيل الملفات في نقرتين.

Sale order hook

ربط أمر البيع

Confirming a logistics sale order with mode set spawns one or more freight jobs depending on direction. The Job button on the sale order opens the spawned files, so operations and commercial work inside one shared record.

تأكيد أمر بيع لوجستي بوضع نقل محدّد يولّد ملف شحن واحد أو أكثر بحسب الاتجاه. زر "الملفات" على أمر البيع يفتح الملفات الناتجة، فيعمل التشغيل والمبيعات داخل سجل واحد مشترك.

Apply quotation template

تطبيق نموذج العرض

Pick the lane and mode; the charge template pre-fills line items, defaults the incoterm, and seeds the carrier choice.

Confirm the sale order

تأكيد أمر البيع

Margin / credit / KYC guards run; if the trio is green the freight job spawns automatically with the matching origin / destination / mode.

Book with the carrier

الحجز مع الناقل

Carrier portal rate-shop, IFTMIN dispatch, or manual booking against an external reference. The booking links back to the freight job.

Operate through milestones

إدارة العمليات بحسب المراحل

Each state transition emits a milestone, a tracking event, and a chatter line. Mass-advance the kanban for batches; drill the pivot for lane analytics.

Customs declare and clear

الإقرار والتخليص الجمركي

Spawn the declaration of the right type. Adapter submits to the regulator of record and polls status until cleared or rejected.

Deliver and collect POD

التسليم وأخذ إيصال الاستلام

Transport trip or last-mile delivery completes with a signed POD. Tracking event renders on the public page.

Bill and reconcile

الفوترة والتسوية

Cost lines arrive from supplier bills; revenue lines invoice the customer; the margin status reconciles to the quote at job close.

Close the file

إغلاق الملف

All milestones logged, all costs accrued, all POD images attached. Closed state is terminal; post-close changes flow through a variation.