Membuat ZUGFeRD Faktur di Make
Membuat ZUGFeRD Faktur adalah sebuah Make modul oleh PDF4me yang menghasilkan hibrida ZUGFeRD/Factur-X faktur elektronik dari CSV, JSON, atau XML Data faktur. Gunakan data tersebut untuk menghasilkan sebuah PDF/A-3 dokumen dengan yang dapat dibaca mesin XML tertanam di dalam, sejajar dengan EN 16931 Standar faktur elektronik Eropa. Pilih tingkat kesesuaian dan versi spesifikasi yang sesuai dengan kebutuhan pembeli Anda. ERP Sistem membutuhkan.
Fungsi modul ini
PDF4meBuatlah sebuah ZUGFeRD faktur menghasilkan faktur elektronik hibrida langsung di dalam aplikasi Anda. Make skenario. Berikan data faktur sebagai CSV, JSON, atau XMLModul tersebut menghasilkan sebuah PDF/A-3 dokumen dengan format yang dapat dibaca mesin ZUGFeRD XML berkas tertanam di dalamnya, atau sebuah XML-hanya output untuk ERP sistem yang menangani renderingnya sendiri. Hasilnya selaras dengan EN 16931 Standar faktur elektronik Eropa dan diterima sebagai Factur-X di Prancis dan di seluruh pasar Uni Eropa. Tingkat kesesuaian dan versi spesifikasi dapat dikonfigurasi agar sesuai dengan kebutuhan pembeli atau penerima sektor publik Anda.
Memverifikasi Identitas Anda API Meminta
Setiap PDF4me modul di Make memerlukan validitas KoneksiBuat atau pilih salah satu yang sesuai dengan kebutuhan Anda. PDF4me API kunci agar skenario dapat memanggil layanan pembuatan faktur dengan aman.
Fakta Penting yang Tidak Boleh Anda Lewatkan
Output hibrida adalah PDF/A-3 dokumen. itu ZUGFeRD XML disematkan sebagai lampiran yang sesuai di dalam file. ERP sistem mengekstrak XML secara otomatis; manusia masih dapat membuka dan membacanya. PDF di aplikasi penampil standar apa pun. Atur Buat Faktur dalam Format PDF Ya, untuk menampilkan item baris faktur secara visual di halaman.
Versi 1.0 mendukung DASAR, NYAMAN, LENGKAPVersi 2+ diperluas menjadi MINIMUM, BASICWL, BASIC, EN16931, DIPERPANJANG, XRECHNUNG. XRECHNUNG Dan EN16931 Diperlukan untuk pembuatan faktur sektor publik di Jerman. Selalu sesuaikan versi dan level dengan yang diharapkan oleh sistem pembeli.
Memilih XML menunjukkan Data XML Faktur bidang; JSON Menampilkan Data JSON Faktur; CSV Menampilkan Data CSV Faktur. Hanya isi kolom yang sesuai dengan format yang Anda pilih. Saat menggunakan XML Dalam format tersebut, modul ini juga mengekspos sebuah Mengajukan radio sehingga Anda bisa menariknya XML Ambil langsung dari Dropbox atau petakan dari modul sebelumnya.
Yang ZUGFeRD Versi mana yang sebaiknya saya gunakan?
Modul ini mendukung dua versi spesifikasi. Sebagian besar integrasi baru sebaiknya menggunakan versi 2.0 ke atas; versi 1.0 dipertahankan untuk interoperabilitas lama.
ZUGFeRD 2.0+ DIREKOMENDASIKAN
Spesifikasi saat ini. Tingkat kesesuaian: MINIMUM, DASAR, DASAR, EN16931 (Comfort, standar hukum Jerman), DIPERPANJANG, XRECHKompatibel silang dengan Factur-XPasangkan dengan 2.0 XML contoh, 2.0 EN16931 JSON contoh, atau 2.0 CSV contohScreenshot di bawah ini menunjukkan UI 2.0+ persis seperti yang ditampilkan saat ini.
ZUGFeRD 1.0 WARISAN
Pra-EN 16931 Spesifikasi. Tingkat kesesuaian: DASAR, KENYAMANAN, DIPERPANJANGGunakan hanya jika penerima ERP atau sistem pembeli secara eksplisit mensyaratkan versi 1.0 (jarang ditemukan setelah tahun 2022). Pasangkan dengan 1.0 XML contoh, itu dasar JSON contoh, atau 1.0 CSV contohSemua kolom lainnya berfungsi sama; hanya menu tarik-turun tingkat kesesuaian yang berubah.
Mulailah dengan Koneksilalu petakan basisnya PDF (Nama File, Dokumen) dan mengatur Format Masukan (Di Sini XML).
Dengan Mengajukan = Petapeta Data XML Faktur, mengatur Mode Keluaran (XmlWithPdf atau Hanya XML), lalu pilih zugferd Versi (Di Sini 1.0).
Parameter
Diperlukan: Koneksi, Format Masukan, Mode Keluaran, ZUGFeRD Versi. Bidang data faktur (Data XML Faktur, Data JSON Faktur, atau Data CSV Faktur) muncul secara dinamis berdasarkan pilihan Format Input Anda. Hanya kolom yang sesuai yang perlu diisi.
Mengapa Mengajukan Muncul dua kali di tangkapan layar versi 2.0 ke atas? Saat Format Input adalah XML dan File diatur ke Peta, modul ini menampilkan pemilih File kedua sehingga Anda dapat memetakan keduanya (a) basis PDF itu ZUGFeRD faktur harus disematkan ke dalam, dan (b) sumber ZUGFeRD XML berkas. Kedua pemilih menampilkan opsi radio yang sama. Saat Format Input adalah JSON atau CSV pemilih kedua digantikan oleh yang sesuai. Data JSON Faktur atau Data CSV Faktur kolom teks.
| Parameter | Diperlukan | Apa fungsinya? | Contoh / Opsi |
|---|---|---|---|
| Connection | Required | PDF4me API connection used to authenticate invoice generation requests. Click Add and paste your API key if connecting for the first time. | Your PDF4me connection |
| File | Conditional | Source of the base PDF where the ZUGFeRD invoice will be embedded (when Output Mode is XmlWithPdf). Radio button with two options: Dropbox - Download a File (pulls directly from a Dropbox account without a prior download step) or Map (supplies the PDF from a prior module. Dropbox, Google Drive, OneDrive, HTTP, etc.). Choose Map for the most flexible workflow. When Map is selected, the two sub-fields below appear. | Map |
| File → File Name | Conditional | Sub-field of File (visible when Map is selected). Filename of the base PDF including the .pdf extension. Map from the prior module's filename output. for example, the File Name field of a Dropbox or Google Drive Download module. | 1. File Name |
| File → Document | Conditional | Sub-field of File (visible when Map is selected). Binary PDF content where the ZUGFeRD XML will be embedded. Map from the prior module's binary data field. typically the Data field of Dropbox, Google Drive, or OneDrive download modules. Hint shown in module: "PDF file where Zugferd invoice should be added". | 1. Data |
| Input Format | Required | Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML; JSON or CSV for structured data. Hint: "Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML, JSON or CSV for structured data." | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice XML Data | Conditional | The ZUGFeRD XML invoice content to embed. Appears when Input Format = XML and File = Map. Hint: "Use when inputFormat is XML, please refer to our Create a ZUGFeRD invoice for guidelines." Map from a prior Dropbox download or HTTP module output. | XML sampleXML 2.0 sample3. Data (mapped) |
| Invoice JSON Data | Conditional | Structured invoice data in JSON format. Appears when Input Format = JSON. Map a JSON string from a Google Sheets, Airtable, or HTTP module. See sample JSON below. | JSON 2.0 EN16931 sampleJSON (basic)(mapped JSON string) |
| Invoice CSV Data | Conditional | Invoice row data in CSV format. Appears when Input Format = CSV. Map a CSV row from an iterator, Google Sheets, or file download module. See sample CSV below. | CSV sampleCSV 2.0 sample(mapped CSV row) |
| Output Mode | Required | XML With PDF (a.k.a XmlWithPdf in API requests) returns a PDF/A-3 file with the ZUGFeRD XML embedded inside, the standard hybrid e-invoice. XML Only (XmlOnly) returns just the XML invoice file without a PDF wrapper. Hint shown in module: "XML with PDF returns a PDF with embedded ZUGFeRD XML. XML only returns only the XML invoice file." | XML With PDF |
| ZUGFeRD Version | Required | ZUGFeRD specification version. Set to match what the recipient ERP or buyer system expects. Latest is 2+; legacy 1.0 also supported. The two have different conformance level sets (see table below). | 2+ |
| Conformance Level | Optional | ZUGFeRD conformance profile. Available levels differ by version. For 2+, EN16931 (Comfort) is the default for German legal e-invoicing compliance. See the Conformance Level Reference table below. Defaults to BASIC if not specified. | EN16931 |
| Render Invoice on PDF | Optional | When set to Yes, invoice line items are drawn visually on the PDF pages. Applies only when Output Mode is XmlWithPdf. Options: Yes, No, Empty. Hint: "Render invoice data visually on PDF pages. Applies only when outputMode is XmlWithPdf." | Yes |
| language | Optional | Two-letter locale code for invoice label localisation. Supported: de, en, fr, it, es, nl, pl, pt, cs. Hint: "Language code for invoice localisation (e.g. de, en, fr, it, es, nl, pl, pt, cs). Defaults to de if not specified." | de |
Referensi Tingkat Kesesuaian
Tingkat kesesuaian yang tersedia berbeda-beda berdasarkan zugferd VersiSelalu sesuaikan levelnya dengan apa yang diinginkan pembeli Anda atau ERP Sistem membutuhkan.
| Tingkat | Gunakan saat |
|---|---|
BASIC | Mandatory EN 16931 fields only. Widest compatibility, safe default. |
COMFORT | Adds optional fields for line-item detail and additional references. |
EXTENDED | Full field set for complex B2B invoices with delivery, allowances, and charges. |
| Tingkat | Gunakan saat |
|---|---|
MINIMUM | Absolute minimum fields. Buyer reference and totals only. |
BASICWL | BASIC without line items. Header-level data only. |
BASIC | Mandatory EN 16931 fields. Recommended starting point. |
EN16931 | Full EN 16931 compliance for cross-border and public sector. |
EXTENDED | Full field set including German-specific extensions. |
XRECHNUNG | German public-sector e-invoice mandate (XRechnung profile). |
Contoh Berkas Faktur
Gunakan file sampel ini untuk menguji modul 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).
ZUGFeRD-invoice-sample.xmlZUGFeRD-invoice-sample-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsoncontoh faktur.jsonfaktur uji.csvzugferd-invoice-2.0.csvCSV Referensi Kolom
Yang CSV Input harus mengikuti urutan kolom yang persis sama. Setiap baris menghasilkan satu faktur.
| Kolom | Keterangan | Contoh |
|---|---|---|
InvoiceId | Unique invoice identifier | INV-2025-001 |
IssueDate | Invoice issue date (YYYY-MM-DD) | 2025-01-15 |
SellerName | Seller company name | Test Company |
SellerStreet | Seller street address | 123 Main St |
SellerCity | Seller city | Test City |
SellerPostalCode | Seller postal / ZIP code | 12345 |
SellerCountry | ISO 3166-1 alpha-2 country code | DE |
SellerVatId | Seller VAT registration number | DE123456789 |
BuyerName | Buyer company or person name | Customer Inc |
BuyerStreet | Buyer street address | 456 Oak Ave |
BuyerCity | Buyer city | Customer City |
BuyerPostalCode | Buyer postal / ZIP code | 67890 |
BuyerCountry | ISO 3166-1 alpha-2 country code | DE |
ProductName | Line item product or service name | Test Product |
Quantity | Quantity of the line item | 10.0 |
UnitPrice | Net unit price | 9.90 |
TaxPercent | VAT / tax percentage | 19.0 |
Currency | ISO 4217 currency code | EUR |
PaymentReference | Payment reference string | PAY-REF-001 |
IBAN | Payee IBAN for bank transfer | DE08700901001234567890 |
BIC | Payee bank BIC / SWIFT code | GENODEF1M04 |
JSON Struktur Faktur
Saat menggunakan Format Input: JSON, muatan data harus mencakup kunci tingkat atas berikut. Semua objek dan array bersarang mengikuti struktur yang ditunjukkan dalam file contoh.
| Kunci | Jenis | Keterangan |
|---|---|---|
InvoiceId | String | Unique invoice number, e.g. "471102" |
IssueDate | String (ISO 8601) | Invoice date, e.g. "2013-03-05T00:00:00" |
InvoiceType | String | Document type label, e.g. "RECHNUNG" |
TypeCode | String | UN/EDIFACT document type code. 380 for standard invoice |
IsTest | Boolean | true for test runs, false / omit for production |
Notes | Array of strings | Free-text notes shown in the invoice header (payment terms, GLN, etc.) |
Seller | Object | Seller party: Name, Address (Street, City, PostalCode, Country), TaxId, VatId, GLN |
Buyer | Object | Buyer party: Name, Address (Street, City, PostalCode, Country, LineTwo), GLN |
Payment | Object | Payment details: PaymentReference, Currency, IBAN, BIC |
DeliveryDate | String (ISO 8601) | Actual delivery date, e.g. "2013-03-05T00:00:00" |
LineItems | Array of objects | Invoice lines. each with Quantity, UnitCode, UnitPrice, LineTotal, ProductName, GTIN, SellerProductId |
Totals | Object | Monetary totals: LineTotal, ChargeTotal, AllowanceTotal, TaxBasisTotal, TaxTotal, GrandTotal, TaxPercent, Currency |
Bagaimana cara saya membuat ZUGFeRD faktur di Make?
- Menambahkan PDF4me → Buat ZUGFeRD faktur sesuai dengan skenario Anda.
- Pilih Koneksi (atau klik) Menambahkan untuk membuat satu dengan milikmu API kunci).
- Memilih Format Masukan. XML, JSON, atau CSVKolom data yang muncul bergantung pada pilihan ini.
- Mengatur Mengajukan ke Peta dan hubungkan kolom data faktur (Data XML Faktur / Data JSON / Data CSV) dari output modul sebelumnya. Atau pilih Dropbox - Unduh File untuk mengambil file langsung dari Dropbox.
- Mengatur Mode Keluaran ke XmlWithPdf untuk hibrida PDF/A-3 faktur, atau Hanya XML untuk XML hanya.
- Mengatur zugferd Versi (1.0 atau 2+) lalu pilih Tingkat Kesesuaian dari kumpulan yang sesuai dengan versi. mulai dengan DASAR.
- Jika menggunakan XmlWithPdf: atur Buat Faktur dalam Format PDF ke Ya untuk menggambar item baris secara visual, dan menetapkan bahasa ke wilayah target Anda (misalnya,
de,en,fr). - Menyimpan lalu klik Jalankan sekali. Arahkan Data Dokumen output ke Dropbox, Google Drive, dan ERP webhook, atau modul email.
Bidang Keluaran
| Bidang | Jenis | Isi di dalamnya |
|---|---|---|
Document Name | String | Filename of the generated invoice file. e.g. invoice-471102.pdf or invoice-471102.xml. |
Document Data | Buffer | Binary content of the ZUGFeRD hybrid PDF/A-3 or XML file. Map into an upload, email attachment, or ERP HTTP module for the next step in your scenario. |
Contoh Alur Kerja
Contoh Alur KerjaCommon Make scenario patterns using Create ZUGFeRD Invoice for automated e-invoicing.
- Pesanan ditandai sebagai telah dikirim di sistem Anda. ERP atau Airtable. Skenario tersebut terpicu.
- Rincian item, harga, alamat pembeli, dan data pajak diambil dan disusun menjadi sebuah JSON muatan.
- Membuat ZUGFeRD faktur berjalan dengan Format Input JSONMode Keluaran XmlWithPdf, versi 2+Tingkat Kesesuaian DASAR, bahasa
dari. - Hibrida PDF Dikirimkan melalui email kepada pembeli melalui Gmail dan salinannya diunggah ke arsip faktur di Google Drive.
- Akuntansi mengalami penurunan CSV Unggah berkas faktur bulanan ke Dropbox.
- Trigger Watch Files mendeteksi file baru dan Iterator memproses setiap baris.
- Membuat ZUGFeRD faktur berjalan per baris dengan Format Input CSV, menghasilkan satu hibrida PDF per faktur.
- Semua PDFs diunggah ke folder arsip terstruktur dan email ringkasan penyelesaian dikirim ke tim keuangan.
- Faktur kontrak pemerintah dipicu dari catatan Airtable.
- Membuat ZUGFeRD faktur berjalan dengan Format Input JSONMode Keluaran Hanya XML, versi 2+Tingkat Kesesuaian XRECHARGE.
- Yang XML File dikirim langsung melalui POST ke perangkat pembeli yang kompatibel dengan Peppol. ERP API melalui sebuah HTTP modul.
- Respons sukses atau error dicatat ke dalam Google Sheet agar dapat ditinjau oleh tim keuangan.