Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Tambahkan Tagihan QR Swiss ke PDF Faktur Apa Pun di Power Automate: Alur Kerja Dropbox 4 Langkah

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

Setiap faktur Swiss harus mencantumkan Uang Kertas QR Swiss Sehingga bank dan perangkat lunak akuntansi dapat memindai dan memproses pembayaran secara otomatis. Dengan Power Automate dan PDF4me, tambahannya adalah... alur empat aksi: Pemicu manual, Dropbox Dapatkan isi file, PDF4me Kode Batang - Buat Tagihan SwissQRDropbox Buat berkas. Tangkapan layar di bawah ini menunjukkan proses persis yang terekam di kanvas. Sebuah faktur 10 halaman di /pdf4metest/sample menjadi faktur yang sesuai dengan peraturan Swiss dengan slip pembayaran terlampir dan diunggah ke /pdf4meoutput dengan nama file yang unik. Siap digunakan 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 or any storage trigger in production.
2. Dropbox Get file content
Reads the 10-page invoice from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Appends the QR payment slip with CHF, QRR reference, English labels, custom Paging Options to land on page 3.
4. Dropbox Create file
Writes the populated PDF to /pdf4meoutput with a unique guid()+headers/FileName so re-runs do not collide.
Versi singkatnya

Empat tindakan Power Automate. Pemicu manual memulai alur kerja. Dropbox Dapatkan isi file membaca /pdf4metest/sample/10 page.pdf dengan Infer Content Type diatur ke Ya. PDF4me Kode Batang - Buat Tagihan SwissQR menambahkan halaman tagihan QR yang sesuai dengan Standar Pembayaran Swiss (Tipe Format Keluaran) PNG dalam putaran ini; beralih ke PDF untuk output hibrida, IBAN CH4431999123000889012, Jumlah 5253531, Mata uang CHFJenis Referensi QRR, Bahasa Bahasa inggris, Garis Pemisah GarisDenganGuntingKreditur: Var Schneider AG, Debitur Utama: Pia-Maria Rutschmann-Schnyder, Referensi 210000000003139471430009017Opsi Penomoran Halaman kebiasaanNomor Halaman 3, Nama Berkas abc.pdfDropbox Buat berkas menulis kepada /pdf4meoutput dengan Nama File yang dibuat dari guid() + header/NamaBerkas untuk keunikan. Hasilnya adalah file yang dapat dipindai oleh bank Swiss di dalam folder arsip.

Dua hal yang menentukan apakah hasil keluaran Anda dapat dipindai oleh bank.

Pertama, IBAN harus diawali dengan CH atau LI dan maksimal 21 karakter. Untuk Tipe Referensi QRR, IBAN harus berupa... QR-IBAN, bukan IBAN standar. Kedua, ketika Tipe Referensi adalah QRR, itu Kolom referensi adalah string numerik 27 digit dengan digit pemeriksa mod-10.Jika Anda tidak memilikinya, ubah Tipe Referensi menjadi SKOR (ISO 11649) atau NON dan biarkan kolom Referensi kosong. Bank menolak nilai referensi yang salah ketik, bukan gambar QR-nya.

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

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

  • "Bagaimana cara menambahkan tagihan QR Swiss ke faktur PDF saya secara otomatis di Power Automate?" Alur 4 langkah ini melakukannya: seret PDF ke Dropbox, picu alur, file faktur yang dilengkapi QR akan masuk ke folder output.
  • "Bisakah Power Automate menghasilkan tagihan QR Swiss dari faktur yang sudah ada?" Ya, melalui tindakan PDF4me Barcode - Create SwissQR Bill. Hasilnya adalah PDF yang sama dengan slip yang ditambahkan di halaman pertama/terakhir/halaman tertentu.
  • "Apakah saya memerlukan langganan perpustakaan kode QR atau generator QR Swiss?" Tidak. Aksi PDF4me menyembunyikan pembuatan QR, perhitungan referensi mod-10, dan tata letak Standar Pembayaran Swiss lengkap di balik satu langkah Power Automate.
  • "Bagaimana jika saya tidak memiliki file PDF sumber, dapatkah saya membuat slip QR terpisah?" Ya. Lewati kolom Konten File dan Nama File di bawah Parameter Lanjutan; tindakan ini akan menghasilkan faktur QR terpisah dalam Tipe Format Output yang dipilih (PDF / PNG / JPEG / Tiff).
  • "Akankah bank-bank Swiss menerima hasil ini?" Tindakan ini menghasilkan slip yang sesuai dengan Standar Pembayaran Swiss ISO 20022. Setiap aplikasi perbankan seluler bank Swiss dapat memindainya untuk memulai pembayaran.

Apa yang sedang Anda bangun​

Alur Power Automate 4 aksi yang dapat digunakan kembali. Pemicu aktif, faktur sumber diambil dari Dropbox (atau SharePoint / OneDrive / Outlook), aksi PDF4me menambahkan faktur QR, dan file yang telah diisi diunggah dengan nama yang diawali dengan GUID. Pola yang sama berlaku untuk faktur pelanggan keluar, eksekusi batch terjadwal, atau pemrosesan piutang berbasis peristiwa.

Kanvas alur Power Automate dengan empat tindakan: Memicu alur secara manual, Dropbox Mendapatkan konten file, Barcode - Membuat Tagihan SwissQR, Dropbox Membuat file.

Empat aksi, dari atas ke bawah. Pemicu manual memudahkan pengujian alur kerja; dapat diganti dengan pemicu penyimpanan apa pun yang digunakan dalam produksi.

Apa yang Anda butuhkan​

  • Power Automate akun dengan arus kas terbuka. Open Power Automate.
  • Kunci API PDF4me. Dapatkan kunci API AndaMasuk ke konektor PDF4me Connect saat pertama kali Anda melakukan drop action.
  • Dropbox dengan folder sumber (misalnya, /pdf4metest/sampel) dan folder keluaran (/pdf4meoutputSemua platform penyimpanan dapat digunakan: SharePoint, OneDrive, atau Dataverse dipetakan dengan cara yang sama.
  • Faktur PDF. Unduh contoh 10 halaman Digunakan dalam tangkapan layar agar mudah diikuti.
  • Data pembayaran Swiss: A CH atau LI IBAN, jumlah, mata uang (CHF atau EUR), dan blok nama/alamat kreditur + debitur. Referensi bidang lengkap di dokumen tindakan.

Referensi cepat: parameter kunci​

Output Format Type
PDF (hybrid), PNG / JPEG / Tiff (standalone images).
IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON.
Address Type
S = structured (separate Postal Code + City). K = combined.
Paging Options
first, last, add at end, or custom (uses Page Number). PDF only.
Page Number
1-based page index. Required only when Paging Options is custom.

Bangun alurnya​

Tindakan 1: Memicu alur secara manual​

Pemicu manual adalah cara tercepat untuk pengujian. Dalam produksi, ganti dengan... Dropbox Saat sebuah file dibuat, SharePoint Saat sebuah file dibuat, OneDrive Saat file dibuat, Outlook Saat email baru tiba, Kambuh, atau Webhooks tergantung pada alur kerja AR Anda.

Aksi 2: Dropbox - Dapatkan isi file​

Ambil faktur sumber dari folder input Anda.

BidangNilai yang digunakan dalam proses ini
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Power Automate Dropbox Dapatkan konten file dengan tindakan File /pdf4metest/sample/10 page.pdf dan parameter Lanjutan Infer Content Type Yes.

Aksi 3: Kode Batang PDF4me - Buat Tagihan SwissQR​

Cari PDF4me dan pilih Kode Batang - Buat Tagihan SwissQRTindakan ini menampilkan kolom pembayaran di panel utama dan 4 kolom di bawah Parameter Lanjutan (Opsi Penomoran Halaman, Nomor Halaman, Konten File, Nama File). Konfigurasi:

KelompokBidangNilai
OutputOutput Format TypePNG
PaymentIBANCH4431999123000889012
PaymentAmount5253531
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeperator LineLineWithScissor
CreditorCreditor NameVar Schneider AG
CreditorCreditor Address TypeS
CreditorCreditor: Address Line 1Var Schneider AG
CreditorCreditor: Address Line 223
CreditorCreditor PostalCode2501
CreditorCreditor Citybiel
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor AddressTypeS
DebtorUltimate Debtor: Address Line 1Grosse Marktgasse
DebtorUltimate Debtor: Address Line 233
DebtorUltimate Debtor PostalCode9400
DebtorUltimate Debtor Citybiel
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAv2 ParametersName AV2: XY;XYService;54321
AdvancedPaging Optionscustom
AdvancedPage Number3
AdvancedFile ContentFile Content (from Action 2)
AdvancedFile Nameabc.pdf

Aksi 4: Dropbox - Buat file​

Simpan berkas yang telah diisi ke folder keluaran. Buat Nama Berkas yang unik dengan guid() agar tayangan ulang tidak bentrok.

BidangNilai yang digunakan dalam proses ini
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3, dynamic content)
Power Automate Dropbox Create file action dengan Folder Path /pdf4meoutput, File Name built from guid() + headers/FileName expression, dan File Content dynamic content dari tindakan PDF4me Create SwissQR Bill.

Yang guid() Ekspresi dalam Nama File menjamin nama unik di setiap eksekusi. Menempatkannya di sebelah header/NamaBerkas Output dari PDF4me mempertahankan nama faktur asli dalam nama file.

Simpan dan klik TesBerkas yang dapat dipindai oleh bank Swiss tersebut sampai di... /pdf4meoutput.

Get your API KeyFull action reference

Penyelesaian Masalah​

QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust Paging Options under Advanced. first puts the slip as the new page 1. last appends it after the last page. custom uses Page Number for a specific 1-based position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With S, fill Postal Code + City and use Address Line 1/2 for street. With K, leave Postal Code + City empty and put the full address into Address Line 1 + Address Line 2.
Create file writes an empty file
File Content on Action 4 is not bound to the PDF4me File Content output. Click the field and re-pick the dynamic content from Action 3.
Want a standalone QR slip without a source invoice
Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters and the action returns a standalone Swiss QR-bill in the chosen Output Format Type.

Kapan menggunakan pola ini?​

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip, append it.
e-Bill fallbacks
For customers who prefer paper or in-app QR-scan over electronic Bill.

Apa yang harus dibaca selanjutnya?​

Pertanyaan yang Sering Diajukan (FAQ)​

Do I need a special Swiss QR library or font?+
No. The PDF4me Create SwissQR Bill action bundles QR-code generation, the QR-bill fonts (Liberation Sans), mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, save the flow, and the output is a Swiss-compliant file.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip, useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters; the action returns a standalone Swiss QR-bill in the chosen Output Format Type (PDF, PNG, JPEG, or Tiff).
My IBAN starts with DE / FR / IT, can I still use this?+
No, Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Generate EPC QR Code for SEPA action instead.
Address Type S vs K, which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; Address Line 1/2 carries the street. K (Combined) puts the full address in two free-text Address Line fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data.
Does the output work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (every major bank since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code.
How do I change where the QR-bill page lands?+
Click Show all on Advanced parameters. Set Paging Options to first / last / add at end / custom. For custom, also fill Page Number with the 1-based page index. Only applies when Output Format Type is PDF.
Same scenario in Make, Zapier, or n8n?+
Yes. The same PDF4me Create Swiss QR Bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create SwissQR Bill action page.

Mulai​

Get your API KeyPDF4me ConnectAction reference