Buat Faktur ZUGFeRD di 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.

Fungsi node ini

PDF4me Buat Faktur Zugferd menghasilkan yang sepenuhnya sesuai Faktur elektronik hibrida ZUGFeRD (Dokumen PDF/A-3 dengan struktur) XML data faktur yang tertanam di dalamnya) langsung di dalam n8n alur kerja. Konversi XML, JSON, atau CSV data faktur ke dalam satu file hibrida yang siap digunakan Mandat e-faktur B2B Jerman, kepatuhan EN 16931 di seluruh Uni Eropa, atau profil sektor publik XRECHNUNG Jerman. Mendukung setiap versi ZUGFeRD dari 1.0 hingga 2.4 dan keenam tingkat kesesuaian dalam satu node.

Postingan Blog Terkait(1)

Bagaimana Cara Membuat Faktur ZUGFeRD di n8n? Alur Kerja Dropbox + JSON, Langkah demi Langkah!

Alur kerja n8n: unggah JSON faktur ke PDF4me, buat faktur ZUGFeRD/Factur-X, lalu unggah PDF yang dihasilkan ke Dropbox. Termasuk tangkapan layar nyata, pemetaan, dan pengecekan output.

Baca postingan →

Memverifikasi Identitas Anda API Meminta

Setiap PDF4me simpul di n8n memerlukan validitas Kredensial untuk terhubung denganBuat atau pilih salah satu yang sesuai dengan kebutuhan Anda. PDF4me API kunci agar alur kerja dapat mengautentikasi permintaan pembuatan faktur ZUGFeRD dengan aman.

Get your API Key

Fakta Penting yang Tidak Boleh Anda Lewatkan

ZUGFeRD adalah format hibrida PDF/A-3 + XML format, bukan murni XML standar

Outputnya berupa satu file PDF/A-3 berkualitas arsip. PDF dengan terstruktur XML Faktur terlampir di dalamnya. Manusia membacanya. PDF, mesin menguraikan XMLTidak ada file terpisah untuk dikirim. Untuk menghasilkan file murni. XML tanpa PDF Untuk membungkus file, atur Mode Output ke XML Saja; untuk menghasilkan file hibrida, atur ke XML Dengan PDF (default).

ZUGFeRD 2.0+ diperlukan untuk mandat B2B Jerman 2025-2028.

Undang-Undang Peluang Pertumbuhan Jerman (Wachstumschancengesetz) mewajibkan penerimaan faktur elektronik untuk semua transaksi B2B mulai 1 Januari 2025, dengan kewajiban pengiriman penuh yang diterapkan secara bertahap hingga tahun 2028. ZUGFeRD versi 2.0 atau lebih tinggi dengan kesesuaian EN16931 atau XRECHNUNG memenuhi persyaratan tersebut. ZUGFeRD versi 1.0 yang lama tidak memenuhi persyaratan.

Tingkat Kesesuaian mengontrol kepatuhan: EN16931 adalah standar aman yang ditetapkan secara default.

Pilih EN16931 untuk pembuatan faktur B2B umum di seluruh Uni Eropa (Standar Eropa), XRECHNUNG saat membuat faktur untuk entitas sektor publik Jerman, dan EXTENDED untuk bidang khusus industri di luar standar dasar EN 16931. MINIMUM dan BASICWL menghilangkan item baris dan tidak dapat digunakan untuk pembuatan faktur lengkap; hanya untuk penghapusan data akuntansi internal.

Parameter

Diperlukan dalam n8n UI: Kredensial untuk terhubung, Tipe Data Masukan, Nama Dokumen (selalu diperlukan meskipun Tipe Data Masukan adalah None, digunakan sebagai nama cadangan dokumen), Mode Keluaran, Versi Zugferd, Render Faktur pada PDF, Bahasa, Format Masukan, dan Tipe Masukan Data Faktur. Tingkat Kesesuaian ditampilkan dan diperlukan berdasarkan cabang Versi Zugferd, dengan nama bidang dan set opsi yang berbeda untuk 1.0 vs 2.0/2.1/2.2/2.4 vs Kustom. Bidang data faktur yang sesuai (Faktur) XML/JSON/CSV Data, Properti Biner, Base64 Konten, atau URL Data) diperlukan berdasarkan Tipe Input Data Faktur. Validasi saat runtime memberlakukan konten yang tidak kosong pada jalur yang dipilih dengan kesalahan seperti "Data Faktur … diperlukan" atau "Konten base64 Faktur diperlukan".

Parameter	Diperlukan	Apa fungsinya?	Contoh
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`

Contoh Berkas Faktur

Gunakan file sampel ini untuk menguji node dengan setiap format input sebelum menghubungkan sumber data langsung Anda. Untuk alur kerja produksi B2B Jerman, mulailah dengan sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 kesesuaian).

DIBORGOL XML Contoh

ZUGFeRD 1.0 BASIC XMLGunakan dengan Format Masukan: XMLTempel atau petakan ke dalam Faktur XML Data.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Sampel (EN16931)

ZUGFeRD 2.0 EN16931 XML dengan pihak penjual/pembeli, item baris, PPN, dan penjumlahan moneter dalam format CrossIndustryInvoice. Gunakan dengan Format Masukan: XML, Versi ZUGFeRD: 2.0, Kesesuaian: EN16931.

ZUGFeRD-invoice-sample-2.0.xml

Direkomendasikan

JSON 2.0 EN16931 Sampel

Faktur terstruktur lengkap untuk ZUGFeRD 2.0 dengan EN16931 kesesuaian. Gunakan dengan Format Masukan: JSON, Versi Zugferd: 2.0, Tingkat Kesesuaian: EN16931Tempel atau petakan ke dalam Faktur JSON Data.

sample-invoice-zugferd-2.0-en16931.json

JSON Contoh Faktur (dasar)

Lebih sederhana JSON untuk uji asap dengan ZUGFeRD 1.0 Dan DASAR kesesuaian.

contoh faktur.json

CSV Contoh Faktur

Datar CSV baris untuk Format Masukan: CSVTempel atau petakan ke dalam Faktur CSV Data.

faktur uji.csv

ZUGFeRD 2.0

CSV 2.0 Contoh Faktur

Diperluas menjadi 22 kolom CSV: InvoiceId, IssueDate, kolom alamat penjual/pembeli, SellerVatId, ProductId, Currency, PaymentReference, IBANBIC. Gunakan dengan Format Masukan: CSV, ZUGFeRD 2.0.

zugferd-invoice-2.0.csv

Opsi Lanjutan

Semua bidang di dalam Opsi Lanjutan Koleksi bersifat opsional. Tambahkan melalui Tambahkan Opsi di UI node.

profil

Kebiasaan PDF4me profil pemrosesan. Terapkan set opsi yang telah dikonfigurasi sebelumnya untuk pembuatan faktur ZUGFeRD tingkat lanjut atau khusus (misalnya aturan validasi khusus, pemetaan skema alternatif, atau penyetelan output khusus sektor).

Opsi Tipe Data Input

Mengontrol bagaimana latar belakang PDF dokumen (lapisan visual dari faktur hibrida) diberikan ke node.

Dropdown Tipe Data Input di node n8n PDF4me Buat Faktur Zugferd menampilkan empat opsi: Tidak Ada dengan deskripsi Tidak diperlukan input dokumen (hanya XML/JSON/CSV), Data Biner disorot dengan deskripsi Gunakan file dari node sebelumnya, String Base64 dengan deskripsi Berikan konten file sebagai string yang dikodekan base64, dan URL dengan deskripsi Berikan URL ke file — Dropdown Tipe Data Input: mengontrol bagaimana latar belakang PDF mencapai simpul

Tidak adaHanya XML/JSON/CSV, tanpa PDF latar belakang.

Tidak diperlukan input dokumen. PDF4me menghasilkan visual PDF lapisan dan struktur XML hanya dari data faktur. Gunakan ini ketika hanya data faktur yang ada dan Anda menginginkannya. PDF4me untuk merender file hybrid lengkap.

Data BinerBerkas dari node sebelumnya (paling umum)

Membaca latar belakang PDF biner langsung dari output sebelumnya n8n node: Unduhan Google Drive, HTTP Minta, atau Baca File Biner. Bidang Properti Biner menentukan bidang keluaran mana yang akan dibaca (default). data).

String Base64Konten file yang dikodekan Base64

Menerima latar belakang PDF sebagai string yang dikodekan base64. Gunakan ini ketika file tiba dari API respons, muatan webhook, atau kolom basis data yang menyimpan dokumen sebagai base64.

URLUnduh dari tautan publik

Sediakan akses publik URL ke latar belakang PDF. PDF4me Mengunduh file secara langsung sebelum membuat faktur hibrida. URL Tidak boleh memerlukan otentikasi.

Opsi Mode Keluaran

Mengontrol apakah node menghasilkan murni XML berkas atau hibrida ZUGFeRD lengkap (PDF/A-3 + terlampir) XML).

Menu tarik-turun Mode Output di node n8n PDF4me Buat Faktur Zugferd menampilkan dua opsi: Hanya XML dengan deskripsi Hasilkan hanya file XML, dan XML Dengan PDF yang disorot dengan deskripsi Hasilkan XML yang disematkan dalam PDF — Menu tarik-turun Mode Output dengan dua pilihan: murni XML atau hibrida PDF/A-3 dengan XML tertanam

Hanya XMLMurni XML, TIDAK PDF pembungkus

Hanya menghasilkan output yang terstruktur. XML Data faktur. Gunakan saat sistem penerima memproses XML langsung dan membuang konten visual, untuk pengiriman XRechnung pure-XML, atau untuk menguji lapisan data secara terpisah. Atur ekstensi Nama File Output ke .xml.

XML dengan PDFDefault: file hibrida ZUGFeRD lengkap

Menghasilkan faktur hibrida standar ZUGFeRD: PDF/A-3 berkualitas arsip. PDF dengan terstruktur XML Data faktur disematkan di dalamnya sebagai lampiran. Manusia membacanya. PDF, mesin menguraikan XMLIni adalah output ZUGFeRD standar untuk pembuatan faktur elektronik B2B dalam produksi.

Opsi Versi ZUGFeRD

Versi spesifikasi ZUGFeRD yang tertanam dalam faktur yang dihasilkan.

Dropdown Versi Zugferd di node Buat Faktur Zugferd n8n PDF4me menampilkan opsi: 1.0, 2.0 yang disorot, 2.1, 2.2, 2.4, dan Kustom, dengan tooltip yang menampilkan Parameter: zugferdVersion — Menu tarik-turun versi ZUGFeRD dengan enam pilihan versi termasuk versi lama 1.0 dan versi terbaru 2.4.

1.0Warisan: tidak memenuhi mandat tahun 2025

Spesifikasi asli tahun 2014. Hanya kompatibel dengan sistem penerima lama. Tidak bukan Memenuhi mandat e-invoicing B2B Jerman yang berlaku mulai tahun 2025. Hindari untuk alur kerja baru.

2.0Default: kompatibilitas luas

Versi pertama yang sesuai dengan EN 16931 (2019). Memenuhi mandat B2B Jerman dan merupakan standar aman untuk pembuatan faktur B2B umum. Sepenuhnya kompatibel dengan Factur-X 1.0.

2.1Perbaikan kecil

Menambahkan penyempurnaan dan klarifikasi skema kecil dibandingkan versi 2.0. Gunakan jika sistem penerima Anda secara khusus membutuhkan versi 2.1.

2.2Profil XRECNHNUNG yang diperbarui

Sesuai dengan profil XRECHNUNG versi 2.x yang telah diperbarui. Pilih opsi ini saat membuat faktur untuk entitas sektor publik Jerman yang memerlukan profil yang lebih baru.

2.4Terbaru: dukungan XRECHNUNG terbaru

Spesifikasi terbaru yang dirilis. Mencakup dukungan untuk profil XRECHNUNG terbaru dan peningkatan skema. Pilih jika pihak penerima membutuhkan versi terbaru.

KebiasaanPenanganan versi lanjutan

Mengaktifkan penanganan versi khusus ketika pengidentifikasi versi non-standar diperlukan oleh sistem penerima tertentu. Gunakan hanya jika diinstruksikan secara eksplisit oleh pihak lawan penagihan Anda.

Opsi Tingkat Kesesuaian

Profil kesesuaian mengontrol bidang faktur mana yang wajib diisi dan divalidasi, pilihan paling penting untuk kepatuhan.

Dropdown Tingkat Kesesuaian di node n8n PDF4me Buat Faktur Zugferd menampilkan enam opsi: MINIMUM, BASICWL, BASIC, EN16931 disorot, EXTENDED, dan XRECHNUNG — Menu tarik-turun Tingkat Kesesuaian dengan enam profil dari MINIMUM hingga XRECHNUNG, yang mengontrol persyaratan lapangan dan ruang lingkup kepatuhan.

MINIMUMHanya bagian header, bukan faktur yang valid.

Hanya data header: pihak-pihak, total, referensi dokumen. Tidak ada item baris. Tidak dapat digunakan sebagai faktur resmi; hanya untuk keperluan administrasi internal atau pemberitahuan status.

DASARDasar Tanpa Garis: Hanya PPN

Menambahkan rincian PPN/pajak di atas MINIMUM. Tetap saja tidak ada item baris. Digunakan untuk skenario pemesanan saja di mana faktur direkonsiliasi dengan pesanan, bukan sebagai faktur hukum yang berdiri sendiri.

DASARFaktur hukum minimum

Menambahkan item baris di atas BASICWL. Memenuhi persyaratan minimum absolut dari arahan faktur elektronik Uni Eropa. Dapat diterima untuk faktur sederhana, tetapi EN16931 adalah standar yang lebih aman untuk kepatuhan B2B penuh.

EN16931Default: Standar Eropa

Profil lengkap Standar Eropa EN 16931. The Rekomendasi default untuk faktur B2B di seluruh Uni Eropa dan tingkat kesesuaian yang dirujuk oleh mandat Jerman 2025. Mencakup semua bidang yang dibutuhkan untuk pembuatan faktur bisnis yang sesuai.

DIPERPANJANGFitur tambahan khusus industri

Menambahkan kolom khusus industri di luar EN 16931, misalnya referensi tambahan terkait logistik, pengangkutan, atau sektor tertentu. Gunakan jika perjanjian industri atau mitra dagang Anda mensyaratkan kolom EXTENDED.

XRECHWajib sektor publik Jerman

Profil XRechnung CIUS Jerman, Wajib untuk faktur yang ditujukan kepada pemerintah federal, negara bagian, dan kota di Jerman. Validasi lebih ketat daripada EN16931. Gunakan setiap kali penerima adalah entitas sektor publik Jerman.

Pilihan Bahasa

Bahasa tampilan untuk label faktur dalam tampilan yang dihasilkan PDF lapisan. Itu XML Data itu sendiri bersifat netral terhadap bahasa.

Menu tarik-turun bahasa di n8n Buat Faktur Zugferd yang menampilkan bahasa Jerman, Prancis, Italia, Inggris, Spanyol, Belanda, Polandia, dan Portugis. — **Bahasa**: label lokal untuk yang ditampilkan PDF (Bahasa Jerman adalah bahasa yang umum digunakan untuk DE B2B dan B2G).

JermanSecara default, Bahasa Jerman B2B/B2G

Bahasa inggrisPenagihan internasional

PerancisAlur kerja Factur-X

ItaliaBisnis B2B Italia

SpanyolBahasa Spanyol B2B

BelandaBelanda/Belgia

PolandiaPolandia B2B

PortugisPortugal/Brasil

Opsi Format Input

Format data faktur yang Anda berikan ke node.

Menu tarik-turun Format Input di n8n Buat Faktur Zugferd menampilkan opsi XML, JSON, dan CSV dengan JSON terpilih. — **Format Masukan**: memilih `XML`, `JSON`, atau `CSV` agar sesuai dengan muatan faktur Anda.

XMLPra-bangun XML faktur

Sediakan format yang sudah sesuai dengan ZUGFeRD. XML atau UBL XML data. Gunakan saat Anda ERP sudah menghasilkan standar XML faktur yang hanya perlu dibungkus dalam bentuk hibrida PDF.

JSONDefault: modern API sumber

Berikan data faktur sebagai data terstruktur. JSON Objek. Pilihan paling umum ketika data faktur tiba dari webhook, REST APIatau perangkat lunak akuntansi modern. PDF4me peta JSON bidang ke ZUGFeRD XML skema secara otomatis.

CSVData faktur batch tabular

Berikan data faktur sebagai CSV, berguna untuk ekspor faktur secara massal dari spreadsheet, sistem lama, atau skenario penagihan massal. PDF4me peta CSV kolom ke skema ZUGFeRD.

Opsi Jenis Input Data Faktur

Mengontrol bagaimana data faktur ( XML, JSON, atau CSV konten) mencapai node.

Dropdown Tipe Input Data Faktur di n8n Create Zugferd Invoice menampilkan opsi Teks Langsung, Data Biner, String Base64, dan URL. — **Jenis Input Data Faktur**: bagaimana XML, JSON, atau CSV muatan disediakan (inline, biner dari node sebelumnya, base64, atau URL).

Teks LangsungDefault: tempel atau petakan sebaris

Tempel atau petakan data faktur langsung ke kolom Data Faktur. Terbaik untuk JSON atau lebih kecil CSV Muatan data dari node hulu. Gunakan n8n sintaks ekspresi untuk membangun data secara dinamis.

Data BinerBerkas dari node sebelumnya

Membaca berkas data faktur (XML, JSON, atau CSV) langsung dari output biner sebelumnya n8n node: Unduh Google Drive, Baca File Biner, atau HTTP Permintaan. Terbaik untuk ukuran besar. XML berkas.

String Base64Data yang dikodekan Base64

Menerima data faktur sebagai string yang dikodekan base64. Gunakan saat konten faktur berasal dari API kolom respons atau basis data yang menyimpan file sebagai base64.

URLUnduh dari tautan publik

Sediakan akses publik URL ke file data faktur. PDF4me Mengunduh file dan menguraikan konten sesuai dengan Format Input yang dipilih.

Bidang Keluaran

Bidang	Jenis	Isi di dalamnya
`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.

Pengaturan Cepat

Menambahkan PDF4me untuk Anda n8n Alur kerja. Atur Sumber ke Faktur Dan Operasi Faktur ke Buat Faktur Zugferd.
Di dalam Kredensial untuk terhubung dengan, pilih milikmu PDF4me kredensial atau klik Buat Kredensial Baru dan tempelkan milik Anda API kunci.
Mengatur Tipe Data Masukan: menghubungkan node sebelumnya (Data Biner), menyediakan Base64 tali atau URL untuk latar belakang PDF, atau pilih Tidak Ada saat PDF4me seharusnya menampilkan PDF hanya berdasarkan data faktur.
Memasuki Nama Dokumen (Misalnya invoice.pdf).
Mengatur Mode Keluaran: XML dengan PDF untuk keluaran ZUGFeRD hibrida standar, atau Hanya XML untuk murni XML.
Memilih Versi Zugferd (menggunakan 2.0 sebagai pengaturan default yang aman; 2.4 (untuk profil XRECHNUNG terbaru).
Memilih Tingkat Kesesuaian: EN16931 untuk B2B umum, XRECH untuk penagihan sektor publik Jerman, DIPERPANJANG untuk bidang-bidang khusus industri.
Mengatur Bahasa untuk yang ditampilkan PDF label (bahasa Jerman secara default).
Memungkinkan Buat Faktur dalam Format PDF jika kamu mau PDF4me untuk menampilkan konten faktur secara visual; nonaktifkan saat menyediakan latar belakang yang telah dirancang sebelumnya. PDF.
Memilih Format Masukan (JSON, XML, atau CSV) Dan Jenis Input Data Faktur (Teks Langsung, Data Biner, String Base64, atau URL). Tempel atau petakan data faktur ke dalam kolom Data Faktur.
Mengatur Nama File Output ke zugferd_invoice.pdf Dan Nama Bidang Biner Keluaran ke data.
Hubungkan output ke node Anda berikutnya (pengirim email, unggahan penyimpanan cloud, portal pemerintah). HTTP POST) dan jalankan alur kerja.

Contoh Alur Kerja

Contoh Alur KerjaCommon n8n workflow patterns using Create Zugferd Invoice.

Perangkat lunak akuntansi → ZUGFeRD 2.0 EN16931 faktur → email pelanggan

Webhook Trigger akan aktif ketika sebuah faktur diselesaikan di platform akuntansi (DATEV, sevDesk, lexoffice).
Payload webhook berisi data faktur sebagai data terstruktur. JSON objek.
PDF4me Create Zugferd Invoice menghasilkan faktur hibrida. Tipe Data Masukan adalah Tidak Ada (PDF4me menampilkan PDF dari JSON). Mode Output adalah XML Dengan PDF, Versi Zugferd adalah 2.0, Tingkat Kesesuaian adalah EN16931, Bahasa adalah Jerman, Format Input adalah JSONTipe Input Data Faktur adalah Teks Langsung yang dipetakan dari payload webhook.
Sebuah node Gmail mengirim email ke ZUGFeRD. PDF ke alamat piutang pelanggan, memenuhi persyaratan mandat penerimaan B2B Jerman.
Sebuah node PostgreSQL mencatat nomor faktur, versi ZUGFeRD, dan tingkat kesesuaian untuk keperluan audit dan pelaporan kepatuhan.

ERP XML faktur → ZUGFeRD XRECHNUNG → unggah ke portal sektor publik

Pemicu Jadwal (Schedule Trigger) akan aktif setiap hari kerja pukul 16:00 untuk memproses faktur sektor publik.
Node SFTP menarik data yang baru saja dibuat. ERP XML berkas faktur dari folder ekspor.
PDF4me Buat Faktur Zugferd menghasilkan faktur XRECHNUNG yang sesuai. Tipe Data Masukan adalah Tidak Ada, Mode Keluaran adalah XML Dengan PDF, Versi Zugferd adalah 2.4 (profil XRECHNUNG terbaru), Tingkat Kesesuaian adalah XRECHNUNG, Bahasa adalah Jerman, Format Masukan adalah XMLTipe Input Data Faktur adalah Data Biner yang dipetakan dari konten file SFTP.
Sebuah HTTP Node permintaan mengunggah faktur XRECHNUNG ke ZRE federal (Platform Penerimaan Faktur Pusat Pemerintah Federal) atau portal negara bagian yang relevan.
Microsoft Outlook Node tersebut mengirimkan konfirmasi ke tim pengadaan dan node PostgreSQL mencatat referensi pengajuan tersebut.

Bulanan CSV batch penagihan → faktur ZUGFeRD → arsip ke SharePoint

Pemicu Jadwal akan aktif pada tanggal 1 setiap bulan untuk memproses proses penagihan bulanan.
Node Google Drive mengunduh data yang telah dikonsolidasikan. CSV Ekspor tagihan, satu baris per faktur pelanggan.
Node Split In Batches melakukan iterasi pada setiap CSV baris. PDF4me Buat Faktur Zugferd menghasilkan satu faktur ZUGFeRD per pelanggan. Tipe Data Masukan adalah Tidak Ada, Mode Keluaran adalah XML Dengan PDF, Versi Zugferd adalah 2.0, Tingkat Kesesuaian adalah EN16931, Bahasa bervariasi per lokal pelanggan, Format Masukan adalah CSVTipe Input Data Faktur adalah Teks Langsung dengan konten CSV per baris.
Microsoft SharePoint node mengunggah setiap ZUGFeRD PDF ke folder arsip penagihan pelanggan.
Sebuah node Gmail mengirimkan faktur hibrida kepada setiap pelanggan; baris ringkasan PostgreSQL terakhir mencatat proses batch dengan jumlah faktur dan jumlah total.

Pertanyaan yang Sering Diajukan

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.