Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Tambahkan Tagihan QR Swiss ke PDF Faktur Apa Pun di Make: Alur Kerja Dropbox 3 Modul

· 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 Make dan PDF4me, tambahannya adalah... skenario tiga modulDropbox Unduh File, PDF4me Buat uang kertas QR SwissDropbox Unggah File. Tangkapan layar di bawah ini menunjukkan langkah persis yang ditampilkan di kanvas: faktur 10 halaman di /pdf4metest/Files/10 page.pdf menjadi faktur yang sesuai dengan peraturan Swiss dengan slip pembayaran terlampir dan disimpan ke /pdf4meoutput/Siap diproduksi dalam waktu kurang dari 10 menit.

Gambaran umum situasi
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
Versi singkatnya

Tiga modul Make. Dropbox Unduh File mengambil faktur sumber (tangkapan layar menunjukkan) YnooxTestone koneksi, Pilih sebuah berkas, jalur /pdf4metest/Files/10 page.pdf). PDF4me Buat uang kertas QR Swiss menambahkan halaman tagihan QR yang sesuai dengan Standar Pembayaran Swiss (Jenis Format) PDFOpsi Penomoran Halaman Pertama, Mata uang CHF, IBAN yang dimulai dengan CH(blok kreditur + debitur lengkap). Dropbox Unggah File menulis hasilnya ke /pdf4meoutput/ dengan File diatur ke Peta, Nama Berkas = 6. Nama, Data = 6. DokumenFile PDF yang dihasilkan siap untuk dikirim melalui email dan dipindai menggunakan aplikasi seluler bank Swiss mana pun.

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, atur Tipe Referensi ke 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?" Unggah faktur ke Dropbox; skenario 3 modul ini akan menangani sisanya, termasuk IBAN, jumlah, referensi, dan detail kreditur/debitur.
  • "Bisakah Make membuat faktur QR Swiss dari faktur yang sudah ada?" Ya. Melalui modul PDF4me Create Swiss QR-bill. Hasilnya adalah PDF yang sama dengan slip pembayaran yang dilampirkan pada halaman yang Anda pilih (pertama / terakhir / spesifik).
  • "Apakah saya memerlukan templat Excel atau pustaka kode QR?" Tidak. Modul ini menyembunyikan semua pembuatan kode QR, perhitungan referensi mod-10, dan tata letak Standar Pembayaran Swiss di balik satu langkah yang dapat dikonfigurasi.
  • "Bagaimana jika saya tidak memiliki PDF faktur yang sudah ada? Bisakah saya tetap membuat slip QR terpisah?" Ya. Lewati grup File sepenuhnya dan modul akan mengembalikan PDF tagihan QR Swiss yang berdiri sendiri.
  • "Akankah bank-bank Swiss benar-benar menerima hasil ini?" Modul 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​

Skenario Make 3 modul yang dapat digunakan kembali. Pemicu aktif (manual, terjadwal, pemantauan file, apa pun), faktur sumber diambil, tagihan QR Swiss ditambahkan, dan hasilnya disimpan. Pola yang sama berlaku untuk pengujian sekali jalan, menjalankan batch terjadwal, atau pemrosesan faktur yang sepenuhnya berbasis peristiwa.

Buat kanvas skenario: Dropbox Unduh File (dengan lencana jam terjadwal) terhubung ke PDF4me Buat tagihan QR Swiss, yang terhubung ke Dropbox Unggah File. Tiga ikon modul melingkar besar terhubung dengan konektor garis putus-putus standar.

Tiga modul ujung-ke-ujung. Lencana jam pada Dropbox 1 menunjukkan pemicu terjadwal. Ganti ke manual atau webhook agar sesuai dengan kasus penggunaan Anda.

Apa yang Anda butuhkan​

  • Membuat akun dengan skenario yang sedang dibuka. Buat akun Make jika Anda membutuhkannya.
  • Kunci API PDF4me. Dapatkan kunci API Anda dan tambahkan saat PDF4me meminta Koneksi. Lihat Hubungkan PDF4me untuk Membuat.
  • Dropbox dengan folder sumber (misalnya, /pdf4metest/File/) dan folder keluaran (/pdf4meoutput/Semua layanan penyimpanan bekerja dengan cara yang sama. Ganti dengan Google Drive, OneDrive, atau SharePoint sesuai kebutuhan.
  • Faktur PDF (tangkapan layar menggunakan 10 halaman.pdf). Opsional: lewati file sumber dan hasilkan slip QR mandiri hanya dari 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.

Bangun skenarionya​

Modul 1: Dropbox - Mengunduh File​

Ambil faktur sumber dari folder input Anda.

BidangNilai yang digunakan dalam proses ini
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Buat konfigurasi Dropbox untuk mengunduh file. Koneksi diatur ke YnooxTestone. Cara memilih file diatur ke Pilih file. Jalur file /pdf4metest/Files/10 page.pdf. Tombol Batal dan Simpan di bagian bawah.

Konfigurasi Unduh File Dropbox. Pilih file melalui pemilih jalur atau, untuk pemrosesan batch, gunakan Cari file dan mengikat File secara dinamis.

Modul 2: PDF4me - Membuat Tagihan QR Swiss​

Cari PDF4me dan pilih Buat uang kertas QR SwissModul ini mengekspos 26 field. Referensi lengkap per field (dengan 5 tangkapan layar UI terperinci dan contoh nilai seperti Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder) terdapat di Buat Tagihan SwissQR di Make Halaman aksi. Minimal yang perlu diatur:

KelompokBidangNilai
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Isi kolom alamat kreditur dan debitur sesuai pilihan Jenis Alamat Anda, lalu isi parameter opsional Referensi / Pesan Tidak Terstruktur / Info Penagihan / AV1 / AV2.

Modul 3: Dropbox - Mengunggah File​

Tulis file PDF yang telah diisi ke folder keluaran.

BidangNilai yang digunakan dalam proses ini
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Buat konfigurasi Unggahan File Dropbox. Koneksi YnooxTestone. Folder /pdf4meoutput/. File diatur ke Map. Nama File terikat ke 6. Nama (dari PDF4me Buat Tagihan QR Swiss). Data terikat ke 6. Dokumen. Petunjuk mengatakan: Nama file, termasuk ekstensi, misalnya invoice.xml.

Radio File disetel ke Peta Menampilkan Nama File dan Data sebagai slot terpisah. Ikat keduanya ke output Modul 2 PDF4me sehingga PDF yang terisi akan terkirim secara utuh.

Simpan dan klik Jalankan sekaliFaktur yang telah diisi akan muncul di /pdf4meoutput/ dalam beberapa detik.

Get your API KeyFull action reference

Apa yang masuk ke folder output?​

Sebuah file PDF tunggal yang diberi nama sesuai dengan sumbernya (misalnya, 10 page.pdf) dengan halaman tagihan QR Swiss yang disisipkan pada posisi yang dipilih di Opsi Paging (First menempatkannya sebagai halaman 1 yang baru; Last (menambahkannya di bagian akhir). Buka file di penampil PDF apa pun dan bagian tagihan QR akan menampilkan kode QR pembayaran, blok Akun/Dibayarkan yang dapat dibaca manusia, Jumlah, Mata Uang, Referensi, dan alamat kreditur/debitur. Arahkan aplikasi perbankan Swiss ke kode QR dan pembayaran akan terisi otomatis.

Referensi cepat: parameter kunci​

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the 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 PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Penyelesaian Masalah​

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the 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. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is 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 via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

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 module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, 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 the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
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 module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/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, Zapier, 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 SwissQR Bill action page.

Mulai​

Get your API KeyPDF4me on MakeAction reference