mohamedhekal/shipbridge-aramex

Aramex carrier driver for ShipBridge (MENA / Global)

v0.2.0 2026-07-16 15:09 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
• express
• shipping
• carrier
• aramex
• mena
• shipbridge

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

README

Aramex shipping driver for ShipBridge · SOAP Shipping API V2
Docs: docs/GUIDE_AR.md · docs/API.md

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

١) التثبيت

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-aramex

٢) بيانات حساب Aramex في .env

SHIPBRIDGE_DRIVER=aramex
ARAMEX_ENV=test
ARAMEX_USERNAME=[e-mail]
ARAMEX_PASSWORD=R123456789$r
ARAMEX_ACCOUNT_NUMBER=20016
ARAMEX_ACCOUNT_PIN=331421
ARAMEX_ACCOUNT_ENTITY=AMM
ARAMEX_ACCOUNT_COUNTRY=JO

القيم الافتراضية أعلاه هي حساب Test الرسمي من توثيق Aramex.
للإنتاج: ARAMEX_ENV=live + بيانات عقدك من Aramex.

٣) ابعت شحنة

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

$shipment = ShipBridge::driver('aramex')->createShipment(new CreateShipmentRequest(
    origin: new Address('المخزن', 'شارع ١', 'Cairo', 'EG', phone: '01011111111'),
    destination: new Address('العميل', 'شارع النيل', 'Giza', 'EG', phone: '01000000000'),
    parcels: [new Parcel(weightKg: 1.5, description: 'ملابس')],
    reference: 'ORD-42',
    metadata: [
        'cod' => 200,
        'currency' => 'EGP',
        'product_group' => 'DOM', // شحن داخلي مصر
        'product_type' => 'OND',
    ],
));

English — Quick start

Uses official SOAP:

• CreateShipments
• TrackShipments
• PrintLabel

WSDL (live): https://ws.aramex.net/ShippingAPI.V2/Shipping/Service_1_0.svc?wsdl

Method	Aramex API
createShipment	CreateShipments
track	TrackShipments
label	PrintLabel
createReturn / createExchange	CreateShipments (typed via metadata)

Testing

composer install && composer test

License

MIT © Mohamed Hekal