ERP e-Fatura Entegrasyonu: e-Arşiv ve e-İrsaliye

Türkiye'de faaliyet göstermek için bir ERP'nin genellikle GİB üzerinden e-Fatura ve e-Arşiv'i — bazı sektörlerde e-İrsaliye'yi de — desteklemesi gerekir; bu da çoğunlukla bir özel entegratör aracılığıyla yapılır. ERP belgeyi UBL-TR formatında oluşturur, satıcı onu mali mühürle imzalar, entegratör GİB'e bildirir ve vergi mükellefi belgelerin arşiv yükümlülüğünün sorumluluğunu taşımaya devam eder.

Türkiye'de faaliyet için ERP neyi desteklemeli?

Türkiye elektronik faturayı bir temizleme modeliyle yürütür: belge satıcı tarafından oluşturulur, yetkili bir kanaldan iletilir, Gelir İdaresi tarafından doğrulanır ve ancak ondan sonra hukuki geçerlilik kazanır. Operasyonunu ERP üzerinde yürüten bir işletme için bunun dört noktada sonucu vardır: Hangi ERP’yi kullandığınızı ve hangi belgeleri düzenlediğinizi yazın; teklif isteyin, entegratöre ve Gelir İdaresi’ne giden entegrasyon yolunu fiyatlandıralım.

• Belge oluşturma. ERP ya da bağlı bir motor, faturaları şemanın istediği kodlar, taraf tanımlayıcıları ve satır düzeyi verilerle, yani baskı bir düzenin XML'e çevrilmesiyle değil, gerektiği UBL-TR yapısında üretmek zorundadır.


• Dijital imza. Belgeler mükellefe verilen mali mühürle imzalanır; imza adımı akışın içine oturmalı, anahtar yönetimi de mühürün zilyetlik düzenine uygun olmalıdır.


• İki yönlü değişim. e-Fatura rejiminde karşı tarafın kayıtlı olup olmadığı belge tipini belirler ve gelen belgeler — alınan faturalar, yanıtlar, izin verilen hallerde iptaller — özgün tanımlayıcılarıyla ERP'ye geri dönmelidir; aksi hâlde muhasebe resmî kayıtla sistem arasındaki bağlantıyı kaybeder.


• Arşiv ve erişim. Verilen ve alınan belgeler yasal saklama süresi boyunca erişilebilir olmalıdır; belgelerin entegratörde mi, ERP'de mi yoksa ikisinde mi saklanacağı, denetim talebiyle değil, devreye almadan önce alınması gereken bir karardır.

Burada yapısal ve yeni ekipleri şaşırtan bir nokta var: fatura, ERP yazdırdığında bitmiş değildir. Değişim tamamlandığında ve yanıtlar geri geldiğinde bitmiştir; bu da ERP'nin fatura durumu anlayışının "oluşturuldu" ve "gönderildi"nin ötesine kabul edildi, reddedildi ve düzeltildi durumlarını da uzatması demektir. Bu kuyruğu atlayan işletmeler, defterleriyle resmî kaydı ay sonunda elle mutabakatla karşılar; elektronik faturanın aslında ortadan kaldırmayı vaat ettiği iş de tam olarak budur.

Bir diğer nokta zamandır. Temizleme modelinde belgeler bir e-posta eki kadar asenkron değildir: ret, ekip hâlâ çalışırken gelir ve istediği düzeltme çoğunlukla belgeyi değil ana veriyi ilgilendirir. Sebebi düzeltebilecek kişinin hatayı bir aylık raporda değil, o anda bildirimle öğrenmesini sağlayan bir akış kurmak; sistemin izlenerek mi yoksa çalışarak mı sürdüğü arasındaki farktır.

e-Fatura, e-Arşiv, e-İrsaliye nedir?

Kimin hangi yükümlülüğe girdiğini GİB kuralları ve tebliğler belirler ve bunlar değişir; eşikler ve sektör belirlemeleri yetkililere aittir ve onlarla birlikte değişir. Alıcı için doğru ifade prosedüreldir: entegrasyonu tasarlarken kayıt durumunuzu muhasebecinizle ya da vergi danışmanınızla, bir makaleye değil geçerli kurallara göre doğrulayın — bu sayfa dâhil.

Entegrasyon seçenekleri

Entegratör modeli sık yanlış anlaşıldığı için bir açıklama hak eder: özel entegratör kullanmak mükellefin yükümlülüklerini devretmez. Entegratör teknik kanalı, iletimi ve arşivleme hizmetini verir; belgelerin hukuki sorumluluğu — doğruluğu, kesimi ve Vuk kapsamında arşivlenmesi — mükellefte kalır. Bir entegratörün satış sayfası uyum sorununun sizin yerinize çözüldüğü izlenimini veriyorsa o cümleyi yeniden okuyun.

Uygulama adımları ve test

ERP tarafı için çalışır bir sıralama:

1. Yükümlülük kapsamını sabitleyin. İşletmeye hangi belgeler uygulanıyor — e-Fatura, e-Arşiv, e-İrsaliye, e-Defter — şirket muhasebecisiyle geçerli kurallara göre teyit edin.


2. Kanalı seçin. Çoğu işletme özel entegratör seçer; seçim soruları — API kalitesi, test ortamı, destek dili ve saatleri, şema güncelleme yönetimi, referanslar — başlı başına bir kısa liste çalışması hak eder.


3. Ana veriyi eşleyin. Müşteriler ve vergi tanımlayıcıları, kalemler, birimler, para birimleri ve vergi kodları şemanın beklentileriyle eşleşmelidir; buradaki uyuşmazlıklar sonraki hataların en büyük tek kaynağıdır.


4. Belge akışını tasarlayın. Ne, ne zaman oluşturulur; mühür ne zaman uygulanır; hata olursa ne olur; giden ve gelen belgeler ERP kayıtlarıyla nasıl eşleştirilir; düzeltmeler nasıl kesilir.


5. Test ortamını kullanın. Her iki taraf da test ortamı sunar; devreye almadan önce her belge tipini, her hata yolunu ve her düzeltme senaryosunu, üretimdeki eşlemeyle aynı çalıştırın.


6. Hatayı bir süreç olarak yönetin. Retler iletimden sonra gelir; biri onu görmeli, sebebini anlamalı ve ana veriyi düzeltmelidir; sahibi olmayan bir uyarı kutusu, işletmenin belgeleri geç kesmesinin yoludur.


7. Arşivlemeyi ve erişimi planlayın. Belgeler nerede saklanıyor, kim erişebilir ve bir denetçi talebi saklama süresi içinde nasıl yanıtlanır?

Bu üç adımın ortak özelliği, sahibinin genellikle BT olmamasıdır. Ana verinin doğruluğu satış ve muhasebenin işidir; ret bildirimlerini takip edecek kişi muhasebedir; belge erişimi de finansın günlük ihtiyacıdır. Projeyi yalnızca BT ekibine bırakmak, bu üç sorumluluğu sahipsiz bırakmak demektir ve ilk ay sonunda faturası çıkacak olan şey de budur. En iyi çalışan düzenlerde, proje başında bu üç alana birer adlandırılmış kişi atanır ve entegrasyon ekibiyle tek bir ortak toplantıda akıştan geçirilir. Bu isimler yazılı olduğu sürece, proje bittikten sonra soruların kime gideceği de bellidir.

Bir de bağımlılık meselesi vardır. Entegratör seçimi, ERP kadar uzun süreli bir karardır: belgelerin gittiği kanal değişemez kolayca, çünkü numaralandırma, arşiv ve alışkanlıklar bir kez oturur. Bu yüzden entegratörü seçerken yalnızca bugünün özelliklerine değil, kanalın taşınabilirliğine bakın — belgelerinizin ve kayıtlarınızın dökümünü düzenli alabiliyor musunuz, yoksa veri yalnızca entegratörün arayüzünde mi yaşıyor. Bu sorunun yanıtını sözleşme öncesi netleştirmek, beş yıl sonra çok daha pahalıya çözülen bir sorunu baştan kapatır; iyi bir entegratör seçimi, bu soruların yanıtının yazılı olduğu bir teklifle başlar.

Yabancı sermayeli ve yerleşik olmayan şirketlerin danışmana soracağı noktalar

Yabancı ortaklı bir şirket ya da eksiksiz bir yerel finans ekibi olmadan Türkiye'ye giren bir şirket için birkaç soru, BT projesine değil vergi danışmanına aittir; yanıtlar tasarımı belirler, bu yüzden entegrasyon başlamadan önce sorun:

• Kayıt yolu. Şirket yükümlülüklerin kapsamına nasıl girer, başvuruları kim imzalar, hangi temsilci tanınır — bunlar vergi kaydı sorunlarıdır, yazılım sorunu değil.


• Mühür düzeni. Mali mühür şirkete nasıl alınır ve imzalayıcılar Türkiye dışında olduğunda zilyetlik nasıl düzenlenir.


• Temsilciler ve imzalar. Kim hangi belgeyi imzalama yetkisine sahip ve denetim izi için ERP imzalayıcı hakkında ne kaydetmeli.


• Yabancı iştirak durumu. Yerleşik olmayan ortaklı şirketlere ek gereksinim uygulanıp uygulanmadığı ve grup içi faturalamanın nasıl ele alındığı.

Sık karşılaşılan sorunlar

Bu tür projelerde en sık görülen hatalar ve her birinin genellikle gösterdiği şey:

• Doğrulamada retler. Neredeyse her zaman bir eşleme sorunu: bir vergi kodu, bir tanımlayıcı biçimi ya da şemanın beklentisiyle uyuşmayan satır düzeyi bir alan. Ana veriyi düzeltin, tekrar mantığını değil.


• Mükerrer numaralandırma. Numara dizisini birden fazla sistemin üretmesi ya da hata sonrası yeniden üretmesi; numaralandırmanın tam olarak bir sahibi ve yazılı bir kurtarma kuralı olmalıdır.


• Karşı taraf durum hataları. Müşterinin kayıtlı olup olmadığı bellekten varsayılarak yanlış belge tipi kesilmesi; durumu hafızayla değil entegratörün kuralına göre sorgulayın.


• Kaybolan gelen belgeler. Alınmış ama ERP'ye hiç işlenmemiş belgeler; böylece borçlar ayrı bir ekrandan çalışır. Değişim yönü entegrasyonun parçasıdır, isteğe bağlı ek değil.


• Kaçırılan şema güncellemeleri. Yapı zamanla değişir; sorumlu olan kişi değiştiğini ve değişikliğin eşlemeye ne yaptığını bilmelidir.


• Son dakikada atlanan test. Yukarıdaki her sorun test ortamında daha ucuzdur; teslim baskısı onları olaya çevirdiği yerdir.

Sıkça Sorulan Sorular

e-Fatura ile e-Arşiv arasındaki fark nedir?

e-Fatura, rejime kayıtlı mükellefler arasında kayıtlı taraflarca yapısal belge olarak değişen faturaları kapsar; e-Arşiv, bu rejimin dışında kalan alıcıyı kapsar — perakende, B2C ve bir kısım B2B — ki alıcı bunu genellikle aynı resmî zincirden üretilen PDF olarak alır. Bir faturaya hangisinin uygulanacağı karşı tarafın kayıtlı olma durumundan gelir; bu yüzden entegrasyon bunu varsaymaz, sorgular.

Özel entegratöre ihtiyacım var mı?

Çoğu işletme için evet — yaygın yol budur ve doğrudan kanalın karmaşık ve seyrek olduğu tarif edilir. Özel entegratör GİB'e teknik kanalı ve arşivleme hizmetini verir; mükellef olarak yükümlülükleriniz sizde kalır. Birini seçmek bir satın alma çalışmasıdır: API kalitesi, test ortamı, destek ve şema güncelleme yönetimi günlük deneyimi markadan çok belirler.

Mali mühür nedir?

Mükellefin elektronik belgeleri iletimden önce imzaladığı dijital kimliğidir; zilyetliği ve kimin kullanabileceği şirket içinde netleştirilecek pratik sorulardır. İmzalayıcıları Türkiye dışında olan ekipler için mühürü kimin tuttuğu ve uyguladığı düzeni, vergi danışmanının önüne çıkarılacak ilk noktalardan biridir.

Herhangi bir ERP Türk e-faturası kesebilir mi?

Hayır. ERP gereken UBL-TR yapısını doğru ana veriyle üretmeli ya da bunu yapan bir motora veya entegratöre bağlanmalıdır; standart bir fatura düzeni yetmez. Çoğu işletme bu yüzden yeniden yazmak yerine bağlanır — bir tedarikçiye sorulacak soru, bağlayıcısının hangi entegratörleri desteklediği, neleri eşlediği ve dokümantasyonunun nerede olduğudur.

Devreye almadan önce nasıl test ederim?

Entegratör ve resmî tarafın sunduğu test ortamlarında, üretimle aynı ana veri eşlemesiyle: her belge tipi, her ret yolu, her düzeltme ve ERP'ye işlenen her gelen belge. Testi hata sürecinin provası olarak da görün — birinin ret alması, teşhis etmesi ve düzeltmesi gerekir; sadece yeşil tik görmesi değil.

Faturaları kim saklar?

Mükellef Vuk kapsamında arşiv yükümlülüğünün sorumluluğunu taşır; entegratör genellikle teknik arşivlemeyi verir ve birçok işletme günlük kullanım için belgeleri ERP'sinde de tutar. Önemli olan düzeni devreye almadan önce kararlaştırmak, saklama süresi içinde hangi belgenin kim tarafından üretileceğini bilmek ve bu erişimi bir denetçi sormadan önce denemektir.

Kaynaklar ve standartlar

• GİB — Gelir İdaresi Başkanlığı — e-Fatura, e-Arşiv, e-İrsaliye ve e-Defter kurallarını, tebliğlerini ve teknik dokümantasyonunu yayımlayan kurumdur; oradaki geçerli versiyonlar bu sayfada özetlenen her şeyin önüne geçer.
• Kayıt durumu, eşikler, sektör belirlemeleri ve süreler yetkililerce belirlenir ve değişir; muhasebecinizle veya vergi danışmanınızla geçerli kurallara göre doğrulayın. Bu sayfanın hiçbiri vergi tavsiyesi değildir ve WorldwideTradeX için entegratör ilişkisi, ortaklık veya sertifika iddia edilmez.

İlgili sayfalar

Yazılım geliştirme · Ticaret şirketleri için Odoo ERP · Özel yazılım ile paket ERP · IT denetimi ve danışmanlık · Teklif isteyin