Buat Tagihan SwissQR
Kode batang → Buat Tagihan SwissQR
Yang Buat Tagihan SwissQR API menghasilkan Swiss QR-tagihan PDF yang sesuai dengan standar resmi Swiss. Anda mengirimkan basisnya PDF (docContent, docName), rincian kreditur (IBAN, nama, alamat), rincian debitur, jumlah, mata uang, referenceType, languageType, seperatorLine, dan opsional IsAsync. Itu API mengembalikan PDF dengan SwissQR Bill terlampir. Gunakan penguji di bawah ini untuk mencobanya; detail selengkapnya ada di bagian selanjutnya.
Coba fitur Buat Tagihan SwissQR. API
:::catatan Referensi cepat
Titik akhir: POST /api/v2/CreateSwissQrBill · Diperlukan: api-key, docContent, docName, iban, crName, crAddressType, crStreetOrAddressLine1/2, crPostalCode, crCity, jumlah, mata uang, udName, udAddressType, udStreetOrAddressLine1/2, udPostalCode, udCity, referenceType, languageType, seperatorLine, IsAsync
:::
Gunakan formulir di bawah ini untuk mengirimkan API kunci, PDF (Base64), dan semua kolom kreditur/debitur dan pembayaran. Responsnya adalah PDF dengan orang Swiss QR-tagihan. Tidak perlu kode, isi kolom dan klik. Kirim permintaan.
Gambaran umum, parameter, dan kasus penggunaan.
- Overview
- Parameters
- Use cases
Apa itu Create SwissQR Bill?
Titik akhir ini menciptakan pola Swiss. QR-tagihan PDF yang sesuai dengan standar resmi Swiss (Juni 2020). Anda menyediakan basis PDF dan data pembayaran lengkap: kreditur (IBAN, nama, alamat), debitur utama, jumlah, mata uang, jenis referensi, bahasa, dan gaya pemisah. API mengembalikan PDF dengan orang Swiss QR-Tagihan terlampir, siap untuk perbankan dan pembayaran digital.
Fitur utama
- Sesuai dengan standar SwissInformasi pembayaran terstruktur, detail kreditur/debitur, terintegrasi QR codedan tata letak yang tepat.
- Data pembayaran lengkap: IBAN, jumlah, mata uang (CHF, EUR, USD), tipe referensi (QRR, NON, SCOR), bahasa (Inggris, Jerman, Prancis, Italia).
- Opsi pemisah: seperatorLine: GarisDenganGunting, GarisPutusDenganGunting, atau Garis Padat untuk memotong/merobek.
Gunakan untuk faktur, tagihan, atau dokumen apa pun yang harus mencantumkan cap Swiss. QR-tagihan. Gabungkan dengan Baca Kode QR Swiss untuk memverifikasi atau mengekstrak data pembayaran dari sistem Swiss yang sudah ada. QR-tagihan.
API parameter
| Parameter | Jenis | Diperlukan | Keterangan |
|---|---|---|---|
| api-key | rangkaian | Ya | Milikmu PDF4me API kunci, Base64 dikodekan. Dapatkan dari dasbor. |
| docContent | base64 | Ya | PDF isi berkas (Base64). |
| docName | rangkaian | Ya | PDF nama file dengan ekstensi .pdf. |
| iban | rangkaian | Ya | Swiss IBAN untuk kreditur (misalnya CH0200700110003765824). |
| crName, crAddressType, crStreetOrAddressLine1, crStreetOrAddressLine2, crPostalCode, crCity | rangkaian | Ya | Nama kreditur, jenis alamat (S/K), jalan, kode pos, kota. |
| jumlah | rangkaian | Ya | Jumlah pembayaran (tanpa angka nol di depan). |
| mata uang | rangkaian | Ya | CHF, EUR, atau USD. |
| udName, udAddressType, udStreetOrAddressLine1, udStreetOrAddressLine2, udPostalCode, udCity | rangkaian | Ya | Nama dan alamat debitur utama. |
| referenceType | rangkaian | Ya | QRR, NON, atau SCOR. |
| languageType | rangkaian | Ya | Bahasa Inggris, Jerman, Prancis, atau Italia. |
| seperatorLine | rangkaian | Ya | GarisDenganGunting, GarisPutusDenganGunting, atau Garis Padat. |
| IsAsync | boolean | Ya | Aktifkan pemrosesan asinkron. |
Kapan menggunakan Buat Tagihan SwissQR?
- Faktur dan tagihanTambahkan Swiss QR-mengubah tagihan menjadi faktur untuk pembayaran digital di Swiss.
- Pemrosesan pembayaran: Menghasilkan tagihan yang sesuai untuk alur kerja pembayaran otomatis.
- Perbankan dan akuntansi: Integrasi Swiss QR-pembuatan tagihan ke dalam perbankan atau ERP sistem.
- Kepatuhan terhadap peraturan: Memenuhi standar perbankan dan pembayaran Swiss dengan tata letak resmi dan QR code.
Untuk skema permintaan/respons dan contoh kode, lihat Buat Tagihan SwissQR di dalam PDF4me API dokumen.
Prasyarat
Sebelum menggunakan endpoint ini, pastikan Anda telah:
- Sebuah valid PDF4me API kunci (Dapatkan milikmu API Kunci)
- A PDF dokumen untuk melampirkan Tagihan QR Swiss
- Semua informasi pembayaran yang diperlukan (IBAN(rincian kreditur, rincian debitur, jumlah, mata uang)
- Yang PDF berkas yang dikodekan dalam Base64 format
Format Respons
Yang API mengembalikan PDF berkas dengan RUU QR Swiss. Status 200 mengembalikan PDF di dalam isi respons; Status 202 artinya pemrosesannya asinkron, lakukan polling Location judul URL sampai PDF sudah siap.