Hepsiburada entegrasyon işlemlerinizde karşılaşacağınız teknik problemler için incelemeniz gereken dokümana Sıkça Sorulan Sorular sayfasından ulaşabilirsiniz.
Test portalınıza mailde iletilen test portal username, password bilgileri ile Merchant SIT Portal sayfasından giriş yapabilirsiniz.
Yetki Basic authentication üzerinden kurulmaktadır. Ek olarak heder alanında user-agent girilerek işlemlerinize başlayabilirsiniz.
Sipariş entegrasyonu önemli bilgiler sayfamıza göz atmanızı öneririz. Bu sayfada teknik dışında business kurallar ve diğer süreçsel bilgiler yer almaktadır.
Sipariş Entegrasyonu (Genel Kurgu):
Önemli Not: Siparişin ilk statüsü ödemesi tamamlanmış siparişler üzerinden iletilir(Paketlenecek). Bu adımdan sonra siparişin API üzerinden paketlenmesi gerekmektedir. Bu paketleme işlemi iki farklı yöntemle yapılabilir. Sipariş kurgusu bu 2 yönteme göre farklılık gösterecektir, test ortamında bu iki yapıdıda test edebilirsiniz. Fakat canlıya geçmeden önce hangi yöntem ile ilerlenecek ise sorun yaşanmaması adına buna uygun kurguyla geçiş yapılmasını rica ederiz.
- HB otomatik paketleme : HB sizin yerinize sipariş geldikten sonra 15 dakikalık süre içerisinde otomatik olarak paketlemektedir. Bu sayede ödemesi tamamlanmış siparişleri listelemenize gerek kalmadan işlemlerinize direk paketlenmiş siparişleri alarak devam edebilirsiniz. ğer yapınız gereği stockout ihtimaliniz yoksa bu durumda bu yapıyı kullanmanızı öneririz.
- API üzerinden paketleme: Bu yapıda sizler öncelikle ödemesi tamamlanmış siparişleri listelersiniz, ardından burdan aldığınız id değeri ile aynı pakete konulabilecek kalemleri listelersiniz sonrasında kalem veya kalemleri paketleme methoduyla paketleme işleminizi tamamlayabilirsiniz. Eğer yapınız gereği stockout ihtimaliniz varsa bu durumda bu yapıyı kullanmanızı öneririz.
HB otomatik paketleme kullanıldığı durumda yapılacak kurgu :
Not: Canlı ortamda otomatik paketlemeyi canlı ortam Merchant portaldan girerek aşağıdaki adımları takip edip açabilirsiniz. Test ortamı için ise test ortam Merchant panelizine girerek aşağıdaki adımları takip edip otomatik paketlemenizi aktif hale getirebilirsiniz.
Tek bir paket olarak hazırlansın : Otomatik paketleme tek paket olarak seçilmesi en uygun olan yapıdır. Bu yapıda sipariş içerisindeki kalemler tek paket içerisinde toplanır(Eğer kargo firmaları aynı ise). Bu sayede kargo maliyeti en az seviyeye indirilir. Ekstra bir gereklilik yoksa bu yapının kullanılmasını öneririz.
Ayrı ayrı hazırlansın : Otomatik paketleme ayrı ayrı hazırlansın seçeneği digital ürün gönderimi yapan firmalar(Kargo olmadığı için maliyet yaratmaz) yada digital ürün satanların dışında ekstra kendi süreçleri buna uygun firmalar tarafından seçilir. Kargo maliyeti yükselir.
Merchant SIT(Test) Portal > Ayarlarım > Açılan pencerede diğer ayarlarım > Siparişler otomatik kargoya hazırlansın mı? ”Evet” > Siparişler otomatik olarak hangi şekilde kargoya hazırlansın ? “ Tek bir paket olarak hazırlansın” seçilmesi yeterlidir.
- Test Siparişi Oluşturma : Bu işlev yalnızca TEST ortamında mevcuttur. Testlerinizi tamamlayabilmeniz için sipariş oluşturmanıza olanak tanır.
- Saticiya Ait Paket Bilgilerini Listeleme : Paketlenmiş siparişleri listelemenizi sağlar.
- Bozulan (Unpack) Paket Bilgilerini Listeleme : Bu metod merchant’ların unpacked olan paketlerini görüntüleyebilmelerini sağlamaktadır.
- Paket Bozma : Eğer bir sebepten dolayı paketi iptal etmek istiyorsanız bu yapıyı kullanabilirsiniz.
- İptal Bilgisi Gonderme : Bu method ile paket içerisindeki sipariş kalemlerine iptal bilgisi gönderebilirsiniz. Bu yapı kullanılacak ise siparişin paketli durumda olmaması gerekir, önce yukarıdaki method ile paket bozulmalıdır.
- Paket Bölme : Bu method ile bir paket içerisindeki kalemleri veya kalemlerin adetlerini birden fazla paket haline getirebilirsiniz. Aynı zamanda paketli halde kalemlere iptal bilgisi gönderilmesini sağlar. Her bölme işleminden sonra paket numarası değişir.
- Fatura Linki Gonderme : Merchant tarafından kendi sisteminde yaratılmış E-Arşiv fatura bilgisini Hepsiburada sistemine transfer ederek müşteri (hepsiburada.com üzerinden sipariş veren) ile faturanın paylaşılması için bu method kullanılacaktır.
API üzerinden paketleme kullanıldığı durumda yapılacak kurgu :
- Test Siparişi Oluşturma : Bu işlev yalnızca TEST ortamında mevcuttur. Testlerinizi tamamlayabilmeniz için sipariş oluşturmanıza olanak tanır.
- Ödemesi Tamamlanmış Siparişleri Listeleme : Bu metod ödemesi tamamlanmış (Paketlenecek durumdaki) siparişleri listeleyebilmenize olanak tanır.
- İptal Siparis Bilgileri Listeleme : Bu metod satıcıya ait iptal edilen sipariş ve kalem bilgilerine ulaşmanıza olanak tanır.
- Ayni Pakete Konulabilecek Kalemleri Listeleme : Bu metod aynı müşteriye gidecek olan tek paket içerisine girebilecek kalemleri görebilmenize olanak tanır.
- Kalem veya Kalemleri Paketleme : Bu metod kalem veya kalemleri paketlemenize olanak tanır.
- Bozulan (Unpack) Paket Bilgilerini Listeleme : Bu metod merchant’ların unpacked olan paketlerini görüntüleyebilmelerini sağlamaktadır.
- Paket Bozma : Eğer bir sebepten dolayı paketi iptal etmek istiyorsanız bu yapıyı kullanabilirsiniz.
- İptal Bilgisi Gonderme : Bu method ile paket içerisindeki sipariş kalemlerine iptal bilgisi gönderebilirsiniz. Bu yapı kullanılacak ise siparişin paketli durumda olmaması gerekir, önce yukarıdaki method ile paket bozulmalıdır.
- Paket Bölme : Bu method ile bir paket içerisindeki kalemleri veya kalemlerin adetlerini birden fazla paket haline getirebilirsiniz. Aynı zamanda paketli halde kalemlere iptal bilgisi gönderilmesini sağlar. Her bölme işleminden sonra paket numarası değişir.
- Fatura Linki Gonderme : Merchant tarafından kendi sisteminde yaratılmış E-Arşiv fatura bilgisini Hepsiburada sistemine transfer ederek müşteri (hepsiburada.com üzerinden sipariş veren) ile faturanın paylaşılması için bu method kullanılacaktır.
Not : Canlıda sorun yaşanmaması adına yukarıdaki ilettiğimiz methodların kesinlikle kullanılmasını öneriyoruz. Bunun haricinde ihtiyaçlarınıza göre aşağıdaki methodlarımızı da kullanabilirsiniz. Aşağıda opsiyonel olarak belirttiğimiz methodlarımız hakkında bilgilendirme yapılmıştır.
Diğer(Opsiyonel) methodlar hakkında bilgiler:
- Paketli Siparisin Hangi Kargo Firmasi Ile Degistirilebilecegini Listeleme : Paketli siparişin hangi kargo firması ile değiştirileceğini listeler.
- Paketli Siparisin Kargo Firmasini Degistirme : Bu method ile paketli siparişin seçtiğiniz kargo firmasına revize işlemini yapabilirsiniz.
- Paketlenecek Siparisin Hangi Kargo Firmasi Ile Degistirilebilecegini Listeleme : Bu method Open statüdeki siparişlerin kargo firmalarının değiştirilmesine olanak tanır. Bu alanda sadece değiştirebileceğiniz kargo firmaları listelenir.
- Paketlenecek Siparisin Kargo Firmasini Degistirme : İlk olarak Ödemesi tamamlanmış siparişler endpointinden listelediğiniz kalemlere ait lineitemId bilgisini almanız gerekmektedir. Daha sonra listelenen kargo firmaları içerisinde ShortName değeri ile güncelleme işlemini bu servis ile yapabilirsiniz.
- Ödemesi Beklenen Siparisleri Listeleme : Bu metod ödemesi tamamlanmamış (fraud kontrolü , havale ödemeleri) yeni siparişleri listeleyebilmenize olanak tanır.
- Teslim Edilen Siparislerin Listelenmesi : Bu metod satıcıya ait kargodan müşteriye teslim edilen sipariş bilgilerine ulaşmanıza olanak tanır.
- Kargoya Verilen Siparislerin Listelenmesi : Bu metod korgoda olan siparişlerinizi listeler.
- Teslim Edilemedi Siparislerin Listelenmesi : Bu metod satıcıya ait kargodan teslim edilemeyen sipariş bilgilerine ulaşmanıza olanak tanır.
- Siparise Ait Detay Listeleme : Bu metod bir siparişe ait kalemlerin detaylarını listelemenize olanak tanır.
- Paket Icin Kargo Bilgilerini Listeleme : Bu metod bir paketin taşıma durumunu ve kargo takip bilgisine ulaşmanıza olanak tanır.
Digital ürün kategorisi kod gönderimi sipariş entegrasyonu kurgusu :
Not: Digital ürün kullanan firmalar için Canlı ortamda otomatik paketleme aktif ve kalem kalem paketleme seçili olarak gelecektir. Test ortamı için ise sizler test ortam Merchant panelizine girerek aşağıdaki adımları takip edip otomatik paketlemenizi aktif hale getirebilirsiniz.
Merchant SIT(Test) Portal > Ayarlarım > Açılan pencerede diğer ayarlarım > Siparişler otomatik kargoya hazırlansın mı? ”Evet” > Siparişler otomatik olarak hangi şekilde kargoya hazırlansın ? “ Ayrı Ayrı Hazırlansın” seçilmesi yeterlidir.
- Test Siparişi Oluşturma : Bu işlev yalnızca TEST ortamında mevcuttur. Testlerinizi tamamlayabilmeniz için sipariş oluşturmanıza olanak tanır. Cargocompanyid değerinin 89100 olarak gönderilmesi gerekmektedir. Aksi takdirde süreçleri ilerletemezsiniz.
- Saticiya Ait Paket Bilgilerini Listeleme : Paketlenmiş siparişleri listelemenizi sağlar. Kod gönderim kurgunuza göre müşteri mail adresi ve telefonu response içerisinde iletilecektir. Hangisi kullanılacak ise alınıp quantity miktarı kadar kod gönderimi yapılmalı ve ardından aşağıdaki süreçler işletilmelidir.
- Teslimat Statusu Iletme (Teslim Edildi) : Digital kod gönderimi yapıldığı için direk olarak teslim edildi statüsüne çekilmesi gerekmektedir. Digital kategoride satış yapan merchantlar siparişleri teslim edildiye çekerken digitalCodes, receivedBy, receivedDate alanı göndermesi zorunludur.
- Fatura Linki Gonderme : Merchant tarafından kendi sisteminde yaratılmış E-Arşiv fatura bilgisini Hepsiburada sistemine transfer ederek müşteri (hepsiburada.com üzerinden sipariş veren) ile faturanın paylaşılması için bu method kullanılacaktır.
Yukarıdaki adımları başarılı olarak tamamlamak teknik anlamda listeleme entegrasyonu testinin tamamlanması için yeterlidir. Süreci tamamladıktan sonra canlı ortam bilgileriniz için trackingid değerini aşağıdaki adımları takip ederek bizlere iletmeniz gerekmektedir.
"Canlı Ortam Merchant Panel > Yardım Merkezi > Talepler > Taleplerimi Görüntüle > API Entegrasyon > API Entegrasyon Teknik Destek" adımından ticket açarak talep edebilirsiniz.