Hepsiburada nedir?
Hepsiburada, Türkiye’nin en büyük pazaryerlerinden biridir. Satıcı olarak ürünlerinizi Hepsiburada Marketplace üzerinden listeler, siparişleri Merchant panelinden veya satıcılara açık Merchant API üzerinden yönetirsiniz. Pazaryeri olması, alıcıyla doğrudan ilişkinizin platformun kuralları içinde kaldığı anlamına gelir: alıcı verisi maskelenebilir, kargo seçeneği çoğu zaman platformun lojistiği üzerinden kurgulanır ve fatura kesim sorumluluğu size aittir.
Paraşüt nedir?
Paraşüt, Türkiye’deki KOBİ’lerin yaygın kullandığı bulut tabanlı ön muhasebe ve e-fatura yazılımıdır. e-fatura ve e-arşiv mükellefiyetiniz için GİB ile bağlantıyı sağlar; cari hesap, gelir-gider takibi, banka entegrasyonları ve raporlama tek panelde toplanır. Pazaryeri satışlarınızın faturalandığı yer burasıdır, ancak Paraşüt’ün Hepsiburada’ya bakan hazır bir butonu yoktur.
Neden Hepsiburada ve Paraşüt entegre edilmeli?
Hepsiburada’dan gelen her sipariş için yasal olarak fatura kesmeniz gerekir. Sipariş hacmi arttığında bunu Merchant panelinden tek tek indirip Paraşüt’e elle girmek hem zaman kaybı hem hata kaynağı olur. Doğru kurulmuş bir akış şunları sağlar:
- Otomatik fatura kesimi: Sipariş Merchant API’den çekilir, Paraşüt’te e-arşiv veya e-fatura otomatik oluşur.
- Bireysel/kurumsal ayrımı: Alıcı kurumsal fatura bilgisi girdiyse e-fatura, girmediyse e-arşiv otomatik seçilir.
- Maskeli alıcı verisiyle uyum: Hepsiburada’nın KVKK gereği maskelediği alanlara rağmen fatura mevzuata uygun kesilir.
- Temiz cari kayıtları: Aynı alıcı için mükerrer cari açılmaz, raporlama tutarlı kalır.
- Komisyon giderleri takibi: İstenirse Hepsiburada’nın size kestiği komisyon/hizmet faturaları Paraşüt’te gider olarak kaydedilir.
Manuel akışta bir kişinin tam zamanlı işi olan pazaryeri fatura takibi, otomatik akışta kendiliğinden yürür.
Hepsiburada Paraşüt entegrasyonu nasıl yapılır?
Önemli nokta: Hepsiburada ile Paraşüt’ün resmi, hazır bir bağlayıcısı yoktur. Bağlantıyı ya 3rd party orchestration platformu (Sentos, Platin360, Sopyo) ya da Merchant API üzerine yazdığımız custom köprü ile kuruyoruz. Zeisoft olarak süreç:
- Sipariş hacminizi ve başka pazaryerleri (Trendyol, n11 vb.) de yönetip yönetmediğinizi inceliyoruz — bu, orchestration mı yoksa custom köprü mü kararını belirler.
- Hepsiburada Merchant API erişimini ve Paraşüt API erişimini açıyoruz.
- Test siparişleriyle Merchant API’den hangi alıcı alanlarının (maskeli/maskesiz) geldiğini doğruluyor, e-arşiv/e-fatura ayrım kuralını ve fatura şablonunu buna göre kuruyoruz.
- İade/iptal akışını ve istenirse komisyon faturası kayıt kuralını birlikte tanımlıyoruz.
- Canlı geçişten sonra ilk hafta günlük kontrol yapıyor, sorun çıkarsa anında düzeltiyoruz.
- Bakım anlaşmasıyla uzun vadeli destek veriyoruz — Merchant API ve Paraşüt API güncellemelerini takip etmek size kalmıyor.
Sıkça karşılaşılan sorunlar
Hepsiburada-Paraşüt akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Maskeli alıcı bilgisiyle fatura hatası. Hepsiburada bireysel siparişlerde TC ve bazı iletişim alanlarını maskeler; akış maskesiz veri beklerse fatura kesimi takılır. Çözüm: test siparişleriyle gelen alanları doğrulayıp e-arşiv şablonunu maskeli veriyle çalışacak şekilde kurmak.
- Bireysel sipariş için yanlışlıkla e-fatura denemesi. Kurumsal/bireysel ayrımı kurulmazsa sistem her siparişe e-fatura kesmeye çalışır, bireysel alıcıda hata verir. Çözüm: Merchant API’deki fatura bilgisine bakarak varsayılanı e-arşiv yapıp, yalnızca VKN geldiğinde e-fatura’ya geçmek.
- Komisyon faturalarının atlanması. Hepsiburada’nın size kestiği komisyon ve hizmet faturaları gider tarafıdır; satış faturalarıyla karıştırılır veya hiç kaydedilmez, mutabakat şişer. Çözüm: komisyon giderlerini ayrı bir akışla Paraşüt’te doğru hesaba işlemek.
- İade sonrası faturanın aktif kalması. İade statüsü Paraşüt’e taşınmadığında fatura iptal/iade edilmez, KDV beyanı yanlış görünür. Çözüm: kurulumda iade akışını netleştirip iptal veya iade faturası kuralını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek 3-5 kat iş yükü yaratır.