Kargo Entegrasyonu
Hepsijet API ve Hepsijet Entegrasyonu: Hazır Uygulama mı, Özel Bağlantı mı?
Hepsijet API, Hepsijet ile anlaşmalı işletmelerin gönderi kaydını, etiketini ve takip bilgisini kendi sistemlerinden yönetmesini sağlar. Shopify'da hazır bir uygulama çoğu zaman yeter; ERP ve özel sitelerde bağlantıyı API ile kurarız.
Hepsijet API, Hepsijet ile anlaşmalı bir işletmenin gönderi kaydını açmasını, barkod etiketini almasını ve gönderinin durumunu kendi sisteminden izlemesini sağlayan entegrasyon servisidir. Hepsijet, Hepsiburada'nın kargo şirketidir ve yalnızca pazaryeri siparişlerini değil, kendi sitenizden gelen siparişleri de taşır. Hepsijet entegrasyonu için iki yol var: hazır bir uygulama ya da Hepsijet API'siyle size özel bir bağlantı.
Baştan belirtelim: Hepsijet için kendi geliştirdiğimiz bir uygulama ya da hazır bir entegrasyon paketimiz yok. Bir Shopify mağazasında Hepsijet gönderimlerini hazır bir uygulamayla kurup mağazanın Hepsijet hesap bilgileriyle ayarladık. Hazır uygulamanın yetmediği durumlarda bağlantıyı Hepsijet API'siyle, Shopify için yayında olan Yurtiçi Kargo uygulamamızda kullandığımız mimariyle size özel yazarız. Tüm kargo firmalarını kapsayan yaklaşımımız kargo entegrasyonu sayfasında.
Hepsijet entegrasyonu için hazır uygulama mı, özel API bağlantısı mı?
| Kriter | Hazır uygulama | Hepsijet API ile özel entegrasyon |
|---|---|---|
| Başlangıç | Kurulum ve ayarla hızlı | Analiz, geliştirme ve test gerektirir |
| Maliyet yapısı | Uygulamaya göre aylık abonelik ya da kullanım ücreti | Geliştirme bedeli, ardından barındırma ve bakım |
| Uygun olduğu sistem | Shopify gibi uygulama mağazası olan altyapılar | ERP, depo yazılımı, özel site ve özel kuralları olan Shopify mağazaları |
| Kurallar | Uygulamanın ayarlarıyla sınırlı | Depo, paket bölme, firma seçimi ve belge kurallarınıza göre yazılır |
| Diğer kargo firmaları | Uygulamanın desteklediği firmalarla sınırlı | Aynı ekranda birden fazla firma, kurala bağlı seçim |
| Bakım | Uygulama geliştiricisi üstlenir | Bakım kapsamında güncellenir |
Karar için basit bir kural: Siparişleriniz Shopify'da, tek depodan çıkıyor ve özel paketleme kuralınız yoksa hazır bir uygulamayla başlayın. Gönderiyi ERP'den ya da depo yazılımından açıyorsanız, birden fazla depo veya gönderici adresiniz varsa ya da Hepsijet'i başka kargo firmalarıyla aynı ekranda kurala bağlamak istiyorsanız Hepsijet API'siyle özel entegrasyon daha doğru olur.
Hepsijet API ile neler yapılabilir?
Kargo entegrasyonlarının temel işlemleri Hepsijet'te de bağlantının omurgasını oluşturur. Entegrasyon servisine erişim, Hepsijet ile anlaşma yapıldıktan sonra verilen kullanıcı bilgileriyle açılır; servisin yapısı ve kimlik doğrulama yöntemi Hepsijet'in anlaşmalı firmalara verdiği dokümanda tanımlanır. Hangi işlemlerin anlaşmanızda açık olduğunu ve alan adlarını Hepsijet'in size verdiği güncel dokümandan kontrol ederiz.
| İşlem | Ne yapar | Dikkat edilecek nokta |
|---|---|---|
| Gönderi oluşturma | Alıcı, adres, parça ve desi bilgisiyle gönderi kaydı açar | Her gönderi için sizin ürettiğiniz benzersiz referans |
| Etiket | Gönderinin barkod etiketini üretir | Termal yazıcı biçimi ya da PDF, çok koli gönderiler |
| Durum sorgulama | Gönderinin hareketlerini ve teslim durumunu döner | Sorguları gruplamak, teslim edilenleri listeden çıkarmak |
| İptal | İşlem görmemiş gönderiyi iptal eder | İşlem görmüş gönderide süreç Hepsijet üzerinden yürür |
| İade | Anlaşmanızda tanımlıysa iade gönderisini oluşturur ya da izler | İadenin stok ve fatura sistemine yansıması |
Gönderi akışı adım adım
- Hazırlanıp paketlenen sipariş seçilir ve gönderi Hepsijet'e bildirilir. Her gönderi, sipariş numarasından türetilen benzersiz bir referansla gider.
- Barkod etiketi termal yazıcıdan ya da PDF olarak basılıp pakete yapıştırılır.
- Takip numarası siparişe yazılır. Shopify'da bu numara gönderi (fulfillment) kaydına eklendiğinde, bildirim ayarınız açıksa müşteriye kargo e-postası gider.
- Açık gönderilerin durumu düzenli sorgulanır. Teslim edildi, teslim edilemedi ve iade gibi durumlar siparişe işlenir.
- Teslim edilen gönderi kapanır ve sorgu listesinden çıkar. Teslim edilemeyen ya da uzun süre hareket görmeyen gönderiler müşteri hizmetlerinin listesine düşer.
Shopify mağazasında Hepsijet kurulumu
Shopify'ın Türkiye'deki kargo firmalarıyla yerleşik bir bağlantısı yok; Hepsijet gönderimleri bir uygulama üzerinden yapılır. Hazır uygulamayla kurulumda dikkat ettiğimiz noktalar:
- Hepsijet hesap bilgilerinin ve gönderici adresinin doğru tanımlanması
- Shopify'daki kargo yöntemlerinin uygulamadaki karşılıklarıyla eşlenmesi
- Ürünlerde ağırlık bilgisinin eksiksiz olması; ölçüler meta alanda tutuluyorsa desiye aktarılması
- Müşteri e-postasındaki takip bağlantısının Hepsijet'in takip sayfasına gitmesi
- Test gönderisiyle etiket, takip numarası ve bildirimin birlikte kontrolü
Shopify'daki diğer kargo seçenekleri Shopify kargo entegrasyonu sayfasında.
ERP ve özel sitede Hepsijet API
Gönderiyi ERP'den ya da depo yazılımından açıyorsanız bağlantıyı doğrudan Hepsijet API'siyle kurarız: irsaliye kesildiğinde gönderi açılır, takip numarası irsaliyeye ve satış kanalına geri yazılır. İstekler kuyrukta işlenir, her çağrı kayda geçer, zaman aşımı gibi geçici hatalar yeniden denenir. Gönderi isteği yanıt vermeden kesilirse kayıt açılmış olabilir; isteği körlemesine tekrarlamak yerine önce referansla sorgularız ki aynı paket için iki gönderi oluşmasın. Mimarinin ayrıntısı e-ticaret ve ERP entegrasyonu sayfasında.
Hepsiburada pazaryeri siparişleri ve Hepsijet
İki konu sık karıştırılır. Hepsiburada'da satış yapıyorsanız pazaryeri siparişlerinin gönderisi çoğunlukla Hepsiburada'nın kendi akışıyla açılır; etiket ve takip bilgisi sipariş paketleriyle gelir ve bunun için ayrı bir Hepsijet entegrasyonu gerekmez. Hepsijet entegrasyonu, kendi sitenizden ya da diğer kanallardan gelen siparişleri kendi Hepsijet anlaşmanızla gönderdiğinizde devreye girer. Pazaryeri tarafını Hepsiburada entegrasyonu sayfasında anlattık.
Hepsijet'i diğer kargo firmalarıyla birlikte kullanmak
Hepsijet'i çoğu zaman başka bir firmayla birlikte kullanırsınız. Firma seçimi bölgeye, desiye, ödeme yöntemine ya da çıkış deposuna göre kurala bağlanabilir; kuralın sonucu siparişe yazılır ve depo ekibi gerekirse gönderiden önce firmayı değiştirir. Teslimat bölgeleri ve ek hizmetler anlaşmanıza göre değişebileceği için kuralı bu bilgiye göre kurarız. Diğer firmalar için Yurtiçi Kargo API entegrasyonu, Aras Kargo entegrasyonu ve MNG Kargo entegrasyonu sayfalarına bakabilirsiniz.
Hepsijet gönderilerinizi siparişe bağlayalım
Siparişlerinizi hangi sistemden yönettiğinizi, günlük gönderi sayınızı ve kaç depodan çıkış yaptığınızı yazın. Hazır uygulamanın mı, Hepsijet API'siyle özel entegrasyonun mu uygun olduğunu söyleyelim.
Kurulum süreci
- Anlaşma ve erişim. Hepsijet'ten entegrasyon erişim bilgileri ve güncel doküman alınır, test imkânı netleşir.
- Yol seçimi. Sisteminize ve kurallarınıza göre hazır uygulama ya da özel entegrasyon kararı verilir.
- Veri hazırlığı. Adres alanları, il ve ilçe eşleşmesi, ürünlerin ağırlık ve ölçü bilgisi kontrol edilir.
- Kurulum ya da geliştirme. Hazır uygulama ayarlanır ya da gönderi, etiket, sorgu ve iptal akışları kuyruk ve hata ekranıyla yazılır.
- Test gönderileri. Etiket, takip numarası ve müşteri bildirimi birkaç gönderiyle denenir.
- Canlı ve izleme. Takılan gönderiler ve hatalı adresler listeden izlenir.
Hepsijet entegrasyonu maliyetini belirleyen kalemler
- Hazır uygulama mı, Hepsijet API ile özel entegrasyon mu
- Gönderinin açılacağı sistem: Shopify, özel site, ERP ya da depo yazılımı
- Depo ve gönderici adresi sayısı
- Etiket biçimi, toplu basım ve çok koli gönderiler
- Durum güncellemesi, müşteri bildirimleri ve iade akışı
- Diğer kargo firmalarıyla kurala bağlı firma seçimi
Kargo tarafındaki işlerimiz
- Bir Shopify mağazasında Hepsijet gönderimlerinin hazır bir uygulamayla kurulumu ve ayarı
- Shopify App Store'da yayında olan Yurtiçi Kargo Entegrasyonu uygulamamız
- Laravel kuyruklarıyla çalışan, hata olunca yeniden deneyen entegrasyonlar
Yayından sonra kargo servislerindeki değişiklikleri bakım ve destek kapsamında izleyebiliriz.
SSS