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
Multi-tenant freight forwarder or carrier consignment creation
Dispatched -> In-Transit -> Inspection -> Delivered lifecycle
Official Saudi transport authority (TGA) integration engine
Digital consignment document generation with verifiable QR data
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