Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

PDF Faktur QR Swiss: Ganti Nama berdasarkan Kreditur, Jumlah, atau Referensi di n8n!

· Satu menit membaca
Sankalp Mishra
SEO and Content Writer

Anda menerima file PDF, faktur, slip pembayaran, masing-masing dengan kode QR Swiss yang berisi informasi siapa yang membayar, berapa jumlahnya, dan referensinya. Anda ingin file-file tersebut diganti namanya sesuai dengan data tersebut agar Anda dapat menemukan dan mengurutkannya dengan cepat. Melakukannya secara manual tidak efisien.

Solusinya: alur kerja n8n yang unduhan PDF tersebut menggunakan Baca Kode QR Swiss (PDF4me) untuk mengambil data pembayaran terstruktur tersebut, penggabungan beserta berkasnya, dan unggahan Ganti namanya, berdasarkan kreditur, jumlah, referensi, atau apa pun yang Anda butuhkan. File yang sama, nama file yang lebih baik, tanpa perlu mengganti nama secara manual.

Panduan ini akan memandu Anda melalui seluruh proses: unduh PDF, baca kode QR Swiss-nya, lalu gabungkan dan unggah dengan nama file yang dibuat dari data yang Anda butuhkan, nama dan kota kreditur, jumlah dan referensi, atau detail debitur.

Gambaran Alur Secara Singkat​

Alur kerja n8n Anda untuk mengubah nama PDF berdasarkan data QR Swiss terlihat seperti ini:

  1. Pemicu: Manual untuk pengujian, atau otomatis (misalnya Dropbox, email, webhook) ketika PDF baru tersedia.
  2. Unduh fileMengambil file PDF dari sumber Anda (misalnya Dropbox) dan menampilkannya sebagai data biner dalam sebuah kolom seperti... document.
  3. Baca Kode QR Swiss (PDF4me): Mengekstrak data QR-bill Swiss dari PDF dan menghasilkan data terstruktur (swissQrData: kreditor cr_Name, cr_City, cr_Countrydebitur ud_Name, Amount, Currency, Reference, dll.). PDF asli tetap berada di node Unduh.
  4. MenggabungkanMenggabungkan output Baca Kode QR Swiss (data QR Swiss) dan output Unduh (biner PDF) menjadi satu item sehingga node berikutnya memiliki nama file baru dan konten file.
  5. Unggah fileMenyimpan PDF dengan jalur/nama file yang diatur ke kolom QR Swiss yang Anda pilih (misalnya, Test AG_Zurich_Switzerland.pdf atau 1000_CHF_REF123.pdf).

Berkas yang sama, nama baru, setiap kali. Di bawah ini kita akan membahas setiap bagian secara detail.

Ikhtisar alur kerja n8n: Pemicu → Unduh file → Baca kode QR Swiss → Gabungkan → Unggah file

Langkah 1: Unduh File dan Baca Kode QR Swiss-nya​

Masukkan PDF ke n8n dan ekstrak nilai penamaan Dengan PDF4me, baca Kode QR Swiss. File tersebut dapat berasal dari Unduh file (misalnya. Dropbox), Google Drive, email, atau node apa pun yang menghasilkan output biner.

Alur sejauh ini: Pemicu → Unduh file → Baca Kode QR Swiss.

Penting: Membaca Kode QR Swiss mengembalikan data pembayaran (dalam swissQrData): tidak melewati PDF. Konten file tetap berada di node Download. Pada Langkah 2, Anda akan menggabungkan keduanya sehingga node Upload memiliki file dan nama baru.

  1. Tambahkan pemicu: Manual untuk pengujian; untuk produksi, gunakan pemicu otomatis (misalnya Dropbox, Email, Google Drive, webhook).
  2. Tambahkan Unduh file (misalnya Dropbox): Atur Jalur File ke lokasi PDF Anda (misalnya, /Blog Data/Read Swiss QR.pdf) Dan Masukkan File Output ke dalam Kolom ke document Jadi, PDF tersebut tersedia dalam format biner untuk node berikutnya.
  3. Tambahkan node PDF4me → Kode batang → Baca Kode QR Swiss.
  4. Konfigurasikan node Baca Kode QR Swiss:
  • Kredensial untuk terhubung: Akun PDF4me Anda.
  • Sumber: Kode batang → Operasi Kode Batang: Baca Kode QR Swiss.
  • Tipe Data Masukan: Data Biner.
  • Input Bidang Biner: document (sama dengan kolom output node Download).
  • Nama File Output: misalnya swissqr_code_data.json.
  • Asinkron: Aktifkan fitur ini untuk PDF berukuran lebih besar jika diperlukan.
  1. Jalankan node tersebut. Outputnya meliputi: kesuksesan, Nama dokumen, Dan swissQrData dengan kreditur (cr_Name, cr_City, cr_Country), debitur (ud_Name, dll.), Jumlah, Mata uang, Referensi, IBAN, dan masih banyak lagi. Anda akan menggunakan kolom-kolom ini untuk nama file pada langkah Unggah.

Referensi parameter lengkap: Baca Kode QR Swiss (n8n).

n8n Dropbox Unduh node file: jalur file dan letakkan output di bidang dokumen
Node n8n Membaca kode QR Swiss: parameter dan output swissQrData

Langkah 2: Gabungkan dan Unggah dengan Nama Baru​

Anda membutuhkan keduanya PDF biner (dari Unduh) dan Data QR Swiss (dari Read Swiss QR Code) dalam satu item sehingga node Upload dapat menyimpan file dengan nama baru. A Menggabungkan simpul tersebut menggabungkannya; Mengunggah Node tersebut kemudian menggunakan kode QR Swiss sebagai jalur atau nama file.

  1. Tambahkan node Gabung
  • Mode: Gabungkan.
  • Gabungkan berdasarkan: Posisi (item pertama dari Input 1 dengan item pertama dari Input 2).
  • Jumlah Masukan: 2.
  • Masukan 1: Terhubung dari Baca Kode QR Swiss (menyediakan) swissQrData).
  • Masukan 2: Terhubung dari Unduh file (menyediakan) binary.document).
  • Keluaran: Satu item gabungan yang berisi JSON QR Swiss dan binary.document, sehingga node berikutnya memiliki nama file baru dan isi file tersebut.
Node penggabungan n8n: menggabungkan JSON QR Swiss dan biner PDF
  1. Tambahkan node Unggah (contoh: Dropbox) Unggah file, atau node apa pun yang menerima biner + jalur)
  • Jalur File (ekspresi): Gunakan output Read Swiss QR Code. Anda dapat merujuk node berdasarkan nama: $('Read SwissQR code').item.json.swissQrData.
  • Berkas Biner: PADA.
  • Input Bidang Biner: document.
  • File diunggah dengan nama yang berasal dari kode QR Swiss; konten PDF tidak berubah.

Gunakan nama kreditur, kota, dan negara untuk nama file (misalnya, Test AG_Zurich_Switzerland.pdf):

/Blog Data/{{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_City }}_{{ $('Read SwissQR code').item.json.swissQrData.cr_Country }}.pdf

Menghasilkan: /Blog Data/Test AG_Zurich_Switzerland.pdf

n8n Unggah berkas: nama berkas dinamis dari data kreditur QR Swiss

Pola Gabung + Unggah yang sama berlaku untuk Google Drive, email, atau penyimpanan apa pun yang menerima data biner dan jalur dinamis. Tip: Untuk Dropbox, aktifkan membaca Dan menulis di dalam Konsol Aplikasi Dropbox (Izin → File dan folder): misalnya, baca untuk Unduh, files.content.write Untuk mengunggah, gunakan token akses baru setelah mengubah izin.

mengerti: Jika Upload melaporkan adanya file biner yang hilang, pastikan untuk melakukan Penggabungan (Merge). Masukan 2 berasal dari Unduh file, bukan dari Read Swiss QR Code.

Mengapa Ini Berhasil​

Poin-poin penting

  • PemicuGunakan pemicu manual untuk pengujian atau pemicu otomatis (Dropbox, email, webhook) agar alur kerja berjalan setiap kali PDF baru tersedia.
  • Baca Kode QR Swiss mengekstrak data QR-bill Swiss dan menampilkan swissQrData (kreditur) cr_*debitur keluar_*, Jumlah, Mata uang, Referensi, dll.). File tersebut tidak melewati PDF; file tetap berada di node Unduh.
  • Menggabungkan (Gabungkan berdasarkan Posisi) pasangkan Baca keluaran Kode QR Swiss dengan keluaran Unduh sehingga node berikutnya menerima satu item dengan keduanya dokumen biner Dan swissQrData.
  • Mengunggah menggunakan ekspresi seperti $('Baca kode SwissQR').item.json.swissQrData.cr_Name (Dan Kota cr_City, cr_Negara, atau bidang lainnya) untuk jalur/nama file dan dokumen biner untuk kontennya, jadi setiap file diganti namanya dengan data QR Swiss.

Skenario Dunia Nyata​

Skenario 1: Faktur yang Diganti Namanya oleh Kreditur

Masalah: File PDF faktur masuk dengan nama generik; Anda perlu mencarinya berdasarkan pemasok (kreditur) dan lokasi.

Larutan: Ganti nama berdasarkan nama kreditur, kota, dan negara (misalnya, Test AG_Zurich_Switzerland.pdfSetiap berkas dapat dicari berdasarkan siapa yang mengirim tagihan.

Ekstrak bidang: cr_Name, cr_City, cr_Country Pemicu: Folder Dropbox, lampiran email, atau webhook

Skenario 2: Slip Pembayaran berdasarkan Jumlah dan Referensi

Masalah: File PDF slip pembayaran perlu diarsipkan berdasarkan jumlah dan referensi pembayaran untuk keperluan rekonsiliasi.

Larutan: Ubah nama berdasarkan jumlah, mata uang, dan referensi (misalnya, 1000_CHF_210000000003139471430009017.pdf). Mencocokkan dokumen dengan transaksi bank.

Ekstrak bidang: Amount, Currency, Reference Pemicu: Dropbox, email, webhook

Skenario 3: Pengajuan Berdasarkan Debitur

Masalah: Anda perlu mengelompokkan PDF berdasarkan pelanggan (debitur utama) untuk keperluan akuntansi.

Larutan: Ganti nama berdasarkan nama debitur (misalnya, Test Debt AG.pdf) atau nama debitur + kota. Pemetaan langsung ke catatan pelanggan.

Ekstrak bidang: ud_Name, ud_City Pemicu: Email, folder bersama, webhook

Pertanyaan yang Sering Diajukan (FAQ) Singkat​

  • Bagaimana jika tidak ditemukan kode QR Swiss? Gunakan opsi cadangan dalam ekspresi Jalur File, misalnya: {{ $('Read SwissQR code').item.json.swissQrData?.cr_Name || 'no-qr-found' }}Anda dapat menambahkan percabangan bersyarat untuk melewati pengunggahan atau mengirim file-file tersebut ke folder terpisah.
  • Bisakah saya menggunakan nama kreditur dan jumlah secara bersamaan? Ya. Contoh: {{ $('Read SwissQR code').item.json.swissQrData.cr_Name }}_{{ $('Read SwissQR code').item.json.swissQrData.Amount }}_{{ $('Read SwissQR code').item.json.swissQrData.Currency }}.pdf.
  • Bisakah saya menggunakan ini untuk Google Drive atau email? Ya. Polanya sama: gunakan node apa pun yang memberi Anda file dalam format biner dan node Unggah (atau simpan) apa pun yang menerima format biner ditambah jalur dinamis.

Langkah Selanjutnya​

Ringkasan: Pemicu → Unduh file → Baca Kode QR Swiss → Gabungkan → Unggah. Nama file dibentuk dari swissQrData (misalnya, nama kreditur, kota, negara, atau jumlah/referensi). Setiap PDF disimpan dengan data QR Swiss yang diekstrak sebagai namanya.

  1. Dapatkan kunci API AndaGunakan akun PDF4me yang sama untuk n8n. Gratis untuk memulai.
  2. Bangun alur n8n Anda: Pemicu → Unduh file → Baca Kode QR Swiss → Gabungkan → Unggah dengan Jalur File yang diatur ke ekspresi QR Swiss yang Anda butuhkan.
  3. Baca dokumen lengkapnya: Baca Kode QR Swiss (n8n).
  4. Coba API-nyaUji endpoint Read Swiss QR Code dengan PDF Anda sendiri di API Tester.
Get Your API KeyRead Swiss QR Code in n8nTry SwissQR Code APIRename with Barcode