Trendyol & Hepsiburada fatura otomasyonu
Türk e-ticaret pazarı 2024 itibariyle 1.5 trilyon TL hacme ulaştı — Trendyol (~%32 pazar payı), Hepsiburada (~%21), n11 (~%9) ve Çiçeksepeti gibi yerli markalar etrafında konsolide oldu. Bu pazaryerlerinde satış yapan markaların ortak sorunu: aylık binlerce sipariş için manuel fatura kesimi imkansız, iade akışı (ortalama %18-22) hızlı yönetilmek zorunda, kargo entegrasyonu (Aras, MNG, Yurtiçi) ayrı sistemde tutulamayacak kadar yoğun. Bu rehber pazaryerlerinin API yapısı, otomatik fatura kesim akışı ve iade-değişim yönetimini açıklıyor.
Pazaryerlerinin API mimarisi
Dört ana pazaryerinin API yapısı:
- Trendyol Seller API: REST, webhook destekli, OAuth2 token, günlük 10.000 istek limiti, sipariş + iade + iade onayı + kargo
- Hepsiburada Marketplace API: REST + XML, API anahtarı, daha yavaş webhook (15 dakika gecikme)
- n11 Pro API: REST, sipariş push + iade çekme, eşitleme ortalama 30 dakika
- Çiçeksepeti API: tarihli ürün için ek alan (teslim tarihi, kampanya kodu), webhook destekli
Otomatik e-Arşiv fatura kesimi
Pazaryerinden gelen siparişin tüketici son müşteri (B2C) olması durumunda e-Arşiv kesilir. Akış:
- Pazaryeri webhook'u sipariş bilgilerini gönderir (TCKN, adres, ürün, KDV)
- Entegratör yazılımı TCKN/VKN doğrulaması yapar (yabancı alıcılar için ilgili kimlik bilgisi)
- İnternet satışında e-Arşiv zorunluluğu ve GİB'in belirlediği tutar eşikleri kontrol edilir
- Fatura ürün-bazlı KDV oranı ile kesilir (genel %20, indirimli %10/%1)
- QR kod ve PDF link sipariş ekranına ve müşteriye SMS'e eklenir
İade akışı: %18-22 oran nasıl yönetilir?
Trendyol iade oranı kategori bazında %12-30 arasında değişir. İade akışı:
- Müşteri pazaryeri panelinden iade başlatır
- Entegratör yazılımı iade onayını alır ve iade belgesini hazırlar
- İade faturası orijinal faturaya referansla (UBL replacedInvoice tag)
- Stok tekrar girer, müşteriye bildirim SMS'i
- İade faturası muhasebede çıkış KDV'sini azaltır
Kargo entegrasyonu
Kargo etiketi otomatik üretimi için ana entegrasyonlar:
- Aras Kargo: WSDL/REST API, gönderici-alıcı bilgileri ile etiket PDF
- MNG Kargo: REST, küme bazlı toplu etiket desteği
- Yurtiçi Kargo: REST, hızlı API ama webhook yok (pull-based takip)
- Sürat Kargo: REST, B2C optimize, takip numarası anlık
- PTT Kargo: SOAP, devlet kuruluşu, fiyat avantajlı
Yıllık ciro raporlama: GİB için tek listesi
Pazaryeri komisyon faturaları (Trendyol ~%18, Hepsiburada ~%14) gider olarak ayrı listelenir. Yıl sonunda toplam satış icmali brüt-net ayrımı ile, KDV-1 beyannamesine bağlı icmal hazır. Yıllık ciro pazaryeri başına raporlanabilir.
4b2b Türkiye'de bu konu için resmî bir entegrasyon sunmaz: GİB e-Fatura/e-Arşiv/e-Defter, SGK e-Bildirge, KEP veya muhasebe yazılımı (Logo, Mikro, Paraşüt) bağlantısı yoktur. Türkiye'de sunulan hizmetler 4invoices (PDF fatura, numaralandırma, müşteri kartları, yapılandırılabilir KDV oranları, ödeme bağlantısı), 4notify (SMS ve WhatsApp bildirimleri), 4hosting (AB'de barındırma) ve 4buildsite'tır (web sitesi oluşturucu). Yasal yükümlülükler için mali müşavirinizle ve GİB onaylı bir özel entegratörle çalışın.
Sıkça sorulan sorular
Trendyol'da kategori değişikliği yaparsam fatura akışı bozulur mu?
Genellikle hayır. Entegratör yazılımları ürün bazlı KDV oranını ürün master kartından alır. Kategori değişikliği fatura akışını etkilemez; ancak KDV oranı değişmesi gerekiyorsa ürün kartından güncelleme yapılmalıdır.
Hepsiburada'dan gelen B2B sipariş için ne yapmalı?
Hepsiburada B2B siparişlerinde alıcı VKN ile gelir. Entegratörünüz e-Fatura mukayyit listesini sorgular; mukayyit ise e-Fatura, değilse e-Arşiv kesilir (her iki durumda da B2B fatura).
Çiçeksepeti'nin tarihli teslimi nasıl faturalandırılır?
Çiçeksepeti API teslim tarihi bilgisini gönderir. e-Arşiv faturası sipariş tarihinde değil teslim tarihinde kesilebilir (KDV açısından teslim tarihi referans). Bu ayrımı entegratör yazılımınızda doğru yapılandırın.
