Trendyol nedir?
Trendyol, Türkiye’nin en büyük pazaryeridir. Satıcı olarak Trendyol Mağaza üzerinden satış yaparsınız; ürün listeleme, sipariş, kargo ve tahsilat akışı Trendyol’un kontrolündedir. Kendi e-ticaret sitenizin aksine müşteriyle doğrudan ilişki kurmazsınız, alıcıyla aranızda Trendyol durur. Bu, faturalama tarafında belirleyici farklar yaratır: sipariş verisine ancak Trendyol Seller API üzerinden ulaşırsınız, alıcı bilgilerinin bir kısmını ise Trendyol sizinle hiç paylaşmaz.
Bir-Fatura nedir?
Bir-Fatura, uygun fiyatı ve sade arayüzüyle özellikle küçük ve orta ölçekli işletmeler arasında yaygınlaşan bir GİB özel entegratörüdür. e-fatura ve e-arşiv kesim yetkisine sahiptir; yani Trendyol siparişinizin faturası Bir-Fatura üzerinden doğrudan GİB’e iletilir. Dikkat edilmesi gereken nokta şu: Bir-Fatura bir muhasebe yazılımı değil, bir fatura kesim katmanıdır. Cari hesap, gelir-gider takibi veya stok yönetimi beklemeyin; işi hızlı ve düşük maliyetli fatura kesmektir. Bu yüzden Trendyol akışında onu bir faturalama motoru gibi konumlandırıyoruz.
Neden Trendyol ve Bir-Fatura entegre edilmeli?
Trendyol’da her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Yoğun dönemde günde yüzlerce siparişi Bir-Fatura paneline tek tek girip faturalamak sürdürülebilir değil. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik fatura kesimi: Trendyol’a düşen sipariş Seller API üzerinden çekilir, Bir-Fatura’da otomatik e-arşiv veya e-fatura olarak kesilir.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, VKN giren kurumsal alıcıya e-fatura — ayrımı sistem kendisi yapar.
- Maliyet avantajı korunur: Bir-Fatura’nın uygun lisans maliyetinden vazgeçmeden, manuel iş yükünü sıfıra indirirsiniz.
- Temiz fatura kaydı: Aynı alıcı için mükerrer kayıt açılmaz, e-arşiv/e-fatura ayrımı tutarlı kalır.
- GİB uyumu: Fatura kesimi Bir-Fatura üzerinden doğrudan GİB’e gönderilir, manuel beyan derdi kalmaz.
Manuel akışta bir kişinin tam zamanlı işi olan Trendyol fatura takibi, otomatik akışta kendiliğinden yürür.
Trendyol Bir-Fatura entegrasyonu nasıl yapılır?
Önce dürüst olalım: Trendyol ile Bir-Fatura arasında tek tıkla kurulan resmi bir entegrasyon yok. Bir-Fatura siparişleri kendi başına Trendyol’dan çekmez, araya sipariş çeken bir katman gerekiyor. Zeisoft olarak bu katmanı kuruyor ve sipariş hacminize göre doğru yöntemi seçiyoruz:
- Mevcut süreci inceliyoruz: Aylık Trendyol sipariş hacmi, başka pazaryeri/site kullanıp kullanmadığınız ve fatura kurallarınız belirleniyor.
- Yöntemi seçiyoruz: Tek pazaryeri ve orta hacim için bir orchestration platformu (Sentos, Platin360 vb.) yeterli olabilir; özel iş kuralları veya çoklu kanal varsa Trendyol Seller API üzerine custom köprü kuruyoruz.
- API erişimini açıyoruz: Trendyol Seller Center’dan Supplier ID, API Key ve API Secret alınır; Bir-Fatura tarafında fatura kesim API erişimi yapılandırılır.
- Fatura kurallarını tanımlıyoruz: e-arşiv/e-fatura ayrımı, KDV haritalaması ve eksik müşteri bilgisi senaryoları Bir-Fatura tarafında kurgulanır.
- Kapasiteyi koruma altına alıyoruz: Bir-Fatura’nın istek sınırına takılmamak için kuyruk sistemi ve yeniden deneme mekanizması ekliyoruz.
- Test ediyoruz: Gerçek 5-10 Trendyol siparişi üzerinde — bireysel, kurumsal, iade — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: Trendyol API kural değişiklikleri ve Bir-Fatura güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (Trendyol, Bir-Fatura, varsa orchestration platformu) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Trendyol-Bir-Fatura akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eksik alıcı bilgisi. Trendyol bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla vermez. Çözüm: Bir-Fatura’da varsayılanı e-arşiv olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura kesmek.
- Yoğun dönemde API darboğazı. Bir-Fatura’nın istek kapasitesi, Efsane Kasım veya 11.11 gibi sipariş patlamalarında sınıra dayanıyor ve faturalar takılıyor. Çözüm: Trendyol’dan gelen siparişleri kuyruğa alıp Bir-Fatura’ya kontrollü istek aralığıyla göndermek, hataları otomatik tekrar denemek.
- Gecikmeli fatura. Trendyol 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.
- İade sonrası fatura aktif kalması. Trendyol’da iade onaylandığında Bir-Fatura’da fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: ‘Returned’/‘Cancelled’ statü değişimini API’den yakalayıp iade akışını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.