E-pin Satış Scriptinde E-Fatura Entegrasyonunu Yanlış Kuranlar Bunu Çok Sonra Fark Ediyor: Otomatik Belge Kesiminin Perde Arkası

Yeni başlayan çoğu dijital ürün satıcısı e-faturayı bir düğme sanır: "entegratörle anlaşırım, panele anahtarı girerim, sistem faturayı keser." Teknik olarak yanlış değil. Ama sahada olan şu: ilk ay faturalar kesilir, ikinci ay bir kısmı GİB tarafında reddedilir, üçüncü ay iade edilmiş siparişlerin faturaları ortada kalır ve mali müşavirin telefonu çalar. Sorun entegratörde de değildir; sorun, scriptin faturaya ne yazdığında ve ne zaman yazdığındadır.

E-fatura, satış verisinin resmî bir dile çevrilmesidir. O dilde ürün adı serbest metin değildir, tutar yuvarlaması keyfi değildir, iptal geri alınamaz bir işlemdir. Bu yüzden e-pin satış scripti tarafında kurulacak entegrasyon, bir API bağlantısından çok bir kurallar setidir. Aşağıda o kuralları tek tek açıyoruz: hangi belge tipini keseceksin, ürün adına ne yazacaksın, iptalde ne yapacaksın ve otomatik kesimi hangi ana bağlayacaksın. Doğru kurulduğunda bu sistem aylarca sana hiç dokunmadan çalışır.

E-fatura mı e-arşiv mi? Yanlış belgeyi kesen herkes geri dönüyor

İlk ayrım bu ve en çok atlanan kısım burası. Karşı taraf e-fatura mükellefiyse belge onun sistemine e-fatura olarak gitmek zorundadır. Mükellef değilse, yani bireysel bir oyuncuysa, kesilecek belge e-arşiv faturadır. Dijital ürün satıcılarının müşteri tabanı ağırlıklı olarak bireysel olduğu için hacmin büyük kısmı e-arşiv tarafında akar; ama kurumsal bir bayi tek bir siparişle gelip dengeyi bozabilir.

Burada scriptin yapması gereken şey basit ama kritik: sipariş formunda vergi kimlik numarası girilmişse, belge kesimi öncesinde mükellef sorgusu yapılmalı ve belge tipi buna göre seçilmelidir. Bu kontrolü atlayan bir kurulumda ne olur? Kurumsal müşteriye e-arşiv kesersin, o müşteri belgeyi kendi sisteminde göremez, sana geri döner, sen iptal edip yeniden keserken dönem değişmiş olur. Sağlam bir e-pin yazılımı bu sorguyu sipariş onayı anında yapar ve sonucu sipariş kaydına yazar; böylece belge kesimi hangi saatte tetiklenirse tetiklensin doğru tipi bilir.

Ürün adına ne yazacaksın? Faturanın en tartışmalı alanı

Panelde ürünün adı "Oyun X 1000 Elmas Kodu - Anında Teslim - Kampanyalı" olabilir. Bu, pazarlama başlığıdır; fatura satırı değildir. Fatura satırında hizmetin ne olduğu anlaşılır, sade ve tutarlı bir tanım gerekir. Kampanya ifadeleri, teslim süresi vaatleri ve emoji benzeri karakterler belge tarafında sorun çıkarır, karakter sınırını aşar, bazı entegratörlerde satır reddine yol açar.

Çözüm, ürün tanımında ikinci bir alan tutmak: fatura adı. Vitrinde uzun başlık görünür, belgede kısa ve standart tanım gider. Bu ayrımı yapan bir dijital ürün satış yazılımı sayesinde pazarlama ekibi başlıkları serbestçe değiştirebilir, fatura tarafı hiç etkilenmez. Miktar ve birim de aynı disiplini ister: bir adet dijital kod satıyorsan miktar 1'dir, kodun içerdiği oyun içi para birimi miktarı değildir. Bu karışıklık, tutar ile miktarın çarpımının tutmamasına ve belgenin geri dönmesine sebep olur.

Otomatik kesimi hangi ana bağlamalısın?

Bu sorunun cevabı entegrasyonun kaderini belirliyor. Üç aday var: sipariş oluşturulduğu an, ödeme onaylandığı an ve teslimat tamamlandığı an. Sipariş anına bağlarsan, ödemesi düşmeyen her sepet için belge kesmiş olursun ve iptal yığını oluşur. Teslimat anına bağlarsan, stok gecikmesi yaşanan siparişlerde belge günlerce beklemede kalır.

Pratikte en sağlıklısı ödeme onayı anıdır; çünkü tahsilat gerçekleşmiştir ve hizmet bedeli kesinleşmiştir. Ancak buna küçük bir gecikme eklemek işi rahatlatır: onaydan sonra kısa bir bekleme penceresi, anlık iptalleri ve hatalı tahsilatları belge kesilmeden yakalamanı sağlar. Yani kesim gerçek zamanlı değil, kısa aralıklı bir kuyruk üzerinden yürür. Kuyruk mantığı ayrıca entegratör tarafında yaşanan geçici kesintilerde işlerin kaybolmasını da engeller: başarısız denemeler tekrar sıraya girer, sen hiçbir şey fark etmezsin.

İptal ve iade: geri alınamayan belgeyle nasıl çalışılır?

Bir belge kesildikten sonra onu yok sayamazsın. Dijital ürün satışında iade oranı düşük olsa da sıfır değildir: kod çalışmaz, yanlış bölge seçilir, müşteri cayma hakkını kullanır. Bu durumda izlenecek yol, kesilmiş belgenin karşılığını oluşturmaktır. E-arşiv tarafında belge, yasal süre içinde iptal edilebilirken, süre geçtiğinde veya karşı taraf e-fatura mükellefiyse iade belgesi düzenlemek gerekir.

Scriptin bu akışı bilmesi gerekiyor. İade işlemi yapıldığında sistem otomatik olarak şunu sormalı: bu siparişin belgesi hangi tipte, hangi tarihte kesildi ve iptal penceresi hâlâ açık mı? Cevaba göre ya iptal talebi gönderilir ya da iade belgesi kuyruğa alınır. Bu mantığı içermeyen kurulumlarda iadeler muhasebede elle takip edilen bir listeye dönüşür ve o liste her zaman eksik kalır. Pinova bu kararı sipariş kaydındaki belge bilgisiyle otomatik verdiği için, iade eden operatör herhangi bir vergi kuralı bilmek zorunda kalmıyor.

Entegratör seçiminde nelere bakılır, neler pazarlama gürültüsü?

Entegratör vaatlerinin çoğu birbirinin kopyası. Senin için gerçekten fark yaratan üç şey var: belge başına maliyet yapısı, hata mesajlarının anlaşılırlığı ve test ortamının varlığı. Maliyet tarafında hacim paketleri cazip görünür ama dijital ürün satışı dalgalıdır; kampanya dönemlerinde paketi aşarsın. Hata mesajları kısmı ise sessiz bir maliyet kalemi: "işlem başarısız" diyen bir servisle çalışıyorsan, her sorunda destek beklemek zorunda kalırsın.

Test ortamı olmazsa olmaz. Canlıda deneme yapmak, gerçek belge numarası yakmak ve o numarayı iptal etmekle uğraşmak demek. Entegrasyonu kurarken en az bir hafta test ortamında her senaryoyu geçmen gerekir: bireysel satış, kurumsal satış, iskontolu satış, iade, kısmi iade ve çoklu kalemli sipariş. Bu altı senaryo geçtiyse canlıda sürpriz yaşama olasılığın neredeyse kalmıyor.

E-fatura entegrasyonu, bir kere doğru kurulduğunda seni yıllarca rahat bırakan nadir işlerden biri. Hangi alanların nerede tanımlandığını ve kuyruğun nasıl izlendiğini merak ediyorsan, özellik listesine göz at ve belge akışının ekranlarda nasıl göründüğünü canlı demo içinde kendin dene; anlatılanların hepsi gerçek bir panel üzerinde çalışıyor.