Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Sisipkan Uang Kertas QR Swiss pada Nomor Halaman Kustom di Power Automate (Alur Dropbox 4 Tindakan dengan PDF4me)

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

Sebagian besar tutorial tagihan QR Swiss menempatkan slip pembayaran di halaman 1 (atau tambahkan di bagian akhir). Faktur asli seringkali membutuhkannya. di suatu tempat di tengah: sebuah paket kontrak 10 halaman di mana tagihan QR berada tepat setelah ringkasan, atau laporan triwulanan di mana slip tersebut harus mengikuti halaman sampul. Konektor PDF4me Power Automate menangani hal itu dalam satu tindakan melalui Opsi Penomoran Halaman = kustom ditambah sebuah Nomor Halaman lapangan. Panduan ini akan menjelaskan langkah-langkah persis yang terekam dalam kanvas: /pdf4metest/sample/10 page.pdf menjadi berkas yang sesuai dengan standar Swiss dengan tagihan QR yang disisipkan sebagai halaman 3, lalu diunggah ke /pdf4meoutput dengan nama yang diawali dengan GUID agar eksekusi ulang tidak bentrok. 4 aksi, tanpa kode, berjalan dalam hitungan detik.

Alur secara sekilas
1. Manually trigger a flow
Manual trigger for testing. Swap for any storage trigger in production.
2. Dropbox Get file content
Reads /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Output Format Type PNG (try PDF for hybrid). Paging Options custom, Page Number 3. All payment fields filled.
4. Dropbox Create file
Writes to /pdf4meoutput. File Name built from guid() plus headers/FileName so every run lands as a unique file.
Versi singkatnya

Empat tindakan Power Automate. Pemicu manual memulai alur kerja. Dropbox Dapatkan isi file membaca /pdf4metest/sample/10 page.pdf dengan Menentukan Jenis Konten diatur ke Ya. PDF4me Kode Batang - Buat Tagihan SwissQR menambahkan halaman tagihan QR yang sesuai dengan Standar Pembayaran Swiss dengan Jenis Format Keluaran PNG (dalam putaran ini; pilih) PDF untuk kontainer hibrida, ditambah JPEG Dan Bertengkar tersedia), IBAN CH4431999123000889012, Jumlah 5253531, Mata uang CHF, Jenis Referensi QRR, Bahasa Bahasa inggris, Garis Pemisah GarisDenganGuntingKreditur Var Schneider AG (Alamat S, biel 2501), Debitur Utama Pia-Maria Rutschmann-Schnyder (Alamat S, biel 9400), Referensi 210000000003139471430009017, ditambah parameter skema alternatif AV1 dan AV2 lengkap. Di bawah Parameter Lanjutan: Opsi Paging kebiasaan Dan Nomor Halaman 3Dropbox Buat berkas menulis kepada /pdf4meoutput dengan Nama File dibangun dari guid() + header/NamaFile untuk keunikan. Output: sebuah file yang dapat dipindai oleh bank Swiss di dalam folder arsip.

Tiga hal yang menentukan apakah hasil Anda dapat dipindai oleh bank DAN sampai ke halaman yang tepat

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, Referensinya adalah Angka 27 digit dengan digit pemeriksa mod-10Jika Anda tidak memilikinya, beralihlah ke SKOR atau NON. Ketiga, Opsi Penomoran Halaman + Nomor Halaman hanya berlaku jika Tipe Format Output adalah PDF.Jenis format gambar (PNG, JPEG, Tiff) diabaikan karena outputnya adalah gambar slip terpisah, bukan dokumen multi-halaman.

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

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

  • "Bagaimana cara menyisipkan uang kertas QR Swiss pada halaman tertentu di PDF saya di Power Automate?" Gunakan Tipe Format Output PDFOpsi Penomoran Halaman custom, dan Nomor Halaman dengan indeks halaman berbasis 1 (3 dalam panduan ini).
  • "Bisakah saya mencetak kode QR Swiss sebagai gambar PNG, bukan sebagai halaman PDF?" Ya. Atur Tipe Format Output ke PNG, JPEG, atau Tiff dan tindakan tersebut mengembalikan gambar slip saja, mengabaikan Opsi Penomoran Halaman.
  • "Bagaimana cara memastikan nama file output saya tidak bentrok saat dijalankan ulang?" Gunakan guid() Ekspresi Power Automate di kolom Nama File pada unggahan Dropbox, opsional digabungkan dengan headers/FileName dari output PDF4me.
  • "Apa yang harus dimasukkan di bawah Parameter Lanjutan pada tindakan Power Automate?" Empat kolom: Nomor Halaman, Opsi Penomoran Halaman, Isi File (PDF sumber), Nama File. Klik Tampilkan semua pada parameter Lanjutan untuk menampilkannya.
  • "Akankah bank-bank Swiss memindai uang kertas QR berformat PNG?" Ya. Kode QR identik di seluruh output PDF dan gambar. PNG adalah pilihan yang tepat untuk email langsung atau slip yang disematkan di web; PDF untuk faktur lengkap + pengiriman slip.

Apa yang sedang Anda bangun​

Alur Power Automate 4 langkah yang dapat digunakan kembali untuk menghasilkan faktur yang dapat dipindai oleh bank Swiss dengan kode QR pada tagihan. halaman mana pun yang Anda pilihAlur yang sama berlaku untuk kasus gambar tunggal (lewati PDF sumber, ubah Tipe Format Output ke PNG / JPEG / TIFF) untuk pengingat pembayaran yang disematkan dalam email.

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 /pdf4metest/sampel sebagai folder sumber dan /pdf4meoutput sebagai tujuan. Semua penyimpanan dapat digunakan: SharePoint, OneDrive, Dataverse dipetakan dengan cara yang sama.
  • Faktur PDF. Unduh contoh 10 halaman Ikuti langkah-langkahnya dengan tepat dari tangkapan layar.
  • Data pembayaran Swiss: CH atau LI IBAN (maks 21 karakter), Jumlah, Mata Uang (CHF atau EUR), blok nama/alamat Kreditur + Debitur Utama lengkap. Referensi bidang lengkap di dokumen tindakan.

Referensi cepat: 4 bidang yang menentukan output​

Output Format Type
PDF (hybrid), PNG, JPEG, or Tiff. Picks the container of the populated output.
Paging Options
first, last, add at end, or custom. PDF Output Format Type only.
Page Number
1-based page index. Required when Paging Options is custom; ignored otherwise. Set to 3 in this run.
File Content + File Name
The source PDF, mapped from a previous action. Skip both for a standalone QR-slip from payment data alone.

Bangun alurnya​

Tindakan 1: Memicu alur secara manual​

Pemicu manual untuk pengujian. Dalam produksi, penggantian untuk... 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​

Tindakan yang menghasilkan pekerjaan. Carilah PDF4me di pemilih aksi dan pilih Kode Batang - Buat Tagihan SwissQRTindakan ini memiliki kolom pembayaran di panel utama dan 4 kolom di bawahnya. Parameter lanjutan (Opsi Penomoran Halaman, Nomor Halaman, Isi 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 file yang sudah diisi dengan nama unik yang diawali dengan GUID agar tidak terjadi bentrokan saat dijalankan ulang.

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 yang dibuat dari guid() dan ekspresi headers/FileName, dan File Content berupa konten dinamis dari action PDF4me Create SwissQR Bill.

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

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

Get your API KeyFull action reference

Keempat pilihan Tipe Format Output, berdampingan.​

PDF
Hybrid output: QR-bill page inserted into your source invoice. Most common for outgoing AR. Uses Paging Options + Page Number.
PNG
Standalone raster image of the QR-bill slip. Best for inline email embeds and web previews. Ignores Paging Options.
JPEG
Compressed raster image. Smaller file size than PNG. Still bank-scannable.
Tiff
Lossless raster archive format. Use when the recipient needs print-grade quality.

Penyelesaian Masalah​

QR-bill landed on the wrong page
Check Paging Options. custom uses Page Number. first puts the slip as the new page 1. last appends at the end. Only applies when Output Format Type is PDF.
Page Number is greyed out / ignored
Paging Options is something other than custom. Switch Paging Options to custom and the Page Number field becomes active.
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.
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?​

Slip on a specific mid-document page
Quarterly statement where the QR-bill belongs right after the cover page. Contract pack with the slip after the summary.
Inline email PNG payment reminders
Output Format Type PNG, skip the source PDF, embed the slip image directly in an Outlook Send email body.
High-volume AR archival
guid()-prefixed Dropbox upload makes every run uniquely addressable for downstream search and audit.
Subscription billing
QR-IBAN plus QRR Reference identifies the customer or contract every recurring run.

Apa yang harus dibaca selanjutnya?​

Pertanyaan yang Sering Diajukan (FAQ)​

How do I insert the Swiss QR-bill on a specific page in Power Automate?+
Click Show all on Advanced parameters in the PDF4me Barcode - Create SwissQR Bill action. Set Paging Options to custom, then set Page Number to the 1-based page index where the QR-bill should land (3 in this guide). Output Format Type must be PDF for Paging Options to take effect.
What is the difference between Paging Options values first, last, add at end, and custom?+
first inserts the QR-bill as the new page 1 (everything else shifts down by one). last appends at the very end of the source PDF. add at end is a functional alias for last. custom uses the Page Number field to insert at a specific 1-based position.
Why does the QR-bill not move when I change Paging Options?+
Output Format Type is set to PNG, JPEG, or Tiff. Image formats ignore Paging Options because the output is a standalone slip image, not a multi-page document. Switch Output Format Type to PDF.
Can I generate a Swiss QR-bill image (PNG) without a source invoice?+
Yes. Set Output Format Type to PNG (or JPEG / Tiff). Skip the File Content and File Name fields under Advanced parameters. The action returns a standalone QR-bill image you can embed inline in an Outlook email or display on a web page.
Why use guid() in the Dropbox Create file File Name?+
It guarantees every run lands as a unique file in /pdf4meoutput so re-runs do not silently overwrite previous outputs. Concatenating headers/FileName from the PDF4me output keeps the original invoice name inside the new filename for traceability.
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 and the recommended choice for new integrations. PostalCode and City go in separate fields; Address Line 1 / 2 carries the street. K (Combined) puts the full address into two free-text Address Line fields and leaves PostalCode and City empty.
Same flow 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 action reference page.

Mulai​

Get your API KeyPDF4me ConnectAction reference