Entegrasyon
Hepsiburada Entegrasyonu: Ürün, Stok, Fiyat ve Sipariş Yönetimi
Hepsiburada entegrasyonu, ürün, stok, fiyat ve siparişlerinizi Hepsiburada'nın satıcı API'si üzerinden Shopify mağazanız, siteniz ya da ERP'nizle eşitler. Katalog eşleştirmesinden paketleme ve faturaya kadar akışı kuruyoruz.
Hepsiburada entegrasyonu, ürünlerinizi Hepsiburada'da listeleyen, stok ve fiyatı merkez sisteminizden güncel tutan ve siparişleri paketleme, kargo ve fatura adımlarıyla birlikte geri getiren bağlantıdır. Hepsiburada satıcılara ürün, listeleme, sipariş ve iade süreçleri için bir satıcı API'si (Merchant API) sunar; entegrasyon bu servislerin üzerine kurulur.
Merkez sistem bir Shopify mağazası, Laravel ile geliştirilmiş özel bir site ya da ERP olabilir. Hepsiburada entegrasyonunu bu sistemlerden birine bağlayarak panelde elle stok ve fiyat güncellemeyi bırakmanızı hedefliyoruz. Hepsiburada'yı diğer pazaryerleriyle birlikte ele alan kurgu için pazaryeri entegrasyonu, genel mimari için entegrasyon hizmetleri sayfamıza bakabilirsiniz.
Hepsiburada entegrasyonu ile Hepsijet entegrasyonu farkı
İki konu sık karıştırılır. Hepsijet, Hepsiburada'nın kargo şirketidir ve Hepsiburada dışındaki sitelerin gönderilerini de taşır. Hepsijet gönderimleri bir kargo entegrasyonu işidir; bunu kargo entegrasyonu sayfasında anlattık.
Hepsiburada pazaryeri entegrasyonu ise ürün ve siparişin Hepsiburada'daki mağazanızla eşitlenmesidir ve ayrı bir projedir. Bu sayfa o işi anlatıyor.
Hepsiburada API'si ile hangi veriler akar?
| Alan | Hepsiburada tarafında | Merkez sistemde |
|---|---|---|
| Ürün ve katalog | Kategori, zorunlu özellikler, yeni ürün gönderimi, içerik kontrolü | Ürün kartı, varyant, barkod, görseller |
| Listeleme | Satıcı stok koduyla fiyat, stok ve kargoya veriliş süresi | Stok kaynağı ve kanal fiyat kuralı |
| Sipariş | Yeni siparişler, paketleme, kargo bilgisi | Sipariş kaydı, stok düşümü, toplama listesi |
| Fatura | Paket için fatura bağlantısının iletilmesi | E-fatura ya da e-arşiv |
| İade ve talepler | Müşterinin iade ve iptal talepleri | Stok iadesi, iade belgesi |
Ürünü katalogla eşleştirmek mi, yeni ürün açmak mı?
Hepsiburada'da aynı ürün sayfasında birden fazla satıcı yer alabilir. Bu yüzden ürün göndermenin iki yolu vardır. Ürün Hepsiburada kataloğunda zaten varsa, kendi satıcı stok kodunuzla o ürünün Hepsiburada SKU'suna bağlanırsınız. Mevcut ürüne eşleştirmede içerik hazırdır, siz fiyat ve stok verirsiniz. Katalogda olmayan ürünler ise yeni ürün olarak kategori, zorunlu özellikler, barkod, görseller ve açıklamayla gönderilir ve Hepsiburada'nın içerik kontrolünden sonra satışa açılır.
Entegrasyonda her ürünün hangi yoldan gittiğini ve onay durumunu bir listede izleriz. Reddedilen ürünler red nedeniyle birlikte görünür, eksik özellik tamamlanınca tek düğmeyle yeniden gönderilir. Barkodu olmayan, varyantları tutarsız ya da marka adı Hepsiburada'daki kayıtla uyuşmayan ürünler onay sürecini uzatır; bunları gönderimden önce bir raporla ayıklarız.
Stok ve fiyat güncellemesi
Hepsiburada'da fiyat ve stok, listeleme servisi üzerinden satıcı stok kodunuza göre güncellenir. Toplu güncellemeler sıraya alınır ve sonucu ayrı bir sorguyla döner; entegrasyon bu sonucu kontrol etmeden bir güncellemeyi tamamlandı saymaz.
Komisyon ve hizmet bedelleri kategoriye göre değiştiği için Hepsiburada fiyatı merkez fiyattan bir fiyat kuralıyla hesaplanır. Bu kural yüzde ya da sabit fark, yuvarlama ve taban fiyattan oluşur. Diğer kanallarla paylaşılan stok bir güvenlik payı (stok tamponu) düşülerek gönderilir, böylece son birkaç ürün için fazla satış riski azalır.
Ürünün kaç günde kargoya verileceği listelemede belirtilir. Siparişe göre üretilen ya da tedarikçiden gelen ürünlerde bu kargoya veriliş süresi ürün grubuna göre ayrı tanımlanabilir. Stok değişiklikleri kısa aralıklarla, tam katalog karşılaştırması ise trafiğin düşük olduğu saatlerde gönderilir.
Sipariş, paketleme, kargo ve fatura
Hepsiburada siparişleri düzenli aralıklarla çekilir ve merkez sisteme kaynak bilgisiyle aktarılır. Siparişin satırları paketlenir, paket için kargo bilgisi ve barkod alınır. Gönderi çoğunlukla Hepsiburada'nın anlaşmalı kargo firmalarıyla yapılır; kendi kargo anlaşmanızla çalışıyorsanız akış buna göre kurulur.
Fatura tarafında alıcının mükellefiyetine göre e-fatura ya da e-arşiv kesilir ve belge bağlantısı Hepsiburada'ya iletilir. Bireysel ve kurumsal faturalı siparişlerin ayrımı burada önemlidir: Sipariş kurumsal fatura bilgisi içeriyorsa vergi numarası ve unvan faturaya doğru aktarılmalıdır. Fatura seçenekleri e-fatura entegrasyonu sayfasında.
İade ve iptal talepleri
Müşterinin iade ya da iptal talebi Hepsiburada'da başlar. Entegrasyon talepleri çeker, onaylanan iadede stoku merkez sisteme geri alır ve iade belgesinin düzenlenmesi için muhasebeye bildirim üretir. Kısmi iadede yalnızca iade edilen satır işlenir. Sipariş kargoya verilmeden iptal edilirse ayrılan stok serbest bırakılır ve diğer kanallara yeniden açılır.
Merkez sistem Shopify, özel site ya da ERP olabilir
Shopify'ın kendi satış kanalları arasında Hepsiburada yoktur. App Store'daki üçüncü taraf uygulamalar tek mağaza ve standart akış için yeterli olabilir. Stok ERP'den geliyorsa ya da kanal bazlı fiyat gerekiyorsa bağlantıyı özel kurarız. Shopify tarafındaki seçenekler Shopify entegrasyonu sayfasında.
Merkez sistem özel bir siteyse Hepsiburada modülü sitenizin yönetim paneline eklenir. Eşleme, fiyat kuralı ve sipariş ekranı aynı yerden yönetilir.
ERP merkezli yapıda Hepsiburada siparişi doğrudan ERP'de sipariş ya da fatura belgesi olarak açılır, stok ve fiyat ERP'den gelir. Belge ve cari kuralları ERP entegrasyonu sayfasında anlattığımız yöntemle kurulur.
Hepsiburada mağazanızı merkez sisteminize bağlayalım
Ürün sayınızı, stoku nerede tuttuğunuzu ve faturayı hangi sistemden kestiğinizi yazın. Hazır bir programın yetip yetmeyeceğini ya da nasıl bir özel entegrasyon gerektiğini birlikte netleştirelim.
Hepsiburada entegrasyonu nasıl kurulur?
- API erişimi. Hepsiburada satıcı hesabınız üzerinden entegrasyon erişim bilgileri alınır; mümkünse test ortamı açılır.
- Ürün analizi. Hangi ürünlerin katalogdaki ürünlere eşleşeceği, hangilerinin yeni ürün olarak gideceği belirlenir.
- Eşleme ve kurallar. Kategori özellikleri, fiyat kuralı, stok tamponu ve kargoya veriliş süreleri yazılı hale getirilir.
- Geliştirme. Listeleme, sipariş, paketleme, fatura ve iade akışı kuyruk ve hata ekranıyla birlikte yazılır.
- Pilot. Sınırlı bir ürün grubuyla canlıya çıkılır, ilk siparişler paketlemeden faturaya kadar birlikte kontrol edilir.
- Canlı ve izleme. Tüm katalog açılır; reddedilen ürünler, bekleyen paketler ve fiyat güncellemelerinin sonuçları izlenir.
Sık yapılan hatalar
Katalogda olan bir ürünü eşleştirmek yerine yeni ürün olarak yeniden açmaya çalışmak, onay sürecini gereksiz yere uzatır. Merkez sistemde satıcı stok kodu değişirse Hepsiburada'daki listeleme bağlantısı kopar. Kargoya veriliş süresi gerçekçi girilmezse gecikmeler satıcı puanını etkiler. Kurumsal fatura bilgisi atlanıp vergi numarası faturaya geçmezse belge yeniden düzenlenmek zorunda kalır.
Hepsiburada entegrasyonu maliyetini belirleyen kalemler
- Merkez sistem: Shopify, özel site ya da ERP
- Ürün ve varyant sayısı; katalog eşleştirmesi ile yeni ürün oranı
- Fiyat ve stok kurallarının karmaşıklığı
- Sipariş hacmi ve paketleme akışı
- Fatura ve iade akışının kapsama dahil olup olmadığı
- Diğer pazaryerleriyle ortak bir yapı kurulup kurulmayacağı
Canlıda çalışan ilgili işlerimiz
Hepsiburada pazaryeri entegrasyonunu her işletmenin merkez sistemine göre ayrı bir proje olarak kuruyoruz. Bu projelerde kullandığımız yapı taşlarının canlıda çalışan örnekleri şunlar:
- Shopify mağazalarında Yurtiçi Kargo gönderimleri
- Shopify ile Nebim V3 arasında sipariş, stok ve ürün aktarımı
- Siparişlerden otomatik Paraşüt e-fatura
- Pazaryerleri ve dış sistemler için XML ürün akışları (XML Product Export & XML Feed)
Entegrasyonu canlıya aldıktan sonra Hepsiburada'nın API ve kategori değişikliklerini bakım ve destek kapsamında takip ediyoruz.
SSS