Back to portfolio
Government Integration

Saudi Elm Bayan Logistics & Transport Integration

Official commercial integration with the Saudi Elm Bayan freight platform, orchestrating trip lifecycles, digital consignment waybills, and Transport General Authority (TGA) compliance.

The challenge

Ensure freight forwarders and carriers operate in real-time compliance with Saudi transport regulations, preventing duplicate document issuance and handling unreliable network retries during active transit.

Architecture & solution

Built an Elm Bayan API integration engine covering both freight-forwarder and carrier roles. Modeled the full trip lifecycle from dispatch through delivery, automated digital waybill creation and cancellation, and enforced idempotent staging/production boundaries to eliminate duplicate government filings.

Architecture pipeline & data flow

1. Transport Dispatch

Multi-tenant freight forwarder or carrier consignment creation

2. Trip State Machine

Dispatched -> In-Transit -> Inspection -> Delivered lifecycle

3. Elm Bayan API

Official Saudi transport authority (TGA) integration engine

4. Waybill Issuance

Digital consignment document generation with verifiable QR data

5. Idempotent Retry

Zero duplicate document filings on staging/production boundaries

Technical highlights

  • Commercial integration with Saudi Elm Bayan (الهيئة العامة للنقل / شركة علم)
  • Carrier and freight-forwarder multi-role orchestration
  • End-to-end trip lifecycle and official waybill document generation
  • Idempotent retry mechanics eliminating duplicate government submissions
  • Unified branch scoping with Firebase FCM dispatch notifications

Tech stack

  • Laravel
  • Elm Bayan API
  • REST Contracts
  • Node.js
  • MySQL
  • Firebase FCM