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:
| Entegrasyon | Ne yapar | Canlı base | Test (SIT) base |
|---|---|---|---|
| Katalog / Ürün | Kategori, özellik, ürün gönderimi | mpop.hepsiburada.com/product | mpop-sit.hepsiburada.com/product |
| Listeleme | Stok, fiyat, kargo süresi | listing-external.hepsiburada.com | listing-external-sit.hepsiburada.com |
| Sipariş (OMS) | Sipariş, paket, iptal, fatura | oms-external.hepsiburada.com | oms-external-sit.hepsiburada.com |
| Test sipariş stub'ı | Test ortamında sahte sipariş üretir | Canlıda yok | oms-stub-external-sit.hepsiburada.com |
| Satıcıya Sor | Müşteri soru-cevapları | api-asktoseller-merchant.hepsiburada.com | api-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ığındaInvalidPricehatası 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ı
VaryantGroupIDdeğ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:
| İşlem | Metot | Uç | Sonuç |
|---|---|---|---|
| Listing sorgulama | GET | /listings/merchantid/{merchantId} | SKU eşlemesi, IsSalable, IsLocked |
| Fiyat güncelleme | POST | /listings/merchantid/{merchantId}/price-uploads | upload Id |
| Stok güncelleme | POST | /listings/merchantid/{merchantId}/stock-uploads | upload Id |
| Tam envanter güncelleme | POST | /listings/merchantid/{merchantId}/inventory-uploads | upload Id |
| İşlem sonucu sorgulama | GET | .../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-Resetheader'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:
- Paketlenecek kalemleri çek:
GET /orders/merchantid/{merchantId}?limit=100. Dönenitems[].iddeğeri lineItemId'dir ve tüm sonraki işlemlerin anahtarıdır. Kalem statüsüOpen(yeni) veyaUnpacked(paketi bozulmuş) olabilir. - Birlikte paketlenebilecekleri sorgula:
GET /lineitems/merchantid/{merchantId}/packageablewith/lineitemid/{lineItemId}. 404 yanıtı "birlikte paketlenecek başka kalem yok" demektir, hata değildir. - Paketi oluştur:
POST /packages/merchantid/{merchantId}. GövdedelineItemRequestsdizisi, desi, koli adedi ve depo bilgisi gönderilir. YanıttapackageNumberdöner. - 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. - 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:
| Konu | Trendyol | Hepsiburada |
|---|---|---|
| Base adres | Tek API gateway | Üç ayrı host: mpop, listing-external, oms-external |
| Kimlik bilgisi | Basic apiKey:apiSecret, sellerId yol parametresinde | Basic merchantId:secretKey; merchantId hem kullanıcı adı hem yol parametresi |
| User-Agent | Belirli bir format zorunlu | Entegratöre atanan sabit geliştirici kullanıcı adı; eksikse 401 |
| Ürün gönderim biçimi | JSON gövde içinde ürün dizisi | multipart/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 format | Katalogda virgüllü metin, listelemede nokta ayraçlı ondalık — iki farklı format |
| Stok ve fiyat güncelleme | Tek uçtan birlikte | Ayrı uçlar: price-uploads ve stock-uploads, her biri ayrı upload Id |
| Asenkron takip | Toplu istek kimliği (batch) | Katalogda trackingId, listelemede upload Id |
| Varyant modeli | Ana ürün kimliği + varyant özellikleri | VaryantGroupID + kategoriye özel *_variant_property alanları |
| Sipariş modeli | Hazır sevkiyat paketi gelir, statü ilerletilir | Kalem bazlı; paketi satıcı oluşturur, barkod paketten alınır |
| Sipariş sorgulama | Statü parametresiyle tek uçtan | Paketlenecek, teslim edilen, iptal edilen için ayrı uçlar |
| Webhook | Self servis abonelik API'si | Ters model: entegratör kendi API'sini yazar, adresini Hepsiburada'ya bildirir |
| Ürün içerik güncelleme | Aynı ürün servisleri üzerinden | Ayrı 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
InvalidPricenedenidir. - 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.