Baca Kode QR Swiss di Zapier

Baca Kode QR Swiss adalah sebuah Zapier tindakan oleh PDF4me yang menerjemahkan kode Swiss QR-tagihan tertanam di dalam PDF dan pengembalian kreditur, debitur, IBAN, jumlah, dan data referensi sebagai JSONGunakan fitur ini untuk mengubah nama faktur secara otomatis, mencocokkan pembayaran dengan catatan akuntansi, atau mengarahkan dokumen berdasarkan jumlah atau referensi tanpa perlu memasukkan data secara manual.

Postingan Blog Terkait(1)

Tagihan QR Swiss Menumpuk di Dropbox? Ganti Namanya Secara Otomatis di Zapier dengan Kode dari Zapier

Otomatis mengganti nama PDF faktur QR Swiss di Zapier: File Baru di Folder → PDF4me Membaca Kode SwissQR → Kode oleh Zapier (mengurai JSON, mengekstrak debitur/kreditur) → Unggah File. Tidak ada langkah Pencarian File. Langkah demi langkah dengan tangkapan layar Dropbox. Berfungsi dengan SharePoint, Google Drive.

Baca postingan →

Apa yang dilakukan oleh tindakan ini?

PDF4me Baca Kode QR Swiss mengambil satu PDF berisi sebuah Swiss QR-tagihan (QR-Faktur) dan mengembalikan data pembayaran terstrukturnya, di dalam Zap. Petakan Mengajukan, dan aksinya kembali Teks Dokumen, A JSON tali dengan IBAN, kreditur, kreditur utama, debitur, jumlah, mata uang, dan kolom referensi. Uraikan dengan Kode berdasarkan Zapier langkah untuk mendorong penggantian nama faktur, pencocokan pembayaran, atau otomatisasi akuntansi.

Memverifikasi Identitas Anda API Meminta

Untuk mengakses PDF4me Web API melalui ZapierSetiap permintaan harus menyertakan kredensial otentikasi yang tepat.

Get your API Key

Fakta Penting yang Tidak Boleh Anda Lewatkan

Teks Dokumen adalah JSON string, bukan kolom individual.

Aksi tersebut mengembalikan satu field, Teks Dokumen, memegang seluruh muatan yang telah didekodekan sebagai sebuah JSON string. Anda memerlukan Kode oleh Zapier (Jalankan JavaScript) langkah ke JSON.parse sebelum memetakan nilai-nilai individual seperti IBAN atau Nama_ud.

Nama kolom menggunakan awalan cr_/ucr_/ud_

cr_ adalah kreditur, ucr_ adalah kreditur utama (seringkali kosong), dan keluar_ adalah debitur utama, yang sesuai dengan Standar Pembayaran Swiss (SPC) penamaan bidang. cr_Nama Dan Nama_ud adalah dua bidang yang paling banyak digunakan dalam alur kerja.

Gunakan berkas asli untuk PDF, bukan output dari tindakan ini

Membaca Kode QR Swiss mengembalikan data tentang PDF, itu tidak lolos PDF terus berlanjut. Teruslah merujuk pada Mengajukan dari pemicu Anda untuk setiap langkah Unggah File, email, atau penyimpanan.

Siapkan panel aksi: hanya File yang wajib diisi, Nama File bersifat opsional.

Parameter

Diperlukan dalam Zapier UI: Berkas. Nama berkas bersifat opsional.

Parameter	Diperlukan	Apa fungsinya?	Contoh
File	Required	The PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.	1. File
File Name	Optional	Name for the response file. If left blank, the name is picked from the source URL.	invoice.pdf

Keluaran

Aksi tersebut mengembalikan metadata file ditambah satu bidang muatan (payload), Teks Dokumen, A JSON Uraikan string tersebut untuk mencapai masing-masing Swiss. QR-kolom tagihan tercantum di bawah tabel.

Bidang	Jenis	Isi di dalamnya
File Name	String	Name of the generated response file, from File Name or picked from the source URL.
File Extension	String	Extension of the response file, .json.
Full File Name	String	Complete filename including extension.
File Alternate Url	String	URL to the generated JSON response file.
Document Id	String	Unique identifier for this processing run.
File Size	Number	Size of the response file in bytes.
Doc Text	String (JSON)	The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields.

Kolom Teks Dokumen (setelah JSON.uraikan)

Bidang	Isi di dalamnya
QRType, Version, CodingType	Swiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBAN	Creditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country	Creditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_Country	Ultimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, Currency	Payment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country	Ultimate debtor (payer) name and address.
ReferenceType, Reference	Reference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfo	Free-text payment message and structured billing information, when present on the bill.

Bagaimana Cara Saya Mengatur Pembacaan Kode QR Swiss di Zapier?

1. Menambahkan PDF4me sebagai aplikasi aksi di Zap Anda dan pilih Baca Kode QR Swiss.
2. Hubungkan milik Anda PDF4me buat akun atau pilih koneksi yang sudah ada.
3. Peta Mengajukan ke Swiss QR-tagihan PDF dari pemicu Anda atau langkah sebelumnya. Secara opsional, petakan. Nama File.
4. Uji langkah tersebut dan periksa. Teks Dokumen di panel Data out, itu adalah JSON rangkaian.
5. Tambahkan Kode oleh Zapier (Jalankan JavaScript) langkah yang menerima Teks Dokumen, berjalan JSON.parse, dan mengembalikan kolom spesifik yang Anda butuhkan (Nama_ud, cr_Nama, IBAN, Referensiatau lainnya).
6. Petakan nilai yang diuraikan tersebut ke dalam Unggah File (untuk penggantian nama), sebuah Menyaring atau Jalan setapak langkah (untuk perutean), atau tindakan spreadsheet/akuntansi.

Apa itu orang Swiss? QR-Bill dan Mengapa Diperlukan Pembaca Khusus?

Orang Swiss QR-tagihan (QR(Rechnung) adalah format Standar Pembayaran Swiss yang menjadi satu-satunya slip pembayaran Swiss yang sah pada tanggal 30 September 2022, menggantikan slip pembayaran lama berwarna oranye dan merah. Slip ini mengkodekan kreditur, debitur, IBAN, jumlah, dan data referensi di dalam sebuah QR kode menggunakan SPC (Swiss Payment Code) struktur, urutan bidang tetap yang merupakan barcode generik atau QR Pemindai membaca teks mentah tetapi tidak dapat memetakan ke bidang bernama. Pembacaan Kode QR Swiss menerjemahkan teks tersebut. SPC struktur dan mengembalikannya sesuai nama yang diberikan. JSON ladang.

Pengaturan Umum

Contoh Alur KerjaCommon Zapier patterns using Read SwissQR Code.

Otomatis mengganti nama faktur berdasarkan nama debitur

1. Pemicu File Baru di Folder (Dropbox, Google Drive, SharePoint) kebakaran di Swiss baru QR-tagihan PDF.
2. Fungsi Read SwissQR Code dijalankan dengan File dan Nama File yang dipetakan dari pemicu, dan mengembalikan Teks Dokumen.
3. Sebuah Kode oleh Zapier Langkah ini mengurai Teks Dokumen dan mengembalikan ud_Name (debitur).
4. Unggah File menyimpan hal yang sama PDF Konten dengan nama yang telah diuraikan sehingga file dapat dicari berdasarkan pembayar.

Cocokkan pembayaran masuk dengan catatan akuntansi.

1. Pemicu email atau folder mengirimkan Swiss QR-tagihan PDF.
2. Baca SwissQR Code yang mengekstrak Teks Dokumen, lalu sebuah Kode oleh Zapier langkah-langkah penguraian IBAN, Jumlah, dan Referensi.
3. Langkah pencarian dalam sistem akuntansi (QuickBooks, Xero, atau basis data khusus) mencocokkan Referensi dengan faktur yang belum dibayar.
4. Langkah selanjutnya menandai faktur sebagai telah dibayar dan mencatat transaksi tersebut.

Rute berdasarkan jumlah atau jenis referensi

1. Program Read SwissQR Code berjalan pada tagihan yang masuk dan mengembalikan Teks Dokumen.
2. Sebuah Kode oleh Zapier Langkah ini menguraikan Jumlah dan Tipe Referensi.
3. Langkah Paths mengarahkan pembayaran bernilai tinggi ke antrian persetujuan manual dan QRR-Pembayaran yang dirujuk ke posting otomatis.

Tips Praktis

Doc Text always needs a parse step

There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.

cr_ vs ud_ vs ucr_ is easy to mix up

cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.

ReferenceType tells you the reference format

QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.

Amount can be null for open-amount bills

Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.

The action reads, it does not validate compliance

This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.

Lembar Panduan Singkat

Bidang	Nilai
Action	Read SwissQR Code
File	Required, Swiss QR-bill PDF
File Name	Optional
Output payload	Doc Text (JSON string)
Common parsed fields	IBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step needed	Code by Zapier, JSON.parse(Doc Text)
Counterpart action	Create SwissQR Bill (generates the QR-bill instead of reading it)

Pertanyaan Umum

What does Read SwissQR Code actually return?+

The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.

Do I need a separate step to parse the output?+

Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.

What is the Swiss QR-bill and why does it need a special reader?+

The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.

Can I use the extracted data to rename or route the PDF?+

Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

Tindakan Terkait

Buat Tagihan SwissQR

Tindakan yang berlawanan menghasilkan Swiss. QR-tagihan PDF dari IBAN, kreditor, dan data jumlah, alih-alih membaca satu per satu.

Klasifikasi Dokumen

Urutkan barang masuk PDFs Periksa jenisnya terlebih dahulu, lalu jalankan perintah Read SwissQR Code hanya pada kode QR yang diklasifikasikan sebagai Swiss. QR-tagihan.

Uraikan Dokumen

Untuk faktur tanpa Swiss QR-tagihan, ekstrak data item baris dan header menggunakan templat parse yang dipetakan.

Studi Kasus & Aplikasi Industri

Swiss Banking & Financial Services

• Pemrosesan PembayaranBaca Kode QR Swiss untuk pemrosesan pembayaran otomatis dan penanganan transaksi.
• Manajemen TransaksiEkstrak data pembayaran untuk pemrosesan dan rekonsiliasi transaksi yang komprehensif.
• Pelaporan KepatuhanMasukkan data referensi dan jumlah yang telah didekode ke dalam catatan jejak audit internal.
• Pelayanan pelanggan: Memproses pembayaran dan pertanyaan pelanggan dengan pengenalan Kode QR Swiss otomatis

Swiss Business & Professional Services

• Pemrosesan FakturMembaca Kode QR Swiss dari faktur untuk pemrosesan pembayaran dan akuntansi otomatis.
• Manajemen KlienEkstrak informasi pembayaran untuk penagihan klien dan pelacakan pembayaran.
• Manajemen KeuanganOtomatisasi pembacaan Kode QR Swiss untuk manajemen keuangan yang komprehensif
• Otomatisasi DokumenSederhanakan pemrosesan dokumen bisnis dengan pembacaan Kode QR Swiss terintegrasi.

Swiss E-commerce & Retail

• Pemrosesan PesananBaca Kode QR Swiss untuk pemrosesan pesanan otomatis dan pengumpulan pembayaran.
• Pelacakan PembayaranEkstrak data pembayaran untuk pelacakan pesanan dan pembayaran yang komprehensif.
• Pengalaman PelangganTingkatkan pengalaman pembayaran pelanggan dengan pemrosesan Kode SwissQR otomatis.
• Manajemen InventarisMenghubungkan data pembayaran dengan manajemen inventaris dan pemenuhan pesanan

Swiss Government & Public Sector

• Layanan PublikBaca Kode QR Swiss untuk layanan pemerintah dan pemrosesan pembayaran sektor publik.
• Administrasi PerpajakanEkstrak data pembayaran untuk pembayaran pajak dan pemrosesan biaya pemerintah.
• Manajemen ArsipMemasukkan data pembayaran yang telah didekode ke dalam pencatatan internal untuk akuntansi sektor publik.
• Layanan DigitalModernisasi pemrosesan pembayaran sektor publik dengan otomatisasi Kode QR Swiss

Dapatkan Bantuan

Zapier IntegrationGet your API KeyZapier Documentation