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.
Development bilgilerinizi mail yoluyla ilettik. Yetki Basic authentication üzerinden kurulmaktadır. Ek olarak heder alanında user-agent girilerek işlemlerinize başlayabilirsiniz.
Katalog ürün etegrasyonu ö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.
Katalog Ürün Entegrasyonu : Ürün gönderim işlemleriniz için aşağıdaki adımları takip edebilirsiniz. Test işlemlerinde kesin beklenen adımları aşağıda iletiyoruz. Test ortam kategori ağacı ile canlı ortam birebir aynı değildir, bu nedenle canlı ortama geçtikten sonra tekrar kategori ağacını listelemeniz gerekmektedir.
- Yeni ürün yaratma süreci : Eğer HB de bulunmayan ürün gönderimi yapılmak isteniyor ise kategori ağacı yapısı ile aşağıdaki adımların takip edilmesi gerekmektedir.
- Kategori Bilgilerini Alma : Kategoriler çekilerek ürün gönderilecek kategori belirlenir.
- Kategori Özelliklerini Alma : Belirlenen kategorinin attribute değerleri listelenir. Mandatory : true olanlar kesin gönderilmesi gerekenlerdir.
- Kategori Özellik Değerlerini Alma : Attribute statüsü enum olanlar listelenir. Eğer enum içerisinde elinizdeki değer yoksa direk olarak kendi değerinizi gönderebilirsiniz.
- Ürün Bilgisi Gönderme : Yukarıdaki adımlar tamamlanarak json file olarak ürünler oluşturulur ve gönderim işlemi tamamlanır.
- Ürün Durumu Sorgulama : Ürün gönderimi işleminden sonra sistem bir trackingid değeri oluşturur bu değer ile ürün gönderimi işleminin sonucunu sorgulamanız gerekmektedir. Hata mesajları kontrol edilerek ilgili aksiyonlar alınmalıdır.
- Eşleşen Statü Onay : Oluşturulan ürünler eğer HB de bulunuyor ise ürün durumu sorguladığınızda eşleşen statüsüne düşecektir. Bu statüdeki ürünleri kontrol ederek eğer sizin gönderdiğiniz ürün ile aynı ürün olduğunu teyit ederseniz bu durumda onay gönderebilirsiniz. Eğer farklı ürün ise red göndermeniz gerekmektedir. Bu methodu test etmek için sadece ilettiğimiz barkodları kullanmanız gerekmektedir. 7541828790114, 7541828790155, 7541828790080.
- Eşleşen Statü Red :Oluşturulan ürünler eğer HB de bulunuyor ise ürün durumu sorguladığınızda eşleşen statüsüne düşecektir. Bu statüdeki ürünleri kontrol ederek eğer sizin gönderdiğiniz ürün ile aynı ürün olduğunu teyit ederseniz bu durumda onay gönderebilirsiniz. Eğer farklı ürün ise red göndermeniz gerekmektedir. Bu methodu test etmek için sadece ilettiğimiz barkodları kullanmanız gerekmektedir. 7541828790114, 7541828790155, 7541828790080.
Not : Ürün gönderimi işlemi için oluşturulan json file içerisine istediğiniz miktarda ürün girebilirsiniz. Varyantlı ürün oluşturmak için, VaryantGroupID değerinin varyantlanacak ürünler arasında aynı değerde gönderilmesi gerekmektedir. Ek olarak varyantlı ürün oluşturabilmek için kategori özelliklerini alma içerisindeki varyant attribute alanından en az 1 tanesinin dolu gönderilmesi gerekmektedir. Diğer methodlar isteğe bağlı olarak kullanılabilir, aşağıda methodlar ve açıklamaları iletilmiştir.
- Hızlı Ürün Yükleme: Method hızlı ürün yüklenebilmesi adına oluşturulmuştur. Hızlı ürün yükleme ile kategori ağacı yapısı çekilmeden en az bilgi ile ürün gönderimi sağlanabilir. Dikkat edilmesi gereken nokta, bu method ile sadece HB de bulunan ürünler yüklenebilir, HB de bulunan ürünler eşleşen statüsüne düşecektir. HB de bulunmayan ürünler ise işleme alınmayacaktır ve yukarıda bahsedilen yeni ürün yaratma süreci adımlarının takip edilerek gönderim sağlanması gerekmektedir.
- Hızlı Ürün yükleme : Merchantid, Merchantsku, productname, barcode alanları ile çok az bilgi göndererek ürün HB de varsa eşleşen statüsüne düşürülebilir.
- Ürün Durumu Sorgulama : Ürün gönderimi işleminden sonra sistem bir trackingid değeri oluşturur bu değer ile ürün gönderimi işleminin sonucunu sorgulamanız gerekmektedir. Hata mesajları kontrol edilerek ilgili aksiyonlar alınmalıdır.
- Eşleşen Statü Onay : Oluşturulan ürünler eğer HB de bulunuyor ise ürün durumu sorguladığınızda eşleşen statüsüne düşecektir. Bu statüdeki ürünleri kontrol ederek eğer sizin gönderdiğiniz ürün ile aynı ürün olduğunu teyit ederseniz bu durumda onay gönderebilirsiniz. Eğer farklı ürün ise red göndermeniz gerekmektedir. Bu methodu test etmek için sadece ilettiğimiz barkodları kullanmanız gerekmektedir. 7541828790114, 7541828790155, 7541828790080.
- Eşleşen Statü Red :Oluşturulan ürünler eğer HB de bulunuyor ise ürün durumu sorguladığınızda eşleşen statüsüne düşecektir. Bu statüdeki ürünleri kontrol ederek eğer sizin gönderdiğiniz ürün ile aynı ürün olduğunu teyit ederseniz bu durumda onay gönderebilirsiniz. Eğer farklı ürün ise red göndermeniz gerekmektedir. Bu methodu test etmek için sadece ilettiğimiz barkodları kullanmanız gerekmektedir. 7541828790114, 7541828790155, 7541828790080.
Not : Ürün yaratma süreci iki adımlı bir süreçtir ürünler gönderildikten sonra HB de bulunmayan ürünler için Business kontroller başlar ve ürün durumu sorgulama içerisinden “katalog sürecinde” statüsünde dönüş sağlanır. Bu statüdeki ürünler Business ekiplerimiz tarafından kontrol edilir ve hatalı bir durum yoksa listing yaratılmış olur. Listing yaratılan ürünlerin statüsü ürün durumu sorgulama servisinde “Yaratıldı” yada "satışa hazır" olarak dönmektedir. Eğer eksik gönderim yada hatalı gönderim varsa ürün durumu sorgulama servisi içerisinden “eksik bilgi” statüsünde dönüş sağlanır. Bu statüdeki ürünler için hatalı kısımlar revize edilerek tekrar gönderim sağlanması gerekmektedir.
Diğer(Opsiyonel) methodlar hakkında bilgiler:
- Aksiyon Bekleyen Ürünleri Silme : Bu metod ile katalog entegrasyon ile girişi yapılmış olan ancak herhangi bir nedenden dolayı onaylanmamış, envantere yansımayan ürünleri aksiyon bekleyenlerden silmenize yarar. Katalog sürecinde, yaratıldı, satışa hazır durumdaki ürünler silinemez.
- Aksiyon Bekleyen Ürün Silme İşlem Kontrolü : Bu method ile aksiyon bekleyen ürünleri sildikten sonra başarı durumunu kontrol edebilirsiniz.
- Ürüne Ait Statü Bilgisi Çekme : Bu method ile bir Merchant'a ait ürünlerin tekil şekilde statü bilgilerine listeleyebilirsiniz.
- Statü Bazlı Ürün Bilgisi Çekme : Bu method ile bir Merchant’a ait bütün ürünlerin toplu şekilde statü bilgileri listeleyebillirsiniz.
- Mağaza Bazlı Ürün Bilgisi Listeleme : Bu metod ile mağazaların tüm ürünlerinin (ürün özellik değerleriyle birlikte) api üzerinden listeleyebilirsiniz. Bu servisle artık mağazaların entegratör değişikliği yaptığı durumlarda eski çalıştığı entegratörden ürün bilgilerini talep etmesine gerek kalmayacak, Hepsiburada API servisi üzerinden bütün ürün bilgilerini listeleyebilecektir. Bu endpoint firmanın katalog ürün entegrasyonundan yüklenen ürünlerini listelemektedir. Hepsiburada katalogundan envanterde açılanların bilgileri dönülmemektedir.
Test ortamında gerçekten bir ürün yaratma süreci olmadığı için yukarıdaki adımları başarılı olarak tamamlamak teknik anlamda testin 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.