Sıkça Sorulan Sorular

• Entegratör yetkilendirme işlemlerini nasıl yapabilirim?

  Entegratör firmanızdan Hepsiburada da kullandıgı developer user bilgisini öğrenerek; Merchant panelden sağ üst köşede yer alan mağaza adı alanında menü bilgisine tıklayarak ""Hesabım->Bilgilerim->Entegrasyon->Entegratör bilgileri"" alanından ""Entegratör ekle"" ile entegratörlere yetkilendirme sağlayabilir yada aşağıdaki alandan tanımlı olan entegratörlerinizi görebilirsiniz. Burada silme, ekleme veya tarih bazlı süreli yetkilendirme sağlayabilirsiniz.
  
  Entegratör ekle adımından sonra ""Mağaza ID"" bilginizi ""Hesabım->Bilgilerim->Entegratör bilgileri"" alanından ""Mağaza ID"" kopyalayarak entegratör firmanız ile yetkilendirme sonrası paylaşabilirsiniz.
  
  Yetkilendirmenin devreye girmesi 2 saat kadar zaman almaktadır ilk denemede geçersiz uyarısı alırsanız ilerleyen saatlerde tekrar denemenizi rica ederiz. Hata devam eder ise entegratör firmanız ile iletişime geçerek, yetki işleminde hangi endpoint'e istek gönderilmektedir. Request bilgisi ve response bilgisini entegratör firmanızdan temin edip tarafımıza iletebilir misiniz?

• Entegrasyon ile siparişlerin faturalarını nasıl yükleyebilirim?

  Sipariş faturalarını müşteriye iletmek ve merchant panelinize de aktarabilmek için faturaların pdf formatında ve .pdf uzantılı http url'ini API servisimiz üzerinden paket bazlı bizlere iletebilirsiniz. Fatura Linki Gönderme

• Tanımlı olan ürünlerime ait detay bilgilerini nasıl çekebilirim?

  Hepsiburada sisteminde yüklemiş olduğunuz ürünlerin detylarını
  Statü Bazlı Ürün Bilgisi Çekme servisi üzerinden alabilirsiniz. Bu servisten ürüne ait, ürün adı, varyant bilgisi, görsel gibi bilgileri dönülmektedir.

• Entegratör sisteminde siparişlerim gözükmüyor ne yapabilirim?

  Entegratör sisteminizde sipariş bilgileriniz gözükmüyor ise Merchant Panel üzerinden yetkilendirme işleminiz sağlanmamış olabilir. Merchant panelden sağ üst köşede yer alan mağaza adı alanında menü bilgisine tıklayarak Entegratör bilgileri alanından bu yetkilendirme işlemini kontrol etmeniz gereklidir. Yetkilendirme sonrasında siparişlerinizi Entegratörünüz Hepsiburada üzerinden çekerek sisteminizde gösterecektir.
  
  Sipariş bilgileri entegrasyon firmaları tarafından hepsiburada üzerinden iki yöntem ile çekilmektedir.
  
  1.'si Otomatik paketleme kullanılmıyor ise ""Ödemesi tamamlanmış siparişler"" end-point üzerinden,
  2.'si Otomatik paketleme kullanılıyor ise ""Paket bilgilerini listeleme"" end-point üzerinden,
  
  Sizlerin otomatik paketleme özelliğiniz hepsiburada tarafında açık mı kapalı mı bilgisini merchant panel üzerinden sayfaya girdiğinizde sağ üst köşede yer alan mağaza adınıza tıkladığınızda menüden Hesabım-Ayarlarım-Diğer ayarlar alanından ""Otomatik Paketleme"" alanından kontrol edebilirsiniz.
  
  Otomatik paketleme kapalı ise yani sipariş geldiğinde otomatik olarak gönderime hazır statüsüne geçmemekte tarafınızdan paketleme adımı uygulanarak gönderime hazır statüsüne getirilmesi gerekir. Bu işlemi entegratör üzerinden yada sizler merchant panel üzerinden yapabilirsiniz.
  
  Otomatik paketleme açık ise sipariş geldiğinde 15 dk içinde otomatik olarak gönderime hazır statüsüne geçmektedir. Paketlenen bu siparişleri 2. yöneteme göre çekebilirsiniz.
  
  Entegratör firmanız hangi statüde sipariş bilgisi çektiğini teyit ederek isterseniz otomatik paketleme özelliğinizi hepsiburada tarafında açabilir yada kapatabilirsiniz. Eğer açılmasını istemiyorsanız 1. yöntemdeki metod ile entegratör firmanız sipariş bilgilerinizi çekebilir.

• Entegratör yetkilendirme yaptım ancak hala yetki uyarısı alıyoruz. Ne yapmam gerekir?

  Yetkilendirmenin devreye girmesi 2 saat kadar zaman almaktadır ilk denemede geçersiz uyarısı alırsanız ilerleyen saatlerde tekrar denemenizi rica ederiz. Hata devam eder ise entegratör firmanız ile iletişime geçerek, yetki işleminde hangi endpoint’e istek gönderilmektedir. Request bilgisi ve response bilgisini entegratör firmanızdan temin edip tarafımıza iletebilir misiniz?

• Paketli durumdaki Siparişimin kargo firmasını nasıl değiştirebilirim?

  Paketli durumdaki siparişinizin kargosunu, Merchant Panel üzerinde Gönderime Hazır Statüsünden güncelleyebilirsiniz. Entegrasyon aracılığı ile bu işlemi gerçekleştirmek için Paketli Siparişin Kargo Firmasının Değiştirilmesi servisini kullanabilirsiniz.

• Tanımlı olan ürünlerime ait detay bilgilerini nasıl çekebilirim?

  Paketli durumdaki siparişinizin kargosunu, Merchant Panel üzerinde Gönderime Hazır Statüsünden güncelleyebilirsiniz. Entegrasyon aracılığı ile bu işlemi gerçekleştirmek için Paketli Siparişin Kargo Firmasının Değiştirilmesi servisini kullanabilirsiniz.

• Listing fiyat ve stok güncelleme işlemim yansımadı, nasıl kontrol edebilirim?

  Entegrasyon aracılığıyla fiyat veya stok bilgileri güncelleme işleminde Hepsiburada tarafından response olarak bu işlemin kontrol edilebilmesi için bir ID değeri dönülmektedir. Bu ID üzerinden Entegratör firmanız güncellenen ürünlerin durumunu varsa uyarılarını Listing Güncelleme Sorgulama servislerinden kontrol edebilir.

• Ürünümü satışa kapattım tekrar nasıl açabilirim?

  Satışa kapattığınız ürününüzü Entegrasyon üzerinden fiyat ve stok varsa Listing Satışa Açma servisi ile veya ürüne stok ve fiyat bilgisi besleyerek satışa açabilirsiniz.

• Delivery manipulation hatası almaktayım nasıl ilerleyebilirim?

  Dijital kod bilgisi satan firmalarımız veya kendi anlaşmalı olduğu kargo firması ile siparişlerini çıkacak firmalar için bir tanımlama mevcut olup talebiniz doğrultusunda yetkilendirme işlemi sağlanmaktadır.

• Kendi anlaşmalı kargo firmam üzerinden siparişlerimi çıkabilir miyim?

  Bu süreç için kategori sorumlunuz ile iletişime geçmeniz gerekmektedir.

• Ürünlerimi yükledim fakat panelde gözükmemektedir?

  Merchant Panel üzerinden Aksiyon Bekleyen Ürünler sekmesinden yüklediğiniz ürünleri kontrol edebilirsiniz.Burada barkod ile sorguladığınız ürünler gözükmüyor ise Entegratör üzerinden ürün yükleme sonucu dönen ' Trackingid' değeri ile alınan uyarı bilgisi kontrol ettirebilirsiniz. Alınan bazı spesifik uyarılar aşağıdaki gibidir;
  
  * Aktif olmayan bir kategori üzerinden ürün girişi denendiyse ''message': 'Category is not a leaf category and is not an available category' hatası alınmaktadır.
  Bir kategoriye ürün açılabilmesi için 3 statününde şartlarının sağlanması ve aktif kategori olması gereklidir. .Entegratörünüz tekrar aktif kategorileri listelemeli ve sizler için uygun kategoriyi çekilen data içerisinden seçerek tekrar bu ürünleri gönderilmelidir.
  
  * ""message"": ""Can not update product in matched or in catalog progress status"" uyarısı alındıysa, yüklemeye çalışılan ürünün barkodu daha önceden sizin mağazanıza yüklendiği için güncelleme işlemi gönderilememektedir.Merchant Panel Aksiyon Bekleyen Ürünler sekmesinden ilgili barkod ile ürünün durumunu kontrol edebilirsiniz.

• Kendi entegrasyon yazılımımı yapacagım nasıl bir yol izlemem gerek?

  Merchant panel üzerinden aşağıdaki adımları takip ederek kayıt açabilirsiniz. Talebinize istinaden öncelikle test ortam bilgileri iletilecektir. İletilen test ortamında API model ve süreçlerini test etmeniz ve deneyimlemeniz beklenmektedir. Kullanacağınız modele göre testleri yaptıktan sonra test adımlarının kontrolü ve başarılı ise canlı ortam bilgisi için yine aynı adımlardan kayıt açarak talebinizi iletebilirsiniz.
  
  Canlı Ortam Merchant Panel -> Yardım Merkezi -> Talepler=Taleplerimi Görüntüle. Açılan yeni ekrandan ise; Yeni talep açmak -> API ENTEGRASYON - API Entegratör Yetkilendirme İşlemleri

• Yüklediğim ürünler satışa kapalı kısmında gözüküyor? Satışta kısmına neden geçmiyor?

  Ürün yükleme ile direk ürünler satışa açılmamaktadır. Yeni ürün girişi yapılan ürünler ürün giriş ekiplerince kontrol edilerek onaylanır ve satışa hazır duruma getirilir. Satışa hazır olan listingleri envanter alanında görebilirsiniz. Satışa açmak içinde fiyat stok gönderilerek ürün satışa açılmalıdır. Entegratörünüzden destek talep edere fiyat stok girişi yapabilirsiniz.

• Otomatik paketlemeyi nasıl açabilir/kapatabilirim?

  Otomatik paketleme özelliğini merchant panel üzerinden sayfaya girdiğinizde sağ üst köşede yer alan mağaza adınıza tıkladığınızda menüden Hesabım-Ayarlarım-Diğer ayarlar alanından "Otomatik Paketleme" alanından kontrol edebilirsiniz.

• "exceeds his inventory upload limit" uyarısı alıyorum ne yapmam gerekir?

  Listing güncelleme için aynı anda POST ettiğiniz devam eden / bekleyen işlemlerin sayısı 5’i geçemez. Limit 5 uyarısına takılmamak için tek seferdeki güncellenen sku adetinizi arttırmanızı öneririz. Tek seferdeki istek içinde maximum 4000 adet sku güncellemesi iletilebilir.

• Tanımlı olan listing bilgilerimi nasıl çekebilirim?

  Envanterinizde varolan ürünlerinizi Listing Bilgilerini Çekme servisi üzerinden entegrasyon aracılığı ile çekebilirsiniz. Doküman linkimiz aşağıdaki gibidir. https://developers.hepsiburada.com/?docs=dokuman/listeleme-entegrasyonu/satici-listing-bilgilerini-cekme

• Ürün giriş sürecinde izlenmesi gereken adımlar nelerdir?

  Güncel akışta basic auth kullanılmaktadır. Basic auth ile tüm endpoint'lere authorization sağlanması gerekir.
  
  Developers dökümanındaki örnek bir kategorinin attribüte'leri ile json oluşturma format örneğidir. Sizler kullanacagınız kategorinin bilgisini Kategori Bilgilerini Alma servisinden alınabilir.
  
  Attribüte değerlerini, mandatory true (girilmesi zorunlu özellikleri) bilgisini Kategori Özelliklerini Alma servisinden alınabilir. Kategori altında çekilen attribute değerlerinin mandatory si true olan özelliklerin hepsinin gönderilmesi gereklidir. Ek olarak mandatorysi false olan değerler içinde mapleme yapılıp tarafımıza gönderilmesi ürünün açılması ve search lere takılması için önemlidir. Mümkün olabilecek bütün attributes değerlerinin göndeirilmesi önem arz eder.
  
  Kullanılan kategori id'deki attribüte'ün ("type": enum") değerlerini Özellik Değerini Alma API'ından çekerek datanızı oluşturabilirsiniz. Enum olan değerler için ise bizdeki değerlerin girilmesi önceliklidir. Eğer bizdeki değerlerde bulunmuyor yada yakın veya dönüştürülebilir bir değer bulunmuyor ise o zaman kendi değerlerinizi string olarak ekleyebilirsiniz.
  
  Oluşturulan json dosyası Ürün Bilgisi Gönderme ile yüklenir.
  
  Yükleme sonrası ürünlerin durumunu Ürün Durumu Sorgulama ile kontrol edilerek error message kontrol edilir ve eksik yada hatalı bilgi varsa bunların düzeltilmesi aksiyon beklenir. Statüs'lere göre açıklamarı aşagıdaki gibidir.
  
  
  İncelenecek : Ürün giriş ekimizin kontrolü için beklenen statüdür.
  Ürün bilgileri eksik : Gönderilen ürünlerin bilgilerinde eksik bulunması durumudur. Eksik olan bilgileri product status servisimizden verilmektedir. Bu bilgilerin tekrar revize edilerek API üzerinden güncelleme gönderilmesi gereklidir.
  Katalog Sürecinde : Gönderilen ürünün, ürün giriş ekibimiz tarafından girildiğini belirtir. API üzerinden güncelleme gönderilemez.
  Eşleşen : Gönderilen ürünün, HB katalogunda bulunma durumunda dönülür. Merchantların MPOP portal üzerinden bizim eşleştirdiğimiz ürünleri göz ile kontrol ederek onay yada red vermesi gerekir. Onay yada red sürecinden önce bu statüdeki ürünlere güncelleme gönderilebilir.
  Satışa Hazır : Gönderilen ürünün, HB kataloguna eklendiği ve merchanta listing yaratıldığını belirten statüdür. API üzerinden güncelleme gönderilemez.
  Reddedildi : Hepsiburada’da satılabilmesi için izin almanız gereken ürünlerinizin ve internette satılması tamamen yasak olan ürünlerinizin listelendiği durumdur.
  
  Ayrıca Ürüne Ait Statü Bilgisi Çekme ile de merchantsku bazlı ürün durumlarını kontrol edebilirsiniz, eksik bilgide mi satışa hazır mı gibi. Yada Statü Bazlı Ürün Bilgisi Çekme sevisinden statülere göre örneğin eksik bilgide olan ürünlerin listesi, eşleşen statüdeki ürünler ve eşleştiği ürün bilgilerini çekebilirsiniz.
  
  Eşleşenleri merchant panel üzerinden de kontrol ederek onay/red verilebilir API ile de Eşleşen Statü Onay / Eşleşen Statü Red verilebilmektedir.

• Kategori bilgilerini ve özelliklerini API ile nasıl çekebilirim?

  Sizler kullanacagınız kategorinin bilgisini Kategori Bilgilerini Alma servisinden,
  
  Attribüte değerlerini, mandatory true (girilmesi zorunlu özellikleri) bilgisini Kategori Özelliklerini Alma servisinden,
  
  Kullanılan kategori id'deki attribüte'ün ("type": "enum") değerlerini Özellik Değerini Alma API'ından çekerek datanızı oluşturabilirsiniz.
  Entegratör ile çalışıyorsanız bu süreç için entegratörünüzden destek talep edebilirsiniz.

• restrictedProductBrand uyarısı alıyorum? Ne yapmam gerekir?

  İlgili uyarıyı kategoriciniz ile görüşmeniz gerekmektedir. Bu ürün üzerinde marka kısıtı koyulmuş gözükmektedir. Bu ürünü satabilmek adına alınması gereken aksiyonlar bulunmaktadır. Kategoriciniz ile iletişime geçerek bu kısıtın nasıl kaldırılacağını görüşebilirsiniz.

• Digital kategoride satış yapıyorum entegrasyon sürecini nasıl yönetmem gerekir?

  Digital kategoride test yapıyor iseniz adımlar şu şekilde kurgulanabilir;
  
  Canlıda siparişler müşteriden gelecektir. Bu yuzden Test siparişi oluşturma yalnızca test’de bulunur. Test ortamında yada canlı ortam içinde “Otomatik Paketleme” özelliğini ortam merchant panel üzerinden sayfaya girdiğinizde sağ üst köşede yer alan mağaza adınıza tıkladığınızda menüden Hesabım-Ayarlarım-Diğer ayarlar alanından “Otomatik Paketleme” alanından “Siparişler otomatik kargoya hazırlansın mı?” Evet” seçerek, “Siparişler otomatik olarak hangi şekilde kargoya hazırlansın” alanından “Ayrı ayrı hazırlansın” kısmınıda seçerek aktif edebilirsiniz.
  
  Sipariş Oluşturma Servisi
  
  -Digital kategoride siparişler kalem bazlı sadece paketlenmelidir. Bir paketlemede birden çok kalem (sku) olamaz. Otomatik paketleme açık olduğunda sipariş otomatik paketlenir ve sizlerin sipariş bilgilerini “Paket bilgilerini listeleme” servisinden çekerek “Digital kod bilgisi gönderimi” sürecine devam edebilirsiniz.
  
  Paket Bilgilerini Listeleme
  
  -Paketleme paket bilgilerini listelemeden packageNumber bilgisi ile “Digital Kod Bilgisi Gönderimi” servisindeki end-point ve body örneğindeki gibi Sipariş teslim edildiye çekilir. Burada body içinde müşteriye gönderilen kod’un Hepsiburada’ya iletilmeside zorunludur.
  
  Dijital Kod Bilgisi Gönderimi
  
  Önemli Not: Müşterilere digital kod’lar tarafınızdan sms/mail yolu ile gönderilmelidir. Bizlere digital kod’un iletilme nedeni müşteri tarafından gelecek şikayetlerde gönderildiğini ve kodun teyidini saglamaktır. Ayrıca her pakette tek kalem bulunabilir ancak aynı kalemden quantity bilgisi birden fazla ise buna uygun olan dökümandaki body örneğindeki gibi deliver gönderilmelidir.
  
  *Test ortamında test siparişi oluşturma için sadece tarafımızdan yüklenen ürünler ile sağlanabilmektedir. Satışa kapalı kısımdaki ürünlerden satışa açarak test siparişi oluşturabilirsiniz.

• Ürün yükleme sonrası "Barcode must be unique barcode" uyarısı dönmektedir. Ne yapmam gerekir?

  Girmiş olduğunuz barkodlar daha önce yüklediğiniz farklı ürünlerde kullanılmış olduğundan barkod uniqe olmalı uyarısı alınamktadır. Barkod numarası ile merchant panelden aksiyon bekleyenler kısmından barkod’u sorgulayarak daha önceki giriş yapılan ürün bilgisini ve statüsünü kontrol edebilirsiniz.

• DiscountedListingPriceIncrease uyarısı alıyorum. Ne yapmam gerekir?

  Üründe tanımlı olan kampanyada fiyat/stok engeli olabilmekte bu konuda kategori yöneticiniz ile iletişime geçerek kampanya süreciniz için bilgi alabilirsiniz.

• DiscountedListingStockDecrease uyarısı alıyorum. Ne yapmam gerekir?

  Üründe tanımlı olan kampanyada fiyat/stok engeli olabilmekte bu konuda kategori yöneticiniz ile iletişime geçerek kampanya süreciniz için bilgi alabilirsiniz.

• OutOfPriceRange uyarısı alıyorum. Ne yapmam gerekir?

  Fiyat hatalarına karşı tedbirli olmanız gerekmektedir. Canlı sistemde yanlış fiyatlandırmalara karşı çalışan bir mekanizma bulunmaktadır. Listelenmiş yayındaki fiyatların en düşüğü ve en yükseği hariç diğerlerinin ortalaması alınarak
  
  • 0 TL – 50 TL arası => %250 • 50 TL – 100 TL arası => %150 • 100 TL – 200 TL arası => %120 • 200 TL – 500 TL arası => %100 • 500 TL – 2000 TL arası => %90 • 2000 TL üzeri => %80 maximum fiyat girilebilir. Eğer bu değerin dışında bir değer girilirse outofpricerange hatası alınacaktır. Bu bir genel kuraldır kaldırılamaz, değiştirilemez.

• Ürün yüklemede "Category is not a leaf category and is not an available category'" uyarısı alıyorum?

  Bir kategoriye ürün açılabilmesi için 3 statününde şartlarının sağlanması ve aktif kategori olması gereklidir. Sizin göndermiş olduğunuz datayı kontrol ettiğmizde aktif olmayan bir kategoriye ürün açıldığı için hata alındığı gözükmektedir.
  
  Entegratörünüz tekrar aktif kategorileri listelemeli ve sizler uygun kategoriyi çekilen data içerisinden seçerek tekrar bu ürünleri göndermelisiniz.
  
  Doküman: Kategori Bilgilerini Alma
  
  

• Ürün yüklemede "Can not update product in matched or in catalog progress status" uyarısı alıyorum?

  Yüklemeye çalışılan ürünün barkodu daha önceden sizin mağazanıza yüklendiği için güncelleme işlemi gönderilememektedir.Merchant Panel Aksiyon Bekleyen Ürünler sekmesinden ilgili barkod ile ürünün durumunu kontrol edebilirsiniz.

• "There are too many ongoing/waiting inventory uploads at the moment. Please try again later" uyarısı alıyorum?

  Listing güncellerken 2 kurala da dikkat etmelisiniz.Aksi halde hata alırsınız.
  
  1) Listing güncelleme için aynı anda POST ettiğiniz devam eden / bekleyen işlemlerin sayısı 5’i geçemez. Günlük toplu güncelleme limitinizin sınırını aştınız.
  
  2) Her satıcının günlük toplu limit sayısı listing sayısının 10 katı kadardır. Yani bir satıcının 100 adet listing’i var ise bir gün içerisinde 1000 listing güncelleme limitidir.
  
  Listing güncelleme’de işlem sayısını azaltmak için xml içindeki listig sayısını arttırabilir ve paraleldeki işlem limitine takılmanın önüne geçebilirsiniz. Ayrıca güncellemeleri 10 saniye civarında aralıklarla yaptıgınızda önceki çıkılan işlem tamamlanmış olacağından limite takılma durumuda yine engellenmiş olacaktır.

• Webhook üzerinden sipariş verilerini almak istiyorum. Ne yapmam gerekir?

  Mevcutta webhook sürecine entegratör yada sizler hiç dahil olmadıysanız ilk kullanımda Webhook sürecinde aşağıdaki adımları izleyebilirsiniz;
  
  1)Webhook entegrasyonunda öncelikli olarak test ortamı mevcuttur.Test ortamında süreç tamamlanmadan canlı ortam da aksiyon alınmamaktadır. Eğer test merchant user’ınız yoksa oluşturulması için bizden talepte bulunabilirsiniz.
  
  2)Hepsiburada’ya kendi oluşturucağınız bir test web servisi(prod değil) yazarak url bilgisini iletmenizi bekliyoruz.
  
  3)Güvenlik basic auth üzerinden sağlanmaktadır. Bizimle baseurl’inizde sahip olduğunuz username ve password bilgisini paylaşmanız gereklidir.
  
  Tanımlamalarımız sonrasında size geri dönüş sağlayacağız ve test ortamında sipariş oluşturarak bütün adımları kontrol edebilirsiniz.
  
  Tüm test süreci başarılı ise canlı ortamınıza ait bilgilerin iletilmesini bekliyor olacağız.

• Test ortamında giriş yaptığım ürünler incelenecek durumda kaldı?

  Test ortamında ürünü onaylayan bir ekip olmadığı için gönderdiğiniz ürünlerin statüleri “incelenecek” olarak kalmıştır. Test adımlarınıza tarafımızdan yüklenen default ürünler ile devam edebilirsiniz. Test adımları tamamlandığında kontrol ve sonrasında canlı ortam bilgisi için “API Entegratör yetkilendirme işlemleri” tipinde kayıt açabilirsiniz.
  
  Canlıda bu süreç ;
  
  İncelenecek: Eğer ürünün barkodu Hepsiburada datasında bulunmuyorsa bu statüye düşer. Ürün giriş ekibimiz ürünlerin hepsini kontrol ettikten sonra hatalı bilgi yoksa satışa hazır statüsüne geçirir. Eşleşen-Onayınız Bekleniyor: Eğer ürünün barkodu Hepsiburada datasında bulunuyorsa bu statüye düşer. Sizin merchant panel’den portal üzerinden Aksiyon bekleyen ürünler=>Eşleşen bekleyen ürünler kısmından ürünü kontrol ederek eşleşeni ile onay/red vermeniz gerekmektedir.