n8n ile E-Fatura (ZUGFeRD/XRechnung) İşleme

ZUGFeRD veya XRechnung formatındaki e-faturalar, n8n'de yerleşik XML düğümü veya Code düğümündeki hedefe yönelik JavaScript ile otomatik olarak okunabilir, yapılandırılmış verilere dönüştürülebilir ve muhasebe yazılımına aktarılabilir. 1 Ocak 2025'ten itibaren tüm yurt içi şirketler B2B alanında e-fatura alabilecek durumda olmak zorundadır; düzenleme için ise önceki yılın cirosuna bağlı olarak 2026 sonuna veya 2027 sonuna kadar geçiş süreleri geçerlidir, 2028'den itibaren e-fatura pratik olarak tüm yurt içi B2B işlemleri için zorunlu hale gelir. Düzenli olarak çok sayıda gelen faturayı manuel olarak kontrol edip muhasebeye aktaran kişi, bu adımı bir n8n otomasyonuyla belirgin şekilde hızlandırabilir. Bir yazılım, bir vergi danışmanı tarafından yapılan bireysel vergi incelemesinin yerini tutmaz. Durum: Temmuz 2026.

E-fatura zorunluluğu için şu anda hangi süreler geçerli?

E-faturaların alınması zorunluluğu 1 Ocak 2025'ten itibaren geçerlidir, düzenleme için ise kademeli geçiş süreleri uygulanır. Federal Maliye Bakanlığı'nın SSS bölümüne göre şirketler, alıcının onayı olması koşuluyla 2026 sonuna kadar isteğe bağlı olarak hâlâ kağıt fatura veya başka elektronik formatlar düzenleyebilir. Önceki yıl cirosu en fazla 800.000 avro olan şirketler için bu geçiş süresi 2027 sonuna kadar uzatılır. 1 Ocak 2028'den itibaren son geçiş düzenlemesi sona erer, bundan sonra e-fatura yurt içi B2B işlerinde temel olarak zorunlu hale gelir. 250 avronun altındaki faturalar bu zorunluluktan muaftır. Bu bilgiler, bireysel bir vergi danışmanlığının yerini tutmaz; durumunuzun bağlayıcı bir değerlendirmesi için vergi danışmanınıza başvurmalısınız.

ZUGFeRD ile XRechnung arasındaki fark nedir?

ZUGFeRD, gömülü XML içeren bir PDF dosyasıyken, XRechnung kendine ait görsel bir gösterimi olmayan saf bir XML belgesidir. Her iki format da Avrupa standardı EN 16931'e dayanır ve e-rechnung-bund.de tarafından B2B alanı için doğrulandığı üzere KDV gerekliliklerini karşılar.

• XRechnung: Ek yazılım olmadan insanlar tarafından okunamayan saf XML, ancak otomatik işleme için idealdir.
• ZUGFeRD (2.0.1 sürümünden itibaren, MINIMUM ve BASIC-WL profilleri hariç): gömülü XML eki içeren PDF/A-3 dosyası, hem insanlar tarafından doğrudan okunabilir hem de makine tarafından okunabilir.

n8n gibi otomatik bir işleme sistemi için bu şu anlama gelir: XRechnung doğrudan okunabilir, ZUGFeRD'de ise önce gömülü XML'in PDF dosyasından çıkarılması gerekir.

n8n gelen e-faturaları teknik olarak nasıl okur?

n8n bunun için iki yerleşik araç sunar: saf format dönüştürme için XML düğümü ve bireysel işleme mantığı için Code düğümü. n8n'in XML düğümüne ilişkin belgelerine göre bu düğüm, verileri XML ile JSON arasında dönüştürür ve bunun için Property Name, Attribute Key ve Character Key gibi seçeneklerin yanı sıra XML'den JSON'a modunda ayrıca Explicit Array, Explicit Root ve Ignore Attributes seçeneklerini sunar. Bir XRechnung için, gelen XML dosyasının XML'den JSON'a modunda işlenmesi yeterlidir, ardından fatura numarası, tutarlar ve kalemler yapılandırılmış bir JSON nesnesi olarak elde edilir. ZUGFeRD'de ise XML, bir PDF/A-3 dosyasının içinde ek olarak bulunur, bu nedenle genellikle Code düğümünde bir PDF kütüphanesiyle çözülen ek bir çıkarma adımı gereklidir. Code düğümü iş akışı içinde kendi JavaScript veya Python kodunuzu çalıştırır; kendi barındırdığınız n8n örneklerinde bunun için ek npm modülleri içe aktarılabilir, bu n8n Cloud'da mümkün değildir.

Ayrıştırmadan sonra süreç nasıl devam eder?

Bir JSON nesnesine dönüştürüldükten sonra fatura verileri, bir HTTP Request düğümü veya uygun bir muhasebe düğümü aracılığıyla DATEV veya Lexoffice gibi sistemlere aktarılabilir. Veriler otomatik olarak aktarılmadan önce, hatalı veya eksik faturaların fark edilmeden geçmemesi için fatura numarası, vergi kimliği ve brüt tutar gibi EN 16931'e göre zorunlu alanların kontrol edilmesi de faydalıdır. Yüksek fatura hacmine sahip şirketler için her kalemin manuel olarak incelenmesi neredeyse imkansız hale gelir; düzgün kurulmuş bir n8n iş akışı bu adımı güvenilir bir şekilde üstlenir ve mevcut muhasebe yazılımınıza uyarlanabilir. Otomasyonun gerçekte ne kadar sağlam çalıştığı, büyük ölçüde gelen faturaların ne kadar düzenli yapılandırıldığına bağlıdır; özellikle farklı kaynaklardan gelen ZUGFeRD dosyalarında yeterli test yapmak önemlidir.

n8n ile e-faturalar hakkında sık sorulan sorular

ZUGFeRD 2026'dan sonra da geçerli mi?

Evet, 2.0.1 sürümünden itibaren ZUGFeRD, MINIMUM veya BASIC-WL profilleri kullanılmadığı sürece 2026'dan sonra da geçerli bir e-fatura formatı olmaya devam eder. Geçiş süreleri format seçiminin kendisiyle değil, yalnızca yapılandırılmış bir elektronik formata ne zamana kadar geçmeniz gerektiğiyle ilgilidir. 2028'den itibaren her B2B faturasının EN 16931 uyumlu bir formatta olması gerekir; ZUGFeRD ve XRechnung her ikisi de bu gerekliliği karşılar.

n8n, gömülü XML içermeyen PDF faturaları işleyebilir mi?

Yalnızca sınırlı ölçüde, çünkü XML düğümü gerçek XML verisi gerektirir, salt görüntü veya metin içeriği değil. Gömülü XML içermeyen klasik bir PDF fatura, n8n'de ancak metin tanıma veya harici bir yapay zeka (YZ) hizmeti aracılığıyla kabaca değerlendirilebilir, ancak bu, gerçek bir e-faturanın yapılandırılmış işlenmesinden belirgin şekilde daha hataya açıktır. Güvenilir bir otomasyon için gelen format olarak ZUGFeRD veya XRechnung'u hedeflemelisiniz.

Bir n8n otomasyonu, vergi danışmanı tarafından yapılan incelemenin yerini tutar mı?

Hayır, bir n8n otomasyonu fatura verilerinin teknik olarak okunması ve iletilmesini üstlenir, ancak vergisel veya hukuki bir incelemenin yerini tutmaz. Süreler, istisnalar veya tek tek faturaların doğru KDV muamelesine ilişkin sorular konusunda hâlâ vergi danışmanınıza danışmalısınız. Otomasyon manuel çabayı azaltır, içeriğe ilişkin sorumluluk sizde kalır.

E-faturaları işlemek için n8n Cloud'a mı yoksa kendi barındırdığım bir çözüme mi ihtiyacım var?

Her iki seçenek de temelde çalışır, ancak ek kütüphanelerle daha karmaşık ZUGFeRD çıkarma işlemleri için kendi barındırma genellikle daha pratiktir. n8n Cloud'da Code düğümünde harici npm modülleri içe aktarılamaz, bu da bazı PDF çıkarma adımlarını sınırlar. Kendi barındırdığınız bir örnekte, ek kütüphanelere tam erişiminiz ve verileriniz üzerinde daha fazla kontrolünüz olur.