Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Membuat Faktur Elektronik ZUGFeRD 2.0+ di Make: Alur Kerja Dropbox 4 Modul

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (juga dikenal sebagai Faktor-X di Prancis dan XRechnung di sektor publik Jerman) adalah sebuah faktur hybrid PDF/A-3 dengan XML yang dapat dibaca mesin yang tertanam di dalam PDF. Satu file yang dapat digunakan baik oleh manusia maupun sistem ERP. Panduan ini menjelaskan langkah-langkah persis yang ditunjukkan pada tangkapan layar: PDF faktur dasar dan XML ZUGFeRD 2.0+ di Dropbox menjadi faktur elektronik hibrida yang sesuai dengan standar EN16931. /pdf4meoutput/, di dalam 4. Buat modul, tanpa kode..

Gambaran umum situasi
1. Dropbox Download (PDF)
Pulls the base invoice PDF (/pdf4metest/Zugfred Invoice/SimplePdf.pdf). Scheduled trigger shown.
2. Dropbox Download (XML)
Pulls the ZUGFeRD 2.0+ XML invoice data (/pdf4metest/Zugfred Invoice/version2.xml).
3. PDF4me Create a ZUGFeRD invoice
Input Format XML, Output Mode XML With PDF, ZUGFeRD Version 2+, Conformance EN16931, Render Yes, Language de.
4. Dropbox Upload
Writes the hybrid PDF/A-3 e-invoice to /pdf4meoutput/ using File set to Map.
Versi singkatnya

Empat modul Make end-to-end. Dua Dropbox Unduh File Langkah-langkahnya adalah mengambil PDF dasar dan XML ZUGFeRD 2.0+ (tangkapan layar menunjukkan YnooxTestone koneksi plus jalur /pdf4metest/Faktur Zugfred/SimplePdf.pdf Dan /pdf4metest/Faktur Zugfred/versi2.xml). PDF4me Buat faktur ZUGFeRD menyematkan XML ke dalam PDF dengan Mode Keluaran XML dengan PDF, Versi ZUGFeRD 2+, Tingkat Kesesuaian EN16931, Buat Faktur dalam Format PDF Ya, Bahasa dariDropbox Unggah File menuliskan hasilnya PDF/A-3 hibrida ke /pdf4meoutput/ dengan File diatur ke Peta, Nama Berkas 15. NamaData 15. DokumenOutputnya dapat dibuka di pembaca PDF mana pun dan diuraikan dengan baik di ERP mana pun yang mendukung ZUGFeRD / Factur-X / XRechnung.

Ada dua hal yang menentukan apakah sistem ERP Anda menerima faktur tersebut.

Pertama, Tingkat Kesesuaian Harus sesuai dengan apa yang diharapkan oleh sistem ERP pembeli atau penerima Anda. EN16931 (Comfort) adalah standar hukum Jerman dan pilihan aman untuk B2B di Uni Eropa; XRECH diperlukan untuk pembuatan faktur B2G (sektor publik) di Jerman; DASAR Hal ini berlaku untuk sebagian besar pembeli lainnya. Kedua, Versi ZUGFeRD harus 2+ untuk segala sesuatu yang sesuai dengan standar EN 16931. Warisan 1.0 Menggunakan BASIC / COMFORT / EXTENDED dan tidak kompatibel dengan receiver EN 16931. Pilih 2+ kecuali jika penerima secara eksplisit meminta versi 1.0.

Pertanyaan umum di dunia nyata yang dapat dipecahkan oleh solusi ini.​

Orang-orang mencari solusi untuk masalah ini dengan menggunakan frasa seperti:

  • "Bagaimana cara membuat faktur ZUGFeRD dengan XML ter embedded di Make?" Skenario 4 modul ini melakukannya secara menyeluruh: templat PDF plus faktur XML sebagai input, dan output berupa PDF/A-3 hibrida.
  • "Apakah ZUGFeRD sama dengan Factur-X?" Ya. Format teknis yang sama dengan nama berbeda. File ZUGFeRD 2.x diterima oleh sistem yang mengharapkan Factur-X dan sebaliknya.
  • "Tingkat Kepatuhan mana yang harus saya pilih?" EN16931 untuk B2B (sesuai dengan standar hukum Jerman dan EU EN 16931), XRECHNUNG untuk sektor publik Jerman (B2G), BASIC untuk kompatibilitas warisan yang paling luas.
  • "Apakah saya perlu menulis XML sendiri?" Tidak, tetapi untuk skenario ini, tangkapan layar menggunakan faktur XML yang sudah ada. Modul ini juga menerima input JSON atau CSV dan akan membuat XML untuk Anda.
  • "Bagaimana jika pembeli saya hanya membutuhkan XML, bukan PDF?" Atur Mode Output ke XML Only dan modul tersebut hanya mengembalikan file faktur XML, bukan file hibrida.

Apa yang sedang Anda bangun​

Skenario Make yang dapat digunakan kembali yang menghasilkan faktur elektronik hibrida ZUGFeRD 2.0+ yang sepenuhnya sesuai dari file PDF dasar dan file faktur XML. Pemicunya dapat berupa manual, terjadwal (seperti yang ditunjukkan), pemantauan file Dropbox, atau webhook HTTP. Outputnya adalah satu file tunggal yang memenuhi persyaratan PDF yang dapat dibaca manusia dan persyaratan XML yang dapat dibaca mesin untuk mandat faktur elektronik Uni Eropa.

Buat kanvas skenario: Dropbox Unduh File (PDF, dengan lencana jam terjadwal) terhubung ke Dropbox Unduh File (XML) kedua, terhubung ke PDF4me Buat faktur ZUGFeRD, terhubung ke Dropbox Unggah File. Setiap modul menampilkan penghitung iterasi 1 dan tanda centang hijau yang menunjukkan eksekusi berhasil.

Empat modul ujung-ke-ujung. Dua unduhan, satu aksi PDF4me, satu unggahan. Lencana jam pada Modul 1 menunjukkan pemicu terjadwal; ubah ke manual / pantau file / webhook agar sesuai dengan kasus penggunaan Anda.

Apa yang Anda butuhkan​

  • Membuat akun dengan skenario yang sedang dibuka. Buat akun Make jika Anda membutuhkannya.
  • Kunci API PDF4me. Dapatkan kunci API Anda dan terhubung pada modul PDF4me pertama. Lihat Hubungkan PDF4me untuk Membuat.
  • Dropbox dengan folder sumber (misalnya, /pdf4metest/Faktur Zugfred/) yang berisi templat PDF dan faktur XML, ditambah folder keluaran (/pdf4meoutput/).
  • PDF dasar (tangkapan layar menggunakan SimplePdf.pdf). Tidak memerlukan markup tata letak apa pun. Modul ini menyematkan XML sebagai lampiran PDF/A-3.
  • Faktur XML ZUGFeRD 2.0+Gunakan milikmu sendiri, atau ambil yang lain. Contoh XML 2.0 untuk mengikuti.

Referensi singkat: fungsi setiap parameter​

Input Format
XML for existing ZUGFeRD XML, JSON for structured JSON, CSV for tabular invoice rows.
Output Mode
XML With PDF returns the hybrid PDF/A-3 (recommended). XML Only returns just the XML invoice file.
ZUGFeRD Version
2+ for EN 16931 alignment (use this). 1.0 is legacy with BASIC / COMFORT / EXTENDED only.
Conformance Level
2+ supports MINIMUM, BASICWL, BASIC, EN16931 (Comfort, default), EXTENDED, XRECHNUNG (German B2G).
Render Invoice on PDF
Yes draws the invoice line items visually on the PDF. Only takes effect when Output Mode is XML With PDF.
Language
Two-letter ISO code: de (default), en, fr, it, es, nl, pl, pt, cs. Controls label localisation on the rendered PDF.

Susun skenarionya​

Modul 1: Mengunduh File dari Dropbox (PDF dasar)​

Ambil file PDF sumber tempat XML ZUGFeRD akan disematkan sebagai lampiran PDF/A-3.

BidangNilai yang digunakan dalam proses ini
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Buat konfigurasi Dropbox Download a File untuk PDF dasar. Koneksi YnooxTestone. Cara memilih file Pilih file. Jalur file /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Modul 2: Mengunduh File dari Dropbox (ZUGFeRD 2.0+ XML)​

Unduh file faktur XML ZUGFeRD. XML tersebut berisi setiap detail faktur; PDF hanyalah pembungkus visualnya.

BidangNilai yang digunakan dalam proses ini
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Buat konfigurasi Dropbox Download a File untuk ZUGFeRD 2.0+ XML. Koneksi YnooxTestone. Cara memilih file Pilih file. Jalur file /pdf4metest/Zugfred Invoice/version2.xml.

Modul 3: PDF4me Membuat faktur ZUGFeRD​

Aksi yang melakukan penyematan sebenarnya. Petakan kedua file yang diunduh sebagai input, pilih pengaturan kesesuaian Anda, dan jalankan.

KelompokBidangNilai
AuthConnectionClassify Documen (testva...). PDF4me connection
SourceFile (PDF template)Map → Module 1 File Name + Data
SourceInput FormatXML
SourceFile (XML invoice)Map → Module 2 File Name + Data (a second File picker appears when Input Format is XML)
OutputOutput ModeXML With PDF (hybrid PDF/A-3)
OutputZUGFeRD Version2+
OutputConformance LevelEN16931
OutputRender Invoice on PDFYes
OutputLanguagede

Modul 4: Mengunggah File ke Dropbox​

Simpan kembali faktur elektronik hybrid PDF/A-3 ke dalam folder output.

BidangNilai yang digunakan dalam proses ini
ConnectionYnooxTestone (ynoox.test...)
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name15. Name (dynamic content from PDF4me Module 3)
Data15. Document (dynamic content from PDF4me Module 3)
Buat konfigurasi Unggahan File Dropbox. Koneksi YnooxTestone. Folder /pdf4meoutput/. File diatur ke Map. Nama File terikat ke 15. Nama (dari PDF4me Buat faktur ZUGFeRD). Data terikat ke 15. Dokumen.

Simpan dan klik Jalankan sekaliPDF/A-3 hibrida tersebut hadir di /pdf4meoutput/ dalam beberapa detik.

Get your API KeyFull action reference

File contoh (XML, JSON, CSV)​

Anda dapat mengganti Modul 2 (XML) dengan salah satu input ini dan mengubahnya Format Masukan oleh karena itu.

Penyelesaian Masalah​

Conformance Level dropdown shows different options than expected
You toggled between Versions. Version 1.0 has BASIC, COMFORT, EXTENDED. Version 2+ has Empty, MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Pick the version first; conformance levels follow.
Second File picker did not appear when Input Format is XML
It only appears when File is set to Map. Click the File radio and choose Map; the second File picker (for the XML invoice) renders below.
Buyer ERP rejects the hybrid PDF as non-compliant
Mismatched Conformance Level. Check what the receiver expects (commonly EN16931 for B2B EU, XRECHNUNG for German B2G). Re-run with the right value.
Output is XML only when you wanted the hybrid PDF
Output Mode is set to XML Only. Switch to XML With PDF.
Rendered invoice on PDF is missing line items
Render Invoice on PDF is set to No or Empty, or Output Mode is XML Only. Set both: Output Mode = XML With PDF AND Render Invoice on PDF = Yes.
Want JSON or CSV instead of XML as the input
Change Input Format. The Invoice XML Data / second File picker is replaced by an Invoice JSON Data or Invoice CSV Data text field, which you map from a Google Sheets, HTTP, or file-download module.

Kapan menggunakan pola ini?​

B2B invoicing in the EU
EN16931 (Comfort) covers the legal default for German and EU business-to-business e-invoicing.
B2G (public-sector) Germany
XRECHNUNG is required for invoicing public authorities. Same flow, different conformance level.
Cross-border Factur-X
France and other EU markets accept ZUGFeRD 2.x as Factur-X. No format conversion needed.
ERP integration without code
Buyer ERP extracts the embedded XML automatically; no manual data entry in accounts payable.

Apa yang harus dibaca selanjutnya?​

Pertanyaan yang Sering Diajukan (FAQ)​

What is ZUGFeRD 2.0+ and how does it differ from 1.0?+
ZUGFeRD 2.0+ aligns with the EU EN 16931 e-invoicing standard and supports the modern Conformance Level set (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). ZUGFeRD 1.0 predates EN 16931 and uses BASIC / COMFORT / EXTENDED only. For any new integration in 2026 use 2+; 1.0 is kept for legacy buyer ERPs.
Is ZUGFeRD the same as Factur-X?+
Same technical format under different brand names. ZUGFeRD is the German designation; Factur-X is the French equivalent. Both align to EN 16931 and are cross-compatible: a ZUGFeRD 2.x invoice is accepted by Factur-X receivers and vice versa.
Which Conformance Level should I pick for a typical EU B2B invoice?+
EN16931 (also called Comfort). It is the German legal default and the safe choice for EU business-to-business invoicing. Use XRECHNUNG when invoicing German public authorities (B2G). Use BASIC only when a recipient ERP explicitly requires it.
Do I need to author the XML myself?+
No. The screenshots use an existing XML (Input Format = XML), but the module also accepts JSON or CSV. Choose Input Format = JSON or CSV and the XML is built for you. Sample JSON and CSV files are in the section above.
What if my buyer needs only the XML, no PDF?+
Set Output Mode to XML Only. The module returns just the XML invoice file without a PDF wrapper. Useful when the receiving ERP renders its own document and only consumes the structured data.
Can I render line items visually on the PDF page?+
Yes. Set Render Invoice on PDF = Yes (only effective when Output Mode is XML With PDF). The module draws the invoice items as a visual table on the PDF pages so human reviewers see the invoice content without opening the embedded XML.
Does this work in Power Automate, n8n, or Zapier?+
Yes. The PDF4me Create ZUGFeRD Invoice action is available on all four platforms with the same parameters. See the cross-platform comparison at the bottom of the Make action reference page.
Does the output PDF/A-3 work with every PDF viewer?+
Yes. PDF/A-3 is backward-compatible with all PDF readers. Human readers see the rendered invoice PDF; ZUGFeRD-aware ERPs extract the embedded XML automatically. Non-aware tools just see a normal PDF.

Mulai​

Get your API KeyPDF4me on MakeAction reference