mohamedhekal/shipbridge-smsa

SMSA Express carrier driver for ShipBridge (Saudi Arabia / GCC)

v0.2.0 2026-07-16 15:25 UTC

Requires

• php: ^8.2
• ext-soap: *
• illuminate/http: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• mohamedhekal/shipbridge: ^0.1

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/phpstan: ^2.0

MIT

• Mohamed Hekal

• laravel
• shipping
• courier
• carrier
• smsa
• saudi
• gcc
• shipbridge

Published on Packagist.org on 2026-07-16 15:25 UTC

README

SMSA Express shipping driver for ShipBridge · Region: Saudi Arabia / GCC / السعودية والخليج

Real SECOM SOAP API: SMSAwebService.asmx

بالعربي — في ٣ خطوات

١) ثبّت الحزمتين

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-smsa

٢) حط مفتاح SMSA في .env

SHIPBRIDGE_DRIVER=smsa
SMSA_PASSKEY=your-passkey
SMSA_WSDL=http://track.smsaexpress.com/SECOM/SMSAwebService.asmx?WSDL

التفاصيل في docs/GUIDE_AR.md.

٣) ابعت شحنة

use Hekal\ShipBridge\Facades\ShipBridge;
use Hekal\ShipBridge\DTOs\Address;
use Hekal\ShipBridge\DTOs\CreateShipmentRequest;
use Hekal\ShipBridge\DTOs\Parcel;

$shipment = ShipBridge::driver('smsa')->createShipment(new CreateShipmentRequest(
    origin: new Address('المستودع', 'شارع الملك', 'Riyadh', 'SA', phone: '0110000000'),
    destination: new Address('العميل', 'طريق فهد', 'Jeddah', 'SA', phone: '0555555555'),
    parcels: [new Parcel(weightKg: 2.0, description: 'ملابس')],
    reference: 'ORD-42',
    metadata: ['cod' => 50],
));

echo $shipment->trackingNumber; // AWB

English — Quick start

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-smsa

SHIPBRIDGE_DRIVER=smsa
SMSA_PASSKEY=your-passkey

ShipBridge::driver('smsa')->createShipment(...); // addShip
ShipBridge::driver('smsa')->track('AWB');         // getTrack
ShipBridge::driver('smsa')->label('AWB');         // getPDF

Requires PHP ext-soap. See docs/API.md.

Testing

composer install && composer test

License

MIT © Mohamed Hekal