mohamedhekal/shipbridge-hepsijet

HepsiJet carrier driver for ShipBridge (Turkey)

v0.2.0 2026-07-16 15:52 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
• Hepsiburada
• hepsijet
• shipbridge

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

README

HepsiJet (Hepsiburada Logistics) driver for ShipBridge · Region: Turkey / Türkiye

REST API: https://integration.hepsijet.com (sandbox: https://integration-apitest.hepsijet.com)

Türkçe — 3 adımda

1) Paketleri kur

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-hepsijet

2) .env anahtarları

SHIPBRIDGE_DRIVER=hepsijet
HEPSIJET_BASE_URL=https://integration-apitest.hepsijet.com
HEPSIJET_USERNAME=your-username
HEPSIJET_PASSWORD=your-password
HEPSIJET_COMPANY_NAME=Your Company
HEPSIJET_ABBREVIATION_CODE=YOURABBR
HEPSIJET_COMPANY_ADDRESS_ID=ADDR-001
HEPSIJET_CURRENT_XDOCK_CODE=XD-001

Detaylar: config/hepsijet.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('hepsijet')->createShipment(new CreateShipmentRequest(
    origin: new Address('Depo', 'Sanayi Cd 1', 'İstanbul', 'TR', state: 'Tuzla', phone: '05551111111'),
    destination: new Address('Ali Yılmaz', 'Kızılay Mah.', 'Ankara', 'TR', state: 'Çankaya', phone: '05551234567', email: '[e-mail]'),
    parcels: [new Parcel(weightKg: 2.0, description: 'Ayakkabı')],
    reference: 'ORD-42',
    metadata: ['desi' => 2, 'town' => 'Çankaya'],
));

echo $shipment->trackingNumber; // TSTORD42...

PDF etiket: ShipBridge::driver('hepsijet')->label($shipment->trackingNumber). Teknik notlar: docs/API.md, araştırma: docs/VENDOR_NOTES.md.

English

Laravel driver for HepsiJet REST integration: Basic Auth token, enhanced delivery create, integration track, and separate PDF label endpoint.

composer require mohamedhekal/shipbridge mohamedhekal/shipbridge-hepsijet

Caller-generated barcodes (customerDeliveryNo) must be 9–16 characters prefixed with your abbreviation_code. Nested address format uses city.name, town.name, and district.name.

License

MIT · Mohamed Hekal