Hepsiburada Marketplace Sync - API veya CSV ile Otomatik Stok ve Fiyat Güncelleme

Doğru bilgi mağazanızdadır. Pazaryeri onu takip etmelidir.

Hepsiburada'da satış yapmak, her ilanda üç bilgiyi güncel tutmak demektir: fiyat, satılabilir stok ve termin süresi. Bunu elle yaptığınızda her sabah yeniden bir tablo dışa aktarırsınız; bir gün unuttuğunuzda ise ya elinizde olmayan stoğu satarsınız ya da vermek istemediğiniz bir fiyattan satışa devam edersiniz. Bu modül PrestaShop kataloğunuzu tek doğru kaynak yapar ve değişiklikleri pazaryerine taşır.

İki gönderim yolu, tek satır üretici

• CSV dışa aktarımı — Hepsiburada toplu yükleme ekranının beklediği sütunları, tam olarak beklediği sırayla içeren dosyayı indirin ve satıcı panelinden kendiniz yükleyin.
• Listing API — bilgilerinizi girin, modül Hepsiburada ile doğrudan konuşsun. Verilen adrese bir cron bağlayın; stok ve fiyat değişiklikleri kendiliğinden iletilsin.

Her iki yol da aynı satır üreticiden geçer; böylece indirdiğiniz dosya ile API'nin gönderdiği veri her zaman birbirini tutar. API'nin ne yaptığını merak ettiğiniz an dosyayı indirip bakabilirsiniz.

Ne gönderiyor — neye hiç dokunmuyor

İlanın kendisi Hepsiburada katalog ekibinin sorumluluğundadır; bu yüzden modül ürün adlarınıza, açıklamalarınıza, görsellerinize, kategorilerinize veya özelliklerinize asla dokunmaz. Yalnızca satıcıya ait alanları gönderir: KDV hariç fiyat, satılabilir stok, termin süresi, kargo ve adres etiketleri, maksimum satın alınabilir adet, kişiselleştirme tipi ve karakter uzunluğu. Katalog tarafına ait hiçbir bilginin üzerine yazılmaz.

Yanlış fiyat pahalıya patlar, o yüzden emniyet kemerleri var

• Stok payı bırak (Hold back) — gönderim öncesinde her adetten bir tampon düşer. 2 yazarsanız, stoğu 5 olan ürün pazaryerine 3 olarak gider; böylece mağazanızın az önce sattığı ürünü pazaryeri siparişi bir daha satamaz.
• Fiyat çarpanı — mağaza fiyatını olduğu gibi gönderin ya da pazaryeri komisyonunu karşılayacak bir kâr payı ekleyin. 10'un üzerindeki değerler yayınlanmaz, yazım hatası kabul edilip reddedilir.
• Bu fiyatın altında asla gönderme (Never send a price below) — bir güvenlik tabanı. Altında kalan satırlar yanlış rakamla yayına çıkmak yerine gönderilmez ve raporlanır.
• Bundan fazlasını asla sunma (Never offer more than) — depoda ne olursa olsun pazaryerinde görünen adedi sınırlayın.

Pasif olan veya siparişe kapalı ürünler listeden çıkarılmaz, stoğu sıfır olarak gönderilir; böylece pazaryerinde sessizce eskimek yerine satıştan düşerler.

Neyin gönderilemediğini ve nedenini size söyler

Getting started sekmesindeki durum paneli tahmin yürütmenize bırakmaz, ilgili ürünleri adıyla listeler: SKU ve stok kodu olmayanlar, fiyatı sıfıra denk gelenler, taban fiyatınızın altında kalanlar, dışa aktarım dilinde adı eksik olanlar. Yinelenen SKU'lar siz göndermeden önce yakalanır — bir SKU iki kez geçtiğinde Hepsiburada partinin tamamını reddettiği için bunu önceden görmek baştan yükleme yapmaktan kurtarır. Kargo alanı Hepsiburada'nın yayınladığı kargo firmalarına göre doğrulanır ve tanınmayan bir isimde sizi uyarır; karşı taraf bunu sessizce yok sayardı.

Dürüst rapor veren zamanlanmış senkronizasyon

Send sekmesi tokenli bir cron adresi gösterir. Hosting cron'unuzu bu adrese bağlayın — genelde otuz dakikada bir yeterlidir — ve modül varsayılan olarak son başarılı çalışmadan bu yana yalnızca değişenleri gönderir; ürün kayıtları ve stok hareketleri ilanları otomatik olarak değişti diye işaretler. Hepsiburada bir partiyi reddettiğinde veya kaybettiğinde her şeyi yeniden göndermek için adrese &mode=full ekleyin. Uç nokta JSON döndürür; böylece bir izleme aracı gerçek hatayı sakin geçen bir çalışmadan ayırt edebilir, eşzamanlı çalışmalar reddedilir ve yavaş bir çalışma diğerlerinin üstüne binmez, adres yeniden üretildiğinde ise URL sızmışsa eskisi anında geçersiz olur.

Ürün eşleştirme ve kombinasyonlar

Her Hepsiburada ilanının bir HepsiburadaSku değeri vardır. Bunu ürün sayfasındaki Hepsiburada sekmesine yapıştırın ya da PrestaShop referanslarınız Hepsiburada satıcı stok kodlarınızla zaten örtüşüyorsa "Link products automatically" seçeneğini kullanın. Kombinasyonlar tam olarak desteklenir — Hepsiburada her varyantı ayrı bir ilan saydığı için her kombinasyon ayrı eşleştirilir ve ayrı fiyatlandırılır.

Sürüm 2.0 neyi düzeltti

1.x sürümü fiyatı her zaman wholesale_price alanından alıyordu; çoğu mağaza bu alanı boş bıraktığı için dışa aktarılan her fiyat 0,00 oluyordu. Sürüm 2.0 varsayılan olarak satış fiyatını kullanır, sıfır fiyatı dışa aktarmayı tümden reddeder ve maliyet fiyatı kaynağı seçildiğinde katalogda maliyet fiyatı yoksa uyarır. 1.x ayrıca SKU'yu her actionProductUpdate çağrısında yazıyordu; bu yüzden başka bir kayıt yolu — bir stok değişikliği, web servisi, başka bir modül — SKU'yu sessizce siliyordu. 2.0 yalnızca ürün formu gerçekten bu alanları taşıdığında yazar. Eşleştirmeler artık ürün başına tek bir SKU yerine mağaza bazında saklanır; 1.x API bilgilerini kaydediyor ama hiçbir yere istek göndermiyordu, bu nedenle yükseltme sonrasında siz bilinçli olarak açana kadar API kapalı kalır.

Uyumluluk

PrestaShop 1.7, 8 ve 9, override kullanmadan, sekiz dilde: Hollandaca, İngilizce, Fransızca, Almanca, İtalyanca, Lehçe, İspanyolca ve Türkçe. Çoklu mağazaya duyarlıdır — eşleştirmeler mağaza bazında saklandığı için aynı ürün farklı mağazalarda farklı Hepsiburada SKU'ları taşıyabilir ve yapılandırma sayfası hangi mağaza üzerinde çalıştığınızı her zaman söyler. Modülü kaldırdığınızda tabloları ve ayarları silinir; Hepsiburada ilanlarınız en son aldıkları değerlerle kalır ve yalnızca güncellenmeyi bırakır.

Sıkça sorulan sorular

API şart mı, sadece dosyayla çalışabilir miyim?

İkisi de olur. CSV'yi indirip satıcı panelinden yükleyebilir ya da API'yi açıp değişiklikleri cron'a bırakabilirsiniz. İkisi de aynı veriyi üretir.

Hepsiburada'daki ürün başlıklarımı veya görsellerimi değiştirir mi?

Hayır. Onlar katalog ekibinin sorumluluğundadır. Modül yalnızca fiyat, stok, termin süresi, kargo ve adres etiketleri, maksimum adet ve kişiselleştirme ayarlarını gönderir.

Stok aşımını nasıl önlerim?

Bir stok payı belirleyin. Her stok adedi gönderilmeden önce bu kadar azaltılır, böylece pazaryeri son birkaç ürününüzü hiç görmez.

API hangi bilgileri istiyor?

Hepsiburada Listing API bilgilerini; bunlar satıcı paneli giriş bilgileriniz değildir, Hepsiburada'dan talep etmeniz gerekir. 401 kullanıcı adı veya parolanın yanlış olduğu, 403 hesabın Listing API yetkisi olmadığı, 404 ise satıcı ID'sinin yanlış olduğu anlamına gelir. Karşı tarafın verdiği mesajı olduğu gibi gösteren bir "Test connection" düğmesi vardır.

Kombinasyonları destekliyor mu?

Evet. Hepsiburada her varyantı kendi başına bir ilan saydığı için her kombinasyon ayrı eşleştirilir ve ayrı fiyatlandırılır.

Yüklemem neden komple reddedildi?

Neredeyse her zaman yinelenen bir SKU yüzünden — bir SKU iki kez geçtiğinde Hepsiburada partinin tamamını reddeder. Durum paneli yinelenenleri siz göndermeden önce bulur.

1.x sürümünde tüm fiyatlarım sıfır olarak çıkıyordu. Bu düzeldi mi?

Evet. Bunun nedeni 1.x'in fiyatı, çoğu mağazanın boş bıraktığı maliyet fiyatı alanından almasıydı. Sürüm 2.0 varsayılan olarak satış fiyatını kullanır ve sıfır fiyatı dışa aktarmayı tümden reddeder.