Lewati ke konten utama

Bagaimana Cara Membuat Faktur ZUGFeRD di Power Automate? Alur Kerja Langkah demi Langkah Menggunakan Dropbox + JSON.

· Satu menit membaca
SEO and Content Writer

Panduan ini menunjukkan secara lengkap Power Automate alur kerja yang membaca sebuah PDF dasar Dan faktur JSON dari Dropbox, menghasilkan ZUGFeRD/Factur-X faktur menggunakan PDF4me Buat Faktur ZUGFeRD, dan menulis kembali file akhir ke Dropbox.

Urutan tangkapan layar menggunakan jalur sampel berikut:

  • PDF Dasar: /data blog/faktur zugferd/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Folder keluaran: /blog data/zugferd invoice/output
Versi singkatnya

1. Memicu alur secara manual → 2. Dapatkan File PDF Dasar (Dropbox) → 3. Dapatkan File JSON (Dropbox) → 4. Buat Faktur ZUGFeRD (PDF4me, Format Input = JSON, Mode Output = Pdf Dengan Xml) → 5. Buat file (folder output Dropbox).

Ingat hal ini saat Anda mengkonfigurasi langkah 4

Mengatur Format Input = JSON, lalu petakan saja Data JSON Faktur. Menyimpan Data XML Faktur Dan Data CSV Faktur kosong pada putaran ini. Untuk PDF dengan XML, Isi File PDF Diperlukan dan harus berasal dari langkah PDF dasar.

Apa yang sedang Anda bangun

Anda memproduksi sebuah faktur hibrida PDF dari templat PDF dan data JSON terstruktur. Output ini cocok untuk tim yang membutuhkan output PDF yang mudah dibaca dengan data faktur yang dapat dibaca mesin yang dikemas melalui konvensi ZUGFeRD/Factur-X.


Sekilas: kelima langkah tersebut

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

Mengapa tata letak alur kerja ini berhasil?

Input terpisah

PDF dan JSON diambil secara terpisah, sehingga Anda dapat memperbarui file payload tanpa menyentuh alur templat PDF visual.

Langkah generasi tunggal

Buat Faktur ZUGFeRD Menerima kedua sumber konten di satu tempat dan mengembalikan output file yang dapat langsung digunakan oleh Dropbox. Buat berkas.

Mudah untuk membuat percabangan di kemudian hari.

Setelah pembuatan, Anda dapat menambahkan validasi, notifikasi, pengiriman ERP/API, atau perutean pengarsipan tanpa perlu mengubah alur inti.


Sebelum Anda mulai

Daftar Periksa

File input yang digunakan dalam panduan ini

Pratinjau dokumen PDF dasar digunakan sebagai input PDF untuk tindakan Buat Faktur ZUGFeRD.

Berkas input PDF dasar.

Konten payload JSON faktur yang menunjukkan kolom faktur yang dipetakan ke generasi ZUGFeRD.

Input payload JSON faktur.


Alur secara sekilas (lima langkah)

  1. Memicu alur secara manual: Jalankan sesuai permintaan saat konfigurasi berlangsung.
  2. Dapatkan File PDF Dasar (Dropbox): Membaca byte PDF templat.
  3. Dapatkan File JSON (Dropbox): Membaca byte/konten JSON faktur.
  4. Buat Faktur ZUGFeRD (PDF4me): Menggabungkan input menggunakan mode JSON.
  5. Buat berkas (Dropbox): Menyimpan output yang dihasilkan di folder target.

Gambaran umum alur kerja

Alur Power Automate: Memicu alur secara manual, Mendapatkan File PDF Dasar, Mendapatkan File JSON, Membuat Faktur ZUGFeRD, Membuat file

Alur rantai lengkap yang digunakan untuk pola pembangkitan ZUGFeRD ini.


Langkah 1: Dapatkan File PDF Dasar (Dropbox)

Alur sejauh ini: Pemicu → Dapatkan File PDF Dasar.

  1. Menambahkan Dropbox Tindakan untuk mengambil konten file berdasarkan jalur.
  2. Mengatur Jalur File ke templat dasar PDF (contoh: /data blog/faktur zugferd/simplepdf.pdf).
  3. Di opsi lanjutan, simpan Inferensi Tipe Konten = Ya.
  4. Simpan dan uji langkah ini; pastikan langkah ini mengembalikan konten file/output biner.
Dropbox Get Base PDF File action showing file path blog data zugferd invoice simplepdf.pdf and Infer Content Type Yes

Tangkapan layar Langkah 1: jalur PDF dasar dan inferensi konten telah dikonfigurasi.


Langkah 2: Dapatkan File JSON (Dropbox)

Alur sejauh ini: Pemicu → Dapatkan PDF Dasar → Dapatkan File JSON.

  1. Tambahkan tindakan konten file Dropbox lainnya.
  2. Mengatur Jalur File ke data JSON faktur Anda (contoh: /blog data/zugferd invoice/sample-invoice.json).
  3. Menyimpan Inferensi Tipe Konten = Ya.
  4. Simpan dan uji; konfirmasikan bahwa konten JSON tersedia untuk pemetaan pada langkah 3.
Aksi Dropbox Dapatkan File JSON yang menampilkan jalur file data blog zugferd invoice sample-invoice.json dan Infer Content Type Yes

Tangkapan layar Langkah 2: File sumber JSON dari Dropbox.


Langkah 3: Buat Faktur ZUGFeRD (PDF4me)

Alur sejauh ini: Pemicu → Dapatkan PDF Dasar → Dapatkan JSON → Buat ZUGFeRD.

Konfigurasi PDF4me, Buat Faktur ZUGFeRD seperti yang ditunjukkan:

  1. Nama File: nama PDF sumber (contoh: Tes.pdf).
  2. Isi File PDF: peta dari Dapatkan File PDF Dasar.
  3. Nama File Output: nama file output yang diinginkan (contoh: Faktur Zugferd.pdf).
  4. Format Masukan: diatur ke JSON.
  5. Mode Keluaran: diatur ke PDF dengan XML.
  6. Data JSON Faktur: peta dari Dapatkan File JSON.
  7. Tingkat Kesesuaian: contoh: DASAR.
  8. Versi ZUGFeRD: contoh: 1.0 (atau versi yang Anda butuhkan).
  9. Buat Faktur dalam Format PDF: contoh: Ya.
Buat aksi Faktur ZUGFeRD yang menampilkan Nama File, Konten File PDF, Nama File Output, Format Input JSON, Mode Output PDF dengan XML, Data JSON Faktur, Kesesuaian BASIC, Versi ZUGFeRD 1.0, Render Faktur pada PDF Ya

Tangkapan layar Langkah 3: pemetaan parameter lengkap untuk pembuatan ZUGFeRD berbasis JSON.


Langkah 4: Buat file (Dropbox)

Alur sejauh ini: Pemicu → Baca PDF + JSON → Hasilkan ZUGFeRD → Simpan file.

  1. Menambahkan Dropbox: Buat file.
  2. Jalur Folder: folder target keluaran (contoh: /blog data/zugferd invoice/output).
  3. Nama File: petakan nama file keluaran dari Buat Faktur ZUGFeRD.
  4. Isi File: peta yang dihasilkan dari konten file Buat Faktur ZUGFeRD.
  5. Simpan dan jalankan alur lengkapnya.
Dropbox Buat tindakan file dengan jalur folder data blog output faktur zugferd dan nama file yang dipetakan serta konten file dari Buat Faktur ZUGFeRD

Tangkapan layar Langkah 4: penulisan kembali file output ke Dropbox.


Verifikasi keluaran

Buka contoh output
Tampilan visual PDF faktur ZUGFeRD yang dihasilkan setelah tindakan Buat Faktur ZUGFeRD.

Output PDF faktur yang dihasilkan.

Output dibuka dengan panel lampiran yang menampilkan data XML tersemat dalam PDF faktur ZUGFeRD yang dihasilkan.

Tampilan lampiran yang menunjukkan data faktur terstruktur yang disematkan.


Referensi cepat

#MelangkahPemetaan tombol
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

Referensi parameter mendalam: Buat Faktur ZUGFeRD, Validasi PDF.


Penyelesaian Masalah

Pembuatan gagal karena pemetaan input.

Jika Format Input = JSON, hanya peta Data JSON FakturKosongkan kolom XML/CSV untuk proses ini.

Ketidaksesuaian mode keluaran

Dengan PDF dengan XML, hilang Isi File PDF menyebabkan kesalahan. Petakan byte file dari langkah PDF dasar.

Kode kesalahan 401, 402, atau masalah koneksi.

Melihat Panduan Pemecahan Masalah PDF4me untuk pemeriksaan kunci API, kredit, dan otorisasi konektor.


Apa yang harus dicoba selanjutnya?

Pengerasan opsional: tambahkan Kondisi Setelah langkah 3 untuk memeriksa keberadaan output, kemudian beralih ke pemberitahuan berhasil/gagal sebelum penulisan file akhir.