Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Membuat Faktur QR Swiss di n8n: Dua Alur Kerja Lengkap (Dengan dan Tanpa PDF yang Sudah Ada)

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

Setiap faktur Swiss harus mencantumkan Uang Kertas QR Swiss (juga disebut slip pembayaran QR Swiss) sehingga bank dan perangkat lunak akuntansi dapat memindai dan memproses pembayaran secara otomatis. n8n dan PDF4me membuat pembuatan slip pembayaran tersebut sepenuhnya otomatis. Panduan ini akan menjelaskan langkah-langkahnya. dua alur kerja siap produksi: satu yang menempatkan slip QR di atas PDF yang sudah ada di Dropbox, dan satu lagi yang menghasilkan dokumen Tagihan QR mandiri dari data pembayaran saja tanpa memerlukan PDF latar belakang. Keduanya dapat diatur dalam waktu kurang dari 10 menit.

Dua alur kerja dibahas dalam panduan ini.
Workflow A (4 nodes)
Trigger → Download PDF → Create SwissQR (Binary Data) → Upload. Output: 602 kB. Best when you already have a PDF invoice in Dropbox.
Workflow B (3 nodes)
Trigger → Create SwissQR (None) → Upload. Output: 132 kB. Best when you only have payment data and need a standalone QR slip.
Versi singkatnya

Alur Kerja A: Pemicu aktif. Dropbox Download mengambil data. Test Debt AG.pdf (344 kB). PDF4me Buat Tagihan SwissQR berjalan dengan Tipe Data Masukan: Data BinerJumlah 1000, CHF, IBAN CH0200700110003765824Kreditur: Test AG. Outputnya adalah tagihan_swissqr.pdf dengan ukuran 602 kB. Dropbox Upload menyimpan hasilnya.

Alur Kerja B: Pemicu aktif. PDF4me Buat SwissQR Tagihan berjalan dengan Tipe Data Masukan: Tidak Ada, kolom pembayaran yang sama ditambah alamat kreditur terstruktur lengkap. Outputnya adalah n8n_swissqr02.pdf dengan ukuran 132 kB. Dropbox Upload menyimpan hasilnya.

Satu pengaturan yang menentukan segalanya

Yang Tipe Data Masukan Kolom pada node PDF4me adalah satu-satunya perbedaan struktural antara kedua alur kerja tersebut. Atur nilainya menjadi... Data Biner Saat Anda memiliki PDF yang sudah ada (Alur Kerja A). Atur ke Tidak ada Saat Anda menginginkan slip QR terpisah hanya dari data pembayaran (Alur Kerja B). Setiap parameter lainnya, jumlah, IBAN, mata uang, nama kreditur, identik di antara keduanya.

Apa yang sedang Anda bangun​

Setiap faktur Swiss yang diterbitkan setelah migrasi tahun 2020 dari standar slip pembayaran lama harus menyertakan Swiss QR Bill: bagian pembayaran standar dengan kode QR yang mengkodekan IBAN, jumlah, mata uang, kreditur, dan data debitur opsional dalam format ISO 20022. Bank dan perangkat lunak akuntansi memindainya tanpa perlu memasukkan data ulang secara manual. Dua alur kerja n8n dalam panduan ini mengotomatiskan langkah pembuatan tersebut sehingga QR Bill diproduksi dan disimpan ke Dropbox tanpa perlu diubah secara manual.

Sekilas​

Alur Kerja A: 4 langkah​

1Trigger
2Download PDF from Dropbox
3Create SwissQR (Binary Data)
4Upload result to Dropbox
Gambaran umum alur kerja n8n: Saat mengklik pemicu Eksekusi alur kerja, node Dropbox Unduh file (unduh: file), node PDF4me Buat tagihan SwissQR (faktur / Buat Tagihan Swiss QR), node Dropbox Unggah file (unggah: file) akan aktif. Keempat node tersebut terhubung secara berurutan dengan 1 item yang berpindah di antara masing-masing node.

Alur Kerja A: empat node, Pemicu untuk Mengunduh untuk Membuat Tagihan SwissQR (Data Biner) untuk Mengunggah.

Alur Kerja B: 3 langkah​

1Trigger
2Create SwissQR (None)
3Upload result to Dropbox
Ikhtisar alur kerja n8n B: Saat mengklik pemicu Eksekusi alur kerja, node PDF4me Buat tagihan SwissQR1 berlabel Buat Swiss QR tanpa data input (PDF) (faktur / Buat Tagihan Swiss QR), node Dropbox Unggah file1 (unggah: file). Tiga node terhubung secara berurutan dengan 1 item yang melewati masing-masing node.

Alur Kerja B: tiga node, Pemicu untuk Membuat Tagihan SwissQR (Tipe Data Masukan Tidak Ada) untuk Diunggah. Tidak diperlukan langkah pengunduhan.

Mengapa ada dua alur kerja terpisah?​

Pertahankan dokumen Anda yang sudah ada.

Alur kerja A mempertahankan templat faktur bermerek Anda tetap utuh. PDF4me menambahkan slip QR Swiss ke PDF yang sudah Anda miliki di Dropbox. Tidak perlu memformat ulang, mendesain ulang, atau melakukan pekerjaan tata letak manual.

Hasilkan hanya dari data.

Alur kerja B sepenuhnya melewati langkah pengunduhan. Berikan data pembayaran dan PDF4me akan menghasilkan dokumen slip pembayaran QR lengkap dari awal. Tidak diperlukan PDF dasar sama sekali.

Satu lokasi, dua jalan

Satu-satunya perbedaan struktural adalah... Tipe Data Masukan Kolom: Data Biner untuk Alur Kerja A, Tidak Ada untuk Alur Kerja B. Jumlah, IBAN, mata uang, dan nama kreditur dikonfigurasi dengan cara yang sama di keduanya.

Sebelum Anda mulai​

Daftar Periksa
  • n8n (cloud atau dihosting sendiri). Buat alur kerja kosong baru.
  • Kunci API PDF4mePengaturan pertama kali: Hubungkan PDF4me ke n8n.
  • Dropbox Kredensial OAuth2 di n8n dengan akses baca dan tulis ke folder kerja Anda.
  • Alur kerja A saja: File PDF yang sudah ada dan tersimpan di Dropbox (misalnya...) Test Debt AG.pdf di dalam /Data Blog/SwissQR/).
  • Data pembayaran: Kode IBAN Swiss yang valid (21 karakter, diawali dengan) CH), jumlah, mata uang (CHF atau EUR), nama kreditur, dan untuk Alur Kerja B, alamat kreditur terstruktur lengkap.

Alur Kerja A: Membuat Tagihan QR Swiss pada PDF yang sudah ada (4 node)​

Gunakan ini jika Anda sudah memiliki faktur atau dokumen dalam format PDF. PDF4me akan menempatkan Tagihan QR Swiss di atas file tersebut.

Langkah 1: Unduh PDF yang sudah ada dari Dropbox​

Alur sejauh ini: Pemicu.

  1. Tambahkan Dropbox simpul.
  2. Mandat: API Dropbox OAuth2.
  3. Sumber: Berkas. Operasi: Unduh.
  4. Jalur Berkas: jalur ke PDF Anda di Dropbox, misalnya. Test Debt AG.pdf (dalam contoh ini, file tersebut berada di bawah) /Data Blog/SwissQR/).
  5. Masukkan File Output di Kolom: data.
  6. Jalankan langkah tersebut. Panel OUTPUT akan menampilkan nama file (Test Debt AG.pdf), direktori, tipe MIME aplikasi/pdf, dan ukuran file 344 kB.
Node n8n Dropbox Download a file: Kredensial Dropbox OAuth2 API, File Sumber Daya, Operasi Unduh, Jalur File Test Debt AG.pdf, Masukkan File Output di Bidang data. Panel OUTPUT menampilkan Nama File Test Debt AG.pdf, Direktori /Blog Data/SwissQR, Ekstensi File pdf, Tipe MIME application/pdf, Ukuran File 344 kB.

Dropbox Download dikonfigurasi dengan Jalur File Test Debt AG.pdf dan Letakkan File Output di Kolom dataOUTPUT mengkonfirmasi bahwa file yang diunduh berukuran 344 kB.

Langkah 2: Buat SwissQR Bill pada PDF yang telah diunduh​

Alur sejauh ini: Aktifkan lalu Unduh PDF.

Ini adalah langkah intinya. PDF4me membaca file biner PDF yang diunduh dan menghasilkan PDF baru dengan uang kertas QR Swiss terlampir.

  1. Tambahkan PDF4me simpul.
  2. Mandat: Akun PDF4ME.
  3. Sumber: Faktur. Operasi Faktur: Buat SwissQR Bill.
  4. Tipe Data Masukan: Data Biner (karena Anda memasukkan PDF dari node sebelumnya).
  5. Sifat Biner: data (sesuai dengan nama kolom dari langkah Unduh).
  6. Nama Berkas: Test Debt AG.pdf (nama file dokumen sumber).
  7. Isi kolom pembayaran:
    • Jumlah: 1000
    • Mata uang: Franc Swiss
    • IBAN: CH0200700110003765824
    • Nama Kreditur: Uji AG
  8. Jalankan langkah tersebut. Panel OUTPUT menampilkan tagihan_swissqr.pdf, tipe MIME aplikasi/pdfUkuran file 602 kB (naik dari 344 kB karena halaman slip QR disematkan).
n8n PDF4me Buat node tagihan SwissQR dengan INPUT yang menampilkan Unduh file output: Nama File Test Debt AG.pdf 344 kB. Parameter: Kredensial akun PDF4ME 3, Sumber Daya Faktur, Operasi Faktur Buat Tagihan SwissQR, Tipe Data Input Data Biner, Properti Biner data, Nama File Test Debt AG.pdf, Jumlah 1000, Mata Uang Franc Swiss, IBAN CH0200700110003765824, Nama Kreditur Test AG. OUTPUT: data, Nama File swissqr_bill.pdf, Ekstensi File pdf, Tipe MIME application/pdf, Ukuran File 602 kB.

Buat Tagihan SwissQR dengan Tipe Data Input Data Biner. INPUT adalah PDF berukuran 344 kB dari Dropbox. OUTPUT adalah tagihan_swissqr.pdf pada ukuran 602 kB. Peningkatan ukuran ini mengkonfirmasi bahwa kode QR telah disematkan.

Langkah 3: Unggah hasilnya ke Dropbox​

Alur sejauh ini: Aktifkan, lalu Unduh PDF, kemudian Buat Tagihan SwissQR.

  1. Tambahkan lagi Dropbox simpul.
  2. Mandat: API Dropbox OAuth2.
  3. Sumber: Berkas. Operasi: Mengunggah.
  4. Jalur Berkas: jalur tujuan di Dropbox, misalnya. /Data Blog/SwissQR/swissqr_bill.pdf.
  5. Berkas Biner: Pada.
  6. Input Bidang Biner: data (hasil keluaran tagihan SwissQR dari langkah sebelumnya).
  7. Jalankan. Dropbox mengembalikan metadata unggahan yang mengkonfirmasi nama dan jalur file.

Alur kerja A selesai. PDF Anda yang ada sekarang memiliki Tagihan QR Swiss dan telah disimpan kembali ke Dropbox.

Alur Kerja B: Membuat Tagihan QR Swiss mandiri (3 node)​

Gunakan ini jika Anda tidak memiliki PDF latar belakang. PDF4me menghasilkan seluruh dokumen slip pembayaran QR dari detail pembayaran yang Anda masukkan langsung di node.

Langkah 1: Buat SwissQR Bill tanpa latar belakang PDF​

Alur sejauh ini: Pemicu.

Karena tidak ada input PDF, Anda harus mengisi alamat kreditur lengkap agar PDF4me dapat menampilkan tata letak QR Bill Swiss secara lengkap.

  1. Tambahkan PDF4me simpul.
  2. Mandat: Akun PDF4ME.
  3. Sumber: Faktur. Operasi Faktur: Buat SwissQR Bill.
  4. Tipe Data Masukan: Tidak ada (ini memberi tahu PDF4me untuk menghasilkan slip QR mandiri tanpa latar belakang PDF).
  5. Isi kolom pembayaran:
    • Jumlah: 1000
    • Mata uang: Franc Swiss
    • IBAN: CH0200700110003765824
    • Nama Kreditur: Uji AG
    • Jenis Alamat Kreditur: Terstruktur
    • Nama Jalan atau Alamat Kreditur: Jalan Uji
    • Nomor Gedung Kreditur: 1
    • Kode Pos Kreditur: 8000
    • Kota Kreditur: Zurich
  6. Jalankan langkah tersebut. Panel OUTPUT menampilkan tagihan_swissqr.pdf dengan ukuran 132 kB. Jauh lebih kecil daripada Alur Kerja A (602 kB) karena tidak ada PDF latar belakang, hanya slip QR itu sendiri.
Node n8n PDF4me Create SwissQR bill dengan Tipe Data Input None: Kredensial PDF4ME akun 3, Sumber Daya Faktur, Operasi Faktur Buat Tagihan SwissQR, Tipe Data Input None, Jumlah 1000, Mata Uang Franc Swiss, IBAN CH0200700110003765824, Nama Kreditur Test AG, Tipe Alamat Kreditur Terstruktur, Nama Jalan Kreditur Test Strasse, Nomor Gedung Kreditur 1, Kode Pos Kreditur 8000, Kota Kreditur Zurich. OUTPUT: data, Nama File swissqr_bill.pdf, Ekstensi File pdf, Tipe MIME application/pdf, Ukuran File 132 kB.

Buat Tagihan SwissQR dengan Tipe Data Input Tidak Ada. Alamat kreditur lengkap diperlukan karena PDF4me menghasilkan tata letak dari awal. Ukuran output adalah 132 kB.

Langkah 2: Unggah Tagihan QR terpisah ke Dropbox​

Alur sejauh ini: Aktifkan lalu Buat Tagihan SwissQR.

  1. Tambahkan Dropbox simpul.
  2. Mandat: API Dropbox OAuth2.
  3. Sumber: Berkas. Operasi: Mengunggah.
  4. Jalur Berkas: /n8n_swissqr02.pdf (atau jalur apa pun di Dropbox Anda).
  5. Berkas Biner: Pada.
  6. Input Bidang Biner: data.
  7. Jalankan. Panel OUTPUT mengkonfirmasi pengunggahan: nama: n8n_swissqr02.pdf, path_display: /n8n_swissqr02.pdf, ukuran: 132191, Dan dapat diunduh: benar.
Node n8n Dropbox Unggah file1: INPUT dari Buat tagihan SwissQR1 yang menampilkan data, Nama File swissqr_bill.pdf, Ekstensi File pdf, Tipe MIME application/pdf, Ukuran File 132 kB. Parameter: Kredensial Dropbox OAuth2 API, File Sumber Daya, Operasi Unggah, Jalur File /n8n_swissqr02.pdf, File Biner diaktifkan, Bidang Biner Input data. OUTPUT: nama n8n_swissqr02.pdf, path_lower /n8n_swissqr02.pdf, path_display /n8n_swissqr02.pdf, ukuran 132191, is_downloadable true, client_modified 2026-05-19T09:08:03Z.

Unggahan mengkonfirmasi: nama n8n_swissqr02.pdf, jalur /n8n_swissqr02.pdf, ukuran 132191 byte, dapat diunduh: benar.

Alur kerja B telah selesai. PDF Tagihan QR Swiss yang berdiri sendiri sudah ada di Dropbox dan siap untuk dikirim melalui email atau dilampirkan ke dokumen keluar apa pun.

Alur kerja mana yang sebaiknya Anda pilih?​

Alur Kerja A (dengan PDF yang sudah ada)Alur kerja B (mandiri)
Nodes4 (trigger + download + QR + upload)3 (trigger + QR + upload)
Input Data TypeBinary DataNone
Requires existing PDFYes (in Dropbox or another source)No
Output size (example)602 kB132 kB
Full creditor address requiredNo (name only shown in example)Yes (Structured address required for layout)
Best forAdding QR slip to finished invoices or lettersSending a separate payment slip alongside any document

Referensi cepat: parameter kunci​

SimpulPengaturan kunciContoh nilai
Dropbox Download (A only)File Path + Put Output File in FieldTest Debt AG.pdf; data
PDF4me Create SwissQR Bill (A)Input Data Type + Binary Property + File NameBinary Data; data; Test Debt AG.pdf
PDF4me Create SwissQR Bill (A and B)Amount + Currency + IBAN + Creditor Name1000; Swiss Franc; CH0200700110003765824; Test AG
PDF4me Create SwissQR Bill (B only)Input Data TypeNone
PDF4me Create SwissQR Bill (B only)Creditor Address Type + Street + Number + Postal Code + CityStructured; Test Strasse; 1; 8000; Zurich
Dropbox Upload (A)File Path + Binary File + Input Binary Field/Blog Data/SwissQR/swissqr_bill.pdf; On; data
Dropbox Upload (B)File Path + Binary File + Input Binary Field/n8n_swissqr02.pdf; On; data

Kasus penggunaan​

Kumpulan faktur bulanan: Ambil daftar PDF faktur dari Dropbox, lakukan perulangan melalui PDF tersebut dengan sebuah n8n Dibagi dalam Beberapa Kelompok Buat node, jalankan Alur Kerja A pada masing-masing node, dan simpan hasilnya ke folder terpisah. Satu kali jalankan akan menangani satu bulan penuh.

Slip pembayaran dinamis dari basis data: Picu melalui Webhook saat permintaan pembayaran dibuat. Ambil jumlah, IBAN, dan data kreditur dari node Postgres atau Airtable. Gunakan Alur Kerja B untuk menghasilkan slip QR dan mengirimkannya melalui email Gmail atau Outlook secara otomatis.

Tagihan sewa dan utilitas: Buat slip QR terpisah (Alur Kerja B) untuk pembayaran sewa, tagihan utilitas, atau biaya keanggotaan setiap bulan. Simpan slip tersebut di Dropbox dan lampirkan ke email yang dikirim dari n8n. Tidak diperlukan PDF latar belakang.

Dihosting sendiri dan di lokasi: Jalankan n8n di infrastruktur Anda sendiri. Data pembayaran tidak pernah meninggalkan jaringan Anda kecuali untuk panggilan API PDF4me. Gabungkan dengan berbagi file lokal atau NAS sebagai pengganti Dropbox.

Pertanyaan yang sering diajukan​

Kapan saya harus menggunakan Alur Kerja A dibandingkan Alur Kerja B?

Menggunakan Alur Kerja A Saat Anda sudah memiliki dokumen PDF yang sudah jadi (faktur, surat, file apa pun) yang ingin Anda tambahkan Tagihan QR Swiss. PDF4me akan menambahkan slip QR ke file Anda yang sudah ada. Gunakan Alur Kerja B Saat Anda hanya memiliki data pembayaran (IBAN, jumlah, detail kreditor) dan menginginkan slip pembayaran PDF QR yang berdiri sendiri. Alur kerja B menghasilkan dokumen lengkap dari awal tanpa memerlukan PDF latar belakang.

Format IBAN apa yang dibutuhkan oleh Swiss QR Bill?

IBAN harus valid. IBAN Swiss: tepat 21 karakter, dimulai dengan CH, diikuti oleh dua angka pengecek dan nomor rekening bank 17 digit. Contoh: CH0200700110003765824Standar QR Swiss juga mendukung QR-IBAN (dimulai dengan CH dan menggunakan rentang 3000 hingga 3199 untuk pengidentifikasi bank). IBAN yang tidak valid atau bukan IBAN Swiss menyebabkan kesalahan validasi dari API PDF4me sebelum PDF apa pun dihasilkan.

Mengapa Alur Kerja B memerlukan alamat lengkap kreditur sedangkan Alur Kerja A tidak?

Saat Anda menggunakan Tipe Data Input Data Biner (Alur Kerja A), PDF4me menambahkan slip QR ke PDF yang sudah ada dan tata letaknya memiliki konteks visual dari dokumen sumber. Alamat kreditur bersifat opsional karena bagian slip QR ditambahkan, bukan dibuat dari awal. Saat Anda menggunakan Tipe Data Input Tidak ada (Alur Kerja B), PDF4me menghasilkan tata letak dokumen lengkap dari awal. Standar QR Swiss mewajibkan bahwa Tagihan QR mandiri harus menyertakan alamat kreditur lengkap (jalan, nomor bangunan, kode pos, kota) dalam data kode QR sehingga sistem pembayaran dapat memprosesnya tanpa konteks dokumen lain.

Bisakah saya menggunakan data pembayaran dinamis dari basis data atau formulir sebagai pengganti nilai yang dikodekan secara permanen?

Ya. Di n8n, setiap field di node PDF4me menerima ekspresi. Petakan field Jumlah, IBAN, Nama Kreditur, dan Kota dari node sebelumnya seperti query Postgres, record Airtable, baris Google Sheets, pengiriman formulir melalui n8n Form Trigger, atau payload webhook. Setiap eksekusi kemudian menghasilkan QR Bill unik untuk item saat ini tanpa pengeditan alur kerja secara manual. Ini adalah pendekatan yang direkomendasikan untuk otomatisasi penagihan produksi.

Node PDF4me menampilkan kesalahan. Apa yang harus saya periksa terlebih dahulu?

Periksa tiga hal secara berurutan. PertamaKonfirmasikan bahwa kunci API Anda aktif di dev.pdf4me.com dan akun Anda memiliki kredit. KeduaUntuk Alur Kerja B, pastikan keempat kolom alamat kreditur (Jalan, Nomor Gedung, Kode Pos, Kota) terisi saat Tipe Alamat Kreditur adalah Terstruktur. Jika salah satu kolom hilang, validasi akan gagal. KetigaUntuk Alur Kerja A, pastikan langkah Unduh Dropbox berhasil diselesaikan dan nama Properti Biner di node PDF4me cocok dengan nama bidang yang ditetapkan di node Unduh (keduanya harus sama). data).

Penyelesaian Masalah​

Kolom biner tidak ditemukan saat mengunggah

Node Dropbox Upload mencari field bernama data Secara default. Jika node Buat Tagihan SwissQR menggunakan Nama Bidang Biner Keluaran yang berbeda, perbarui Bidang Biner Masukan di node Unggah agar sesuai. Pertahankan nama bidang yang sama di semua node untuk menghindari hal ini.

Kesalahan validasi tagihan QR Swiss (IBAN atau alamat tidak valid)

IBAN harus berupa IBAN Swiss yang valid yang diawali dengan CH (21 karakter). Untuk Alur Kerja B, keempat kolom alamat kreditur (Jalan, Nomor Gedung, Kode Pos, Kota) harus diisi ketika Tipe Alamat Kreditur adalah Terstruktur. Jika salah satu kolom tidak diisi, akan terjadi kegagalan validasi.

File Dropbox tidak ditemukan (Alur Kerja A)

Periksa kembali Jalur File di node Unduh. Jalur Dropbox peka terhadap huruf besar dan kecil di beberapa akun. Buka Dropbox Anda dan salin jalur persisnya termasuk nama folder dan ekstensi file. Jika file berada di dalam subfolder, jalur harus menyertakan hierarki folder lengkap, misalnya. /Data Blog/SwissQR/Uji Hutang AG.pdf.

Kesalahan kunci API atau kredit dari PDF4me

Melihat Panduan Pemecahan Masalah PDF4me Untuk langkah-langkah memverifikasi kunci API Anda, memeriksa sisa kredit, dan menghubungkan kembali kredensial di n8n.

Apa yang harus dicoba selanjutnya?​

Opsional: ganti pelatuknya. Ganti pelatuk manual dengan Jadwal untuk penagihan bulanan, sebuah Webhook untuk diaktifkan saat permintaan pembayaran dibuat, atau Dropbox pada file yang telah dibuat untuk memproses PDF baru secara otomatis saat tiba.

n8n

Dapatkan Kunci API

Uang Kertas QR Swiss (dokumen n8n)

Alur kerja penggabungan QR + PDF Swiss