Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Make uygulamasında herhangi bir PDF faturaya İsviçre QR kodu ekleme: 3 modüllü Dropbox iş akışı

· 19 dakikalık okuma
Sankalp Mishra
SEO and Content Writer

Her İsviçre faturasında şu unsur bulunmalıdır: İsviçre QR Banknotu Böylece bankalar ve muhasebe yazılımları ödemeyi otomatik olarak tarayabilir ve işleyebilir. Make ve PDF4me ile bu ekleme, üç modüllü senaryoDropbox Dosya İndirPDF4me İsviçre QR faturası oluşturunDropbox Dosya YükleAşağıdaki ekran görüntüleri, tuvalde gösterilen işlemin adım adım nasıl gerçekleştiğini göstermektedir: 10 sayfalık bir fatura. /pdf4metest/Files/10 page.pdf Ödeme makbuzu eklenmiş ve kaydedilmiş olarak İsviçre mevzuatına uygun bir fatura haline gelir. /pdf4meoutput/10 dakikadan kısa sürede üretime hazır.

Senaryoya genel bakış
1. Dropbox Download a File
Reads /pdf4metest/Files/10 page.pdf. Scheduled trigger (clock badge) is shown but any trigger works.
2. PDF4me Create Swiss QR-bill
Appends the QR payment slip to the source PDF. Currency, IBAN, creditor + debtor blocks, reference filled out.
3. Dropbox Upload a File
Writes the populated PDF to /pdf4meoutput/. File Name and Data mapped from the prior step.
kısa versiyon

Üç adet Make modülü. Dropbox Dosya İndir Kaynak faturayı çekiyor (ekran görüntüsü gösteriyor) YnooxTestone bağlantı, Bir dosya seçin, yol /pdf4metest/Dosyalar/10 sayfa.pdfPDF4me İsviçre QR faturası oluşturun İsviçre Ödeme Standartlarına uygun bir QR fatura sayfası ekler (Biçim Türü) PDFSayfalama Seçenekleri Birinci, Para birimi CHFIBAN numarası ile başlayan CH(tam alacaklı + borçlu blokları). Dropbox Dosya Yükle Sonucu şuraya yazar: /pdf4meoutput/ Dosya ayarı ile HaritaDosya Adı = 6. İsimVeri = 6. BelgeOluşturulan PDF dosyası e-posta ile gönderilmeye ve herhangi bir İsviçre bankasının mobil uygulamasındaki QR kod tarayıcısı tarafından taranmaya hazırdır.

Çıktınızın banka tarafından taranabilir olup olmadığını belirleyen iki şey vardır.

İlk olarak, IBAN numarası CH veya LI ile başlamalıdır. ve en fazla 21 karakter olmalıdır. QRR referans türü için IBAN şu şekilde olmalıdır: QR-IBANİkinci olarak, standart bir IBAN değil. Referans Türü QRR'dir., o Referans alanı, mod-10 kontrol basamağına sahip 27 basamaklı sayısal bir dizedir.; eğer yoksa, Referans Türünü şuna ayarlayın: PUAN (ISO 11649) veya OLMAYAN Referans alanını boş bırakın. Bankalar QR kodunu değil, yanlış yazılmış referans değerlerini reddeder.

Bu, gerçek dünyada sıkça karşılaşılan soruları çözüyor.​

İnsanlar bu sorunu şu gibi ifadelerle arıyorlar:

  • "PDF faturama otomatik olarak İsviçre QR kodlu fatura nasıl eklerim?" Faturayı Dropbox'a bırakın; bu 3 modüllü senaryo, IBAN, tutar, referans ve alacaklı/borçlu bilgileri de dahil olmak üzere gerisini halleder.
  • "Make, mevcut bir faturadan İsviçre QR kodlu fatura oluşturabilir mi?" Evet. PDF4me'nin İsviçre QR fatura oluşturma modülü aracılığıyla. Çıktı, seçtiğiniz sayfaya (ilk/soyad/belirli) ödeme makbuzunun eklendiği aynı PDF dosyasıdır.
  • "Excel şablonuna veya QR kod kütüphanesine ihtiyacım var mı?" Hayır. Modül, tüm QR kod oluşturma, mod-10 referans matematiği ve İsviçre Ödeme Standartları düzenini tek bir yapılandırılabilir adımın arkasına gizler.
  • "Eğer elimde mevcut bir fatura PDF'i yoksa, yine de bağımsız bir QR fişi oluşturabilir miyim?" Evet. Dosya grubunu tamamen atlayın ve modül bağımsız bir İsviçre QR fatura PDF'si döndürsün.
  • "İsviçre bankaları bu çıktıyı gerçekten kabul edecek mi?" Bu modül, ISO 20022 İsviçre Ödeme Standartlarına uygun bir ödeme belgesi üretir. Her İsviçre bankasının mobil bankacılık uygulaması, ödeme başlatmak için bu belgeyi tarayabilir.

Ne inşa ediyorsunuz?​

Yeniden kullanılabilir 3 modüllü bir Make senaryosu. Tetikleyici çalışır (manuel, planlı, dosya izleme, herhangi biri), kaynak fatura çekilir, İsviçre QR faturası eklenir ve çıktı kaydedilir. Aynı model, tek seferlik testler, planlı toplu çalıştırmalar veya tamamen olay odaklı fatura işleme için de geçerlidir.

Senaryo tuvali oluşturun: PDF4me'ye bağlı Dropbox Dosya İndir (zamanlanmış zamanlayıcı rozetiyle) İsviçre QR faturası oluştur, bu da Dropbox Dosya Yükle'ye bağlı. Standart Noktalı Çizgi Bağlantılarıyla birbirine bağlı üç büyük dairesel modül simgesi.

Uçtan uca üç modül. Dropbox 1'deki saat simgesi, planlanmış bir tetikleyiciyi gösterir. Kullanım durumunuza uyacak şekilde manuel veya webhook'a geçin.

İhtiyacınız olan şey​

  • Yapmak Senaryo açık olan hesap. Make hesabı oluşturun İhtiyacınız varsa.
  • PDF4me API anahtarı. API anahtarınızı alın PDF4me bağlantı istediğinde ekleyin. Bkz. PDF4me'yi Oluşturmak İçin Bağlayın.
  • Dropbox Kaynak klasörüyle birlikte (örneğin, /pdf4metest/Dosyalar/) ve bir çıktı klasörü (/pdf4meoutput/Herhangi bir depolama çözümü aynı şekilde çalışır. İhtiyacınıza göre Google Drive, OneDrive veya SharePoint ile değiştirebilirsiniz.
  • Fatura PDF'si (ekran görüntüleri kullanılıyor) 10 sayfa.pdfİsteğe bağlı: Kaynak dosyayı atlayın ve yalnızca ödeme verilerinden bağımsız bir QR fişi oluşturun.
  • İsviçre ödeme verileri: A CH veya LI IBAN, miktar, para birimi (CHF veya EUR), ve alacaklı + borçlu adı/adres blokları. Tam alan referansı şurada yer almaktadır: eylem belgeleri.

Senaryoyu oluşturun​

Modül 1: Dropbox - Dosya İndirme​

Kaynak faturayı giriş klasörünüzden çıkarın.

AlanBu çalıştırmada kullanılan değer
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Files/10 page.pdf
Dropbox Dosya İndirme yapılandırmasını oluşturun. Bağlantı YnooxTestone olarak ayarlandı. Dosya seçme yöntemi Dosya Seç olarak ayarlandı. Dosya yolu /pdf4metest/Files/10 page.pdf olarak ayarlandı. Altta İptal ve Kaydet düğmeleri bulunuyor.

Dropbox Dosya İndirme yapılandırması. Dosyayı yol seçici aracılığıyla seçin veya toplu işlem için şunu kullanın: Dosyaları ara ve dosyayı dinamik olarak bağlayın.

Modül 2: PDF4me - İsviçre QR faturası oluşturma​

Arama PDF4me ve seç İsviçre QR faturası oluşturunBu modül 26 alanı kullanıma sunmaktadır. Her alanın tam referansı (5 detaylı kullanıcı arayüzü ekran görüntüsü ve Var Schneider AG, CH4431999123000889012, Pia-Maria Rutschmann-Schnyder gibi örnek değerlerle birlikte) şu adreste bulunmaktadır: Make uygulamasında SwissQR faturası oluşturun. Eylem sayfası. Ayarlanması gereken minimum değerler:

GrupAlanDeğer
SourceFileDropbox - Download a File (pulls from Module 1 automatically)
OutputFormat TypePDF
OutputPaging OptionsFirst (also: Last, or a specific 1-based page number)
PaymentCurrencyCHF (or EUR)
PaymentReference TypeQRR, SCOR, or NON
PaymentLanguageEnglish / German / French / Italian
PaymentSeparator LineLine With Scissor, Only Line, or No Line
PaymentAmounte.g. 1250.00
PaymentIBANCH or LI IBAN, max 21 chars
CreditorCreditor Address TypeS (Structured) or K (Combined)
CreditorCreditor NameCompany name on the account
DebtorUltimate Debtor AddressTypeS or K

Adres Türü seçiminize göre alacaklı ve borçlu adres alanlarını doldurun, ardından isteğe bağlı Referans / Yapılandırılmamış Mesaj / Faturalama Bilgisi / AV1 / AV2 Parametrelerini ekleyin.

Modül 3: Dropbox - Dosya Yükleme​

Oluşturulan PDF dosyasını çıktı klasörüne yazın.

AlanBu çalıştırmada kullanılan değer
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection as Module 1
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name6. Name (dynamic content from PDF4me Module 2)
Data6. Document (dynamic content from PDF4me Module 2)
Dropbox'a Dosya Yükleme yapılandırması oluşturun. Bağlantı YnooxTestone. Klasör /pdf4meoutput/. Dosya Harita olarak ayarlandı. Dosya Adı 6. Ad'a (PDF4me İsviçre QR faturası oluşturma bölümünden) bağlandı. Veri 6. Belge'ye bağlandı. İpucu şöyle diyor: Dosya adı, uzantısı dahil, örneğin invoice.xml.

Dosya radyosu şu şekilde ayarlandı: Harita Dosya Adı ve Veriyi ayrı yuvalar olarak gösterir. Her ikisini de PDF4me Modül 2 çıktılarına bağlayın, böylece doldurulmuş PDF dosyası bozulmadan kaydedilir.

Kaydet ve tıkla Bir kez çalıştırOluşturulan fatura şu adreste görünecektir: /pdf4meoutput/ birkaç saniye içinde.

Get your API KeyFull action reference

Çıktı klasörüne ne kaydediliyor?​

Kaynak dosyanın adıyla adlandırılmış tek bir PDF dosyası (örneğin, 10 page.pdfİsviçre QR fatura sayfası, seçilen konuma yerleştirilerek Sayfalama Seçenekleri (First Bunu yeni 1. sayfa olarak koyuyor; Last (Sonuna ekler). Dosyayı herhangi bir PDF görüntüleyicide açın ve QR fatura bölümünde ödeme QR kodu, insan tarafından okunabilir Hesap/Ödenecek Kişi bilgileri, Tutar, Para Birimi, Referans ve alacaklı/borçlu adresleri gösterilir. Bir İsviçre bankacılık uygulamasını QR koduna yönlendirin ve ödeme otomatik olarak doldurulacaktır.

Hızlı referans: temel parametreler​

IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Currency
CHF or EUR only. Anything else is rejected by the Swiss Payment Standards.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON. Pick once, fill Reference accordingly.
Address Type
S = structured (separate PostalCode + City). K = combined (full address in two AddressLines).
Paging Options
First, Last, or a 1-based page number. Decides where the QR-bill page lands.
AV1 / AV2
Alternative scheme parameters for eBill and similar. Format: Name AV1: UV;value;id.

Sorun giderme​

QR-bill page is blank or the QR code is unreadable
The IBAN is invalid (must start with CH or LI, max 21 chars) or the Currency was something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Reference Type QRR but the bank rejects the reference
QRR references must be 27 digits with a mod-10 check digit. If you do not have one, switch Reference Type to SCOR (ISO 11649) or NON and leave Reference empty.
QR-bill landed on the wrong page
Adjust Paging Options. First puts the slip as the new page 1. Last appends it after the last page. Or pass a 1-based page number to insert at that position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With type S, fill PostalCode + City and use AddressLine1/2 for street. With type K, leave PostalCode + City empty and put the full address into AddressLine1 + AddressLine2.
Upload writes a zero-byte file
File Name or Data in the Upload module is not bound to the PDF4me Module 2 outputs. Click the field and re-pick the dynamic content from Module 6 (PDF4me Create Swiss QR-bill).
Want a standalone QR slip without an invoice
Skip the source file entirely. Remove Dropbox Module 1, or leave the File group empty in the PDF4me module. The output is a standalone Swiss QR-bill PDF.

Bu deseni ne zaman kullanmalısınız?​

Outgoing customer invoices
Bills that need to be Swiss-payable directly from a banking app via QR scan.
Subscription billing
QR-IBAN + 27-digit QRR reference identifies the customer or contract on every recurring run.
Bulk invoice retrofitting
When an existing PDF invoice template does not yet carry the payment slip. Append it via this scenario.
e-Bill replacements / fallbacks
For customers who prefer paper or in-app QR-scan over the electronic Bill flow.

Sırada ne okumalıyım?​

SSS​

Do I need a special Swiss QR library or font?+
No. The PDF4me Create Swiss QR-bill module bundles QR-code generation, the QR-bill fonts (Liberation Sans), the mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, click Run, and the output is a Swiss-compliant PDF.
What is the difference between QRR, SCOR, and NON references?+
QRR is the Swiss 27-digit numeric reference with a mod-10 check digit; it requires a QR-IBAN. SCOR is the international ISO 11649 creditor reference; it works with a standard IBAN. NON means no reference is shown on the slip. useful for ad-hoc one-off payments where the debtor adds their own reference at payment time.
Can I generate a Swiss QR-bill without an existing PDF invoice?+
Yes. Skip the File group in the PDF4me module and the output is a standalone Swiss QR-bill PDF (just the payment slip, no invoice body). Useful when the debtor only needs the slip, or when your invoice body comes from a different source.
My IBAN starts with DE / FR / IT. can I still use this?+
No, Swiss QR-bills are scoped to CH and LI IBANs only. For European SEPA payments with non-Swiss IBANs, use the Generate EPC QR Code for SEPA module instead.
Address Type S vs K. which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; AddressLine1/2 carries the street. K (Combined) puts the full address in two free-text AddressLine fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data that does not separate postal code and city.
Does the output PDF work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (which is all of them since 2022) can scan the output to pre-fill the payment form. Test by opening UBS, PostFinance, Raiffeisen, or any Swiss banking app and scanning the QR code on the printed or on-screen slip.
How do I change where the QR-bill page lands?+
Set Paging Options. First puts the slip as the new page 1 of the output PDF, Last appends it to the end, or pass a 1-based page number to insert it at that position. Page indexing starts at 1.
Same scenario in n8n, Zapier, or Power Automate?+
Yes. The same PDF4me Create Swiss QR-bill action is available on all four platforms with identical parameters. See the cross-platform comparison at the bottom of the Create SwissQR Bill action page.

Başlayın​

Get your API KeyPDF4me on MakeAction reference