e-Fatura entegrasyonunda sık yapılan beş hata
Entegratörle bağlantıyı kurmak işin kolay kısmı. Sorunlar faturanın muhasebeye düşmesinde, iptal ve iade akışında, mali dönem mantığında ve tahsilat eşleştirmesinde çıkıyor.
Yazan · Avanox Bilişim

Avanox Muhasebe finans panosu: nakit, alacak, borç ve vergi yükü tek ekranda
e-Fatura entegrasyonu denince akla önce entegratör bağlantısı gelir: kullanıcı adı, şifre, bir test faturası, tamam. Sahada gördüğümüz şu: bağlantı kurulduktan sonraki altı ayda çıkan sorunların neredeyse hiçbiri bağlantıyla ilgili değil. Aşağıdaki beş hata, muhasebe ve tahsilat sistemlerinde tekrar tekrar karşımıza çıkanlar.
1. Faturayı belge, muhasebe kaydını ayrı iş saymak
Fatura kesildi, entegratöre gitti, onaylandı. Yevmiye kaydı? “Muhasebe ay sonunda toplu atar.” Bu ayrım küçük işletmede idare eder, üç şubeli bir yapıda kontrolden çıkar. Her belge kesildiği anda tanımlı bir kurala göre fişe dönüşmeli ve her yevmiye kaydı hangi kuraldan doğduğunu üzerinde taşımalı. Avanox Muhasebe’de fişleme motoru bu yüzden kural tabanlı: kurallar arayüzden yönetilir, koda gömülü değildir. Denetimde “bu kayıt neden böyle?” sorusunun cevabı kayıtın kendisinde durur.
2. Entegratör kuyruğunu görmezden gelmek
Gönderim her zaman başarılı olmaz: şema hatası, mükellef bilgisi eşleşmiyor, entegratör tarafında geçici arıza. Kuyruk ekranı olmayan sistemlerde bu faturalar “gitti sanılan” faturalar olur ve ay sonunda mutabakatta ortaya çıkar. Giden ve gelen her belge için durum, hata mesajı ve yeniden deneme düğmesi tek ekranda olmalı. Sessizce başarısız olan entegrasyon, hiç olmayan entegrasyondan daha tehlikelidir.
3. Mali dönem mantığını sonradan eklemek
Tarih içeren her kayıt bir mali döneme aittir; dönem kapanınca o döneme kayıt atılamaz, düzeltme sonraki dönemde yapılır. Bu mantık başlangıçta modele girmezse tarih filtreleri “bu ay / geçen ay” seviyesinde kalır ve dönem kapanışı bir ritüele dönüşür: herkes kayıtları dondurmak için birbirine e-posta atar. Enflasyon düzeltmesi ve çoklu döviz de aynı temele oturur; sonradan yama olarak eklendiğinde her raporda ayrı bir istisna doğurur.
4. Tahsilatı elle eşleştirmek
Tahsilat takibinde en çok zaman alan iş banka ekstresindeki hareketi doğru faturayla eşleştirmektir. Açıklama alanı çoğu zaman boş, bazen üç faturanın toplamı tek havaleyle gelir, bazen kısmi ödeme yapılır. Süzen Fatura Takip bu eşleştirmeyi IBAN, tutar, unvan benzerliği ve açıklama üzerinden skorlayarak yapar; emin olamadığı kayıtları skoruyla operatöre sunar. Karar her zaman insanda kalır, ama insan yüz hareketin doksanına değil onuna bakar.
Buradaki tasarım kararı önemli: fatura–ödeme ilişkisi çoktan çoğa olmalı. Bir ödeme birden çok faturayı, bir fatura birden çok ödemeyi kapatabilmeli. Bire bir kurulan modeller ilk kısmi ödemede kırılır.
5. Test ortamını atlamak
GİB test ortamı ve entegratör test hesabı vardır; çoğu proje bunları “bir fatura gönderip” geçer. Oysa asıl kırılganlık kenar durumlarda:
İptal edilen faturanın muhasebe kaydı ve cari bakiyesi geri alınıyor mu?
İade faturası orijinal faturaya bağlanıyor mu, yoksa bağımsız bir kayıt mı oluyor?
Dövizli faturada kur hangi tarihten okunuyor; kur farkı fişi kim atıyor?
Aynı belge iki kez gönderilirse sistem ikinciyi durduruyor mu?
Entegratör üç saat yanıt vermezse kuyrukta ne birikiyor, kim haberdar oluyor?
Bu beş senaryo test edilmeden canlıya çıkan entegrasyon, ilk ay sonunda muhasebeciyle yazılımcıyı aynı masaya oturtur. Baştan yarım gün ayırmak sonradan üç haftayı kurtarır.
Kayıt düzeninizi ve entegratör akışınızı bir görüşmede birlikte inceleyebiliriz; finans ve muhasebe sayfasında teslim ettiğimiz kalemler yazıyor.
Bu konuyu sizin tarafınızda konuşalım.
İlk görüşme ve süreç haritası ücretsizdir. Yazıdaki örneklerin sizde nasıl karşılık bulacağını birlikte çıkaralım.