Hepsiburada API entegrasyonu tek bir veri gönderiminden oluşmaz. Katalog kaydı, satıcı teklifi, sipariş ve fatura süreçlerinin ayrı sorumlulukları vardır. Önce hangi sistemin hangi verinin sahibi olduğunu belirleyin; ardından küçük bir test kapsamıyla başlayın.
Dört akışı birbirinden ayırın
Hepsiburada'nın resmî entegrasyon portalı katalog, listeleme, sipariş ve muhasebe alanlarını ayrı ele alır. Katalog entegrasyonu ürün verisi gönderimi; listeleme entegrasyonu ise stok, fiyat ve kargoya veriliş süresi gibi teklif bilgileri için kullanılır.
- Katalog: Ürün kimliği, kategori ve özellik verilerinin kaynağını belirleyin. Mevcut ürünle eşleşme kararını teklif güncellemesinden ayrı inceleyin.
- Listeleme: Fiyat, stok ve gönderim süresi verisini hangi sistemin yazacağını netleştirin. Panelden ve entegrasyondan çelişen güncellemeler yapılmasını önleyin.
- Sipariş: Siparişin okunmasından depoya aktarılmasına kadar kayıt eşleşmesini ve tekrar işlemeyi kontrol edin.
- Fatura ve mutabakat: Sipariş, fatura ve ödeme kayıtlarının ilişkisini kurun. Kullandığınız e-fatura hizmetinin kendi yetki, şema ve durum kontrollerini ayrıca doğrulayın; sipariş API erişimini fatura erişimiyle aynı kabul etmeyin.
Örnek: test ortamında sipariş okuma isteği
Resmî sipariş listeleme dokümanı, satıcıya ait sipariş alındı statüsündeki kalemleri okumak için şu GET yolunu gösterir. Aşağıdaki adres SIT test ortamına aittir; üretim adresi değildir.
GET https://oms-external-sit.hepsiburada.com/orders/merchantid/{merchantId}?limit=20&offset=0
{merchantId} yer tutucusunu yetkili olduğunuz test satıcısının kimliğiyle değiştirin. Dokümanda kimlik doğrulama Basic Auth olarak belirtilir. Bilgileri güvenli istemci ayarlarından sağlayın; anahtar veya parolayı kaynak kodda, blogda ya da destek ekran görüntüsünde paylaşmayın.
İstek JSON gövdesi göndermez. limit ve offset sonuçların sayfalanmasını belirler. Dokümandaki limit alanı açıklamalarında tutarsızlık bulunduğundan örnekte limit açıkça verilmiştir; geliştirmede güncel dokümanı ve test yanıtını esas alın. Bu yazı hazırlanırken satıcı hesabına bağlanılmamış, örnek istek çalıştırılmamıştır.
Testte hangi sonucu doğrulamalısınız?
- HTTP yanıtını ve hata gövdesini kaydedin; kimlik doğrulama hatasını boş sipariş listesi gibi yorumlamayın.
- Dönen kayıtların doğru test satıcısına ait olduğunu doğrulayın.
- Sayfalama sonunda kayıt atlanmadığını veya aynı kaydın iki kez işlenmediğini kontrol edin.
- Sipariş ve satır kimliklerini iç sistem kayıtlarıyla eşleştirin.
- Aynı isteğin tekrarıyla depoda ikinci bir iş emri oluşmasını önleyen kontrol kurun.
Üretime geçiş kontrol listesi
Önerimiz; önce test okuması, sonra dar kapsamlı veri aktarımı ve en son kontrollü üretim geçişidir. Kullanılan her servisin üretim adresini, yetkisini ve istek şemasını kendi dokümanından doğrulayın. Bir servisin kimlik doğrulama yöntemini tüm API'lere genellemeyin.
Geçiş kaydında sorumlu kişi, izlenecek hata göstergeleri, tekrar deneme sınırı, geri dönüş planı ve manuel operasyon alternatifi bulunmalıdır. Satıcı verilerini gereğinden fazla loglamayın; kişisel bilgileri ve sırları maskeleyin.
Sık sorulan sorular
Ürün kaydının oluşması, fiyat ve stok teklifinin hazır olduğu anlamına gelir mi?
Bu sonuç otomatik varsayılmamalıdır. Katalog ve teklif akışlarını ayrı kontrol edin; beklenen fiyat, stok ve durumun satıcı tarafında yansıdığını doğrulayın.
Tek bir API isteği bütün entegrasyonu test eder mi?
Hayır. Yukarıdaki örnek yalnızca bir sipariş okuma yolunu gösterir. Katalog, teklif güncellemesi, sipariş işleme ve fatura süreçleri için ayrı kabul senaryoları gerekir.
Hata alındığında destek kaydında ne olmalı?
Servis adı, ortam, zaman, maskelenmiş istek bilgisi, durum kodu ve ilgili hata mesajını ekleyin. Gerçek parola, servis anahtarı veya gereksiz müşteri bilgisi paylaşmayın.
Teknik bağlantıdan düzenli operasyona
Entegrasyonun amacı yalnızca veri taşımak değil, hatayı görünür ve düzeltilebilir kılmaktır. Operasyon kapsamı için Hepsiburada pazaryeri yönetimi hizmetimizi ve entegrasyon hataları rehberini inceleyin.
Editoryal güncelleme ve kaynak kontrolü: 7 Eylül 2026. Ortam, yetki ve servis şeması için güncel Hepsiburada geliştirici dokümanlarını esas alın.