XML ile Hepsiburada'ya Ürün Aktarma Rehberi

Kısa cevap

Hepsiburada tarafında katalog ürünü ile satıcı listeleme verisini birbirinden ayırmak önemlidir. XML'den gelen ürün bilgisi katalog sürecine, stok-fiyat ve teslimat bilgisi ise listeleme sürecine uygun biçimde dönüştürülmelidir.

XML ile Hepsiburada'ya Ürün Aktarma Rehberi neden önemli?

Ürün katalogda mevcut olsa bile satıcının stok, fiyat ve kargoya veriliş süresi ayrıca listeleme katmanında yönetilir. Bu ayrım kurulmazsa 'ürün var ama satışa açık değil' türü operasyon hataları oluşabilir.

XML veya Excel bir veri kaynağıdır; pazaryerinin katalog şeması değildir. Kaynak alanları temizlemek, normalize etmek ve kanalın kategori/özellik modeline çevirmek entegrasyonun asıl işidir.

2026 itibarıyla pazaryerleri katalog ve sipariş servislerini düzenli olarak güncelliyor. Bu nedenle entegrasyon kararını yalnız bir kez yapılan kurulum gibi değil, izlenen ve güncellenen bir operasyon sistemi gibi ele almak daha sağlıklıdır.

Doğru çalışma mantığı nasıl kurulmalı?

Sağlam akış kaynak veriyi önce yerel ürün modeline alır. Ardından kategori, marka, varyant, fiyat ve stok kuralları uygulanır; son aşamada kanal özelindeki payload üretilir. Böylece bir pazaryerindeki değişiklik ana ürün verisini bozmaz.

Ürün veya sipariş kaydında yerel kimlik ile pazaryerinin uzak kimliğini birlikte saklamak, tekrar deneme ve durum sorgularında kritik önem taşır. İşlem geçmişi kaybolmadığında aynı kaydın neden beklediği veya reddedildiği daha hızlı bulunur.

Adım adım uygulama planı

XML ürün alanlarını katalog verisi ve satıcı listeleme verisi olarak ayırın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Barkod/merchant SKU eşleşmesini kararlı hale getirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kategori ve zorunlu ürün özelliklerini Hepsiburada kataloğuna göre eşleştirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Stok, satış fiyatı ve kargoya veriliş süresini listeleme verisi olarak yönetin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
İlk ürün grubunu gönderip katalog ve listeleme sonucunu ayrı kontrol edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Stok-fiyat güncellemesi için periyodik iş akışı oluşturun. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Sipariş entegrasyonunda merchant SKU'nun yerel ürünle eşleştiğini doğrulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.

Kontrol ve ölçüm noktaları

İlk toplu aktarımda başarı oranı, eşleşmeyen marka/kategori sayısı, zorunlu özellik eksikleri ve batch sonucu izlenmelidir. Sonraki senkronlarda yalnız değişen ürünleri göndermek API yükünü ve hata yüzeyini azaltır.

İşlem hangi mağaza ve kanal için çalıştı?
Yerel SKU/barkod ile uzak ürün kimliği eşleşiyor mu?
Son durum ilk API yanıtından mı, nihai sonuç servisinden mi geliyor?
Başarısız işlem için kullanıcıya anlaşılır hata nedeni gösteriliyor mu?
Tekrar deneme mükerrer ürün veya sipariş oluşturmadan çalışıyor mu?
Canlı kanalda örnek ürün/sipariş ile sonuç doğrulandı mı?

Sık yapılan hatalar ve düzeltme yaklaşımı

Katalog oluşturmayı stok-fiyat güncellemesiyle aynı işlem sanmak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

XML'deki açıklama ve özellik alanlarını kategori şemasına doğrulamadan göndermek.

Merchant SKU değiştirerek mevcut listeleme bağını koparmak.

Başarısız katalog ürününe sürekli stok-fiyat göndermek.

2026 için güncellik notları

Pazaryeri API dokümanları, endpoint sürümleri, zorunlu alanlar ve işlem limitleri zaman içinde değişebilir. Bu yazıdaki operasyon mantığını uygularken ilgili kanalın güncel geliştirici veya satıcı destek dokümanını esas alın. Özellikle ürün oluşturma, toplu güncelleme ve sipariş durum servislerinde sürüm notlarını takip etmek gerekir.

Canlı sistemlerde değişiklik yapmadan önce küçük ürün grubu, düşük riskli stok-fiyat değeri ve test edilebilir sipariş senaryosu kullanmak; geniş kataloğa geçmeden önce hata davranışını görmeyi sağlar.

3E Entegrasyon tarafında hangi akışlar değerlendirilebilir?

3E Yazılım’ın pazaryeri entegrasyonu sayfasında XML, Excel, manuel ürün ekleme, desteklenen bağlantılardan ürün alma, tekil/toplu ürün gönderimi, kategori-özellik eşleştirme, stok-fiyat senkronizasyonu ve sipariş takibi gibi operasyon başlıkları yer alıyor. İhtiyacınız bu akışlardan biriyse önce gerçek ürün verinizle demo senaryosu oluşturmak en sağlıklı karşılaştırma yöntemidir.

Pazaryeri entegrasyonu özelliklerini inceleyin veya demo talebi oluşturun.

Sık sorulan sorular

Hepsiburada katalog ve listeleme farkı nedir?

Katalog ürünün temel kimliğini ve özelliklerini; listeleme ise satıcının stok, fiyat ve teslimat verisini yönetir.

XML ile mevcut katalog ürünü eşleştirilebilir mi?

Barkod ve katalog kimliği doğruysa mevcut ürünle eşleştirme senaryosu kurulabilir.

Stok ve fiyat ne sıklıkla güncellenmeli?

İşletmenin satış hacmi ve resmi API sınırlarına göre, overselling riskini azaltacak uygun periyot seçilmelidir.

Resmî ve güvenilir kaynaklar

Hepsiburada Developer Portal