Bir e-pin sitesinde günde yüzlerce sipariş gecikmeden teslim edilirken, faturalar hâlâ ay sonunda tek tek elle kesiliyorsa bir çelişki var demektir. Ürün saniyeler içinde otomatik teslim ediliyor ama vergi kaydı gün sonuna, hatta hafta sonuna kalıyor. Bu yazıda otomatik fatura kesmenin teknik olarak ne anlama geldiğini, hangi entegratörlerle nasıl konuşulduğunu ve Pinova gibi bir e-pin scriptinde bunun sipariş akışına nereden bağlandığını anlatıyoruz.
E-pin siparişleri bittiğinde fatura neden hâlâ ayrı bir dünyaya düşüyor?
Çoğu e-pin ve dijital ürün sitesinde teslimat tarafı otomatikleşmiş durumda: ödeme onaylanır, tedarikçi API'sinden kod çekilir, müşteriye anında gösterilir. Ama fatura süreci genelde bu hattın tamamen dışında kalır. Sipariş verisi bir Excel'e ya da rapor ekranına düşer, muhasebeci ya da site sahibi bunu haftalık/aylık toplu olarak e-Fatura veya e-Arşiv portalına elle girer.
Bu kopukluğun somut maliyetleri var:
- Yoğun kampanya günlerinde yüzlerce satırı elle girerken satır atlama veya tutar hatası riski
- Müşterinin "faturamı nereden alacağım" sorusuna anlık cevap verilememesi
- Ay sonu muhasebe kapanışının sipariş raporu ile fatura kayıtlarının tutmaması
- İade/iptal olan siparişlerde iade faturasının unutulması
Otomatik fatura kesme entegrasyonu bu kopukluğu kapatır: sipariş onaylandığı anda, aynı işlem içinde fatura da kesilir ve kayıt altına alınır.
Otomatik fatura kesme tam olarak nasıl bir mekanizma?
Türkiye'de dijital ürün satışında iki fatura türü öne çıkar: kurumsal müşterilere (vergi mükellefi) e-Fatura, bireysel müşterilere e-Arşiv Fatura. İkisi de sonuçta GİB (Gelir İdaresi Başkanlığı) altyapısına bağlı bir e-fatura entegratörü üzerinden kesilir; site kendisi doğrudan GİB'e bağlanmaz, aradaki entegratör firmanın API'sini kullanır.
Otomasyonun işleyişi özetle şöyledir:
- Sipariş tamamlandığında script, fatura kesilecek bilgileri (müşteri adı/unvanı, TC/VKN, adres, ürün, tutar, KDV oranı) JSON olarak hazırlar
- Bu veri entegratörün REST API'sine (genelde API kullanıcı adı + şifre + GB kodu ile kimlik doğrulaması yapılarak) gönderilir
- Entegratör faturayı üretir, GİB'e iletir, bir UUID (fatura kimlik numarası) ve PDF çıktısı döner
- Site bu UUID ve PDF linkini sipariş kaydına işler, müşteri panelinde "Faturanı Görüntüle" bağlantısı olarak sunar
Bütün bu adımlar, ürün teslimatıyla aynı saniyede, kullanıcı hiçbir şey fark etmeden tamamlanır.
Hangi entegratörler bir e-pin scriptiyle konuşabiliyor?
Türkiye'de yaygın kullanılan e-fatura entegratörlerinin çoğu (Foriba, Nesbilgi, Uyumsoft, Logo e-Fatura, İzibiz, Paraşüt gibi) SOAP veya REST tabanlı API sunar. Bir e-pin scriptinin bu entegratörlerle konuşabilmesi için genelde iki şey gerekir: entegratör tarafında bir API kullanıcı hesabı, script tarafında ise bu API'ye uygun bir bağlayıcı (connector) katmanı.
Pinova'da bu bağlayıcı katman ödeme sağlayıcı entegrasyonlarına benzer şekilde tasarlanmıştır: hangi entegratör kullanılacaksa panelden API bilgileri girilir, sipariş tamamlanma olayına (order.completed gibi) bir "fatura kes" adımı eklenir. Manuel süreçle otomatik süreç arasındaki fark, günlük işleyişte oldukça belirgindir:
| Kriter | Manuel / Elle | Pinova ile |
|---|---|---|
| Fatura kesme süresi | Sipariş sonrası saatler/günler | Sipariş anında, saniyeler içinde |
| Veri girişi hatası riski | Yüksek (elle kopyala-yapıştır) | Sipariş verisinden otomatik doldurulur |
| Yoğun gün / kampanya | Kuyruk birikir, gecikme artar | Sipariş hacminden bağımsız işler |
| Müşteriye fatura sunumu | Talep üzerine mail ile gönderim | Panelde anında görüntüleme/indirme |
| Muhasebe mutabakatı | Ay sonunda elle karşılaştırma | Sipariş = fatura kaydı birebir eşleşir |
Sipariş anından faturaya kadar veri nereden nereye akar?
Akışı uçtan uca izlemek, entegrasyonun neden "eklenti" değil de sipariş hattının doğal bir parçası olduğunu daha net gösterir. Müşteri ürünü seçer, ödeme sağlayıcı (PayTR, Shopier veya havale onayı) ödemeyi doğrular, sipariş "tamamlandı" durumuna geçer. Bu durum değişimi tetiklendiğinde script iki işi paralel yürütür: tedarikçi API'sinden (Turkpin/Pinabi gibi) kod çekip teslimatı yapmak ve fatura entegratörüne veri göndermek.
Fatura tarafında akan veri tipik olarak şunları içerir:
- Müşteri bilgisi: bireysel ise TC kimlik + ad-soyad, kurumsal ise VKN + unvan
- Ürün satırı: ürün adı, birim fiyat, KDV oranı, toplam tutar
- Sipariş numarası (mutabakat için fatura ile sipariş arasındaki köprü)
- Fatura tipi: e-Arşiv mi, e-Fatura mı (müşterinin mükellefiyet durumuna göre otomatik seçilir)
Canlıya geçmeden önce mutlaka entegratörün test (sandbox) ortamında birkaç deneme faturası kesin. TC/VKN doğrulaması, KDV oranı eşlemesi ve PDF şablonu gibi ayrıntılar test aşamasında düzeltilirse, gerçek siparişlerde hatalı fatura riski neredeyse sıfıra iner.
Çok seviyeli bayi sistemi fatura kesmeyi nasıl karmaşıklaştırır?
Tek bir bireysel müşteriye e-Arşiv fatura kesmek nispeten basit bir senaryo. İşler, sitede bayi sistemi devreye girdiğinde değişir. Bayiler genelde cari hesap/bakiye üzerinden alışveriş yapar, toplu sipariş verir, bazen vergi mükellefi bir firma olarak işlem görür. Bu durumda fatura mantığı da farklılaşmak zorundadır:
- Bayiye yapılan satış bireysel son kullanıcıdan farklı bir fatura tipi (e-Fatura, kurumsal VKN'li) gerektirebilir
- Bakiye yüklemesi ile ürün satışı ayrı fatura konuları olabilir; hangisinin ne zaman faturalandırılacağı önceden tanımlanmalı
- Bayinin alt bayilere yaptığı satışlar sitenin kendi fatura akışının dışında kalır, bu nedenle bayi seviyesi ile "otomatik fatura kes" kuralı eşleştirilmeli
- Toplu/periyodik faturalandırma isteyen bayiler için (her sipariş yerine haftalık tek fatura gibi) ayrı bir kural seti gerekebilir
Pinova'nın bayi modülünde her bayi seviyesine ayrı fatura davranışı tanımlanabilmesi, tam da bu karmaşıklığı yönetmek içindir: bireysel müşteri anında e-Arşiv alırken, kurumsal bayi farklı bir akışla e-Fatura alabilir.
Kurulum ne kadar sürer, hangi bilgiler gerekir?
Otomatik fatura kesme entegrasyonunun kurulumu, ödeme sağlayıcı entegrasyonuna benzer bir hazırlık gerektirir. Genel akış şu şekildedir:
- Bir e-fatura entegratörü ile anlaşma yapılır ve API erişimi (kullanıcı adı, şifre, GB kodu/API anahtarı) alınır
- Firma bilgileri (vergi dairesi, VKN, adres, e-posta) entegratör panelinde ve sitenin fatura ayarlarında eşleştirilir
- KDV oranları ürün kategorilerine göre tanımlanır (dijital ürünlerde oran ürün tipine göre değişebilir)
- Test ortamında birkaç deneme faturası kesilip PDF çıktısı ve GİB kabulü kontrol edilir
- Canlı API bilgileri girilir, sipariş tamamlanma tetikleyicisi aktif edilir
Bu adımların tamamı, entegratör tarafında hesap zaten hazırsa genelde bir-iki iş günü içinde tamamlanabilir. Asıl zaman alan kısım, entegratör firmasının hesap onayı ve API bilgilerinin ulaştırılması olur — teknik entegrasyonun kendisi kısa sürer.
Fatura kesmeyi de teslimat kadar otomatik hale getirsek?
Pinova, sipariş tamamlandığı anda tedarikçiden kod çekmekle kalmaz; fatura entegratörünüzle konuşarak faturayı da aynı akışın içine alır.
Otomatik fatura kesme için hangi entegratörler destekleniyor?
REST veya SOAP tabanlı API sunan Türkiye'deki yaygın e-fatura entegratörleriyle (Foriba, Nesbilgi, Uyumsoft, Logo e-Fatura, İzibiz gibi) bağlantı kurulabilir. Hangi entegratörün kullanılacağı panelden API bilgileri girilerek belirlenir.
Bireysel ve kurumsal müşteriler için fatura tipi otomatik mi seçiliyor?
Evet, müşterinin girdiği bilgiye göre (TC kimlik veya VKN) sistem bireysel müşteriye e-Arşiv, vergi mükellefi müşteriye e-Fatura kesecek şekilde ayrım yapabilir.
İade edilen bir siparişte fatura ne olur?
İade/iptal durumunda ilgili sipariş için iade faturası (iade e-Arşiv/e-Fatura) kesme adımı ayrıca tanımlanabilir; bu, orijinal fatura ile aynı entegratör API'si üzerinden yürür.
Bayilere kesilen faturalar bireysel müşterilerden farklı mı işler?
Evet. Bayi seviyesine göre farklı fatura kuralları tanımlanabilir; örneğin bireysel müşteri anlık e-Arşiv alırken, kurumsal bayi için farklı bir fatura tipi veya periyodik faturalandırma akışı kurulabilir.