Lewati ke konten utama

Buat Tagihan SwissQR di Make

Fungsi modul ini

PDF4me Buat Tagihan SwissQR menambahkan Swiss yang sesuai QR slip pembayaran tagihan ke rekening yang sudah ada PDF dokumen. Ini menambahkan bagian standar lengkap yang dipersyaratkan oleh Standar Pembayaran Swiss (ISO 20022) untuk pembuatan faktur di Swiss dan Liechtenstein. Berikan faktur Anda PDF, rincian kreditur dan debitur, IBAN, jumlah, dan referensi, dan modul tersebut mengembalikan dokumen yang sama dengan slip pembayaran terlampir. Setiap bank Swiss menerima output tersebut untuk memulai pembayaran melalui aplikasi perbankan seluler.

Postingan Blog Terkait(2)

Memverifikasi Identitas Anda API Meminta

Setiap PDF4me modul di Make memerlukan validitas KoneksiBuat atau pilih salah satu yang sesuai dengan kebutuhan Anda. PDF4me API kunci agar skenario tersebut dapat mengautentikasi Swiss QR Pembuatan tagihan secara aman.

Fakta Penting yang Tidak Boleh Anda Lewatkan

Menambahkan slip pembayaran ke slip pembayaran Anda yang sudah ada. PDF dan tidak membuat gambar yang berdiri sendiri
Tidak seperti Create Barcode, yang mengembalikan Base64 Gambar, modul ini memodifikasi dokumen sumber Anda dengan menambahkan teks lengkap Swiss. QR bagian RUU dengan QR kode dan kolom pembayaran yang mudah dibaca manusia langsung ke PDFTemplat faktur Anda dimasukkan, dan faktur Swiss siap kirim beserta slip pembayaran akan keluar.
Tipe Alamat S dan K memerlukan kolom yang berbeda.
Baik Kreditur maupun Debitur Utama memiliki kolom Jenis Alamat: S (Terstruktur) atau K (Gabungan). Dengan S, isi secara terpisah. PostalCode Dan City bidang. Dengan K, gunakan dua AddressLine Kolom-kolom ini memungkinkan Anda menulis alamat lengkap sebagai teks bebas. Jenis yang Anda pilih menentukan kolom alamat mana yang divalidasi, jadi isi hanya kolom yang sesuai dengan jenis yang Anda pilih.
IBAN harus berkewarganegaraan Swiss atau Liechtenstein dan mata uangnya adalah CHF atau EUR hanya
Petunjuk modul menyatakan bahwa IBAN Harus diawali dengan CH atau LI, dengan maksimal 21 karakter. Mata uang dibatasi secara ketat hingga... CHF atau EUR. Untuk Eropa SEPA pembayaran dengan non-Swiss IBANs, gunakan Hasilkan EPC QR Kode untuk SEPA alih-alih.

Parameter

Modul ini menampilkan 26 bidang yang dikelompokkan menjadi empat blok logis: koneksi + file sumber, hal-hal penting pembayaran, blok kreditur, blok debitur, Dan referensi pembayaranTangkapan layar di bawah ini mencerminkan urutan kolom yang persis sama seperti pada Make UI.

Wajib (tanda bintang merah di dalam UI): Koneksi, Tipe Format, Opsi Penomoran Halaman, Mata Uang, Tipe Referensi, Bahasa, Garis Pemisah, Jumlah, IBAN, Jenis Alamat Kreditur, Nama Kreditur, Debitur Utama AddressType. Bersyarat: Nama File + Dokumen saat File diatur ke Map; Nomor Halaman hanya ketika Opsi Paging diatur ke Kustom (nomor halaman). Opsional: semua kolom alamat kreditur/debitur yang tersisa ditambah Referensi, Pesan Tidak Terstruktur, Info Penagihan, dan AV1/AV2 Parameter.

Make Create SwissQR Bill module: Block 1: Connection, Format Type, File source, Paging Options, Currency
Block 1: Connection, Format Type, File source, Paging Options, Currency
Make Create SwissQR Bill module: Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Make Create SwissQR Bill module: Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Make Create SwissQR Bill module: Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Make Create SwissQR Bill module: Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
ParameterDiperlukanApa fungsinya?Contoh
ConnectionYesPDF4me connection. Click Add and paste your API key the first time, then reuse the connection across every PDF4me module.test prod account
Format TypeYesOutput container format. PDF for printable invoices and email attachments; PNG, JPEG, or TIFF for image output (no Paging Options applies in image modes). Empty falls back to the connector default. See the dropdown reference card below.PDF
FileConditionalHow the source PDF arrives. Radio: Dropbox - Download a File (or any other storage module), PDF4me Dev - Create Swiss QR Bill (chain from a prior PDF4me action), or Map (bind File Name and Document from a prior module manually). Skip the source file entirely for a standalone payment slip.Map
File NameConditionalFilename of the source PDF including .pdf extension. Required when File is set to Map. Mapped from the prior module File Name output.1. File Name
DocumentConditionalBinary content of the source PDF. Required when File is set to Map. Mapped from the prior module Data / binary output.1. Data
Paging OptionsYesWhere the Swiss QR-bill page is inserted (PDF Format Type only). Options: Empty (default), First (new page 1), Last (appended), Add page at the end (alias for Last), Custom (page number) (insert at the page number you supply in the Page Number field). See the dropdown reference card below.Custom (page number)
Page NumberConditionalThe 1-based page number where the Swiss QR-bill is inserted. Required when Paging Options is Custom (page number); ignored for every other Paging Options value. Page indexing starts at 1.3
CurrencyYesPayment currency. Only CHF and EUR are permitted by the Swiss Payment Standards.CHF
Reference TypeYesFormat of the payment reference. QRR (Swiss QR Reference, 27-digit numeric, used with QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference).QRR
LanguageYesLanguage for the printed QR-bill text (Payment part labels: Account / Payable to, Reference, Currency, Amount). German, French, Italian, English.English
Separator LineYesSeparator line style displayed in the QR-bill section. Line With Scissor (line + scissor pictogram, standard print), Only Line (line, no pictogram), or No Line (eBill / e-invoice). Note: the Make UI labels the field "Seperator Line" (the engine accepts either spelling.Line With Scissor
AmountYesPayment amount in two decimal places without leading zeroes. Use the locale decimal separator your Culture & Language Settings expect.35345436
IBANYesIBAN or QR-IBAN of the creditor. Maximum 21 characters with CH or LI country codes only. QR-IBAN required when Reference Type is QRR.CH4431999123000889012
Creditor Address TypeYesAddress format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).S
Creditor NameYesCreditor name or company according to the bank account. Maximum 70 characters.Var Schneider AG
Creditor AddressLine1NoCreditor primary address line. Maximum 70 characters.Var Schneider AG
Creditor AddressLine2NoCreditor secondary address line. 16 characters when address type is S; 70 characters when type is K.23
Creditor PostalCodeNoCreditor postal code. Maximum 16 characters.2501
Creditor CityNoCreditor town or city. Maximum 35 characters.biel
Ultimate Debtor AddressTypeYesAddress format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.S
Ultimate Debtor NameNoDebtor name or company according to the bank account. Maximum 70 characters.Pia-Maria Rutschmann-Schnyder
Ultimate Debtor AddressLine1NoDebtor primary address line. Maximum 70 characters.Grosse Marktgasse
Ultimate Debtor AddressLine2NoDebtor secondary address line. 16 characters (S) or 70 characters (K).32
Ultimate Debtor PostalCodeNoDebtor postal code. Maximum 16 characters.9400
Ultimate Debtor CityNoDebtor town or city. Maximum 35 characters.Rorschach
ReferenceNoPayment reference number. Maximum 27 characters. Format depends on Reference Type (QRR: 27-digit numeric with mod-10 check; SCOR: ISO 11649; NON: leave empty).210000000003139471430009017
Unstructured MessageNoFree-text payment description shown in the Additional information block. Maximum 140 characters.Instruction of 15.09.2019
Billing InfoNoStructured billing information (Swico, etc) shown alongside the Unstructured Message. Maximum 140 characters.S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
AV1 ParametersNoAlternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: "Name AV1: UV;…".Name AV1: UV;UltraPay005;12345
AV2 ParametersNoAlternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.Name AV2: XY;Service002;67890

Opsi Jenis Format

Yang Make UI Menampilkan 5 nilai. Pilih PDF untuk faktur yang dapat dicetak dan lampiran email; format gambar berguna saat Anda menyematkan QR menyelipkan diri ke dalam templat PDF nanti atau tampilkan langsung di dalam isi email.

PDF
Standard. Hybrid PDF/A-compatible page appended to the source invoice. Use with the Paging Options field below to choose where the slip lands.
PNG
Raster image of the QR-bill slip alone. Useful for inline email images or web previews.
JPEG
Compressed raster output. Slightly smaller than PNG; the QR code stays scannable.
TIFF
Lossless raster archive format. Best when the recipient needs print-grade quality.
Empty
No value set; the connector falls back to its default (PDF).

Referensi Opsi Paging

Hanya berlaku jika Tipe Format adalah PDF. Jenis Format Gambar (PNG, JPEG, TIFF) Abaikan Opsi Penomoran Halaman karena tidak ada dokumen multi-halaman untuk disisipkan.

First
Insert the QR-bill as the new page 1 of the output. The original first page becomes page 2.
Last
Insert the QR-bill at the end, after the original last page.
Add page at the end
Functional alias for Last. Picks whichever phrasing matches your downstream documentation.
Custom (page number)
Insert the QR-bill at a specific 1-based page index. Requires the Page Number field to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).
Empty
No value set; the connector falls back to its default (First).

Pengaturan Cepat

  1. Menambahkan PDF4me ke Buat Tagihan SwissQR di dalam dirimu Make skenario.
  2. Pilih Koneksi (atau klik) Menambahkan untuk membuat satu dengan milikmu API kunci).
  3. Mengatur Jenis Format ke PDF (atau PNG / JPEG / TIFF (untuk keluaran gambar). Atur Opsi Paging ke First, Last, Add page at the end, atau Custom (page number)Jika Anda memilih Kustom (nomor halaman), juga isi Nomor Halaman dengan indeks berbasis 1 di mana slip tersebut seharusnya berada (misalnya, 3).
  4. Mengatur Mengajukan ke modul penyimpanan seperti Dropbox - Unduh Fileatau pilih Map dan mengikat Nama File Dan Dokumen dari langkah sebelumnya. Lewati grup File sepenuhnya untuk versi mandiri. QR terpeleset.
  5. Isilah kolom pembayaran yang diperlukan dengan nilai dari tangkapan layar di atas: Mata uang (CHF atau EUR), Jenis Referensi (QRR), Bahasa (English), Garis Pemisah (Line With Scissor), Jumlah, IBAN (maksimal 21 karakter, CH atau LI), Jenis Alamat Kreditur (S atau K), Nama Kreditur, Dan Debitur Utama AddressType.
  6. Tambahkan kolom alamat kreditur dan debitur, lalu (opsional) isi Referensi, Pesan Tidak Terstruktur, Informasi Penagihan, Dan AV1 / AV2 Parameter untuk data pembayaran yang lebih lengkap.
  7. Simpan dan jalankan. Output modul Doc Data berisi sumber PDF dengan orang Swiss QR-halaman tagihan disisipkan pada posisi yang dipilih pada langkah 3 (atau terpisah) QR (kesalahan terjadi ketika tidak ada file sumber yang diberikan).

Contoh Alur Kerja

Contoh Alur KerjaCommon Make scenario patterns using Create SwissQR Bill.
Otomatiskan pembuatan faktur Swiss dari Google Sheet.
  1. Penambahan baris baru ke register faktur Google Sheets memicu skenario ini.
  2. Google Drive mengunduh faktur kosong. PDF templat.
  3. Buat SwissQR Bill memetakan semua kolom pembayaran, termasuk Jumlah, IBAN, Referensi, dan detail Kreditur dan Debitur, langsung dari kolom lembar kerja.
  4. Gmail mengirimkan faktur yang sudah selesai dengan tanda tangan Swiss. QR Tagihan terlampir pada alamat email pelanggan yang tertera di lembar tersebut.
Penagihan langganan bulanan untuk pelanggan Swiss
  1. Pemicu terjadwal berjalan pada tanggal 1 setiap bulan.
  2. Airtable menampilkan semua catatan langganan aktif.
  3. Iterator memproses setiap pelanggan secara individual. Buat Tagihan SwissQR menghasilkan faktur yang dipersonalisasi dengan jumlah langganan, detail pelanggan yang dipetakan sebagai Debitur Utama, dan Referensi unik untuk setiap catatan.
  4. Gmail mengirimkan faktur kepada setiap pelanggan. Airtable diperbarui dengan stempel waktu pengiriman.
Piutang usaha: lampirkan QR RUU tentang ERP persetujuan
  1. Webhook akan aktif ketika faktur disetujui di ERP sistem.
  2. HTTP mengunduh faktur yang telah disetujui PDF.
  3. Buat Tagihan SwissQR yang melampirkan slip pembayaran menggunakan ERP-disediakan IBAN, jumlah, dan nomor referensi.
  4. Faktur yang telah selesai diunggah ke SharePoint folder piutang dan tim akuntansi diberitahu melalui Microsoft Teams.

Pertanyaan yang Sering Diajukan

What does this module actually add to my PDF?+
It appends the complete Swiss QR bill payment slip section to your existing PDF. This is a standardized block containing the QR code with all encoded payment data, plus the human-readable payment fields (amount, IBAN, reference, creditor details). The output is a ready-to-send invoice accepted by Swiss banks for payment via mobile banking app.
What is the difference between Address Type S and K?+
S (Structured) means you fill separate PostalCode and City fields alongside AddressLine1 for the street. K (Combined) means you write the complete address across two free-text AddressLine fields with no separate city or postal code. Choose whichever matches how your data is structured, since both are valid under Swiss Payment Standards.
What Reference Type should I use?+
QRR (QR Reference) is the most common and uses a 27-character numeric string with a check digit for automated bank reconciliation in Switzerland. SCOR follows the international ISO 11649 creditor reference format. NON means no reference is included. Check with your bank which format your account supports for incoming payment matching.
Why is the IBAN restricted to CH or LI?+
Swiss QR bills are a payment standard specific to Switzerland and Liechtenstein. The module hint confirms: "Max 21 characters with CH or LI only." For SEPA payments across the EU and EEA using other country IBANs, use the Generate EPC QR Code for SEPA module instead.
What does the module return?+
Name (the output filename) and Doc Data (the binary PDF buffer of your source document with the Swiss QR bill section appended). Route Doc Data into Gmail as an attachment, upload it to Dropbox or Google Drive, or POST it to your ERP system.

Modul Terkait

Dapatkan Bantuan