mohamedhekal/shipbridge-mng

MNG Kargo / DHL eCommerce Turkey carrier driver for ShipBridge

v0.2.0 2026-07-16 15:46 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
• turkey
• courier
• cod
• carrier
• mng
• dhl-ecommerce
• shipbridge
• mng-kargo

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

README

MNG Kargo / DHL eCommerce Turkey driver for ShipBridge · Region: Turkey / Türkiye

Real ApiZone REST API: https://api.mngkargo.com.tr (sandbox: https://testapi.mngkargo.com.tr)

Türkçe — 3 adımda

1) Paketleri kur

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-mng

2) .env anahtarları

SHIPBRIDGE_DRIVER=mng
MNG_BASE_URL=https://testapi.mngkargo.com.tr
MNG_CLIENT_ID=your-ibm-client-id
MNG_CLIENT_SECRET=your-ibm-client-secret
MNG_CUSTOMER_NUMBER=your-customer-number
MNG_PASSWORD=your-panel-password

Detaylar: config/mng.php ve docs/GUIDE_TR.md.

3) Gönderi oluştur

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

$shipment = ShipBridge::driver('mng')->createShipment(new CreateShipmentRequest(
    origin: new Address('Depo', 'Sanayi Cd 1', 'İstanbul', 'TR', phone: '05551111111'),
    destination: new Address('Ali Yılmaz', 'Atatürk Mah. No:5', 'Adana', 'TR', state: 'Seyhan', phone: '05551234567', email: '[e-mail]'),
    parcels: [new Parcel(weightKg: 2.0, description: 'Ayakkabı')],
    reference: 'ORD-42',
    metadata: [
        'city_code' => 1,
        'district_code' => 100,
        'cod' => 150,
        'desi' => 2,
    ],
));

ZPL etiket: $shipment->raw['zpl']. Teknik notlar: docs/API.md, araştırma: docs/VENDOR_NOTES.md.

English

Laravel driver for MNG Kargo (DHL eCommerce Turkey) against the official ApiZone REST stack: Identity JWT, Standard Command (createOrder), Barcode Command (createbarcode), Standard Query (track), Plus Command (createRecipient), CBS Info (cities/districts).

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-mng

Requires ApiZone IBM client_id / client_secret plus merchant customer_number / panel password. Prefer sandbox host while integrating.

License

MIT · Mohamed Hekal