Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Membuat Faktur ZUGFeRD di Power Automate dari PDF Dropbox + XML: Alur Kerja 5 Langkah

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

Jerman Undang-Undang Peluang Pertumbuhan Mengubah faktur elektronik hibrida ala ZUGFeRD dari sesuatu yang "baik untuk dimiliki" menjadi persyaratan B2B. Dari 1 Januari 2025 Setiap bisnis di Jerman harus dapat menerima faktur elektronik terstruktur, dengan kewajiban pengiriman penuh yang diterapkan secara bertahap. Tahun 2028Jalur tercepat untuk tim Microsoft 365 mana pun adalah alur Power Automate lima langkah: Picu secara manual → Dropbox Dapatkan konten file (PDF) → Dropbox Dapatkan konten file (XML) → PDF4me Buat Faktur ZUGFeRD → Dropbox Buat file. Muatan XML disematkan di dalam sebuah PDF/A-3 Kerangka arsip, menghasilkan satu file yang dibuka oleh manusia dan diuraikan oleh sistem akuntansi. Panduan ini menggunakan tangkapan layar persis yang diambil di kanvas: /pdf4metest/sample/10 page.pdf untuk media visual dan /pdf4metest/zugfred invoice/version2.xml untuk data terstruktur, dengan output hibrida yang masuk ke /pdf4meoutput dengan nama unik yang diawali dengan GUID. Siap produksi dalam waktu kurang dari 10 menit.

Alur secara sekilas
1. Manually trigger a flow
Manual trigger for testing. Swap for SharePoint When a file is created, Dropbox When a file is created, or any storage trigger in production.
2. Dropbox Get file content (PDF)
Reads the visual carrier from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes. This is the PDF the recipient sees.
3. Dropbox Get file content (XML)
Reads the structured ZUGFeRD XML from /pdf4metest/zugfred invoice/version2.xml with Infer Content Type Yes. This is what accounting systems parse.
4. PDF4me Create ZUGFeRD Invoice
Combines both inputs as 2.0-XML format, XmlWithPdf output mode, BASIC conformance, Render Invoice on PDF Yes, Language de. Embeds the XML inside a PDF/A-3.
5. Dropbox Create file
Writes the hybrid file to /pdf4meoutput with guid()+headers/FileName so reruns never collide.
Versi singkatnya

Dua langkah Dropbox Get-file, satu aksi PDF4me, satu langkah Dropbox Create-file. PDF adalah media yang dapat dibaca manusia; XML adalah data yang dapat dibaca mesin. PDF4me menggabungkan keduanya ke dalam satu file hibrida PDF/A-3 yang memenuhi mandat e-invoicing B2B Jerman 2025. Tanpa kode, tanpa alat desktop, tanpa Java SDK.

Tanya Jawab Berbasis Alasan​

Mengapa harus menggunakan ZUGFeRD? Karena peraturan faktur elektronik di seluruh Uni Eropa dan Jerman Undang-Undang Peluang Pertumbuhan ZUGFeRD mewajibkan penggunaan faktur terstruktur untuk B2B. ZUGFeRD adalah format hibrida yang menyelesaikan kedua sisi: manusia mendapatkan PDF biasa, sedangkan sistem AP dan ERP mendapatkan XML terstruktur yang tertanam di dalam file yang sama. Satu artefak, dua pembaca.

Mengapa ada dua langkah untuk mendapatkan konten file? Salah satu output mengambil PDF visual yang menjadi kerangka pembawa (halaman yang dibuka penerima); output lainnya mengambil XML ZUGFeRD terstruktur yang menjadi lampiran yang disematkan di dalam pembawa. Kedua output tersebut kemudian digunakan untuk membuat Faktur ZUGFeRD: PDF sebagai Isi File PDF, XML sebagai Data XML Faktur.

Mengapa "2.0-XML" ada di menu dropdown gabungan? ZUGFeRD 2.0+ diperlukan untuk mandat Jerman 2025 (versi lama 1.0 tidak memenuhinya). Akhiran "-XML" memberi tahu konektor bahwa muatan faktur Anda sudah dalam format XML ZUGFeRD. Pilih 2.0-JSON atau 2.0-CSV Untuk sumber data terstruktur; konektor mengonversinya ke skema sebelum penyematan.

Mengapa XmlWithPdf dan bukan Hanya XML? XmlWithPdf Mengembalikan hibrida ZUGFeRD kanonik: file PDF/A-3 dengan XML terlampir di dalamnya. Hanya XML Hanya mengembalikan XML. Sebagian besar skenario penagihan keluar mengirimkan file hibrida karena pelanggan mengharapkan untuk membuka PDF; XmlOnly digunakan untuk umpan ERP-ke-ERP langsung.

Apa yang Akan Anda Dapatkan​

Masukan: Sebuah PDF faktur 10 halaman (media visual) dan sebuah file XML ZUGFeRD (data terstruktur). Keluaran: Sebuah file PDF/A-3 tunggal dengan XML yang tertanam di dalamnya, sesuai dengan standar EN 16931, kesesuaian BASIC, siap untuk dikirim melalui email ke pelanggan, diarsipkan ke SharePoint, atau diposting ke ERP Anda. Langkah pembuatan file Dropbox akan menuliskannya kembali ke /pdf4meoutput di bawah yang unik guid() + headers/FileName beri nama agar proses berjalan secara bersamaan tidak pernah bentrok.

Apa yang Anda Butuhkan​

  • Power Automate. Open Power AutomateBuat alur cloud baru (Instan atau Otomatis).
  • Kunci API PDF4me. Dapatkan kunci API AndaHubungkan saat Anda menambahkan Faktur ZUGFeRD. Baru pertama kali? Lihat Hubungkan PDF4me ke Power Automate.
  • Dropbox (atau SharePoint, OneDrive). Menyimpan file PDF sumber, XML ZUGFeRD, dan folder output. Panduan ini menggunakan Dropbox sepenuhnya.
  • Berkas XML ZUGFeRDSesuai dengan standar EN 16931. Repositori ini mencakup starter di ZUGFeRD-invoice-sample-2.0.xml; ganti nama menjadi versi2.xml Jika Anda ingin menyalin tangkapan layar persis seperti aslinya.

Gambaran Alur Secara Singkat​

  1. Memicu alur secara manual (atau Saat sebuah file dibuat (di Dropbox untuk otomatisasi).
  2. Dropbox Dapatkan isi file untuk operator PDF (/pdf4metest/sample/10 page.pdf).
  3. Dropbox Dapatkan isi file untuk XML ZUGFeRD (/pdf4metest/zugfred invoice/version2.xml).
  4. PDF4me Buat Faktur ZUGFeRD dengan 2.0-XML, XmlWithPdf, BASIC, render pada, bahasa de.
  5. Dropbox Buat file ke /pdf4meoutput dengan guid() + headers/FileName untuk nama keluaran yang bebas benturan.

Gambaran alur lengkap​

Kanvas Power Automate yang menampilkan alur ZUGFeRD lima tindakan: Memicu alur secara manual, Mendapatkan konten file (PDF), Mendapatkan konten file 1 (XML), Membuat Faktur ZUGFeRD, Membuat file - semuanya terhubung secara vertikal dengan ikon Dropbox dan PDF4me.

Lima langkah tersusun dari atas ke bawah. Setiap tindakan Dropbox menampilkan ikon konten file berwarna biru; PDF4me Create ZUGFeRD Invoice berada di tengah. Kedua output Get-file memberi input ke tindakan PDF4me yang sama; File Content PDF4me memberi input ke Create file.

Langkah 1: Memicu Alur​

  1. Di dalam Power Automate, klik + Buat, memilih Aliran awan instan.
  2. Sebutkan namanya Create ZUGFeRD Invoice from Dropbox, memilih Memicu alur secara manual, klik Membuat.
  3. Setelah bagian-bagian yang bergerak terhubung, Anda dapat mengganti pemicunya. Saat sebuah file dibuat di Dropbox (/pdf4metest/zugfred invoice/) sehingga setiap XML baru memicu eksekusi secara otomatis. Tindakan hilir yang sama, tanpa pembangunan ulang.

Langkah 2: Dapatkan PDF Operator dari Dropbox​

Alur sejauh ini: Pemicu → Dapatkan konten file (PDF).

  1. Klik + Langkah baruCari Dropbox, memilih Dapatkan isi file menggunakan jalur.Masuk ke akun Dropbox Anda jika diminta.
  2. Mengajukan. /pdf4metest/sample/10 page.pdfIni adalah faktur visual yang dibuka pelanggan Anda.
  3. Parameter lanjutan → Menentukan Jenis Konten. Ya (Power Automate menggunakan ekstensi file dan byte untuk menandai tipe konten sehingga PDF4me tahu bahwa itu adalah data PDF).
  4. Simpan. Hasil keluaran Isi File menjadi PDF sumber untuk penyematan ZUGFeRD pada langkah 4.

Dapatkan isi file (PDF): Konfigurasi​

Dapatkan tindakan konten file dengan File diatur ke /pdf4metest/sample/10 page.pdf dan Infer Content Type diatur ke Ya di bawah Parameter lanjutan, Terhubung ke Dropbox

File PDF operator di /pdf4metest/sample/10 page.pdf. Infer Content Type Yes mengembalikan byte PDF bersih yang dapat dibungkus PDF4me ke dalam PDF/A-3.

Langkah 3: Dapatkan XML ZUGFeRD dari Dropbox​

Alur sejauh ini: Dapatkan isi file (PDF) → Dapatkan isi file (XML).

  1. Klik + Langkah baruTambahkan lagi Dropbox → Dapatkan konten file menggunakan jalur. Ganti namanya menjadi Dapatkan isi file 1 (Power Automate melakukan ini secara otomatis) sehingga kedua tindakan Dropbox tersebut dapat dibedakan.
  2. Mengajukan. /pdf4metest/zugfred invoice/version2.xmlIni adalah payload XML ZUGFeRD yang diselaraskan dengan EN 16931.
  3. Parameter lanjutan → Menentukan Jenis Konten. Ya.
  4. Simpan. Hasil keluaran Isi File menjadi data faktur terstruktur yang akan disematkan PDF4me di dalam format hibrida PDF/A-3.

Dapatkan isi file (XML): Konfigurasi​

Dapatkan konten file 1 tindakan dengan File diatur ke /pdf4metest/zugfred invoice/version2.xml dan Infer Content Type diatur ke Ya di bawah Parameter lanjutan, Terhubung ke Dropbox

Muatan XML ZUGFeRD di /pdf4metest/faktur zugfred/versi2.xmlFile ini berada di ZUGFeRD 2.0 EN 16931 conformance; pick 2.0-XML dalam aksi selanjutnya untuk mencocokkan.

Untuk memberikan tip. Perlu memvalidasi XML sebelum menyematkan? Tinggalkan Menyusun tindakan antara Langkah 3 dan Langkah 4 dan periksa Isi File dalam riwayat eksekusi. ZUGFeRD XML selalu dimulai dengan <?xml version="1.0" dan berisi sebuah Faktur Lintas Industri Akses root untuk payload 2.x.

Langkah 4: Buat Faktur ZUGFeRD​

Alur sejauh ini: Pemicu → PDF → XML → Buat Faktur ZUGFeRD.

  1. Klik + Langkah baru, mencari PDF4me, memilih Buat Faktur ZUGFeRDMasuk menggunakan kunci API PDF4me Anda jika Anda belum pernah terhubung sebelumnya.
  2. Versi ZUGFeRD dan Format Input. 2.0-XMLDropdown gabungan memilih versi spesifikasi (2.0) dan bentuk data (XML) sekaligus. Awalan "2.0" adalah yang memenuhi mandat B2B Jerman 2025.
  3. Mode Keluaran. XmlWithPdfMengembalikan file hibrida PDF/A-3 kanonik dengan XML yang terlampir di dalamnya.
  4. Data XML Faktur. Isi File dari Dapatkan isi file 1 (Langkah XML). Petakan hanya yang ini. Jangan isi kolom JSON atau CSV.
  5. Tingkat Kesesuaian. BASICProfil tingkat dasar dengan rincian item dan pajak, kompatibilitas penerima terluas. Beralih ke COMFORT atau EXTENDED hanya setelah penerima mengkonfirmasi dukungan.
  6. Buat Faktur dalam Format PDF. YesPDF4me menggambar ulang konten faktur pada PDF kurir menggunakan data Anda sehingga halaman yang terlihat dan XML yang disematkan tetap sinkron.
  7. Isi File. Isi File dari Dapatkan isi file (Langkah PDF). Ini adalah cangkang pembawa.
  8. Nama File. abc.pdf (atau nama file sumber asli Anda). Digunakan untuk konteks pelacakan.
  9. Parameter lanjutan → Bahasa. de (Label Jerman). Kode lain yang diterima: en, fr, it, es, nl, pl, pt, cs.
  10. Menyimpan.

Buat Faktur ZUGFeRD: Konfigurasi​

Kolom inti yang wajib diisi
  • Versi ZUGFeRD dan Format Input: 2.0-XML
  • Mode Keluaran: XmlWithPdf
  • Data XML Faktur: Langkah Konten File dari XML
  • Tingkat Kesesuaian: DASAR
  • Buat Faktur dalam Format PDF: Ya
  • Isi File: Langkah pengambilan konten file dari PDF
  • Nama File: abc.pdf
Parameter lanjutan
  • Bahasa: dari (Bahasa Jerman, standar)
  • Diterima: dari, di, fr, it, es, nl, pl, pt, cs
  • XML tersebut tetap netral terhadap bahasa; hanya label yang digambar pada PDF yang menggunakan lokal tersebut.

Tiga kombinasi yang akan benar-benar Anda gunakan. 2.0-XML ketika sistem hulu Anda sudah memancarkan XML ZUGFeRD. 2.0-JSON ketika platform penagihan Anda menggunakan format JSON dan Anda ingin PDF4me mengonversinya ke skema ZUGFeRD. 2.0-CSV untuk ekspor massal dari spreadsheet dan alat akuntansi. Ketiganya menghasilkan output hibrida yang identik; perbedaannya hanya pada bentuk data yang Anda berikan.

Langkah 5: Simpan PDF Hibrida Kembali ke Dropbox​

Alur sejauh ini: PDF → XML → Buat Faktur ZUGFeRD → Buat file.

  1. Klik + Langkah baru. Mencari Dropbox, memilih Buat berkas.
  2. Jalur Folder. /pdf4meoutput.
  3. Nama File. guid() + headers/FileName (dari Buat Faktur ZUGFeRD). Ada dua cara untuk mengisinya:
    • Ekspresi: concat(guid(), '_', outputs('Create_ZUGFeRD_Invoice')?['headers']?['FileName'])Atau lebih sederhananya:
    • Konten dinamis: jenis guid() pertama (tab Ekspresi), lalu tambahkan headers/FileName dari output aksi PDF4me.
  4. Isi File. Isi File dari Buat Faktur ZUGFeRD.
  5. Pertahankan alurnya.

Buat file (Dropbox): Konfigurasi​

Buat aksi Dropbox file dengan Jalur Folder /pdf4meoutput, Nama File diatur ke ekspresi guid() diikuti oleh konten dinamis header/FileName dari aksi PDF4me, dan Konten File dipetakan dari output PDF4me, Terhubung ke Dropbox

Output yang ditulis ke /pdf4meoutput dengan nama yang diawali dengan GUID. GUID membuat proses paralel berjalan tanpa benturan; header/NamaBerkas bagian tersebut mempertahankan akhiran yang mudah dibaca manusia.

Jalankan Alur dan Verifikasi​

  1. Klik Tes Di pojok kanan atas, pilih Secara manual, klik Tes, Kemudian Alur eksekusi.
  2. Setelah beberapa detik, setiap tindakan akan menampilkan tanda centang hijau.
  3. Buka Dropbox /pdf4meoutputFile baru tersebut cocok. <guid>_<filename>.pdf.
  4. Unduh file tersebut. Buka di aplikasi penampil PDF apa pun untuk melihat faktur. Buka di alat AP yang mendukung ZUGFeRD (atau ekstrak dengan alat yang mendukung ZIP) untuk melihat dokumen yang tertanam di dalamnya. factur-x.xml / zugferd.xml lampiran.

Apa yang sebenarnya Anda hasilkan? A PDF/A-3 PDF arsip dengan sebuah tertanam ZUGFeRD 2.0 EN 16931 File XML. Jumlah halaman PDF dan konten visual sesuai dengan faktur asli 10 halaman (karena Buat Faktur dalam Format PDF (Ya). XML di dalamnya memenuhi persyaratan data terstruktur dari mandat B2B Jerman. Satu file, dua pembaca.

ZUGFeRD vs Factur-X vs XRechnung dalam 30 Detik​

FormatDi mana itu digunakanJenis keluaran
ZUGFeRDGermany B2B, EU buyersHybrid PDF/A-3 + embedded XML (this blog)
Factur-XFrance, sister format technically identical to ZUGFeRD 2.xHybrid PDF/A-3 + embedded XML
XRechnungGerman public sector (federal, state, municipal)Strict pure-XML profile

Alur yang baru saja Anda buat menghasilkan ZUGFeRD; beralihlah ke alur kerja Factur-X tanpa perubahan apa pun (file hibrida yang sama berfungsi di kedua sisi Sungai Rhine). Untuk penagihan sektor publik Jerman, ganti Tingkat Kesesuaian dengan profil yang selaras dengan XRechnung ketika penerima meminta XML murni.

Variasi Umum yang Dapat Anda Tambahkan Tanpa Membangun Ulang​

Sumber JSON atau CSV, bukan XML.
Tukar langkah 3 untuk mengambil .json atau .csv berkas. Ubah dropdown gabungan menjadi 2.0-JSON atau 2.0-CSVPetakan yang cocok Data JSON Faktur atau Data CSV Faktur PDF4me mengonversi ke skema ZUGFeRD sebelum penyematan.
SharePoint sebagai pengganti Dropbox
Ganti konektor Dropbox dengan SharePoint Mendapatkan konten file menggunakan jalur Dan SharePoint Buat filePemetaan field yang sama; hanya otoritas konektor yang berubah. Berfungsi sama dengan OneDrive for Business atau Azure Blob Storage.
Outlook: Kirim alih-alih (atau setelah) Buat file
Menambahkan Outlook Mengirim email (V2) dengan alamat pelanggan. Peta Isi File sebagai isi lampiran dan concat('Faktur-', utcNow(), '.pdf') sebagai nama lampiran. Pelanggan mendapatkan faktur hibrida secara langsung.
Validasi PDF/A sebelum diarsipkan
Rantai PDF4me Memvalidasi PDF/A Setelah langkah 4. Jika validasi berhasil, tulis ke arsip jangka panjang; jika gagal, buat cabang ke peringatan Teams. Pengamanan ekstra untuk alur kerja yang sensitif terhadap kepatuhan.

Memecahkan Masalah Kesalahan Nyata​

Memilih 1.0-XML, output yang gagal memenuhi mandat.

ZUGFeRD 1.0 tidak memenuhi mandat B2B Jerman 2025. Jika output Anda harus sesuai dengan mandat, selalu pilih 2.0-* kombinasi dalam menu tarik-turun gabungan.

Baik data XML faktur maupun data JSON faktur telah terisi.

Hanya petakan yang sesuai dengan pilihan dropdown Anda. Power Automate tidak akan mencegah Anda mengisi keduanya, tetapi tindakan tersebut akan menampilkan kesalahan validasi saat dijalankan. Biarkan kolom format lainnya kosong.

Tampilkan Faktur pada PDF nonaktif + tanpa visual yang sudah ditampilkan sebelumnya

Dengan Buat Faktur dalam Format PDF Jika dimatikan, PDF4me menyematkan XML tetapi tidak menggambar ulang konten faktur. PDF dari kurir yang Anda kirimkan Isi File Tetap seperti semula. Matikan hanya jika PDF dari penyedia layanan Anda sudah menampilkan konten faktur secara visual.

PERLUASAN ditolak oleh penerima

EXTENDED menambahkan bidang khusus industri di luar EN 16931 dan ditolak oleh penerima yang disetel untuk standar dasar. Mulailah dengan DASAR untuk uji kompatibilitas; tingkatkan hanya jika pembeli atau ERP mengkonfirmasi dukungan.

Langkah Selanjutnya​

Buat dokumen tindakan Faktur ZUGFeRD

Hubungkan PDF4me ke Power Automate

Dapatkan kunci API Anda

Pola lima langkah yang sama berlaku untuk otomatisasi dokumen apa pun di Power Automate: picu, ambil input, jalankan tindakan PDF4me, tulis hasilnya. Setelah Anda meluncurkan satu, peluncuran berikutnya hampir tidak memerlukan biaya.