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

Power Automate'te Herhangi Bir Fatura PDF'ine İsviçre QR Faturası Ekleme: 4 Adımlı Dropbox İş 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. Power Automate ve PDF4me ile bu ekleme yapılabilir. dört aşamalı akış: Dropbox'ı manuel olarak tetikleyin Dosya içeriğini alPDF4me Barkod - SwissQR Faturası OluşturmaDropbox Dosya oluşturAşağıdaki ekran görüntüleri, tuvalde yakalanan işlemin adım adım nasıl gerçekleştiğini göstermektedir. 10 sayfalık bir fatura /pdf4metest/sample Ödeme makbuzu eklenerek İsviçre mevzuatına uygun bir fatura haline gelir ve yüklenir. /pdf4meoutput Benzersiz bir dosya adıyla. 10 dakikadan kısa sürede üretime hazır.

Akışa genel bakış
1. Manually trigger a flow
Manual trigger for testing. Swap for SharePoint When a file is created or any storage trigger in production.
2. Dropbox Get file content
Reads the 10-page invoice from /pdf4metest/sample/10 page.pdf with Infer Content Type Yes.
3. PDF4me Barcode - Create SwissQR Bill
Appends the QR payment slip with CHF, QRR reference, English labels, custom Paging Options to land on page 3.
4. Dropbox Create file
Writes the populated PDF to /pdf4meoutput with a unique guid()+headers/FileName so re-runs do not collide.
kısa versiyon

Dört Güçlü Otomasyon eylemi. Manuel tetikleme, akışı başlatır. Dropbox Dosya içeriğini al okur /pdf4metest/sample/10 page.pdf İçerik türünü çıkar seçeneği Evet olarak ayarlanmış. PDF4me Barkod - SwissQR Faturası Oluşturma İsviçre Ödeme Standartlarına uygun bir QR fatura sayfası ekler (Çıktı Biçimi Türü) PNG Bu çalıştırmada; şuna geçin PDF Hibrit çıktı için, IBAN CH4431999123000889012, Miktar 5253531, Para birimi CHFReferans Türü QRR, Dil İngilizceAyırıcı Çizgi Makasla ÇizgiAlacaklı: Var Schneider AG, Nihai Borçlu: Pia-Maria Rutschmann-Schnyder, Referans 210000000003139471430009017Sayfalama Seçenekleri gelenekSayfa Numarası 3, Dosya adı abc.pdfDropbox Dosya oluştur yazıyor /pdf4meoutput Dosya adı şu şekilde oluşturulmuştur: kılavuz() + başlıklar/DosyaAdı Benzersizlik için. Çıktı, arşiv klasöründe İsviçre bankası tarafından taranabilir bir dosyadı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ü değiştirin. 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:

  • "Power Automate'te PDF faturama otomatik olarak İsviçre QR kodlu faturayı nasıl eklerim?" Bu 4 aşamalı işlem akışı şu şekilde çalışır: PDF dosyasını Dropbox'a bırakın, işlem akışını tetikleyin, QR kodlu fatura dosyası çıktı klasörüne yerleşsin.
  • "Power Automate mevcut bir faturadan İsviçre QR kodlu fatura oluşturabilir mi?" Evet, PDF4me Barkod - SwissQR Fatura Oluşturma işlemi aracılığıyla. Çıktı, fişin ilk/son/belirli bir sayfaya eklenmiş haliyle aynı PDF dosyasıdır.
  • "QR kod kütüphanesine veya İsviçre QR kod oluşturucu aboneliğine ihtiyacım var mı?" Hayır. PDF4me işlemi, QR kod oluşturmayı, mod-10 referans matematiğini ve İsviçre Ödeme Standartları'nın tam düzenini tek bir Power Automate adımının arkasına gizler.
  • "Eğer elimde kaynak PDF dosyası yoksa, bağımsız bir QR kod oluşturabilir miyim?" Evet. Gelişmiş parametreler altındaki Dosya İçeriği ve Dosya Adı alanlarını atlayın; işlem, seçilen Çıktı Biçimi Türünde (PDF / PNG / JPEG / Tiff) bağımsız bir QR faturası döndürür.
  • "İsviçre bankaları bu çıktıyı kabul edecek mi?" Bu işlem, 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 4 aşamalı bir Power Automate akışı. Tetikleyici çalışır, kaynak fatura Dropbox'tan (veya SharePoint / OneDrive / Outlook'tan) çekilir, PDF4me eylemi QR kodlu faturayı ekler ve doldurulmuş dosya GUID önekli bir adla yüklenir. Aynı model, giden müşteri faturaları, planlanmış toplu işlemler veya olay odaklı alacak işlemleri için de geçerlidir.

Dört işlem içeren Power Automate akış tuvali: Akışı manuel olarak tetikleme, Dropbox'tan dosya içeriğini alma, Barkod - SwissQR faturası oluşturma, Dropbox'tan dosya oluşturma.

Yukarıdan aşağıya dört işlem. Manuel tetikleyici, akışın test edilmesini kolaylaştırır; üretimde herhangi bir depolama tetikleyicisiyle değiştirilebilir.

İhtiyacınız olan şey​

  • Güç Otomasyonu Akışı açık olan hesap. Open Power Automate.
  • PDF4me API anahtarı. API anahtarınızı alınİşlemi ilk kez başlattığınızda PDF4me Connect bağlantısına giriş yapın.
  • Dropbox Kaynak klasörüyle birlikte (örneğin, /pdf4metest/örnek) ve bir çıktı klasörü (/pdf4meoutputHerhangi bir depolama çözümü işe yarar: SharePoint, OneDrive veya Dataverse aynı şekilde eşlenir.
  • Fatura PDF'si. 10 sayfalık örnek dosyayı indirin. Ekran görüntülerinde kullanılan yöntem, olayları tam olarak takip etmenizi sağlar.
  • İ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.

Hızlı referans: temel parametreler​

Output Format Type
PDF (hybrid), PNG / JPEG / Tiff (standalone images).
IBAN
CH or LI prefix, max 21 chars. QR-IBAN required for QRR references.
Reference Type
QRR (27-digit + mod-10), SCOR (ISO 11649), or NON.
Address Type
S = structured (separate Postal Code + City). K = combined.
Paging Options
first, last, add at end, or custom (uses Page Number). PDF only.
Page Number
1-based page index. Required only when Paging Options is custom.

Akışı oluşturun​

Eylem 1: Akışı manuel olarak tetikleyin​

Manuel tetikleme, test etmenin en hızlı yoludur. Üretimde bunun yerine manuel tetikleme kullanılır. Dropbox Bir dosya oluşturulduğunda, SharePoint'te bir dosya oluşturulduğunda, OneDrive'da bir dosya oluşturulduğunda, Outlook Yeni bir e-posta geldiğinde, Tekrarlama, veya Web kancaları AR işlem hattınıza bağlı olarak.

2. Adım: Dropbox - Dosya içeriğini al​

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

AlanBu çalıştırmada kullanılan değer
File/pdf4metest/sample/10 page.pdf
Infer Content TypeYes
Power Automate Dropbox Dosya içeriğini alma işlemi, Dosya /pdf4metest/sample/10 page.pdf ve Gelişmiş parametre İçerik Türünü Çıkar Evet ile birlikte kullanılır.

3. Adım: PDF4me Barkod - SwissQR Faturası Oluşturma​

Arama PDF4me ve seç Barkod - SwissQR Faturası OluşturmaBu işlem, ana paneldeki ödeme alanlarını ve Gelişmiş parametreler altındaki 4 alanı (Sayfalama Seçenekleri, Sayfa Numarası, Dosya İçeriği, Dosya Adı) ortaya çıkarır. Yapılandır:

GrupAlanDeğer
OutputOutput Format TypePNG
PaymentIBANCH4431999123000889012
PaymentAmount5253531
PaymentCurrencyCHF
PaymentReference TypeQRR
PaymentLanguage TypeEnglish
PaymentSeperator LineLineWithScissor
CreditorCreditor NameVar Schneider AG
CreditorCreditor Address TypeS
CreditorCreditor: Address Line 1Var Schneider AG
CreditorCreditor: Address Line 223
CreditorCreditor PostalCode2501
CreditorCreditor Citybiel
DebtorUltimate Debtor NamePia-Maria Rutschmann-Schnyder
DebtorUltimate Debtor AddressTypeS
DebtorUltimate Debtor: Address Line 1Grosse Marktgasse
DebtorUltimate Debtor: Address Line 233
DebtorUltimate Debtor PostalCode9400
DebtorUltimate Debtor Citybiel
Ref/MsgReference210000000003139471430009017
Ref/MsgUnstructured MessageInstruction of 15.09.2019
Ref/MsgBilling InfoS1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
Ref/MsgAV1 ParametersName AV1: UV;UltraPay005;12345
Ref/MsgAv2 ParametersName AV2: XY;XYService;54321
AdvancedPaging Optionscustom
AdvancedPage Number3
AdvancedFile ContentFile Content (from Action 2)
AdvancedFile Nameabc.pdf

4. Adım: Dropbox - Dosya Oluştur​

Oluşturulan dosyayı çıktı klasörüne kaydedin. Benzersiz bir dosya adı oluşturun. guid() Böylece tekrarlanan yayınlar çakışmaz.

AlanBu çalıştırmada kullanılan değer
Folder Path/pdf4meoutput
File Nameguid() + headers/FileName (concat expression for a unique-per-run name)
File ContentFile Content (from Action 3, dynamic content)
Power Automate Dropbox Dosya Oluşturma eylemi, Klasör Yolu /pdf4meoutput, Dosya Adı (guid() + headers/FileName ifadesinden oluşturulmuş) ve Dosya İçeriği (PDF4me İsviçre QR Faturası Oluşturma eyleminden gelen dinamik içerik) ile birlikte kullanılır.

O kılavuz() Dosya Adı'ndaki ifade, her çalıştırmada benzersiz bir ad garanti eder. Bunu yanına bırakmak... başlıklar/DosyaAdı PDF4me çıktısı, dosya adında orijinal fatura adını korur.

Kaydet ve tıkla Testİsviçre bankası tarafından taranabilir dosya şuraya düşüyor: /pdf4meoutput.

Get your API KeyFull action reference

Sorun giderme​

QR-bill page is blank or unreadable
IBAN is invalid (must start with CH or LI, max 21 chars) or Currency is something other than CHF / EUR. Both are hard requirements of the Swiss Payment Standards.
Bank rejects a QRR 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 under Advanced. first puts the slip as the new page 1. last appends it after the last page. custom uses Page Number for a specific 1-based position.
Creditor or Debtor address looks wrong on the slip
Mismatched Address Type. With S, fill Postal Code + City and use Address Line 1/2 for street. With K, leave Postal Code + City empty and put the full address into Address Line 1 + Address Line 2.
Create file writes an empty file
File Content on Action 4 is not bound to the PDF4me File Content output. Click the field and re-pick the dynamic content from Action 3.
Want a standalone QR slip without a source invoice
Skip Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters and the action returns a standalone Swiss QR-bill in the chosen Output Format Type.

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.
e-Bill fallbacks
For customers who prefer paper or in-app QR-scan over electronic Bill.

Sırada ne okumalıyım?​

SSS​

Do I need a special Swiss QR library or font?+
No. The PDF4me Create SwissQR Bill action bundles QR-code generation, the QR-bill fonts (Liberation Sans), mod-10 reference math, and the Swiss Payment Standards layout. Configure the fields, save the flow, and the output is a Swiss-compliant file.
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 Action 2 (Get file content). On Action 3, leave File Content and File Name empty under Advanced parameters; the action returns a standalone Swiss QR-bill in the chosen Output Format Type (PDF, PNG, JPEG, or Tiff).
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 action instead.
Address Type S vs K, which one should I pick?+
S (Structured) is the modern default: PostalCode and City go in separate fields; Address Line 1/2 carries the street. K (Combined) puts the full address in two free-text Address Line fields and ignores PostalCode/City. New integrations should use S unless you are importing legacy data.
Does the output work with mobile banking apps?+
Yes. Every Swiss bank app that supports payments via QR-bill (every major bank 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.
How do I change where the QR-bill page lands?+
Click Show all on Advanced parameters. Set Paging Options to first / last / add at end / custom. For custom, also fill Page Number with the 1-based page index. Only applies when Output Format Type is PDF.
Same scenario in Make, Zapier, or n8n?+
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 ConnectAction reference