Hepsiburada nedir?
Hepsiburada, Türkiye’nin önde gelen pazaryerlerinden. Satıcı olarak kendi sitenizi değil Hepsiburada’nın müşteri trafiğini ve altyapısını kullanırsınız; siparişler Hepsiburada Merchant paneline düşer, ödemeyi Hepsiburada toplar ve komisyon kesintisinden sonra hak edişinizi öder. Bir e-ticaret sitenizin aksine alıcıyla aranızda Hepsiburada durur. Bu, faturalama tarafında belirleyici farklar yaratır: sipariş verisine ancak Hepsiburada Merchant API üzerinden ulaşırsınız ve alıcı bilgilerinin bir kısmını Hepsiburada sizinle hiç paylaşmaz.
Logo nedir?
Logo, Türkiye’nin en köklü iş yazılımlarından biri. Logo Tiger orta-büyük ölçekli işletmelerde, Logo Go ise küçük-orta ölçekte muhasebe, stok, cari hesap, e-fatura ve e-arşiv işlemlerini tek çatı altında toplar. Önemli teknik özelliği on-premise (yerinde kurulum) mimarisidir: yazılım çoğunlukla kendi sunucunuzda veya yerel ağınızda çalışır. Bu, veri kontrolü açısından avantaj sağlarken Hepsiburada gibi bulut tabanlı pazaryeri API’leriyle doğrudan konuşamaması anlamına gelir — araya bir köprü katmanı gerekir.
Neden Hepsiburada ve Logo entegre edilmeli?
Hepsiburada’da her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Satış hacminiz büyüdükçe her siparişi Merchant panelinden tek tek Logo’ya girip fatura kesmek hem saatler alır hem hata üretir. Manuel akışta tek tek panel veya CSV indirme derdi, doğru kurulmuş bir Hepsiburada-Logo akışıyla ortadan kalkar:
- Otomatik fatura kesimi: Sipariş Merchant API’den çekilir, Logo’da e-arşiv veya e-fatura otomatik oluşur; manuel panel/CSV indirme süreci biter.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, VKN giren kurumsal talebe e-fatura — ayrım otomatik yönetilir.
- Komisyon mutabakatı: Brüt satış faturalanır, Hepsiburada komisyon ve kesintileri Logo’da ayrı gider kaydı olur; hak ediş raporuyla mutabakat tutar.
- Tutarlı cari hesap: Aynı alıcı için mükerrer cari açılmaz, Logo raporlaması temiz kalır.
- On-premise uyumu: Logo sunucunuzdaki kurulumu bozmadan, bulut pazaryeriyle güvenli köprü üzerinden bağlanır.
- GİB uyumu: Kesim Logo’nun e-fatura/e-arşiv modülü üzerinden GİB’e gider, mevzuat takibi size kalmaz.
Manuel akışta yoğun kampanya dönemlerinde fatura takibi tek başına bir kişinin işine dönüşür; otomatik akışta sipariş hacmi artsa bile süreç kendiliğinden yürür.
Hepsiburada Logo entegrasyonu nasıl yapılır?
Önce dürüst olalım: Hepsiburada ile Logo arasında tek tıkla kurulan resmi bir entegrasyon yok. Logo on-premise çalıştığından, bulut tabanlı Merchant API ile arasına bir köprü katmanı gerekir. Zeisoft olarak bu akışı uçtan uca kuruyoruz:
- Mevcut süreci inceliyoruz: Hepsiburada sipariş hacminizi, kategori karmanızı ve mevcut Logo kurulumunuzu (Tiger mı Go mu, hangi sürüm, e-fatura modülü aktif mi) belirliyoruz.
- Yöntemi seçiyoruz: Hepsiburada Merchant API üzerinden custom köprü kurulumunu ve mevcut Logo ara katman araçlarınızın uygunluğunu değerlendiriyoruz; lisanslar müşteride, kurulum bizde.
- API erişimini açıyoruz: Hepsiburada Merchant Center’dan geliştirici/Merchant ID ve API kimlik bilgileri alınır; sipariş çekme aralığı ve fatura tetikleme statüsü yapılandırılır.
- Köprüyü kuruyoruz: Katman Merchant API’den siparişi çeker, Logo’nun beklediği formata dönüştürüp Logo veritabanına güvenli bağlantıyla yazar; sunucu erişimi/VPN gereksinimleri netleştirilir.
- Fatura kurallarını tanımlıyoruz: e-arşiv/e-fatura ayrımı, KDV haritalaması, komisyon gider kaydı ve cari eşleşme kuralları birlikte kurgulanır.
- Test ediyoruz: Gerçek 5-10 Hepsiburada siparişi üzerinde — bireysel, kurumsal, iade — kesimi, iade senaryosunu ve komisyon kaydını doğruluyoruz.
- Bakım veriyoruz: Hepsiburada Merchant API ve Logo sürüm değişikliklerini bakım anlaşmasıyla takip ediyoruz; güncelleme sonrası akışın bozulmasını önlüyoruz.
Sıkça karşılaşılan sorunlar
Hepsiburada-Logo akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eksik alıcı bilgisi. Hepsiburada bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla maskeler ya da vermez. Çözüm: varsayılanı e-arşiv fatura olarak kurmak, yalnızca alıcı kurumsal fatura talep edip VKN girdiğinde Logo’da e-fatura mükellefi kontrolü yapıp e-fatura kesmek.
- Gecikmeli fatura. Merchant API webhook yerine sorgulama (polling) ile çalıştığından, sorgu aralığı geniş tutulursa fatura geç kesiliyor. Çözüm: sipariş çekme aralığını yoğunluğa göre 5-15 dakikaya ayarlamak ve doğru statüde tetiklemek.
- Logo sürüm güncellemesi köprüyü bozuyor. Logo’nun büyük sürüm geçişleri veritabanı yapısını değiştirebiliyor; custom köprü güncellenmezse fatura kesimi durur. Çözüm: bakım anlaşmasıyla her Logo güncellemesinden önce köprüyü test edip uyarlamak.
- Komisyonun muhasebeye yansımaması. Yalnızca brüt satış faturalanıp Hepsiburada kesintileri Logo’ya işlenmediğinde, banka hesabınıza geçen net hak ediş Logo cirosuyla tutmuyor. Çözüm: komisyon, hizmet ve kargo bedellerini hak ediş raporundan okuyup Logo’da ayrı gider/cari kaydı olarak işlemek.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıya çıktıktan sonra düzeltmek katbekat iş yükü yaratır.