mohamedhekal/shipbridge-turbo

Turbo carrier driver for ShipBridge (Egypt)

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

Requires

• php: ^8.2
• 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
• Egypt
• turbo
• shipbridge

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

README

Turbo Egypt shipping driver for ShipBridge · Region: Egypt / مصر

Real External API: https://backoffice.turbo-eg.com/external-api

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

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

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-turbo

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

SHIPBRIDGE_DRIVER=turbo
TURBO_AUTHENTICATION_KEY=your-authentication-key
TURBO_MAIN_CLIENT_CODE=your-client-code
TURBO_BASE_URL=https://backoffice.turbo-eg.com/external-api

التفاصيل في config/turbo.php و 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('turbo')->createShipment(new CreateShipmentRequest(
    origin: new Address('المخزن', 'شارع ١', 'القاهرة', 'EG', phone: '01011111111'),
    destination: new Address('العميل', 'شارع النيل', 'الجيزة', 'EG', phone: '01000000000'),
    parcels: [new Parcel(weightKg: 1.2, description: 'ملابس')],
    reference: 'ORD-42',
    metadata: [
        'cod' => 250,
        'government' => 'الجيزة',
        'area' => 'الدقي',
    ],
));

echo $shipment->trackingNumber; // bar_code

تتبع / ليبل / مرتجع:

ShipBridge::driver('turbo')->track($shipment->trackingNumber);
ShipBridge::driver('turbo')->label($shipment->trackingNumber); // رابط التتبع العام

English — Quick start

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-turbo

SHIPBRIDGE_DRIVER=turbo
TURBO_AUTHENTICATION_KEY=your-authentication-key
TURBO_MAIN_CLIENT_CODE=your-client-code
TURBO_BASE_URL=https://backoffice.turbo-eg.com/external-api

ShipBridge::driver('turbo')->createShipment(...); // POST /add-order
ShipBridge::driver('turbo')->track('BARCODE');    // /get-status → /search-order
ShipBridge::driver('turbo')->label('BARCODE');    // public tracking URL

See docs/API.md for the full External API contract.

How it fits

Your Laravel app
      │
      ▼
 ShipBridge  (one API for all carriers)
      │
      ▼
 shipbridge-turbo  ← this package (Turbo Egypt)

Testing

composer install && composer test

License

MIT © Mohamed Hekal