PHP/Laravel ile EasyShip API Kullanarak Uluslararası Gönderimleri Basitleştirin

Modern eCommerce’da hızlı ve güvenilir kargo, sadece hoş bir özellik değil; başarı için kritik bir faktördür. Müşteriler, uluslararası siparişlerde şeffaflık, hız ve adil fiyatlar beklemektedir. Geliştiriciler için birden fazla kargo taşıyıcısıyla entegre olmak, fiyatları hesaplamak, gönderileri takip etmek ve gümrük belgelerini hazırlamak büyük bir baş ağrısı olabilir. Neyse ki, lojistik zorluklarını yönetme yeteneğine sahip platformlar mevcuttur ve bu platformlardan biri EasyShip‘dir.

EasyShip Nedir?

EasyShip, dünya çapında 550’den fazla kargo servisine bağlanabilen hepsi bir arada bir kargo platformudur. Online mağazalar, pazar yerleri ve büyük işletmeler, kargo süreçlerini otomatikleştirmek ve optimize etmek için bu platformdan faydalanmaktadır. EasyShip, %91’e kadar indirimli tarifeler, otomatik vergi ve gümrük hesaplamaları, takip ve iade için araçlar sunmaktadır. eBay ve Shopify gibi devler, küresel operasyonlarını genişletmek için EasyShip’i kullanmaktadır.

EasyShip API’sinin temel özellikleri şunlardır:

• Fiyat Karşılaştırması: Yüzlerce taşıyıcıdan gerçek zamanlı kargo fiyatları alın.
• Etiket Üretimi: Kargo etiketlerini toplu olarak oluşturun ve yazdırın.
• Takip: Gönderi durumunu webhook bildirimleri ile izleyin.
• Gümrük İşlemleri: Otomatik olarak gümrük vergisi ve harçlarını hesaplayın (DDP veya DDU).
• İade Yönetimi: Ön ödemeli iade etiketleri oluşturun.

easyship-php: EasyShip API için PHP/Laravel İstemcisi

PHP ve Laravel ile çalışan geliştiriciler için EasyShip ile entegrasyonu kolaylaştıran yeni bir araç ortaya çıktı: tigusigalpa/easyship-php kütüphanesi. Bu SDK, 348’den fazla EasyShip API endpoint’i için tam destek sunmakta ve entegrasyon sürecini önemli ölçüde basitleştirmektedir.

Kütüphane, modern PHP standartları (PSR-4/PSR-12) ile inşa edilmiş olup, PHP 8.1+ ve Laravel 9-12 sürümlerini desteklemektedir. Aşağıdaki temel özellikleri içermektedir:

• Tam API Kapsamı: Tüm mevcut EasyShip API yöntemleri uygulanmıştır.
• Laravel Entegrasyonu: Servis sağlayıcı, facade ve yapılandırma dosyası içerir.
• OAuth 2.0 Desteği: Partner entegrasyonlarının oluşturulmasını kolaylaştırır.
• Webhook İşleme: Güvenli bildirim işleme için yerleşik imza doğrulaması.
• Tiplenmiş İstisnalar: API hata durumlarının yönetimini kolaylaştırır.
• Otomatik Yeniden Deneme: Geçici ağ hatalarında güvenilirlik sağlar.
• Sandbox ve Üretim Desteği: Ortamlar arasında kolayca geçiş yapma olanağı sunar.

Hızlı Başlangıç

Kütüphaneye başlamak oldukça basittir. Öncelikle, Composer aracılığıyla yükleyin:

composer require tigusigalpa/easyship-php

Bağımsız bir PHP Projesi için:

use Tigusigalpa\EasyShip\EasyShipClient;

$client = new EasyShipClient([
    'api_token' => 'sand_xxxxxxxxxxxxxxxx', // veya prod_xxxxxxxxxxxxxxxx
    'timeout' => 30,
    'retry' => 3,
]);

$shipments = $client->shipments()->list();

Laravel Projesi için:

1. Yapılandırma dosyasını yayımlayın:

   php artisan vendor:publish --tag=easyship-config
   

2. .env dosyanıza API anahtarınızı ekleyin:

   EASYSHIP_API_TOKEN=sand_xxxxxxxxxxxxxxxx
   

3. Facade veya bağımlılık enjeksiyonu kullanın:

   use Tigusigalpa\EasyShip\Laravel\Facades\EasyShip;
   
   // Facade ile
   $shipments = EasyShip::shipments()->list();
   
   // Bağımlılık Enjeksiyonu ile
   use Tigusigalpa\EasyShip\EasyShipClient;
   
   class ShippingController extends Controller
   {
       public function __construct(private EasyShipClient $easyship) {}
   
       public function index()
       {
           $shipments = $this->easyship->shipments()->list();
       }
   }
   

Sonuç

EasyShip, uluslararası kargoları otomatikleştirmek için güçlü bir çözüm sunmakta ve easyship-php kütüphanesi, PHP ve Laravel projelerine entegrasyonunu son derece basit ve hızlı hale getirmektedir. Tam API kapsama alanı, modern mimarisi ve pratik framework entegrasyonu ile bu SDK, e-ticaret işinizi küresel bir seviyeye taşımak isteyen geliştiriciler için vazgeçilmez bir araç haline gelecektir.

EasyShip API ile çalışmak için güvenilir ve işlevsel bir çözüm arıyorsanız, bu kütüphaneye göz atmayı unutmayın.