AnasayfaÖzelliklerTemalarPazaryeriİletişimGiriş yapTeklif Al
Rehber

Hepsiburada Entegrasyonu

Hepsiburada entegrasyonu, Trendyol entegrasyonuna benzer görünse de teknik olarak farklı bir modeldir: tek bir gateway yerine üç ayrı servis hostu, JSON gövde yerine dosya tabanlı ürün gönderimi ve hazır sipariş paketi yerine satıcının kendi oluşturduğu paketler vardır. Bu sayfa, entegratör API'sinin gerçek yapısını, kurulum sırasını ve RapiSoft'un bu akışı nasıl yönettiğini anlatır.

Kısa cevap

RapiSoft, Hepsiburada'nın entegratör API'sine bağlanarak ürün, stok, fiyat ve siparişleri tek panelden yönetir. Bağlantı, satıcı panelinden alınan MerchantId ve Servis Anahtarı ile HTTP Basic Auth üzerinden kurulur. Katalog (mpop), listeleme (listing-external) ve sipariş (oms-external) servisleri ayrı ayrı çalışır; stok ve fiyat değişiklikleri otomatik iletilir, siparişler paketlenip kargo barkodu alınır.

Hepsiburada entegrasyonu tam olarak neyi kapsar?

Hepsiburada'da "entegrasyon" tek bir servis değil, birbirinden bağımsız çalışan üç ayrı entegrasyon anlamına gelir. Satıcı panelinden manuel yapılan her iş, karşılığında ayrı bir API ailesine sahiptir:

  • Katalog (ürün) entegrasyonu: Kategori ağacını ve kategori özelliklerini çekmek, yeni ürün göndermek, gönderilen ürünün durumunu takip etmek.
  • Listeleme entegrasyonu: Hepsiburada kataloğunda karşılığı oluşmuş ürünlerin stok, fiyat ve kargoya veriliş süresini güncellemek.
  • Sipariş (OMS) entegrasyonu: Ödemesi tamamlanmış sipariş kalemlerini çekmek, paketlemek, kargo barkodu almak, fatura linki iletmek, iptal bildirmek.

Bu ayrım pratikte şu anlama gelir: ürünü göndermek onu satışa açmaz, satışa açmak listeleme servisinin işidir; siparişi çekmek onu kargoya vermez, kargo barkodu ancak paketleme yapıldıktan sonra oluşur. RapiSoft bu üç akışı tek panelde birleştirir, ancak arka planda üç ayrı servis kuyruğu olarak yönetir.

Bunların yanında opsiyonel servis aileleri de vardır: talep/iade (claim) yönetimi, komisyon sorgulama, buybox sıralaması ve müşteri sorularının yönetildiği "Satıcıya Sor" servisi.

API mimarisi: üç ayrı base host

Trendyol'daki gibi tek bir API gateway yoktur. Hepsiburada'da her entegrasyon türü kendi alan adında çalışır ve canlıya geçerken URL'lerden yalnızca -sit eki kaldırılır:

Hepsiburada entegratör servislerinin base adresleri
EntegrasyonNe yaparCanlı baseTest (SIT) base
Katalog / ÜrünKategori, özellik, ürün gönderimimpop.hepsiburada.com/productmpop-sit.hepsiburada.com/product
ListelemeStok, fiyat, kargo süresilisting-external.hepsiburada.comlisting-external-sit.hepsiburada.com
Sipariş (OMS)Sipariş, paket, iptal, faturaoms-external.hepsiburada.comoms-external-sit.hepsiburada.com
Test sipariş stub'ıTest ortamında sahte sipariş üretirCanlıda yokoms-stub-external-sit.hepsiburada.com
Satıcıya SorMüşteri soru-cevaplarıapi-asktoseller-merchant.hepsiburada.comapi-asktoseller-merchant-sit.hepsiburada.com

Bu mimarinin pratik sonucu: bir entegrasyon istemcisi yazarken tek bir HTTP client yetmez. Üç host için ayrı taban adres, ayrı hata sözlüğü ve ayrı hız limiti yönetimi gerekir. Ayrıca test (SIT) ortamının kategori ağacı canlı ortamla birebir aynı değildir; canlıya geçildiğinde kategori ağacının yeniden çekilmesi gerekir.

Kimlik doğrulama: MerchantId + Servis Anahtarı ile Basic Auth

Tüm Hepsiburada servisleri HTTP Basic Authentication ile korunur. OAuth, token yenileme veya imza hesaplama yoktur; kimlik bilgileri her istekte header'da gider:

  • Kullanıcı adı: MerchantId (GUID formatında satıcı kimliği).
  • Şifre: Servis Anahtarı (SecretKey).
  • Authorization header: Basic base64(merchantId:secretKey)
  • User-Agent header'ı zorunludur. Değeri, Hepsiburada'nın entegratöre verdiği sabit geliştirici kullanıcı adıdır. Bu header gönderilmezse istek 401 döner.

Buradaki en sık karıştırılan nokta şudur: MerchantId hem kimlik bilgisi hem de yol (path) parametresidir. Örneğin stok güncelleme adresi /listings/merchantid/{merchantId}/stock-uploads şeklindedir; yani aynı GUID hem Basic Auth kullanıcı adında hem de URL'de bulunur.

Trendyol'un {sellerId} - SelfIntegration biçimindeki User-Agent kuralının aksine Hepsiburada'da format zorunluluğu yoktur; entegratöre atanan kullanıcı adı sabit metin olarak gönderilir. Yanlış User-Agent, doğru şifreyle bile 401 üretir ve bu, entegrasyonlarda en çok vakit kaybettiren hatalardan biridir.

Servis anahtarı satıcı tarafından şu yoldan verilir: Satıcı Paneli → Bilgilerim → Entegrasyon → Entegratör Bilgileri sekmesi → ilgili entegratörün Servis Anahtarı butonu. Anahtar yenilendiğinde entegratör tarafındaki kaydın da güncellenmesi gerekir; aksi halde tüm senkronizasyon 401 ile durur.

Kurulum: RapiSoft ile Hepsiburada bağlantısı adım adım

1. Hepsiburada satıcı hesabının ve entegratör yetkisinin hazırlanması

Hepsiburada'da satış yapan aktif bir satıcı hesabı gerekir. Panelde entegratör tanımı yapılır ve RapiSoft için bir servis anahtarı üretilir. Yeni entegrasyon kuran ekipler için Hepsiburada ayrıca bir SIT (test) hesabı tahsis eder.

2. MerchantId ve Servis Anahtarı'nın panele girilmesi

Satıcı panelinden alınan MerchantId ve Servis Anahtarı, RapiSoft yönetim panelindeki Hepsiburada kanalına kaydedilir. RapiSoft, kaydetme anında listeleme servisine doğrulama isteği atarak kimlik bilgilerinin geçerliliğini test eder; hatalıysa kanal aktifleştirilmez.

3. Kategori ağacının ve kategori özelliklerinin çekilmesi

Ürün gönderebilmek için kategori zorunludur ve kategori, ürünün veri modelini belirler. Kategori listesi GET /api/categories/get-all-categories ile çekilir; ürün yalnızca leaf=true, status=ACTIVE ve available=true olan kategorilere gönderilebilir. Ardından her kategori için GET /api/categories/{categoryId}/attributes ile özellikler alınır. Burada mandatory: true olan alanlar doldurulmadan ürün geçmez.

4. Kategori eşleştirmesi ve zorunlu özelliklerin doldurulması

Kendi kataloğunuzdaki kategoriler Hepsiburada'nın alt kırılım (leaf) kategorileriyle eşleştirilir. Özellik tipi enum olan alanlarda serbest metin yerine listeden değer seçilir; bu değerler GET /api/categories/{categoryId}/attribute/{attributeId}/values ucundan sayfalı olarak çekilir (sayfa başına en fazla 1000 kayıt).

5. Ürünlerin gönderilmesi ve trackingId ile takip

Ürünler POST /api/products/import ucuna gönderilir. Buradaki kritik fark: veri düz JSON gövdesi olarak değil, multipart/form-data içinde .json uzantılı bir dosya olarak iletilir. Yanıt olarak bir trackingId döner ve sonuç GET /api/products/status/{trackingId} ile sorgulanır. RapiSoft bu takip kodunu saklar, işlem sonucunu periyodik olarak yoklar ve hataları ürün bazında panelde gösterir.

6. Listeleme (stok ve fiyat) senkronizasyonunun açılması

Ürün Hepsiburada kataloğunda karşılık bulup listing oluştuğunda, artık stok ve fiyat listeleme servisinden yönetilir. Mevcut listing'ler GET /listings/merchantid/{merchantId} ile çekilerek HepsiburadaSku ↔ MerchantSku eşlemesi kurulur. Bu eşleme, sonraki tüm güncellemelerin temelidir.

7. Sipariş akışının devreye alınması

Ödemesi tamamlanmış kalemler GET /orders/merchantid/{merchantId} ile çekilir, paketlenir ve kargo barkodu alınır. Siparişler RapiSoft'un tek sipariş ekranında kendi siteniz ve diğer pazaryeri siparişleriyle aynı listede görünür.

8. Test ortamı doğrulaması ve canlıya geçiş

Hepsiburada, entegrasyonun canlıya alınması için üç adımın test ortamında tamamlanmasını ister: ürün gönderimi (ve oluşan trackingId'nin iletilmesi), stok/fiyat güncellemesi ve sipariş listeleme/paketleme. Bu adımlar tamamlandıktan sonra canlı ortam için ayrı bir servis anahtarı verilir ve base URL'lerden -sit eki kaldırılır.

Ürün gönderimi: trackingId akışı ve ürün statüleri

Hepsiburada'da ürün gönderimi anlık değil, asenkron bir süreçtir. Gönderim yapılır, takip kodu alınır, sonuç ayrı bir uçtan sorgulanır. Ürün dosyasında üst seviyede yalnızca categoryId ve merchant bulunur; diğer tüm alanlar attributes nesnesinin içindedir ve alan adları Türkçedir: UrunAdi, UrunAciklamasi, Marka, Barcode, GarantiSuresi (ay), kg (desi), tax_vat_rate (KDV), price, stock, Image1...Image10.

Dikkat edilmesi gereken biçim kuralları:

  • Fiyat katalog tarafında virgüllü metindir: "130,50". Aynı fiyat listeleme servisinde nokta ayraçlı ondalık sayı olarak gönderilir. İki servis iki farklı format ister; karıştırıldığında InvalidPrice hatası alınır.
  • Barkod 13 haneli EAN13 olmalı ve tekil olmalıdır. Hepsiburada kataloğuyla eşleşmenin en kritik alanıdır.
  • MerchantSku büyük harfe çevrilir. Küçük harfle gönderilen stok kodu sistemde büyük harfe dönüşür; eşleştirme mantığı büyük/küçük harf duyarsız kurulmalıdır.
  • Görseller png veya jpg olmalı ve URL'ler dışarıdan erişilebilir olmalıdır. Ulaşılamayan görsel adresleri belirli sayıda yeniden denenir, sonra ürün eksik kalır.
  • Varyantlar aynı VaryantGroupID değeri ve kategoriye özel varyant özelliklerinden (*_variant_property) en az biri doldurularak gruplanır.

Gönderim sonrası ürün şu statülerde gezinir: WAITING (incelenecek), MISSING_INFO (eksik bilgi), PRE_MATCHED (eşleşen – onay/red bekliyor), MATCHED (satışa hazır), REJECTED, CREATED. Kritik kural: katalog sürecinde ve satışa hazır statüsündeki ürünlere API'den içerik güncellemesi gönderilemez. Bu ürünlerin içeriği, hbSku bazlı çalışan ayrı bir güncelleme servisiyle (/api/integrator/import) değiştirilir ve görsel değişikliğinin algılanması için görselin yeni bir URL ile gönderilmesi gerekir.

Stok ve fiyat senkronizasyonu nasıl işler?

Listeleme servisinde stok ve fiyat ayrı uçlardan güncellenir ve her istek geriye bir yükleme kimliği (upload Id) döndürür. Sonuç, o kimlikle ilgili sorgu ucundan okunur:

Listeleme servisinin temel işlemleri
İşlemMetotSonuç
Listing sorgulamaGET/listings/merchantid/{merchantId}SKU eşlemesi, IsSalable, IsLocked
Fiyat güncellemePOST/listings/merchantid/{merchantId}/price-uploadsupload Id
Stok güncellemePOST/listings/merchantid/{merchantId}/stock-uploadsupload Id
Tam envanter güncellemePOST/listings/merchantid/{merchantId}/inventory-uploadsupload Id
İşlem sonucu sorgulamaGET.../price-uploads/id/{id} ve .../stock-uploads/id/{id}Başarılı/hatalı SKU listesi

Servisin kendi sınırları senkronizasyon tasarımını doğrudan belirler:

  • Tek istekte en fazla 4.000 SKU gönderilebilir.
  • Aynı anda tamamlanmamış (bekleyen) güncelleme işlemi sayısı 5'i geçemez. Bu yüzden entegrasyonun bir kuyruk mantığıyla çalışması şarttır; sırasız gönderim yapan sistemler burada takılır.
  • Ürünü satışa kapatmak için stok veya fiyat 0 gönderilir; satışa açmak için ikisi de sıfırdan farklı olmalıdır.
  • Fiyat, Hepsiburada'nın belirlediği eşik aralığının dışında kalırsa SKU kilitlenir (IsLocked, LockReasons: MinLock/MaxLock) ve toplu kilit kaldırma işlemiyle açılır.
  • Katalog servisi dakikada 180 istek ile sınırlıdır; sipariş servisi ise saniyelik yüksek bir limitle çalışır ve yanıtta X-RateLimit-Remaining, X-RateLimit-Limit, X-RateLimit-Reset header'larını döner.

RapiSoft'un varsayılan davranışı: stok ve fiyat değişiklikleri olay tabanlı çalışır — panelde veya kendi sitenizde bir satış gerçekleştiğinde ya da fiyat değiştiğinde ilgili SKU güncelleme kuyruğuna alınır ve toplu paketler halinde iletilir. Sipariş çekme ise düzenli aralıklarla yapılan yoklama (polling) ile yürür. Kuyruk aralıkları ve paket boyutları mağaza hacmine göre kurulum sırasında ayarlanır; yüksek SKU sayısına sahip mağazalarda toplu gönderim aralığı, bekleyen işlem sınırı aşılmayacak şekilde planlanır.

Sipariş akışı: kalem, paket ve kargo barkodu

Hepsiburada'nın sipariş modeli kalem (lineItem) bazlıdır. Trendyol'daki gibi hazır bir sevkiyat paketi gelmez; satıcı hangi kalemleri hangi kutuya koyacağına kendisi karar verir ve paketi kendisi oluşturur. Akış şöyledir:

  1. Paketlenecek kalemleri çek: GET /orders/merchantid/{merchantId}?limit=100. Dönen items[].id değeri lineItemId'dir ve tüm sonraki işlemlerin anahtarıdır. Kalem statüsü Open (yeni) veya Unpacked (paketi bozulmuş) olabilir.
  2. Birlikte paketlenebilecekleri sorgula: GET /lineitems/merchantid/{merchantId}/packageablewith/lineitemid/{lineItemId}. 404 yanıtı "birlikte paketlenecek başka kalem yok" demektir, hata değildir.
  3. Paketi oluştur: POST /packages/merchantid/{merchantId}. Gövdede lineItemRequests dizisi, desi, koli adedi ve depo bilgisi gönderilir. Yanıtta packageNumber döner.
  4. Kargo barkodunu al: GET /packages/merchantid/{merchantId} veya paket numarası bazlı uç. Etiket, HepsiJet ve Aras için zpl, pdf, png, jpg gibi biçimlerde alınabilir.
  5. Faturayı ilet: Fatura bağlantısı paket bazında gönderilir; adresin içerik tipi PDF veya HTML olmalıdır.

Sipariş listesindeki dueDate alanı, kargoya veriliş için son tarihi bildirir. Bu alan operasyonel olarak kritiktir: RapiSoft, süresi yaklaşan kalemler için panelde uyarı üretecek şekilde bu tarihi saklar. Teslim edilen, teslim edilemeyen, kargoya verilen ve iptal edilen siparişler için ayrı listeleme uçları vardır; hepsi tek listeden okunmaz.

İptal işlemi kalem bazında yapılır (cancelbymerchant) ve yalnızca Open statüsündeki kalemler için mümkündür; ayrıca günlük iptal adedi sınırlıdır. Bu nedenle stok senkronizasyonunun gecikmesiz çalışması, iptal cezalarından korunmanın en pratik yoludur.

Hepsiburada ile Trendyol entegrasyonunun somut farkları

İki pazaryeri de Basic Auth kullanır ve REST tabanlıdır; benzerlik büyük ölçüde burada biter. Aşağıdaki tablo, aynı işi yapan bir entegrasyonun iki tarafta neden farklı yazıldığını gösterir:

Trendyol ve Hepsiburada entegratör API'lerinin karşılaştırması
KonuTrendyolHepsiburada
Base adresTek API gatewayÜç ayrı host: mpop, listing-external, oms-external
Kimlik bilgisiBasic apiKey:apiSecret, sellerId yol parametresindeBasic merchantId:secretKey; merchantId hem kullanıcı adı hem yol parametresi
User-AgentBelirli bir format zorunluEntegratöre atanan sabit geliştirici kullanıcı adı; eksikse 401
Ürün gönderim biçimiJSON gövde içinde ürün dizisimultipart/form-data ile .json dosyası olarak import
Ürün alan adlarıİngilizce (title, description...)Türkçe ve attributes nesnesi içinde (UrunAdi, Marka, kg...)
Fiyat formatıSayısal, tek formatKatalogda virgüllü metin, listelemede nokta ayraçlı ondalık — iki farklı format
Stok ve fiyat güncellemeTek uçtan birlikteAyrı uçlar: price-uploads ve stock-uploads, her biri ayrı upload Id
Asenkron takipToplu istek kimliği (batch)Katalogda trackingId, listelemede upload Id
Varyant modeliAna ürün kimliği + varyant özellikleriVaryantGroupID + kategoriye özel *_variant_property alanları
Sipariş modeliHazır sevkiyat paketi gelir, statü ilerletilirKalem bazlı; paketi satıcı oluşturur, barkod paketten alınır
Sipariş sorgulamaStatü parametresiyle tek uçtanPaketlenecek, teslim edilen, iptal edilen için ayrı uçlar
WebhookSelf servis abonelik API'siTers model: entegratör kendi API'sini yazar, adresini Hepsiburada'ya bildirir
Ürün içerik güncellemeAynı ürün servisleri üzerindenAyrı servis ailesi (/api/integrator/import), hbSku bazlı
Canlıya geçişCanlı anahtarla doğrudanÜç adımlı test süreci zorunlu; trackingId ticket ile iletilir

Bu farkların en çok hissedileni sipariş tarafındadır. Trendyol'da paket hazır gelirken Hepsiburada'da paketleme kararı satıcıya aittir; bu, entegrasyonun depo süreçlerine daha yakın çalışması gerektiği anlamına gelir. RapiSoft tarafında bu fark, aynı sipariş ekranında iki farklı arka plan akışı olarak yönetilir: Trendyol için statü ilerletme, Hepsiburada için kalem seçme ve paket oluşturma.

Hepsiburada entegrasyonunda en sık yapılan hatalar

  • User-Agent header'ının unutulması. Doğru MerchantId ve anahtarla bile 401 alınır. Kimlik doğrulama sorunlarında ilk kontrol edilecek nokta budur.
  • Fiyat formatının iki servis arasında karıştırılması. Katalog import'unda nokta ayraçlı fiyat, listelemede virgüllü fiyat gönderilmesi tipik InvalidPrice nedenidir.
  • Bekleyen işlem sınırının aşılması. Aynı anda beşten fazla tamamlanmamış stok/fiyat yüklemesi olduğunda yeni gönderimler reddedilir; kuyruk yönetimi olmayan entegrasyonlar burada tıkanır.
  • Satışa hazır ürüne katalog servisinden güncelleme gönderilmesi. Bu statüdeki ürünler için hbSku bazlı güncelleme servisi kullanılmalıdır.
  • Görselin aynı URL ile değiştirilmesi. Adres değişmediği için güncelleme algılanmaz; yeni görsel yeni bir adresle gönderilmelidir.
  • Barkod tekilliğinin ihlali. Aynı barkodun farklı ürünlerde kullanılması, ürünün yanlış katalog kaydıyla eşleşmesine yol açar.
  • SKU eşlemesinin büyük/küçük harf duyarlı kurulması. MerchantSku sistemde büyük harfe dönüştüğü için eşleme kaçar.
  • Test ortamı kategori ağacının canlıya taşınması. İki ortamın kategori ağacı birebir aynı olmadığından canlıda kategori kimlikleri yeniden çekilmelidir.

Listeleme servisi hataları isimlendirilmiş olarak döner: ProductNotFound, InvalidPrice, InvalidAvailableStock, InvalidDispatchTime, OutOfPriceRange, MissingStandardCargoCompany, ListingFrozen, MerchantAlreadyListedAgainstProduct gibi. Bu adların ürün bazında panele yansıtılması, hata ayıklama süresini belirgin biçimde kısaltır; RapiSoft hataları ham kod yerine bu şekilde ürün satırında gösterir.

Hepsiburada entegrasyonunun RapiSoft altyapısındaki yeri

Hepsiburada, RapiSoft'ta bağımsız bir modül değil, tek kataloğun bağlandığı kanallardan biridir. Ürün bilgisi tek yerde tutulur; kanal bazlı fiyat ve stok kuralları bu tek kaynaktan türetilir.

Aynı panelde çalışan diğer entegrasyonlar:

  • Pazaryerleri: Trendyol, Hepsiburada, N11, ÇiçekSepeti, Pazarama, PttAVM, İdefix, Modanisa.
  • Kargo: Yurtiçi Kargo, Aras Kargo, PTT Kargo, Sürat Kargo, HepsiJet.
  • Ödeme: PayTR, havale/EFT, kapıda ödeme, taksitli satış.
  • e-Fatura ve ön muhasebe: Paraşüt, Uyumsoft.
  • ERP: Logo, Mikro, Nebim V3.
  • Pazarlama ve ölçümleme: Google Analytics 4, Google Ads, Google Merchant, Meta Pixel, Meta Katalog, Meta Conversion API, TikTok Pixel, Akakçe, Cimri.
  • Bildirim: WhatsApp Business, SMS, e-posta, sepet terk akışı.

Pratik faydası şudur: Hepsiburada'dan gelen bir sipariş, kendi sitenizden gelen siparişle aynı ekranda listelenir, aynı kargo hesabından etiketlenir ve aynı e-fatura akışına düşer. Stok, satış hangi kanaldan gelirse gelsin tüm kanallarda güncellenir.

Maliyet ve kurulum modeli

RapiSoft'ta sabit paket kademesi yoktur. Kullanılacak modül ve entegrasyonlara göre işletmeye özel teklif hazırlanır; kurulum bedeli ve satış başına komisyon alınmaz. Hepsiburada entegrasyonu, kullanılan modüller arasında yer aldığında teklif kapsamına dahil edilir.

Hepsiburada'nın kendi tarafındaki satıcı komisyonu, kargo anlaşması ve kampanya katılım koşulları pazaryeriyle satıcı arasındaki ticari sözleşmeye tabidir ve RapiSoft'un fiyatlandırmasından bağımsızdır. Komisyon oranları API üzerinden sorgulanabildiği için, kanal bazlı kâr hesaplaması panelde bu veriyle yapılabilir.

Mevcut bir mağazadan geçişte ürün, kategori ve müşteri verileri Excel/CSV ve XML akış formatlarıyla aktarılır; aktarım öncesinde önizleme alınır ve veriler onayınızla yazılır. Hepsiburada'da halihazırda satıştaki ürünleriniz varsa, listeleme servisinden çekilen mevcut listing kayıtları üzerinden SKU eşlemesi kurulur; ürünlerin yeniden gönderilmesi gerekmez.

Entegrasyon kapsamını konuşmak veya mevcut Hepsiburada mağazanızın RapiSoft'a bağlanma sürecini planlamak için info@rapisoft.com adresinden ulaşabilir, iletişim sayfasındaki formu doldurabilirsiniz.

Sıkça sorulan sorular

Hepsiburada entegrasyonu için API anahtarını nereden alıyorum?

Hepsiburada Satıcı Paneli'nde Bilgilerim bölümündeki Entegrasyon sayfasının Entegratör Bilgileri sekmesinden alınır. İlgili entegratörü seçip Servis Anahtarı butonuna basarak anahtarı kopyalarsınız. Bu anahtar, MerchantId ile birlikte RapiSoft paneline girilir. Anahtarı yenilerseniz entegratör tarafındaki kaydı da güncellemeniz gerekir, aksi halde senkronizasyon 401 hatasıyla durur.

Hepsiburada API'si Basic Auth mı kullanıyor, token mı?

Basic Auth kullanır. Authorization header'ında base64(merchantId:secretKey) gönderilir; token alma veya yenileme adımı yoktur. Buna ek olarak User-Agent header'ı zorunludur ve değeri Hepsiburada'nın entegratöre verdiği sabit geliştirici kullanıcı adıdır. Bu header eksikse doğru şifreyle bile istek reddedilir.

Ürünü gönderdim ama satışta görünmüyor, neden?

Ürün gönderimi ürünü doğrudan satışa açmaz. Gönderim asenkrondur: önce trackingId alınır, ürün incelenecek statüsüne düşer, katalog kontrolünden geçtikten sonra listing oluşur. Ayrıca listing oluşsa bile stok ve fiyat sıfırsa ürün satışa kapalı kalır. Ürün durumunu trackingId ile sorgulayarak eksik bilgi veya doğrulama hatası olup olmadığını görebilirsiniz.

Hepsiburada ile Trendyol entegrasyonu arasındaki en büyük fark ne?

Üç temel fark var. Birincisi, Hepsiburada'da tek gateway yerine üç ayrı servis hostu vardır. İkincisi, ürün gönderimi JSON gövdesiyle değil, .json dosyası yüklenerek yapılır. Üçüncüsü, sipariş modeli kalem bazlıdır: Trendyol'da hazır paket gelirken Hepsiburada'da paketi satıcı oluşturur ve kargo barkodu paketten alınır.

Stok güncellemesi Hepsiburada'ya ne kadar sürede yansıyor?

Stok ve fiyat güncellemeleri asenkron çalışır: istek gönderildiğinde bir yükleme kimliği döner, sonuç ilgili sorgu ucundan okunur. Yansıma süresi gönderim büyüklüğüne ve o anda bekleyen işlem sayısına bağlıdır. Aynı anda beşten fazla tamamlanmamış işlem olamayacağı için, entegrasyonun kuyruk mantığıyla çalışması yansıma süresini doğrudan etkiler.

Aynı ürünü hem Trendyol'da hem Hepsiburada'da satarken stok nasıl yönetiliyor?

Stok tek kaynakta tutulur. Herhangi bir kanalda satış gerçekleştiğinde ilgili SKU güncelleme kuyruğuna alınır ve bağlı tüm kanallara iletilir. Böylece iki pazaryerinde aynı anda satılan son ürün nedeniyle oluşan iptaller azalır. Hepsiburada'da satıcı kaynaklı iptaller günlük olarak sınırlı olduğu için bu senkronizasyon operasyonel olarak önemlidir.

Hepsiburada test ortamı zorunlu mu?

Evet. Hepsiburada canlıya geçiş için üç adımın test ortamında tamamlanmasını ister: ürün gönderimi ve oluşan trackingId'nin iletilmesi, stok/fiyat güncellemesi, sipariş listeleme ve paketleme. Test ortamında sipariş, ayrı bir test servisi üzerinden oluşturulur. Süreç tamamlandığında canlı ortam için ayrı bir servis anahtarı verilir.

Hepsiburada webhook desteği var mı?

Klasik anlamda self servis webhook aboneliği yoktur; model terstir. Entegratör, Hepsiburada'nın yayımladığı kontratlara uygun kendi servislerini yazar ve adres ile kimlik bilgilerini Hepsiburada'ya iletir; olaylar bu adreslere gönderilir. Bu nedenle birçok entegrasyon, ilk sürümde siparişleri düzenli aralıklarla sorgulayarak (polling) çalışır.

Halihazırda Hepsiburada'da satıştaki ürünlerimi yeniden mi göndermem gerekiyor?

Hayır. Mevcut listing kayıtlarınız listeleme servisinden çekilerek HepsiburadaSku ve MerchantSku eşlemesi kurulur. Bu eşleme kurulduktan sonra stok ve fiyat güncellemeleri doğrudan mevcut listing'ler üzerinden yürür. Yeniden ürün gönderimi yalnızca Hepsiburada kataloğunda karşılığı olmayan yeni ürünler için gerekir.

Varyantlı ürünler Hepsiburada'ya nasıl gönderiliyor?

Aynı varyant grubuna ait ürünler ortak bir VaryantGroupID değeriyle gönderilir ve kategorinin varyant özelliklerinden en az biri doldurulur. Bu alanlar kategoriye göre değişir; örneğin renk ve beden gibi özellikler kategori özellik listesinden çekilerek belirlenir. Varyant alanı boş bırakılırsa ürünler ayrı kayıtlar olarak açılır.

Hepsiburada siparişlerinin faturasını RapiSoft üzerinden kesebilir miyim?

Evet. Sipariş verileri panelde toplandığı için fatura süreci bağlı e-fatura veya ön muhasebe entegrasyonu üzerinden yürütülür. Hepsiburada tarafında fatura, paket bazında bir bağlantı adresi olarak iletilir ve bu adresin içerik tipi PDF veya HTML olmalıdır. Faturası eksik paketler ayrı bir uçtan listelenebildiği için eksikler takip edilebilir.

Hepsiburada entegrasyonu için ek ücret ödüyor muyum?

RapiSoft'ta sabit paket kademesi yoktur; teklif kullanılacak modül ve entegrasyonlara göre hazırlanır. Kurulum bedeli ve satış başına komisyon alınmaz. Hepsiburada'nın kendi satıcı komisyonu, kargo anlaşması ve kampanya koşulları ise pazaryeri ile aranızdaki ticari sözleşmeye tabidir ve RapiSoft fiyatlandırmasından bağımsızdır.

Sonraki adım

E-ticaret altyapınızı RapiSoft ile değerlendirin

İhtiyaç analizi ve teklif hazırlığı ücretsizdir. Mevcut mağazanızın taşınması dahil tüm süreç ekibimiz tarafından planlanır ve yürütülür.