Buat Faktur ZUGFeRD di Zapier

Apa yang dilakukan oleh tindakan ini?

PDF4me Buat Faktur ZUGFeRD menghasilkan yang sepenuhnya sesuai Faktur elektronik hibrida ZUGFeRD, A PDFDokumen A-3 dengan struktur XML Data faktur tertanam di dalamnya, langsung di dalam milik Anda. Zapier alur kerja. Konversi XML, JSON, atau CSV data faktur ke dalam satu file hibrida yang siap digunakan Mandat e-faktur B2B Jerman (2025+)Sesuai dengan standar EN 16931 di seluruh Uni Eropa, atau profil sektor publik XRECHNUNG Jerman. Mendukung versi ZUGFeRD 1.0 hingga 2.x dan setiap tingkat kesesuaian, BASIC, COMFORT, EXTENDED, EN16931, XRECHNUNG, dalam satu tindakan Zap. Pengganti langsung untuk alur kerja manual Adobe Acrobat, JustOn, atau ZUGFeRD Manager.

Postingan Blog Terkait(1)

Cara Membuat Faktur ZUGFeRD di Zapier dengan Dropbox dan XML (Langkah demi Langkah)

Otomatiskan pembuatan faktur hibrida ZUGFeRD dan Factur-X di Zapier. Picu pada file Dropbox baru, ambil muatan PDF dan XML dasar, jalankan PDF4me Buat Faktur ZUGFeRD dengan output XmlWithPdf, lalu simpan ke Dropbox. Panduan langkah demi langkah yang telah diverifikasi menggunakan kesesuaian EN 16931 BASIC.

Baca postingan →

Memverifikasi Identitas Anda API Meminta

Untuk mengakses PDF4me Web API melalui ZapierSetiap tindakan harus diautentikasi. Klik Hubungkan akun baru pertama kali dan tempelkan milik Anda PDF4me API Intinya, Zap berikutnya akan menggunakan kembali koneksi secara otomatis.

Get your API Key PDF4me on Zapier

Fakta Penting yang Tidak Boleh Anda Lewatkan

ZUGFeRD 2.0+ diperlukan untuk mandat B2B Jerman tahun 2025.

Undang-Undang Wachstumschancengesetz mewajibkan penerimaan faktur elektronik mulai 1 Januari 2025, dengan kewajiban pengiriman penuh pada tahun 2028. ZUGFeRD 2.0 atau lebih tinggi dengan kesesuaian EN16931 atau XRECHNUNG memenuhi persyaratan: ZUGFeRD 1.0 tidak memenuhi persyaratan. Tindakan default ke 1.0 di beberapa instalasi; beralih secara eksplisit ke 2.0+ untuk produksi.

Isi satu kolom data per proses, jangan pernah dua.

Peta hanya kolom data faktur yang sesuai dengan Format Input Anda, Data XML Faktur untuk XML, Data JSON Faktur untuk JSON, Data CSV Faktur untuk CSVMengisi beberapa kolom "hanya untuk berjaga-jaga" akan merusak validasi dan menyebabkan langkah Zap gagal saat dijalankan.

Tingkat Kesesuaian, EN16931 adalah standar aman untuk versi 2.x.

Memilih EN16931 untuk penagihan B2B umum Uni Eropa (ZUGFeRD 2.x), XRECH untuk entitas sektor publik Jerman, DIPERPANJANG untuk bidang khusus industri. Untuk ZUGFeRD 1.0, BASIC adalah tingkat faktur legal minimum. MINIMUM dan BASICWL menghilangkan item baris dan bukan merupakan faktur legal secara sendiri-sendiri.

Pada langkah Konfigurasi, lakukan tindakan Zapier PDF4me Create ZUGFeRD Invoice: File dan Nama File dari langkah sebelumnya, Format Input XML, Data XML Faktur dipetakan dari langkah sebelumnya, Mode Output XmlOnly, Versi Zugferd 1.0, Tingkat Kesesuaian BASIC, Render Invoice On Pdf True, Bahasa de — Zapier tindakan **Konfigurasi** tab, peta **Mengajukan** / **Nama File**, mengatur **Format Masukan** dan kolom data faktur yang sesuai, lalu **Mode Keluaran**, **Versi Zugferd**, **Tingkat Kesesuaian**, **Buat Faktur dalam Format PDF**, Dan **Bahasa**.

Parameter

Diperlukan dalam Zapier UI (bertanda bintang): Format Masukan, Mode Keluaran, Versi Zugferd, dan Tingkat Kesesuaian. Bersyarat: Kolom data Faktur yang sesuai (Data XML Faktur, Data JSON Faktur, atau Data CSV Faktur) berdasarkan Format Input. Untuk output XmlWithPdf: File dan Nama File (template PDF) biasanya dibutuhkan oleh konektor meskipun tidak diberi tanda bintang di setiap tata letak. Opsional: Buat Faktur dalam Format PDF, Bahasa.

Parameter	Diperlukan	Apa fungsinya?	Contoh
File	Conditional	Template/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly.	`3. File: (Exists but not shown)`
File Name	Conditional	Filename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step.	`3. File Name: 10 page + 3. File Ext: .pdf`
Input Format	Yes	Format of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample
Invoice Xml Data	Conditional	XML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs.	XML sample XML 2.0 sample`4. File: (Exists but not shown)`
Invoice Json Data	Conditional	JSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data.	JSON 2.0 EN16931 sample JSON (basic)`4. Body`
Invoice Csv Data	Conditional	CSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports.	CSV sample CSV 2.0 sample`4. File`
Output Mode	Yes	XmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked.	`XmlOnly`
Zugferd Version	Yes	ZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked.	`1.0`
Conformance Level	Yes	Profile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked.	`BASIC`
Render Invoice On Pdf	No	Toggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout.	`True`
Language	No	Two-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral.	`de`

Opsi Format Input

Mengontrol format data yang digunakan pada payload faktur Anda, dan kolom data Faktur mana yang harus Anda isi di bawah ini.

XMLPra-bangun XML faktur

Terbaik saat Anda ERP sudah memproduksi yang sesuai dengan ZUGFeRD. XML atau UBL XML yang hanya perlu dibungkus dengan hibrida PDF. Petakan file ke Data XML Faktur.

JSONModern APIdata yang bersumber

Paling cocok untuk alur kerja berbasis webhook atau SaaS sistem penagihan yang memancarkan JSON. PDF4me peta JSON bidang ke ZUGFeRD XML skema secara otomatis. Petakan ke Data JSON Faktur.

CSVEkspor spreadsheet atau batch

Paling cocok untuk ekspor faktur massal dari Google Sheets, Excel, sistem lama, atau skenario penagihan per baris. PDF4me peta CSV kolom ke skema. Petakan ke Data CSV Faktur.

Opsi Mode Keluaran

Mengontrol apakah Anda menghasilkan file hibrida ZUGFeRD kanonik atau XML murni.

XmlWithPdfFile hibrida ZUGFeRD lengkap default.

Menghasilkan hibrida ZUGFeRD standar: PDF/A-3 arsip PDF dengan terstruktur XML Faktur disematkan di dalamnya sebagai lampiran. Manusia membacanya. PDF, mesin menguraikan XMLOutput standar untuk faktur elektronik B2B. Membutuhkan pemetaan File dan Nama File.

Hanya XMLMurni XML, TIDAK PDF pembungkus

Hanya menghasilkan yang terstruktur XML faktur. Digunakan untuk XRechnung murni-XML pengajuan sektor publik, saluran EDI, pengujian lapisan data, atau sistem yang hanya memasukkan data. XML tanpa representasi visual.

Opsi Versi Zugferd

Versi spesifikasi ZUGFeRD yang tertanam dalam faktur yang dihasilkan. Menentukan opsi Tingkat Kesesuaian mana yang muncul di menu tarik-turun.

1.0Warisan, pra-EN 16931

Spesifikasi asli tahun 2014. Opsi kesesuaian: DASAR, NYAMAN, LENGKAP. TIDAK memenuhi mandat e-invoicing B2B Jerman 2025+. Gunakan hanya untuk penerima lama yang secara eksplisit memerlukan versi 1.0.

2.0+Direkomendasikan, sesuai dengan EN 16931

Sesuai dengan Standar Eropa EN 16931 dan memenuhi mandat B2B Jerman. Opsi kesesuaian meliputi MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNGPilihan tepat untuk penagihan produksi 2025+ dan interoperabilitas Factur-X.

Opsi Tingkat Kesesuaian

Profil kesesuaian mengontrol bidang faktur mana yang wajib diisi dan divalidasi. Opsi yang tersedia bergantung pada Versi Zugferd yang dipilih.

MINIMUMHanya versi 2.x, hanya header.

Hanya data header, tanpa item baris. BUKAN faktur resmi yang sah. Hanya untuk keperluan administrasi internal.

DASAR2.x saja, hanya PPN

Menambahkan rincian PPN tetapi tidak ada item baris. Untuk skenario pemesanan saja yang direkonsiliasi terhadap pesanan.

DASARKedua versi, faktur hukum minimum

Menambahkan item baris. Memenuhi persyaratan minimum absolut dari arahan faktur elektronik Uni Eropa. Tersedia di versi 1.0 dan 2.x.

KENYAMANAN1.0 saja, referensi yang diperluas

Menambahkan data referensi dan bidang tambahan di atas BASIC. Hanya untuk ZUGFeRD 1.0, setara dengan EN16931 di versi 2.x modern.

EN169312.x, Rekomendasi default B2B

Profil lengkap Standar Eropa EN 16931. Rekomendasi standar untuk faktur B2B Uni Eropa dan level yang dirujuk oleh mandat Jerman. Hanya untuk ZUGFeRD 2.x.

DIPERPANJANGKedua versi, tambahan untuk industri.

Menambahkan kolom khusus industri di luar kolom dasar (logistik, pengiriman barang, referensi khusus sektor). Tersedia di versi 1.0 dan 2.x.

XRECHARGE2.x, wajib sektor publik Jerman

Profil XRechnung CIUS Jerman, wajib untuk faktur kepada otoritas federal, negara bagian, dan kota. Validasi lebih ketat daripada EN16931. Hanya ZUGFeRD 2.x.

Bidang Keluaran

Bidang	Jenis	Isi di dalamnya
`File Content`	Binary	Generated ZUGFeRD invoice file: hybrid PDF/A-3 for XmlWithPdf output or pure XML for XmlOnly output. Map into the next Zap step (upload, email, ERP POST).
`File Url`	String	Direct URL to access the generated file: useful for sharing or downstream HTTP processing.
`File Name`	String	Output filename without extension.
`Full File Name`	String	Complete output filename with extension (.pdf for hybrid, .xml for XmlOnly).

Contoh Berkas Faktur

Gunakan file sampel ini untuk menguji aksi 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).

Contoh XML ZUGFeRD

ZUGFeRD 1.0 BASIC XMLGunakan dengan Format Masukan: XML. Petakan ke Data XML Faktur.

ZUGFeRD-invoice-sample.xml

ZUGFeRD 2.0

Contoh XML ZUGFeRD 2.0 (EN16931)

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

ZUGFeRD-invoice-sample-2.0.xml

Direkomendasikan

Contoh JSON 2.0 EN16931

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

sample-invoice-zugferd-2.0-en16931.json

Contoh Faktur JSON (dasar)

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

contoh faktur.json

Contoh Faktur CSV

Datar CSV baris untuk Format Input: CSV. Petakan ke Data CSV Faktur.

faktur uji.csv

ZUGFeRD 2.0

Contoh Faktur CSV 2.0

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

zugferd-invoice-2.0.csv

Pengaturan Cepat

Di dalam Zapier, klik + untuk menambahkan tindakan baru dan memilih PDF4me.
Memilih Buat Faktur ZUGFeRD sebagai peristiwa aksi.
Hubungkan milik Anda PDF4me akun Anda atau tempelkan API Tekan tombol saat diminta.
Untuk XmlWithPdf keluaran, peta Mengajukan Dan Nama File sesuai tata letak Anda PDF (seringkali merupakan langkah pengunduhan Dropbox atau Google Drive sebelumnya). Untuk Hanya XML, ini bisa dibiarkan kosong.
Mengatur Format Masukan ke XML, JSON, atau CSV tergantung pada sumber data Anda.
Mengisi hanya Isi kolom data faktur yang sesuai: Data XML Faktur, Data JSON Faktur, atau Data CSV Faktur. Biarkan dua kolom lainnya kosong.
Mengatur Mode Keluaran ke XmlWithPdf (berkas hibrida, ZUGFeRD kanonik) atau Hanya XML (murni XML).
Memilih Versi Zugferd: 2.0+ untuk kepatuhan mandat B2B Jerman 2025+, 1.0 hanya untuk receiver lama.
Memilih Tingkat Kesesuaian: EN16931 untuk B2B umum (2.x), XRECH untuk sektor publik Jerman, DASAR untuk ZUGFeRD 1.0 versi lama.
Alihkan Buat Faktur dalam Format PDF ke BENAR jika kamu mau PDF4me untuk menampilkan konten faktur secara visual pada PDF; PALSU jika templat Anda PDF sudah menampilkan tata letaknya.
Mengatur Bahasa ke kode lokal yang sesuai dengan wilayah pembeli Anda (de, en, fr, it, es, nl, pl, pt).
Klik Tindakan pengujian, verifikasi hasilnya, dan nyalakan Zap.

Contoh Alur Kerja

Contoh Alur KerjaCommon Zapier workflow patterns using Create ZUGFeRD Invoice.

Webhook SaaS JSON → ZUGFeRD 2.x EN16931 → email pelanggan

Milikmu SaaS Sistem penagihan mengirimkan webhook ke Zapier ketika pelanggan B2B Jerman ditagih.
PDF4me Buat Faktur ZUGFeRD berjalan: Format Input = JSONData JSON Faktur dipetakan dari payload webhook, Mode Output = XmlWithPdf, Versi Zugferd = 2.0, Kesesuaian = EN16931, Bahasa = de.
Hibrida PDF (dapat dibaca manusia + dapat diuraikan mesin) dilampirkan pada langkah Gmail dan dikirim ke alamat hutang pelanggan, memenuhi mandat e-invoicing B2B 2025+.
Satu baris di Google Sheets mencatat ID faktur, pelanggan, jumlah, dan stempel waktu untuk keperluan pelaporan audit.
A SharePoint mengunggah arsip salinan ZUGFeRD PDF untuk keperluan penyimpanan dan kepatuhan.

Ekspor CSV ERP → XRECHNUNG → Portal sektor publik Jerman

Zap terjadwal berjalan setiap hari kerja pukul 16:00 untuk memproses faktur sektor publik yang tertunda.
Pemicu Dropbox menangkap data terbaru. ERP CSV ekspor dan tata letak PDF.
PDF4me Buat Faktur ZUGFeRD berjalan: Format Input = CSV, Data CSV Faktur = the CSV berkas, Mode Keluaran = XmlWithPdf, Versi Zugferd = 2.0, Kesesuaian = XRECHNUNG, Bahasa = de.
Hybrid XRECHNUNG yang sesuai standar PDF dikirim melalui langkah Webhook ke portal ZRE federal atau titik akhir e-invoicing negara bagian yang relevan.
Email konfirmasi dikirim ke tim AR beserta referensi pengajuan; log PostgreSQL mencatat jejak audit.

XML bawaan → XmlOnly → Integrasi mitra EDI

Milikmu ERP sudah menghasilkan yang sesuai dengan ZUGFeRD. XML faktur melalui modul ekspornya dan memasukkannya ke dalam folder Google Drive.
Zapier pemicu pada setiap yang baru XML berkas. PDF4me Buat Faktur ZUGFeRD berjalan: Format Input = XML, Data XML Faktur = the XML berkas, Mode Keluaran = XmlOnly, Versi Zugferd = 2.0, Kesesuaian = EN16931.
Murni yang telah divalidasi-XML Faktur dikirim melalui SFTP ke titik akhir EDI mitra dagang, tidak PDF Diperlukan wrapper untuk proses handoff antar sistem.
Notifikasi Slack mengkonfirmasi pengiriman EDI; catatan Airtable diperbarui dengan nama mitra dan stempel waktu pengiriman.

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 can read the PDF in any viewer; ERP systems and accounting software extract and process the XML automatically without manual data entry. 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 for cross-border French-German invoicing. Use ZUGFeRD 2.x with EN16931 for general EU B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for international DACH-FR workflows.

Which ZUGFeRD Version should I choose in Zapier for the 2025 German B2B e-invoicing mandate?+

The German Wachstumschancengesetz (Growth Opportunities Act) made e-invoice receipt mandatory for all B2B transactions from 1 January 2025, with full sending obligations phasing in through 2028. ZUGFeRD 2.0 or higher with EN16931 or XRECHNUNG conformance is required to satisfy the mandate. ZUGFeRD 1.0 is legacy and does not comply. The Zapier action exposes 1.0 as a default in some installations: explicitly switch to 2.0+ for compliant production workflows. Confirm the exact version your trading partner or invoicing portal accepts; some larger enterprises and government portals may require version 2.2 or 2.4 specifically.

What is the difference between XmlWithPdf and XmlOnly output modes?+

XmlWithPdf generates the standard ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the structured XML invoice data embedded as an attachment inside the PDF. Humans read the PDF, machines parse the XML: one file serves both audiences and is the canonical ZUGFeRD format for B2B. XmlOnly generates a pure XML file with no PDF wrapper, used when the receiving system only ingests XML, typical for XRechnung pure-XML public-sector portals, EDI pipelines, or data-layer integration testing. Choose XmlWithPdf for production B2B invoicing; XmlOnly for pure-XML system integration or compliance submissions that explicitly require XML-only delivery.

Which Conformance Level should I pick: BASIC, COMFORT, EXTENDED, EN16931, or XRECHNUNG?+

Conformance levels differ by ZUGFeRD version. For ZUGFeRD 1.0: BASIC (minimum legal invoice with line items), COMFORT (additional reference data on top of BASIC), and EXTENDED (industry-specific fields beyond the baseline) are available. For ZUGFeRD 2.x: MINIMUM (header only, not a legal invoice: for internal use only), BASICWL (Basic Without Lines, adds VAT but no line items, for booking-only), BASIC (line items, minimum EU directive), EN16931 (European Standard full profile, recommended default for EU B2B), EXTENDED (industry-specific fields), and XRECHNUNG (German public-sector mandatory profile with stricter validation). Start with BASIC for ZUGFeRD 1.0 workflows and EN16931 for ZUGFeRD 2.x B2B. Switch to XRECHNUNG when invoicing German federal, state, or municipal authorities.

Can I generate ZUGFeRD invoices from CSV data, and how do CSV, JSON, and XML inputs compare?+

Yes. The Input Format parameter supports XML, JSON, and CSV: pick the format matching your data source. CSV is ideal for batch invoice exports from spreadsheets (Google Sheets, Excel), legacy ERP exports, or per-row billing workflows where each row represents one invoice. JSON is the modern choice when invoice data arrives from a webhook, REST API, or SaaS billing system that emits structured JSON payloads. XML is best when your ERP already produces ZUGFeRD or UBL XML that just needs wrapping in the hybrid PDF. The action automatically maps CSV columns or JSON fields to the ZUGFeRD XML schema before embedding in the output PDF, no manual XML construction is required for CSV or JSON paths. Critical: fill ONLY the data field matching your chosen Input Format. Mapping both Invoice Xml Data and Invoice Csv Data in the same run will fail the validation step.