Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Tambahkan Tagihan QR Swiss ke PDF Faktur Apa Pun di Zapier: 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 Zapier dan PDF4me, tambahannya adalah... empat langkah ZapDropbox File Baru di dalam FolderDropbox Temukan File, PDF4me Buat Tagihan QR SwissDropbox Unggah File. Tangkapan layar di bawah ini menunjukkan proses persis yang terekam di kanvas: faktur 10 halaman di /pdf4metest/Swiss-RP menjadi faktur yang sesuai dengan peraturan Swiss dengan slip pembayaran terlampir dan disimpan ke /pdf4meoutputSiap diproduksi dalam waktu kurang dari 10 menit.

Sekilas tentang Zap
1. Dropbox New File in Folder
Watches /pdf4metest/Swiss-RP every 2 minutes. Trigger fires when a new invoice PDF lands.
2. Dropbox Find File
Resolves the file by name (10 page.pdf) and pulls the binary, ready for the next step.
3. PDF4me Create Swiss QR Bill
Appends the QR payment slip with all required SPS fields: CHF, QRR reference, English, Line with Scissor separator.
4. Dropbox Upload File
Writes the populated PDF to /pdf4meoutput. File Name and File Extension carried from the PDF4me output.
Versi singkatnya

Empat langkah Zap. Dropbox File Baru di dalam Folder jam tangan /pdf4metest/Swiss-RP (Ruang penyimpanan default, Sertakan file di dalam subfolder) PALSUSertakan isi file dan tautan berbagi. YaDropbox Temukan File melihat ke atas 10 halaman.pdf di dalam /pdf4metest/File dan mengembalikan data biner. PDF4me Buat Tagihan QR Swiss menambahkan halaman tagihan QR yang sesuai dengan Standar Pembayaran Swiss (Jenis Format) PDFOpsi Penomoran Halaman Pertama, Mata uang CHFJenis Referensi QRR, Bahasa Bahasa inggris, Pemisah Garis dengan Gunting, Jumlah 1923.67IBAN CH4431999123000889012Kreditur: Var Schneider AG, Debitur Utama: Pia-Maria Rutschmann-Schnyder, Referensi 210000000003139471430009017Dropbox Unggah File menulis PDF yang sudah terisi ke /pdf4meoutput menggunakan 3. URL File, dengan 3. Nama File Dan 3. Ekstensi File sebagai nama output. Hasilnya adalah PDF 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 Zapier?" Zap 4 langkah ini melakukannya: file masuk ke Dropbox, Zap dijalankan, PDF yang dilengkapi dengan kode QR untuk faktur masuk ke folder output.
  • "Bisakah Zapier membuat tagihan QR Swiss dari faktur yang sudah ada?" Ya, melalui tindakan PDF4me Create Swiss QR Bill. Hasilnya adalah PDF yang sama dengan slip pembayaran yang ditambahkan pada halaman yang Anda pilih (pertama, terakhir, atau halaman tertentu).
  • "Apakah saya memerlukan langganan perpustakaan kode QR atau generator QR Swiss?" Tidak. Tindakan PDF4me menyembunyikan pembuatan QR, perhitungan referensi mod-10, dan tata letak Standar Pembayaran Swiss lengkap di balik satu langkah Zapier.
  • "Bagaimana jika saya tidak memiliki file PDF sumber, dapatkah saya membuat slip QR terpisah?" Ya. Lewati Langkah 2 (Cari File) dan kolom File / URL File di Langkah 3. Tindakan ini akan mengembalikan PDF tagihan QR Swiss mandiri hanya dari data pembayaran.
  • "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​

Sebuah Zap Zapier 4 langkah yang dapat digunakan kembali. Pemicunya memantau folder Dropbox, Zap tersebut menemukan faktur terbaru, menjalankan tindakan PDF4me Swiss QR Bill dengan detail kreditur + debitur + pembayaran Anda, dan mengunggah PDF yang telah disempurnakan ke folder output. Pola yang sama berlaku untuk faktur pelanggan keluar, eksekusi batch terjadwal, atau pemrosesan AR yang sepenuhnya berbasis peristiwa.

Kanvas Zapier Zap dengan empat langkah: Dropbox File Baru di Folder (interval 2 menit), Dropbox Cari File, PDF4me Buat Tagihan SwissQR, Dropbox Unggah File. Banner status menunjukkan Berhasil 01 Juni 2026 13:00:20 dengan ID Eksekusi.

Empat langkah dari atas ke bawah. Interval 2 menit pada Langkah 1 adalah frekuensi polling default Zapier untuk pemicu Dropbox; paket upgrade dapat melakukan polling lebih sering.

Apa yang Anda butuhkan​

  • Zapier akun. Buat akun Zapier jika Anda membutuhkannya.
  • Kunci API PDF4me. Dapatkan kunci API Anda dan tambahkan saat PDF4me meminta akun di editor Zap. Lihat Hubungkan PDF4me ke Zapier.
  • Dropbox dengan folder sumber (misalnya, /pdf4metest/Swiss-RP) dan folder keluaran (/pdf4meoutput).
  • Faktur PDF (tangkapan layar menggunakan 10 halaman.pdf). Opsional: lewati file sumber untuk slip QR mandiri yang hanya berisi data pembayaran.
  • 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​

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Other currencies rejected by Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate Postal Code + City). K = combined (full address in two Address Lines).
paging Options
first, last, append, or a specific 1-based page number.
Format Type
PDF for printable invoices, PNG/JPEG/TIFF for image output.

Bangun Zap​

Langkah 1: Dropbox - File Baru di Folder (pemicu)​

Pantau folder sumber untuk faktur baru.

BidangNilai yang digunakan dalam proses ini
SpaceDefault
Folder/pdf4metest/Swiss-RP
Include files in subfolders?False
Include file contents?Yes
Include sharing link?Yes
Zapier Dropbox Pemicu File Baru di Folder: Ruang Default, Folder /pdf4metest/Swiss-RP, Sertakan file di subfolder Salah, Sertakan isi file Ya, Sertakan tautan berbagi Ya.

Langkah 2: Dropbox - Temukan File​

Identifikasi file berdasarkan namanya. Ini akan memberikan referensi file yang stabil dan dapat dipetakan untuk Langkah 3.

BidangNilai yang digunakan dalam proses ini
SpaceDefault
Folder/pdf4metest/Files
Include files in subfolders?False
File Name10 page.pdf
Include Deleted Files?False
Include file contents?Yes
Zapier Dropbox Find File: Space Default, Folder /pdf4metest/Files, File Name 10 page.pdf, Include Deleted Files False, Include file contents Yes.

Langkah 3: PDF4me - Buat Tagihan SwissQR​

Tindakan yang menghasilkan pekerjaan. Carilah PDF4me di pemilih aksi, pilih Buat Tagihan QR SwissKemudian, isi kolom-kolom tersebut persis seperti yang ada pada tangkapan layar di bawah ini. referensi tindakan tampilkan. Persyaratan minimum untuk menyamai lari ini:

KelompokBidangNilai
SourceFormat TypePDF
SourceFile2. File: (Exists but not shown)
SourceFile Name2. File Name: 10 page + 2. File Ext: .pdf
Sourcepaging Optionsfirst
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeparator LineLine with Scissor
PaymentAmount1923.67
PaymentIBANCH4431999123000889012
CreditorCreditor Address TypeS
CreditorCreditor NameVar Schneider AG
CreditorCreditor:Street / Address Line 1Var Schneider AG
CreditorCreditor:Building No. / Address Line 223
CreditorCreditor Citybiel
CreditorCreditor Postal Code2501
DebtorUltimate Debtor Address TypeS
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor:Address Line 1Grosse Marktgasse
DebtorUltimate Debtor:Address Line 232
DebtorUltimate Debtor CityRorschach
DebtorUltimate Debtor Postal Code9400
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

Langkah 4: Dropbox - Unggah File​

Simpan PDF yang telah diisi ke folder keluaran.

BidangNilai yang digunakan dalam proses ini
SpaceDefault
Folder/pdf4meoutput
File3. File Url (from PDF4me Step 3)
Overwriteno
Specify File Name3. File Name: 10 page (from PDF4me Step 3)
Specify File Extension3. File Extension: .pdf (from PDF4me Step 3)
Unggah File Dropbox Zapier: Ruang Default, Folder /pdf4meoutput, File 3. URL File, Timpa tidak, Tentukan Nama File 3. Nama File: 10 halaman, Tentukan Ekstensi File 3. Ekstensi File: .pdf.

Peta Mengajukan ke PDF4me URL File keluaran (Langkah 3); terpisah Tentukan Nama File Dan Tentukan Ekstensi File kolom-kolom tersebut mempertahankan nama aslinya.

Simpan dan klik MenerbitkanZap sudah aktif; masukkan faktur baru di /pdf4metest/Swiss-RP dan PDF yang dilengkapi dengan kode QR untuk tagihan tersebut sampai di... /pdf4meoutput dalam siklus pemungutan suara berikutnya.

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. first puts the slip as the new page 1. last appends it after the last page. Pass a 1-based page number to insert at that 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.
Upload writes a zero-byte or missing file
File field on Step 4 is not bound to the PDF4me File Url. Re-pick 3. File Url. Also confirm Specify File Name and Specify File Extension are mapped to the PDF4me Step 3 outputs, not hardcoded.
Want a standalone QR slip without a source invoice
Skip Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF.

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 Swiss QR 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, publish the Zap, and the output is a Swiss-compliant PDF.
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 Step 2 (Find File). In Step 3, leave File and File URL empty and the action returns a standalone Swiss QR-bill PDF (just the payment slip, no invoice body).
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 Create EPC QR Code action instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: Postal Code 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 Postal Code/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them 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 on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set paging Options. first puts the slip as the new page 1 of the output PDF, last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Make, or Power Automate?+
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 Swiss QR Bill action page.

Mulai​

Get your API KeyPDF4me on ZapierAction reference