Hepsiburada entegrasyonu nedir, kimler için?
Hepsiburada entegrasyonu, Hepsiburada'nın satıcılara açtığı API üzerinden mağazanızı bir yazılıma bağlamaktır. Siparişler, stok, fiyat ve ürün bilgisi yazılıma akar; her iş için satıcı paneline geçmeniz gerekmez.
Hepsiburada'da satıp Trendyol, N11 ya da kendi sitenizde de satıyorsanız Saystok bir kanaldaki satışı diğerlerine yazar, son adedin iki kez satılmasını önler. Hepsiburada'nın sipariş akışı paket üzerinden ilerler: sipariş paketlenir, fatura linki eklenir, kargoya verilir. Saystok bu adımları panele taşır.
Hepsiburada entegrasyonu nasıl yapılır?
- Hepsiburada satıcı panelinde Merchant ID'nizi (mağaza numarası) bulun.
- Aynı hesapla Hepsiburada geliştirici portalına girin ve yeni bir entegrasyon uygulaması tanımlayın. Servis anahtarı (API Key) başvuru onaylandığında üretilir; onay süresi Hepsiburada'ya bağlı olduğu için işe erken başlayın.
- User-Agent alanına portalda tanımladığınız uygulama adını yazın. Hepsiburada istekleri bu adla tanır.
- Saystok kurulum ekranında Hepsiburada sekmesine üç değeri girip "Bağlantıyı test et ve kaydet"e basın.
- Ürünlerinizi eşleştirin. İsterseniz Webhooklar sayfasındaki Hepsiburada adreslerini satıcı panelinin entegrasyon ayarlarına girin.
Ekran ekran anlatım: Hepsiburada API bağlantısı kurulumu ve Hepsiburada entegrasyonu nasıl yapılır?
Hepsiburada servis anahtarı ve User-Agent nedir?
Servis anahtarı, Hepsiburada'nın API Key için kullandığı addır ve şifre yerine geçer. Geliştirici portalında tanımladığınız entegrasyon uygulamasına aittir; başvuru onaylanmadan çalışmaz.
User-Agent, aynı uygulamanın adıdır. Hepsiburada her isteği bu adla tanır; alanı boş bırakmak ya da portaldaki adı farklı yazmak bağlantı testini başarısız yapar. Merchant ID ile servis anahtarı aynı hesaba ait olmalıdır.
Hepsiburada stok ve fiyat senkronu
Hepsiburada ürünleri iki kaynaktan okunur: ürün adı ve görseller katalog servisinden, gerçek stok listeleme servisinden gelir. Katalog servisinin stok alanı geç güncellenebildiği için Saystok eşleşmiş ürünlerde bu değeri esas almaz. Hepsiburada bir ürünün SKU'sunu değiştirirse eşleşme barkoddan korunur.
Stoğu sıfırdan yukarı çıkan bir ürün Hepsiburada'ya fiyatla birlikte gönderilir. Fiyatı bilinmeyen ürünün stoğu gönderilmez; ürün hatalı bir fiyata, örneğin 1 TL'ye düşmez.
| İş | Sıklık | Ne olur? |
|---|---|---|
| Sipariş okuma | 5 dakikada bir | Yeni siparişler okunur, satılan adet diğer mağazalardan düşülür. |
| Webhook (isteğe bağlı) | Bildirim geldiği anda | Trendyol, Hepsiburada, N11 ve WooCommerce siparişleri beklemeden işlenir. |
| Katalog kontrolü | 2 saatte bir (Etsy 6 saatte bir) | Pazaryerinde farklı görünen adetler yeniden gönderilir. |
| Platforma özel fiyat | 2 saatlik kontrolde | Tanımladığınız yüzde farkı o platformun fiyatına uygulanır. |
Komisyon farkını fiyata yansıtmak için Hepsiburada'ya özel yüzde tanımlarsınız. Doğru yüzdeyi Hepsiburada komisyon oranları ve pazaryeri kâr karşılaştırma araçlarıyla ücretsiz bulabilirsiniz.
Hepsiburada paket işlemleri
| Paket durumu | Saystok'ta yapabildikleriniz |
|---|---|
| Paketlenecek | Siparişi paketlemek, kalemleri ayırmak |
| Gönderime hazır | Fatura linki göndermek, kargo firmasını değiştirmek, ortak barkodu PDF indirmek |
| Kargoda, teslim edildi, teslim edilemedi | Durumu diğer kanalların siparişleriyle tek listede izlemek |
| İptal | Kargolanmadan iptal edilen siparişin stoğu kendiliğinden geri eklenir |
e-Arşiv faturayı Saystok'ta kesip linkini aynı ekrandan pakete gönderirsiniz. Ayrıntı: e-Arşiv fatura.
Hepsiburada entegrasyon hataları ve çözümleri
Kimlik doğrulama reddedildi (401)
Merchant ID ile servis anahtarı aynı uygulamaya ait olmalıdır. User-Agent boşsa ya da portaldaki addan farklıysa bağlantı kurulmaz. Portal başvurunuz henüz onaylanmadıysa anahtar çalışmaz.
Hepsiburada'da stok 0 görünüyor ama depoda ürün var
Ürünün fiyatı Saystok'ta 0 ya da boş olabilir; fiyatsız ürünün stoğu gönderilmez. Fiyatı girin, sonraki gönderimde stok açılır. Başarısız gönderimler Senkronizasyon ekranında ve uyarılarda görünür.
Ürün yükleme reddedildi
Hepsiburada en az bir görsel ister ve kategori özelliklerini kontrol eder. Seçmediğiniz zorunlu özellikler için listedeki ilk değer kullanılır; ürününüze uymuyorsa bu özellikleri kendiniz seçin.
Tüm kurallar Hepsiburada bağlantı ayrıntıları sayfasında; API uç noktaları Hepsiburada API rehberi'nde.
Hepsiburada entegrasyonu ücretli mi?
Hepsiburada için ayrı bir entegrasyon ücreti yoktur; Hepsiburada ve diğer 9 platform aynı pakettedir.
| Paket | Fiyat (KDV dahil) | Kapsam |
|---|---|---|
| 1 Aylık | 899 TL | Tüm özellikler, 10 platformun hepsi |
| Yıllık | 7.188 TL (ayda 599 TL) | Tüm özellikler, peşin fiyatına 3 taksit |
Paketler tek çekimdir ve otomatik yenilenmez. İlk 30 gün ücretsizdir; deneme için kart bilgisi istenmez, süre bitince devam etmek isterseniz paketi siz seçersiniz. Ayrıntılar fiyatlandırma sayfasında.
Hepsiburada'yı Trendyol ile birlikte kullanmak
Hepsiburada genelde Trendyol ile birlikte açılır. İki pazaryerinde aynı ürünü satarken birinde satılan ürün diğerinde de düşer; ayrıntılar Trendyol ve Hepsiburada sayfasında. Trendyol tarafı için Trendyol entegrasyonu, kendi siteniz için Hepsiburada ve WooCommerce sayfalarına bakın.
Bilinen sınırlar
- Hepsiburada müşteri soruları ve iade talepleri Saystok'a gelmez; satıcı panelinden yönetilir.
- Fiyatı bilinmeyen ürünün stoğu Hepsiburada'ya gönderilmez.
- API erişimi Hepsiburada geliştirici portalındaki onaya bağlıdır.
- Her platformdan bir mağaza bağlanır; aynı pazaryerindeki ikinci bir mağaza hesabı aynı Saystok hesabına eklenemez.
Sık sorulanlar
Hepsiburada entegrasyonu nedir?
Hepsiburada mağazanızı Hepsiburada API'si ile bir yazılıma bağlayıp stok, fiyat, sipariş, paket ve ürün işlerini oradan yönetmektir. Saystok'ta Hepsiburada satışı diğer mağazalarınızın stoğundan da düşer.
Hepsiburada entegrasyonu nasıl yapılır?
Satıcı panelinden Merchant ID'nizi alın, geliştirici portalında entegrasyon uygulaması tanımlayın ve onaylanınca üretilen servis anahtarını kopyalayın. Saystok'ta Hepsiburada sekmesine Merchant ID, servis anahtarı ve User-Agent'ı girip bağlantıyı test edin.
Hepsiburada servis anahtarı nereden alınır?
Servis anahtarı (API Key), Hepsiburada geliştirici portalında tanımladığınız entegrasyon uygulaması için başvuru onaylandığında üretilir. Onay süresi Hepsiburada'ya bağlıdır.
Hepsiburada entegrasyonu ücretsiz mi?
Saystok ilk 30 gün ücretsizdir. Sonrasında 1 Aylık paket 899 TL, yıllık pakette ayda 599 TL (KDV dahil); Hepsiburada için ayrı ücret yoktur.
Hepsiburada fatura linkini Saystok'tan gönderebilir miyim?
Evet. Siparişler ekranındaki Hepsiburada paket işlemlerinden fatura adresini pakete gönderirsiniz. Aynı yerden kargo firmasını değiştirir, ortak barkodu indirir ya da paketi bozarsınız.
Hepsiburada müşteri soruları ve iadeleri Saystok'ta görünür mü?
Hayır. Müşteri soruları yalnız Trendyol ve N11, iade yönetimi yalnız Trendyol ve WooCommerce için çalışır. Hepsiburada soru ve iadelerini satıcı panelinden yönetirsiniz.