Mağaza hesabı modeli ile kendi carinizden kargo çıkış süreci için kullanılacak olan teknik süreç dokümanıdır.
Eğer kendi carinizden çalışmak istediğiniz kargo firması aşağıdakilerden biri ise mağaza hesabı modeli değil satıcı öder modelini kullanabilirsiniz. Satıcı öder modelinde teknik ek adımlar bulunmamaktadır. Satıcı öder modelini destekleyen kargo firmaları aşağıdaki gibidir:
- MNG Kargo
- Sürat Kargo
- PTT Kargo
- Horoz Lojistik
Bu sürece geçmek için "Merchant Panel > Yardım > Satıcı Destek Talep Formu" talep formu açarak talebinizi iletebilirsiniz.
Mağaza Hesabı Sıkça Sorulan Sorular
Değerli iş ortağımız,
Hepsiburada Entegrasyon ekibi olarak, teknik destek beklenen konularda Satıcı destek bölümünden açılan ticketlar üzerinden destek verilmektedir. Bu kapsamda; Bizden destek beklediğiniz konularda aşağıdaki belirtilen adımları izleyip bize ticket açarak iletmenizi rica ediyoruz.
Canlı Ortam Merchant Panel > Yardım > Satıcı Destek Talep Formu > API Entegrasyon > API Entegrasyon Teknik Destek
Desteğiniz ve işbirliğiniz için teşekkürler
| Soru | Cevap |
|---|---|
| Siparişlerimde il kısıtım var ne yapmalıyım ? | Teslimat olmayan illerin listesini Hepsiburada panel’inizden satıcı destek üzerinden ticket ile iletilmesi gerekir. Daha farklı bir ayrıma yada ilçe bazlı ayrım uygulanamaz. Il kısıtınız bulunmuyorsa bu adımda bir işlem yapmanıza gerek bulunmuyor. |
| Mağaza hesabımda kendi araçlarımız ile dağıtım yada kendi anlaşmalı oldugum kargo firması olması bir etken midir ? | Hayır kendi carinizde kendi anlaşmalı oldugunuz kargo firması da kullanabilirsiniz, yada kendi lojistiğinizle dağıtım yapabilirsiniz. Siparişi paketlerken “Mağaza Hesabı kalem-veya-kalemleri-paketleme “ linkindeki sayfada “Mağaza hesabı paketleme servisi” adı altında bulunan body ile endpoint çağırılması gerekir. cargoCompany”:”MP” sabit kalmalı “carrier”:”XX” alanı kendi lojistik ile dağıtımda ET olarak güncellenir, kendi carinizle bir kargo firması kullanılacak ise carrier alanına “Carrier Shortname” den alınan kısaltması kullanılmalıdır. |
| Kendi carim ile beraber Hepsiburada anlaşması üzerinden kargo kullanabilir miyim ? | İki yapıyıda kullanmak isteniyorsa bir listing üzerinden kullanılamaz, listing bazlı ayrım yapılmalıdır. Hangi listingler kendi cari’nizden hangileri Hepsiburada anlaşmalı kargodan çıkacak excel olarak ayrıştırılıp satıcı destek üzerinden açılacak ticket ile iletilmesi gerekir. Kendi cariniz üzerinden çıkacak listingler “Magaza hesabı” Hepsiburada anlaşması kullanılacak listingler kullanılacak kargo firmasına ticket içerisinde bildirilip güncellenmesi gerekir. |
| Mağaza hesabı kargo sürecinde kargo statüleri nasıl takip edilecek ? | Mağaza hesabı yapısına geçildiği zaman artık kargolama ve Hepsiburada üzerindeki kargo takip kısmı tarafınızdan endpoint’ler ile doldurulması gerekir. Ürün kargolandıgında anlaşmalı olduğunuz kargo firmasından alınan barkod “intransit” statüsüne geçtiğinde Hepsiburada üzeride de sipariş’in statüsünün intransit durumuna alınması gerekir, teslim edildiğinde de “deliver” veya teslim edilemedi durumunda ise “undeliver” statulerine endpointler ile alınması gerekir. NOT: Undeliver statüsü gönderildiğinde sipariş iptal olmaktadır. Bu sebeple kargo firmasının trycount’u (tekrar teslim deneme sayısı) tamamlandıgında gönderilmesi gerekir. |
| Test sürecini tamamladıktan sonra ne yapmalıyım ? | Testleriniz tamamlandıgında ticket üzerinden “mağaza hesabı kargo sürecinize ait testlerin tamamlandıgına dair” bilgi paylaşılması gerekir. Kontrol edilerek başarılı gözüküyor ise, mevcuttaki listinglerin mağaza hesabı olarak güncellenmesi için 3 ‘uncü soruda belirttiğimiz üzere ticket açarak talep iletilmesi gerekmektedir. Sonrasında canlı ortam bilgilerinizi kullanarak test ortamlarında deneyimlediğiniz gibi sipariş yapınızda artık mağaza hesabı enpointlerini kullanmanız gerekir. Bu süreçte Hepsiburada üzerinden otomatik paketleme kullanılmaması gerekir. |
| Herhangi bir IP kısıtlaması var mıdır ? | Endpoint’lerimizde IP kısıtlaması bulunmuyor. |
| Entegratör kullanıyorum, burada süreci nasıl ilerletmem gerekir ? | Yeni bir süreç olduğu için entegratörünüzde bu yapı kurulu olmayabilir. Bunun için sizinle paylaştığımız döküman ve süreç bilgisini entegratörünüze iletmeniz gerekmektedir. Eğer entegratörünüz bu yapıda bir destek sağlamayacak ise entegratör değişikliği yapabilir yada kendi iç sürecinizde değerlendirebilirsiniz. |
NOT
Test yada canlı ortam için kullanımlarınızda karşılaşacağınız teknik sorular için ticket açarak iletebilirsiniz.
Test için Sipariş Oluşturma
Bu işlev yalnızca TEST ortamında mevcuttur. Mağaza Hesabı testlerinizi tamamlayabilmeniz için sipariş oluşturmanıza olanak tanır.
- Request body içinde "CargoCompanyId":89100 olarak giriş sağlanması gerekir.
Oluşturulan test siparişi "Ödemesi tamamlanmış siparişleri listeleme" servisinden alınırken mağaza hesabı olup olmadığı cargoCompanyModel alanındaki id değerinin 89100 olmasına bakılarak belirlenebilir.
Teslimat Statü İletme
NOT
Statü iletme tarihleri aşağıdaki sıra ile olmalıdır.
- Intransit statü tarihi , paketleme tarihinden önce olmamalıdır.
- Deliver statü tarihi , intransit statü tarihinden önce olmamalıdır.
İntransit, deliver statüye alırken body içerisinde gönderilen tarih bilgileri son 7 günden eski tarih gönderilemez. Gönderilme durumunda hata alınacaktır.
Bu kurala uymayan statü iletme denemeleri hata alacaktır.
InTransit Status (Kargoda)
Mağaza Hesabı modelinde sipariş entegrasyonu üzerinden oluşturduğunuz paketin packagenumber bilgisi ile ilk aşamada InTransıt statüsüne çekilmesi gerekmektedir.
| Alan Adı | Açıklama |
|---|---|
| shippedDate | Paketin kargoya veriliş tarihi |
| estimatedArrivalDate | Paketin tahmini teslim tarihi |
| trackingUrl | Kargo takip Url’i |
| trackingNumber | Kargo takip numarası |
| trackingPhoneNumber | Kargo takip telefon numarası |
| tax | Paketin kdv bilgisi 0 gönderilmelidir. |
| cost | Paketin tutarı (0 gönderilmelidir.) |
| deci | Paketin desi bilgisi |
Delivered Status (Teslim Edildi)
Mağaza Hesabı modelinde InTransit statüsünde bulunan paketlerin son kullanıcıya teslim edildiğinde deliver endpointi üzerinden teslim edildi statüsüne çekilmesi gerekmektedir.
| Alan Adı | Açıklama |
|---|---|
| receivedDate | Paketin teslim tarihi |
| receivedBy | Paketin teslim edildiği kişi bilgisi |
Undelivered Status (Teslim Edilemedi)
Mağaza Hesabı modelinde InTransit statüsünde bulunan paketlerin son kullanıcıya teslim edilemediğinde undelivered endpointi üzerinden teslim edilemedi(undelivered) statüsüne çekilmesi gerekmektedir.
| Alan Adı | Açıklama |
|---|---|
| undeliveredDate | Paketin teslim edilemediği tarih bilgisidir. |
| undeliveredReason | Paketin neden teslim edilemediği bilgisinin iletileceği alandır. Alabileceği değerler : CustomerDoesNotWantProduct (Müşteri ürünü istemiyor) , CustomerUnreachable(Müşteriye ulaşılamadı.) |
NOT
Oluşturmuş olduğunuz paketler için Paket Bilgilerini Listeleme endpointinden paket numarasına ulaşabilirsiniz.
Talep Sonucu Oluşan Teslimat Statüsü İletme
Buradaki servisler ile müşteri tarafından oluşturulan talep sonucunda, paketin tekrar merchant tarafından müşteriye gönderim adımında teslimatın kargo firması “Mağaza Hesabı” olarak oluştuğu durumda kullanılır.
Mağaza hesabı olarak oluşan MerchantToCustomer teslimatının sırası ile önce intransit (Kargoda) sonrasında teslim edilince deliver isteği gönderilmelidir. Eğer kargodan teslimat sağlanamadıysa deliver değil undeliver (Teslim edilemedi) isteği gönderilmelidir.
NOT
Statü iletme tarihleri aşağıdaki sıra ile olmalıdır.
- Intransit statü tarihi , paketleme tarihinden önce olmamalıdır.
- Deliver statü tarihi , intransit statü tarihinden önce olmamalıdır.
Bu kurala uymayan statü iletme denemeleri hata alacaktır.
Talep Kabul/Red sonucu olan paket numarası bilgisine Webhook modelini kullanıyorsanız "Talep Kabul/Red Sonucu Oluşan Paket Bildirimi" modelinde packageNumber alanında iletilmektedir.
Webhook kullanmıyor "Talep Detaylarını Listeleme" üzerinden GET metod ile çekiyorsanız 'Accepted’ yada ‘Rejected’ statüsüne göre listelediğinizde Deliveries alanı altındaki MerchantToCustomer alanında packageNumber bilgisi bulunmaktadır.
Talep Sonucu Oluşan Teslimat için InTransit Status (Kargoda)
Talep Kabul/Red sonucu oluşan Mağaza hesabı olarak oluşan MerchantToCustomer teslimatının paketin packagenumber bilgisi ile ilk aşamada InTransıt statüsüne çekilmesi gerekmektedir.
NOT
İntransit statüye alırken body içerisinde gönderilen tarih bilgileri son 7 günden eski tarih gönderilemez. Gönderilme durumunda hata alınacaktır.
| Alan Adı | Açıklama |
|---|---|
| barcode | Kargo barkod numarası |
| cargoCompany | Kargo firması adı |
| cost | Paketin tutarı (0 gönderilmelidir.) |
| deci | Paketin desi bilgisi |
| Paketin desi bilgisi | Paketin tahmini teslim tarihi |
| packageNumber | Talep Kabul/Red sonucu oluşan paket numarası, Url'de kullanılan paketno ile aynı olmalıdır. |
| shippedDate | Paketin kargoya veriliş tarihi |
| status | Paketin durumu, Created değeri alabilir. |
| tax | Paketin kdv bilgisi 0 gönderilmelidir. |
| trackingNumber | Kargo takip numarası |
| trackingPhoneNumber | Kargo takip telefon numarası |
| trackingUrl | Kargo takip Url'idir. |
Talep Sonucu Oluşan Teslimat için Delivered Status (Teslim Edildi)
Talep Kabul/Red sonucu oluşan Mağaza hesabı olarak oluşan MerchantToCustomer teslimatının InTransit statüsünde bulunan paketlerin son kullanıcıya teslim edildiğinde deliver endpointi üzerinden teslim edildi statüsüne çekilmesi gerekmektedir.
NOT
Deliver statüye alırken body içerisinde gönderilen tarih bilgileri son 7 günden eski tarih gönderilemez. Gönderilme durumunda hata alınacaktır.
| Alan Adı | Açıklama |
|---|---|
| receivedDate | Paketin teslim tarihi |
| receivedBy | Paketin teslim edildiği kişi bilgisi |
Talep Sonucu Oluşan Teslimat için Undelivered Status (Teslim Edilemedi)
Talep Kabul/Red sonucu oluşan Mağaza hesabı olarak oluşan MerchantToCustomer teslimatının InTransit statüsünde bulunan paketlerin son kullanıcıya teslim edilemediğinde undelivered endpointi üzerinden teslim edilemedi (undelivered) statüsüne çekilmesi gerekmektedir.
| Alan Adı | Açıklama |
|---|---|
| undeliveredDate | Paketin teslim edilemediği tarih |
| undeliveredReason | Paketin neden teslim edilemediği bilgisinin iletileceği alandır. Alabileceği değerler : CustomerDoesNotWantProduct (Müşteri ürünü istemiyor) , CustomerUnreachable(Müşteriye ulaşılamadı.) |