ZUGFeRD Faturası Oluştur n8n

Q: What is ZUGFeRD and how does it differ from XRechnung and Factur-X?

ZUGFeRD is the German hybrid e-invoicing standard, a PDF/A-3 document with embedded structured XML invoice data readable by both humans (the PDF) and machines (the XML). XRechnung is the German public sector profile, used for invoices to federal, state, and municipal authorities; it is a stricter pure-XML profile but is also available as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the exact same hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully compatible. Choose ZUGFeRD 2.x with EN16931 conformance for general B2B use, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Bu düğüm ne işe yarıyor?

PDF4me Zugferd Faturası Oluştur tamamen uyumlu bir şekilde üretir. ZUGFeRD hibrit e-faturaları (Yapılandırılmış PDF/A-3 belgeleri) XML fatura verilerini doğrudan içine yerleştirin) n8n iş akışı. Dönüştür XML, JSON, veya CSV Fatura verilerini tek bir hibrit dosyaya dönüştürerek kullanıma hazır hale getirin. Almanya'da B2B e-fatura zorunluluğuAB çapında EN 16931 uyumluluğu veya Alman XRECHNUNG kamu sektörü profili. 1.0'dan 2.4'e kadar tüm ZUGFeRD sürümlerini ve altı uyumluluk seviyesinin tamamını tek bir düğümde destekler.

İlgili Blog Yazıları(1)

n8n'de ZUGFeRD Faturası Nasıl Oluşturulur? Dropbox + JSON İş Akışı, Adım Adım!

n8n iş akışı: fatura JSON dosyasını PDF4me'ye yükleyin, ZUGFeRD/Factur-X faturası oluşturun, ardından oluşturulan PDF dosyasını Dropbox'a yükleyin. Gerçek ekran görüntüleri, eşleştirmeler ve çıktı kontrolleri içerir.

Yazıyı oku →

Kimliğinizi Doğrulama API Rica etmek

Her PDF4me düğümde n8n geçerli bir belge gerektirir Bağlantı kurmak için kimlik bilgisi. İçeriğinizi barındıran birini oluşturun veya seçin. PDF4me API Bu sayede iş akışı, ZUGFeRD fatura oluşturma isteklerini güvenli bir şekilde doğrulayabilir.

Get your API Key

Kaçırmamanız Gereken Önemli Bilgiler

ZUGFeRD hibrit bir PDF/A-3+ formatıdır. XML format, saf değil XML standart

Çıktı, arşiv kalitesinde tek bir PDF/A-3 dosyasıdır. PDF yapılandırılmış ile XML İçine iliştirilmiş fatura. İnsanlar okuyor. PDFmakineler bunu ayrıştırır XML. Gönderilecek ayrı dosya yok. Saf dosya oluşturmak için. XML olmadan PDF Oluşturma işlemi için Çıktı Modunu Yalnızca XML olarak ayarlayın; hibrit dosya oluşturmak için ise XML ve PDF (varsayılan) olarak ayarlayın.

ZUGFeRD 2.0+, 2025-2028 Alman B2B zorunluluğu için gereklidir.

Almanya'nın Büyüme Fırsatları Yasası (Wachstumschancengesetz), 1 Ocak 2025'ten itibaren tüm B2B işlemlerinde e-fatura alımını zorunlu hale getirmiş ve tam gönderim yükümlülüğünü 2028 yılına kadar kademeli olarak uygulamaya koymuştur. EN16931 veya XRECHNUNG uyumluluğuna sahip ZUGFeRD sürüm 2.0 veya üzeri bu zorunluluğu karşılamaktadır. Eski ZUGFeRD 1.0 sürümü bu şartı karşılamamaktadır.

Uygunluk Seviyesi, uyumluluğu kontrol eder: EN16931 güvenli varsayılan değerdir.

AB genelinde B2B faturalama için EN16931'i (Avrupa Standardı), Alman kamu sektörü kuruluşlarına faturalama yaparken XRECHNUNG'u ve EN 16931 temelinin ötesindeki sektöre özgü alanlar için EXTENDED'ı seçin. MINIMUM ve BASICWL kalemleri içermez ve tam faturalama için kullanılamaz; yalnızca dahili muhasebe dökümleri için kullanılabilir.

Parametreler

Gereklidir n8n Kullanıcı Arayüzü: Bağlantı kurulacak kimlik bilgisi, Giriş Veri Türü, Belge Adı (Giriş Veri Türü "Yok" olsa bile her zaman gereklidir, belge adı yedekleme olarak kullanılır), Çıkış Modu, Zugferd Sürümü, Faturayı PDF Olarak Oluştur, Dil, Giriş Formatı ve Fatura Veri Giriş Türü. Uygunluk Seviyesi Zugferd Sürüm dalına bağlı olarak gösterilir ve gereklidir; 1.0, 2.0/2.1/2.2/2.4 ve Özel sürümleri için farklı alan adı ve seçenek seti bulunur. Eşleşen fatura veri alanı (Fatura) XML/JSON/CSV Veri, İkili Özellik, Base64 Fatura Veri Giriş Türüne bağlı olarak İçerik (veya Veri URL'si) gereklidir. Çalışma zamanı doğrulaması, seçilen yolda boş olmayan içerik bulunmasını "Fatura … verisi gereklidir" veya "Fatura base64 içeriği gereklidir" gibi hatalarla zorunlu kılar.

PDF4ME hesabı dev ile bağlantı kurmak için gerekli kimlik bilgilerini içeren eksiksiz parametre panelini gösteren Zugferd Fatura n8n düğümünü oluşturun. Kaynak Fatura, Fatura İşlemleri Zugferd Fatura Oluşturma, Giriş Veri Türü İkili Veri, İkili Özellik data, Belge Adı invoice.pdf, Çıkış Modu PDF ile XML, Zugferd Sürümü 2.0, Uyumluluk Seviyesi EN16931, Dil Almanca, Faturayı PDF'ye Oluşturma etkinleştirildi, Giriş Biçimi JSON, Fatura Veri Giriş Türü Doğrudan Metin, Çıkış Dosya Adı zugferd_invoice.pdf, Çıkış İkili Alan Adı data — Tam dolu **Parametreler** Görünüm; düğümdeki her alanı bulmak için aşağıdaki tabloyla birlikte kullanın.

Parametre	Gerekli	Ne işe yarar?	Örnek
Input Data Type	Conditional	How the background PDF (the visual layer of the hybrid invoice) is supplied. None creates the PDF from invoice data alone. Binary Data reads from a previous n8n node. Base64 String accepts encoded content. URL downloads from a public link.	`Binary Data`
Binary Property Name	Conditional	Name of the binary field from the previous node. Required when Input Data Type is Binary Data.	`data`
Base64 Content	Conditional	Base64-encoded PDF string. Required when Input Data Type is Base64 String.	`JVBERi0xLjQK...`
File URL	Conditional	Public URL to the source PDF. Required when Input Data Type is URL.	`https://example.com/invoice.pdf`
Document Name	Yes	Filename of the source PDF document. Always required in the UI, including when Input Data Type is None (used as document name fallback in the payload). Include the .pdf extension.	`invoice.pdf`
Output Mode	Yes	XML Only generates a pure XML file. XML With PDF generates the full hybrid ZUGFeRD file: a PDF/A-3 document with structured XML embedded inside. XML With PDF is the canonical ZUGFeRD output.	`XML With PDF`
Zugferd Version	Yes	ZUGFeRD specification version. 1.0 is legacy and does not satisfy the German B2B mandate. 2.0 through 2.4 all support EN 16931. 2.2 and 2.4 add the latest XRECHNUNG profile updates. Custom enables advanced version handling.	`2.0`
Zugferd Version Custom	Conditional	Custom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty).	`2.3.1`
Conformance Level	Conditional	Profile controlling which invoice fields are required. Shown when Zugferd Version is 1.0 (legacy options). Switches to Conformance Level (Above 2) for versions 2.0/2.1/2.2/2.4 and Custom (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG).	`EN16931`
Language	Yes	Display language for invoice labels in the rendered PDF. Options: German, French, Italian, English, Spanish, Dutch, Polish, Portuguese. The XML data itself remains language-neutral.	`German`
Render Invoice On PDF	Yes	Toggle (ON/OFF). When enabled, PDF4me visually renders the invoice content on the PDF using your invoice data. When disabled, only the structured XML is generated and embedded, useful when you supply a pre-designed background PDF.	`true`
Input Format	Yes	Format of the invoice data you are providing. XML for pre-built ZUGFeRD XML or UBL data. JSON for structured invoice objects. CSV for tabular batch exports.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample
Invoice Data Input Type	Yes	How the invoice data reaches the node. Direct Text accepts pasted or mapped data inline. Binary Data reads from a previous file node. Base64 String for encoded payloads. URL downloads from a public link.	`Direct Text`
Invoice XML / JSON / CSV Data	Conditional	The actual invoice content. Appears as Invoice XML Data, Invoice JSON Data, or Invoice CSV Data, matching the chosen Input Format. Required when Invoice Data Input Type is Direct Text. Runtime also throws "Invoice … data is required" if empty.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample`Paste, map, or load via Binary / Base64 / URL to match the format you chose above.`
Invoice Binary Property Name	Conditional	Name of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data.	`data`
Invoice Base64 Content	Conditional	Base64-encoded invoice data. Required when Invoice Data Input Type is Base64 String. Runtime also throws "Invoice base64 content is required" if empty.	`PGludm9pY2U+...`
Invoice Data URL	Conditional	Public URL to the invoice data file. Required when Invoice Data Input Type is URL.	`https://example.com/invoice.json`
Output File Name	No	Filename for the generated ZUGFeRD invoice. Default provided and normalized in execute (e.g. extension matched to Output Mode). Use .pdf for XML With PDF and .xml for XML Only.	`zugferd_invoice.pdf`
Output Binary Field Name	No	Name of the binary field holding the generated ZUGFeRD file. Defaults to data. Used to reference the file in subsequent workflow nodes.	`data`

Örnek Fatura Dosyaları

Canlı veri kaynağınızı bağlamadan önce düğümü her giriş formatıyla test etmek için bu örnek dosyaları kullanın. Alman B2B üretim iş akışları için şunlarla başlayın: örnek-fatura-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 uygunluk).

MANŞETLİ XML Örnek

ZUGFeRD 1.0 TEMEL XML. ile kullanın Giriş Formatı: XMLYapıştır veya haritayı şuraya yapıştırın: Fatura XML Veri.

ZUGFeRD-fatura-örneği.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Örnek (EN16931)

ZUGFeRD 2.0 EN16931 XML Satıcı/alıcı tarafları, kalemler, KDV ve parasal toplam içeren, sektörler arası fatura formatında. Şunlarla kullanın: Giriş Formatı: XML, ZUGFeRD Sürümü: 2.0, Uygunluk: EN16931.

ZUGFeRD-fatura-örneği-2.0.xml

Tavsiye edilen

JSON 2.0 EN16931 Örneği

Tam yapılandırılmış fatura ZUGFeRD 2.0 ile EN16931 Uyumluluk. Kullanım amacı. Giriş Formatı: JSON, Zugferd Sürümü: 2.0, Uygunluk Seviyesi: EN16931Yapıştır veya haritayı şuraya yapıştırın: Fatura JSON Veri.

örnek-fatura-zugferd-2.0-en16931.json

JSON Fatura Örneği (temel)

Daha Basit JSON duman testleri için ZUGFeRD 1.0 Ve TEMEL uyumluluk.

örnek-fatura.json

CSV Fatura Örneği

Düz CSV satır için Giriş Formatı: CSVYapıştır veya haritayı şuraya yapıştırın: Fatura CSV Veri.

test-fatura.csv

ZUGFeRD 2.0

CSV 2.0 Fatura Örneği

Genişletilmiş 22 sütunlu CSV: Fatura Kimliği, Düzenleme Tarihi, satıcı/alıcı adres alanları, Satıcı KDV Kimliği, Ürün Kimliği, Para Birimi, Ödeme Referansı, IBANBIC. Şunlarla kullanın: Giriş Formatı: CSV, ZUGFeRD 2.0.

zugferd-fatura-2.0.csv

Gelişmiş Seçenekler

İçerideki tüm alanlar Gelişmiş Seçenekler Koleksiyonlar isteğe bağlıdır. Bunları şu şekilde ekleyebilirsiniz: Seçenek Ekle Node kullanıcı arayüzünde.

profiller

Gelenek PDF4me İşleme profilleri. Gelişmiş veya özel ZUGFeRD fatura oluşturma için önceden yapılandırılmış seçenek setlerini uygulayın (örneğin özel doğrulama kuralları, alternatif şema eşlemeleri veya sektöre özgü çıktı ayarlamaları).

Giriş Veri Türü Seçenekleri

Kontroller nasıl arka plan PDF belge (Hibrit faturanın görsel katmanı) düğüme sağlanır.

n8n PDF4me Zugferd Fatura Oluşturma düğümündeki Giriş Veri Türü açılır menüsünde dört seçenek bulunmaktadır: Açıklaması "Belge girişi gerekmez (yalnızca XML/JSON/CSV)" olan "Yok", açıklaması "Önceki düğümden dosyayı kullan" olan "İkili Veri" (vurgulanmış) ve açıklaması "Dosya içeriğini base64 kodlu dize olarak sağla" olan "Base64 Dize" ve açıklaması "Dosyaya URL sağla" olan "URL". — Giriş Veri Türü açılır menüsü: arka planın nasıl görüneceğini kontrol eder. PDF düğüme ulaşır

HiçbiriYalnızca XML/JSON/CSV, arka plan PDF'si yok.

Herhangi bir belge girişi gerekmiyor. PDF4me hem görseli üretir PDF katman ve yapılandırılmış XML Yalnızca fatura verilerinden yararlanarak. Sadece fatura verileri mevcut olduğunda ve yalnızca fatura verilerini kullanmak istediğinizde bunu kullanın. PDF4me Hibrit dosyanın tamamını oluşturmak için.

İkili VeriÖnceki düğümden gelen dosya (en yaygın olanı)

Arka planı okuyor. PDF ikili veriyi doğrudan önceki bir işlemin çıktısından almak n8n Düğüm: Google Drive İndirme, HTTP İkili Dosya İsteği veya Okuma. İkili Özellik alanı, hangi çıktı alanının okunacağını belirtir (varsayılan). veri).

Base64 DizisiBase64 kodlu dosya içeriği

Arka planı kabul ediyor. PDF Base64 kodlu bir dize olarak. Dosya bir yerden geldiğinde bunu kullanın. API Yanıt, webhook yükü veya belgeleri base64 olarak depolayan bir veritabanı sütunu.

URLHerkese açık bağlantıdan indir

Herkese açık erişim sağlayın. URL arka plana PDF. PDF4me Hibrit faturayı oluşturmadan önce dosyayı doğrudan indirir. URL Kimlik doğrulaması gerektirmemelidir.

Çıkış Modu Seçenekleri

Düğümün saf bir çıktı üretip üretmeyeceğini kontrol eder. XML dosya veya tam ZUGFeRD hibriti (PDF/A-3 + gömülü) XML).

n8n PDF4me Zugferd Fatura Oluşturma düğümündeki Çıktı Modu açılır menüsünde iki seçenek gösteriliyor: Yalnızca XML (açıklama: Yalnızca XML dosyasını oluştur) ve PDF'ye gömülü XML oluştur (açıklama: PDF ile birlikte XML) — Çıkış Modu açılır menüsünde iki seçenek bulunur: saf XML veya hibrit PDF/A-3 ile XML gömülü

Yalnızca XMLSaf XML, HAYIR PDF sarmalayıcı

Yalnızca yapılandırılmış çıktıları verir. XML Fatura verileri. Alıcı sistem fatura verilerini işlediğinde kullanılır. XML XRechnung saf XML gönderimleri için veya veri katmanını izole olarak test etmek için görsel içeriği doğrudan atar ve yok sayar. Çıkış Dosya Adı uzantısını şu şekilde ayarlayın: .xml.

XML ve PDFVarsayılan: tam ZUGFeRD hibrit dosyası

Standart ZUGFeRD hibrit faturasını oluşturur: PDF/A-3 arşiv kalitesinde dosya. PDF yapılandırılmış ile XML Fatura verileri ek olarak dosyaya yerleştirilmiştir. İnsanlar bunu okur. PDFmakineler bunu ayrıştırır XMLBu, üretim amaçlı B2B e-faturalama için standart ZUGFeRD çıktısıdır.

ZUGFeRD Sürüm Seçenekleri

Oluşturulan faturaya gömülü ZUGFeRD spesifikasyon sürümü.

n8n PDF4me Zugferd Fatura Oluştur düğümündeki Zugferd Sürümü açılır menüsünde şu seçenekler gösteriliyor: 1.0, 2.0 (vurgulanmış), 2.1, 2.2, 2.4 ve Özel; ipucu ise Parametre: zugferdVersion şeklinde. — ZUGFeRD Sürüm açılır menüsünde eski 1.0 ve en yeni 2.4 dahil olmak üzere altı sürüm seçeneği bulunmaktadır.

1.0Eski sistem: 2025 hedefini karşılamıyor

Orijinal 2014 spesifikasyonu. Yalnızca eski alıcı sistemleriyle uyumludur. Olumsuz 2025'ten itibaren yürürlüğe girecek olan Alman B2B e-fatura zorunluluğunu karşılayın. Yeni iş akışları için kaçının.

2.0Varsayılan: geniş uyumluluk

İlk EN 16931 uyumlu sürüm (2019). Alman B2B şartnamesini karşılar ve genel B2B faturalama için güvenli varsayılan seçenektir. Factur-X 1.0 ile tamamen uyumludur.

2.1Küçük iyileştirmeler

2.0 sürümüne kıyasla şemada küçük iyileştirmeler ve açıklamalar ekler. Alıcı sisteminiz özellikle 2.1 sürümünü gerektiriyorsa kullanın.

2.2XRECHNUNG profili güncellendi.

Güncellenmiş XRECHNUNG profil sürümü 2.x ile uyumludur. Yeni profili gerektiren Alman kamu sektörü kuruluşlarına fatura keserken bu seçeneği tercih edin.

2.4En son: en yeni XRECHNUNG desteği

En son yayınlanan spesifikasyon. En yeni XRECHNUNG profil ve şema geliştirmelerini destekler. Alıcı tarafın en son sürüme ihtiyacı olduğunda seçin.

GelenekGelişmiş sürüm yönetimi

Belirli bir alıcı sistem tarafından standart dışı bir sürüm tanımlayıcısı gerektiğinde özel sürüm işleme olanağı sağlar. Yalnızca faturalama tarafınızca açıkça talimat verildiğinde kullanın.

Uyumluluk Seviyesi Seçenekleri

Uyumluluk profili, hangi fatura alanlarının zorunlu ve doğrulanmış olduğunu kontrol eder; bu da uyumluluk açısından en kritik tercihtir.

n8n PDF4me Create Zugferd Invoice düğümündeki Uyumluluk Seviyesi açılır menüsünde altı seçenek gösteriliyor: MINIMUM, BASICWL, BASIC, EN16931 (vurgulanmış), EXTENDED ve XRECHNUNG — Uyumluluk Seviyesi açılır menüsü, minimumdan XRECHNUNG'a kadar altı farklı profil sunarak saha gereksinimlerini ve uyumluluk kapsamını kontrol eder.

MİNİMUMSadece başlık bilgisi, geçerli bir fatura değil.

Sadece başlık verileri: taraflar, toplamlar, belge referansları. Hiçbir satır öğesi yok. Yasal fatura olarak kullanılamaz; yalnızca dahili muhasebe işlemleri veya durum bildirimleri için kullanılabilir.

TEMELWLSade Fiyat (Çizgisiz): Sadece KDV

Minimum tutara ek olarak KDV/vergi detaylarını da ekler. Hiçbir satır öğesi yok. Faturaların bağımsız yasal faturalar olarak değil, yalnızca siparişlerle karşılaştırıldığı rezervasyon senaryolarında kullanılır.

TEMELMinimum yasal fatura

BASICWL'nin üzerine ek kalemler ekler. AB e-fatura direktifinin mutlak minimum gereksinimlerini karşılar. Basit faturalar için kabul edilebilir, ancak tam B2B uyumluluğu için EN16931 daha güvenli bir varsayılan standarttır.

EN16931Varsayılan: Avrupa Standardı

Avrupa Standardı EN 16931 tam profil. AB genelinde B2B faturalama için önerilen varsayılan ayar ve Alman 2025 yönetmeliğinin referans aldığı uygunluk düzeyi. Uygun ticari faturalama için gerekli tüm alanları içerir.

UZATILMIŞSektöre özgü ekstralar

EN 16931 standardının ötesinde, örneğin ek lojistik, nakliye veya sektöre özgü referanslar gibi sektöre özgü alanlar ekler. Sektör anlaşmanız veya ticari ortağınız GENİŞLETİLMİŞ alanları gerektirdiğinde kullanın.

XRECHARGEAlman kamu sektörü zorunluluğu

Alman XRechnung CIUS profili, Alman federal, eyalet ve belediye yetkililerine kesilecek faturalar için zorunludur. EN16931'den daha sıkı doğrulama. Alıcı Alman kamu sektörü kuruluşu olduğunda kullanılmalıdır.

Dil Seçenekleri

Oluşturulan ekranda fatura etiketleri için görüntüleme dili PDF katman. XML Verinin kendisi dilden bağımsızdır.

n8n Zugferd Fatura Oluşturma uygulamasındaki dil açılır menüsünde Almanca, Fransızca, İtalyanca, İngilizce, İspanyolca, Felemenkçe, Lehçe ve Portekizce dilleri gösterilmektedir. — **Dil**: oluşturulan içerik için yerelleştirilmiş etiketler PDF (Almanca, Almanya'daki B2B ve B2G iş modelleri için tipiktir.)

AlmancaVarsayılan, Almanca B2B/B2G

İngilizceUluslararası faturalama

FransızcaFactur-X iş akışları

İtalyanİtalyan B2B

İspanyolİspanyolca B2B

FlemenkçeHollanda/Belçika

LehçePolonya B2B

PortekizcePortekiz/Brezilya

Giriş Biçimi Seçenekleri

Düğüm noktasına sağladığınız fatura verilerinin formatı.

n8n Zugferd Fatura Oluşturma uygulamasındaki Giriş Formatı açılır menüsünde XML, JSON ve CSV seçenekleri gösteriliyor ve JSON seçili. — **Giriş Formatı**: seçmek `XML`, `JSON`, veya `CSV` Fatura içeriğinizle eşleşecek şekilde.

XMLÖnceden üretilmiş XML fatura

Önceden biçimlendirilmiş ZUGFeRD uyumlu dosyaları sağlayın. XML veya UBL XML Verilerinizi kullanırken. ERP halihazırda standart üretiyor XML Hibrit sisteme entegre edilmesi gereken faturalar PDF.

JSONVarsayılan: modern API kaynak

Fatura verilerini yapılandırılmış bir biçimde sağlayın. JSON Nesne. Fatura verileri bir webhook'tan geldiğinde en yaygın tercih, REST APIveya modern muhasebe yazılımı. PDF4me haritalar JSON ZUGFeRD'e ait alanlar XML şemayı otomatik olarak.

CSVTablo halindeki toplu fatura verileri

Fatura verilerini şu şekilde sağlayın: CSVElektronik tablolardan, eski sistemlerden veya toplu faturalama senaryolarından toplu fatura dışa aktarımı için kullanışlıdır. PDF4me haritalar CSV ZUGFeRD şemasına sütunlar ekleyin.

Fatura Veri Giriş Türü Seçenekleri

Fatura verilerinin ( XML, JSON, veya CSV içerik) düğüme ulaşır.

n8n Create Zugferd Invoice uygulamasındaki Fatura Veri Giriş Türü açılır menüsünde Doğrudan Metin, İkili Veri, Base64 Dizisi ve URL seçenekleri gösterilmektedir. — **Fatura Veri Giriş Türü**: nasıl XML, JSON, veya CSV Veri yükü sağlanır (satır içi, önceki bir düğümden gelen ikili veri, base64 veya URL).

Doğrudan MetinVarsayılan: satır içi yapıştır veya eşle

Fatura verilerini doğrudan Fatura Verileri alanına yapıştırın veya eşleştirin. En uygun kullanım alanı: JSON veya daha küçük CSV Yukarı akış düğümlerinden gelen yükleri kullanın. n8n Verileri dinamik olarak oluşturmak için ifade sözdizimi.

İkili VeriÖnceki düğümden gelen dosya

Fatura veri dosyasını okur (XML, JSON, veya CSV) doğrudan önceki bir işlemin ikili çıktısından n8n düğüm: Google Drive'dan İndir, İkili Dosyayı Oku veya HTTP İstek. Büyük boy için en iyisi. XML Dosyalar.

Base64 DizisiBase64 kodlu veriler

Fatura verilerini base64 kodlu bir dize olarak kabul eder. Fatura içeriği bir kaynaktan geldiğinde kullanılır. API Dosyaları base64 olarak depolayan yanıt veya veritabanı alanı.

URLHerkese açık bağlantıdan indir

Herkese açık erişim sağlayın. URL fatura veri dosyasına. PDF4me Dosyayı indirir ve seçilen Giriş Biçimine göre içeriğini ayrıştırır.

Çıkış Alanları

Alan	Tip	İçeriğinde neler var?
`fileName`	String	Filename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output.
`mimeType`	String	MIME type of the output file: application/pdf for hybrid output, application/xml for XML Only. Useful for content type validation in downstream HTTP or storage nodes.
`fileSize`	Number	Size of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow.
`success`	Boolean	True when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches.
`message`	String	Human-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps.

Hızlı Kurulum

Eklemek PDF4me senin n8n İş akışı. Ayarla Kaynak ile Fatura Ve Fatura İşlemleri ile Zugferd Faturası Oluştur.
İçinde Bağlantı kurmak için kimlik bilgisi, sizinkini seçin PDF4me kimlik bilgileri veya tıklayın Yeni Kimlik Bilgisi Oluştur ve yapıştırın API anahtar.
Ayarlamak Giriş Veri Türü: önceki bir düğüme bağlanın (İkili Veri), bir bilgi sağlayın Base64 dize veya URL arka plan için PDFveya "Hiçbiri" seçeneğini seçin PDF4me oluşturmalıdır PDF Sadece fatura verilerinden yola çıkarak.
Girmek Belge Adı (Örneğin invoice.pdf).
Ayarlamak Çıkış Modu: XML ve PDF standart hibrit ZUGFeRD çıkışı için veya Yalnızca XML saf için XML.
Seçmek Zugferd Versiyonu (kullanmak 2.0 Güvenli varsayılan değer olarak; 2.4 (en yeni XRECHNUNG profili için).
Seçmek Uygunluk Seviyesi: EN16931 genel B2B için, XRECH Alman kamu sektörü faturalaması için, UZATILMIŞ Sektöre özgü alanlar için.
Ayarlamak Dil oluşturulan için PDF Etiketler (varsayılan olarak Almanca).
Olanak vermek Faturayı PDF Olarak Oluştur eğer istersen PDF4me Fatura içeriğini görsel olarak oluşturmak için; önceden tasarlanmış bir arka plan sağlandığında devre dışı bırakılır. PDF.
Seçmek Giriş Formatı (JSON, XML, veya CSV) Ve Fatura Veri Giriş Türü (Doğrudan Metin, İkili Veri, Base64 Dizisi veya URL). Fatura verilerini Fatura Verileri alanına yapıştırın veya eşleştirin.
Ayarlamak Çıktı Dosya Adı ile zugferd_invoice.pdf Ve Çıktı İkili Alan Adı ile data.
Çıktıyı bir sonraki düğüme bağlayın (e-posta gönderici, bulut depolama alanına yükleme, devlet portalı). HTTP POST) ve iş akışını yürütün.

İş Akışı Örnekleri

İş Akışı ÖrnekleriCommon n8n workflow patterns using Create Zugferd Invoice.

Muhasebe yazılımı → ZUGFeRD 2.0 EN16931 fatura → müşteriye e-posta gönder

Bir fatura muhasebe platformunda (DATEV, sevDesk, lexoffice) kesinleştiğinde bir Webhook tetikleyicisi çalışır.
Webhook yükü, yapılandırılmış bir biçimde fatura verilerini içerir. JSON nesne.
PDF4me Zugferd Faturası Oluştur, hibrit fatura oluşturur. Giriş Veri Türü Yoktur (PDF4me oluşturur PDF -den JSONÇıktı Modu XML (PDF ile), Zugferd Sürümü 2.0, Uyumluluk Seviyesi EN16931, Dil Almanca, Giriş Formatı JSONFatura Veri Giriş Türü, webhook yükünden eşlenen Doğrudan Metindir.
Bir Gmail düğümü ZUGFeRD'e e-posta gönderir. PDF Müşterinin ödeme adresine gönderilmekte olup, Alman B2B alım yetki belgesi şartını karşılamaktadır.
PostgreSQL düğümü, denetim ve uyumluluk raporlaması için fatura numarasını, ZUGFeRD sürümünü ve uygunluk düzeyini kaydeder.

ERP XML fatura → ZUGFeRD XRECHNUNG → kamu sektörü portalına yükle

Kamu sektörüne ait faturaları işlemek için her hafta içi saat 16:00'da bir Zamanlama Tetikleyicisi çalışır.
Bir SFTP düğümü yeni oluşturulan verileri çeker. ERP XML Dışa aktarma klasöründeki fatura dosyaları.
PDF4me Zugferd Fatura Oluştur, XRECHNUNG uyumlu bir fatura oluşturur. Giriş Veri Türü Yok, Çıkış Modu XML (PDF ile), Zugferd Sürümü 2.4 (en son XRECHNUNG profili), Uyumluluk Seviyesi XRECHNUNG, Dil Almanca, Giriş Formatı XMLFatura Veri Giriş Türü, SFTP dosya içeriğinden eşlenen İkili Veridir.
Bir HTTP Talep düğümü, XRECHNUNG faturasını federal ZRE'ye (Federal Hükümetin Merkezi Fatura Alma Platformu) veya ilgili eyalet portalına yükler.
Bir Microsoft Outlook Düğüm, tedarik ekibine bir onay gönderir ve bir PostgreSQL düğümü, gönderim referansını kaydeder.

Aylık CSV faturalama grubu → ZUGFeRD faturaları → arşivle SharePoint

Aylık faturalama işlemini gerçekleştirmek için her ayın 1'inde bir Zamanlama Tetikleyicisi devreye girer.
Bir Google Drive düğümü, birleştirilmiş dosyayı indirir. CSV Fatura dışa aktarımı, her müşteri faturası için bir satır.
"Split In Batches" düğümü her biri üzerinde yineleme yapar. CSV sıra. PDF4me Zugferd Faturası Oluştur, müşteri başına bir ZUGFeRD faturası oluşturur. Giriş Veri Türü Yok, Çıkış Modu XML (PDF ile), Zugferd Sürümü 2.0, Uyumluluk Seviyesi EN16931, Dil müşteri yerel ayarına göre değişir, Giriş Formatı CSVFatura Veri Giriş Türü, satır başına CSV içeriğiyle birlikte Doğrudan Metindir.
Bir Microsoft SharePoint düğüm her ZUGFeRD'i yükler PDF Müşterinin fatura arşiv klasörüne.
Bir Gmail düğümü, her müşteriye hibrit faturasını gönderir; son PostgreSQL özet satırı, fatura sayısı ve toplam tutarla birlikte toplu işlemi kaydeder.

Sıkça Sorulan Sorular

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+

ZUGFeRD is the German hybrid e-invoicing standard: a PDF/A-3 archival-grade PDF with structured XML invoice data embedded inside as an attachment. Humans read the visual PDF and machines parse the embedded XML, so a single file serves both audiences. XRechnung is the German public-sector profile, mandatory when invoicing federal, state, or municipal authorities; it can be issued as pure XML or as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the identical hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully interoperable. Use ZUGFeRD 2.x with EN16931 for general B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Which ZUGFeRD version should I use in 2025 for the German B2B e-invoicing mandate?+

ZUGFeRD 2.0 or higher is required to comply with the German B2B e-invoicing mandate. The mandate, enacted under the Wachstumschancengesetz (Growth Opportunities Act), made e-invoice receipt mandatory from 1 January 2025 and phases in full sending obligations by 2028. Versions 2.0 through 2.4 all comply with EN 16931, the European standard the mandate references. ZUGFeRD 2.2 and 2.4 add support for the newer XRECHNUNG profile updates. Legacy ZUGFeRD 1.0 does not satisfy the mandate. Default to 2.0 for broad compatibility across receiving systems, or 2.4 when the latest XRECHNUNG profile is required.

What is the difference between MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, and XRECHNUNG conformance levels?+

MINIMUM contains only the absolute minimum invoice header data (totals and parties) and cannot serve as a legal invoice; it is for internal accounting drop-offs only. BASICWL (Basic Without Lines) adds VAT and tax breakdowns but still has no line items. BASIC adds line items and meets the absolute minimum of the EU e-invoicing directive. EN16931 is the European Standard EN 16931 profile, recommended as the default for B2B invoicing across the EU and the level the German mandate references. EXTENDED adds industry-specific fields beyond EN 16931. XRECHNUNG is the German public-sector mandatory profile, required when invoicing federal, state, or municipal authorities. Use EN16931 for general B2B, XRECHNUNG for public sector, EXTENDED for industry-specific scenarios.

What is the difference between XML Only and XML With PDF output modes?+

XML Only generates a pure XML file containing the structured invoice data, useful when the receiving system processes only the XML and discards visual content, for XRechnung pure-XML submissions, or for testing the data layer in isolation. XML With PDF generates the full ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the XML embedded as an attachment inside the PDF. The hybrid format is the canonical ZUGFeRD output and is required when both human readability and machine processing must be supported by a single file. Choose XML With PDF for production e-invoicing workflows and XML Only for data-layer integration testing or pure-XML public-sector submissions.

Can I generate ZUGFeRD invoices from CSV data, and what does Invoice Data Input Type control?+

Yes. The Input Format parameter supports XML, JSON, and CSV; pick the format matching your data source. Invoice Data Input Type then controls how the data reaches the node: Direct Text lets you paste or map the data inline (best for JSON or small CSV from upstream nodes), Binary Data reads from a previous file node (best for large XML files), Base64 String accepts encoded content (best for API payloads), and URL downloads the data file from a public link. CSV input is automatically mapped to the ZUGFeRD XML schema by PDF4me before being embedded in the output PDF; no manual XML construction is required.