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

SwissQR kodunu okuyun. Zapier

SwissQR kodunu okuyun bir Zapier eylem tarafından PDF4me İsviçre'yi deşifre eden QR-faturanın içine gömülü PDF ve alacaklıya, borçluya geri döner, IBANMiktar ve referans verileri olarak JSONFaturaları otomatik olarak yeniden adlandırmak, ödemeleri muhasebe kayıtlarıyla eşleştirmek veya belgeleri tutar veya referans numarasına göre manuel veri girişi yapmadan yönlendirmek için kullanabilirsiniz.

İlgili Blog Yazıları(1)

Bu eylemin yaptığı şey

PDF4me SwissQR kodunu okuyun bir tane alır PDF içeren bir İsviçre QR-fatura (QR-Fatura) ve yapılandırılmış ödeme verilerini bir Zap içinde döndürür. Haritala Dosyave eylem geri döner Belge Metni, A JSON dize ile IBANAlacaklı, nihai alacaklı, borçlu, tutar, para birimi ve referans alanları. Bunu bir Kod ile ayrıştırın. Zapier Faturaların yeniden adlandırılmasını, ödemelerin eşleştirilmesini veya muhasebe otomasyonunu sağlamak için atılacak adım.

Kimliğinizi Doğrulama API Rica etmek​

Erişmek için PDF4me Web API başından sonuna kadar ZapierHer istekte geçerli kimlik doğrulama bilgileri bulunmalıdır.

Get your API Key

Kaçırmamanız Gereken Önemli Bilgiler​

Belge metni bir JSON dize, tek tek alanlar değil
Bu işlem tek bir alan döndürür. Belge Metniçözümlenmiş yükün tamamını tutarak JSON Dize. Bir koda ihtiyacınız var. Zapier (JavaScript Çalıştır) adım JSON.parse bireysel değerleri eşleştirmeden önce, IBAN veya ud_Name.
Alan adları cr_/ucr_/ud_ öneklerini kullanır.
cr_ alacaklıdır, ucr_ nihai alacaklıdır (genellikle boş bırakılır) ve dışarı_ İsviçre Ödeme Standartlarına uygun olarak nihai borçludur (SPCAlan adlandırması. cr_Adı Ve ud_Name İş akışlarının çoğunun kullandığı iki alan bunlardır.
Orijinal dosyayı kullanın. PDF, bu eylemin çıktısı değil
SwissQR Code'un döndürdüğü veriler hakkında bilgi edinin. PDFBu, testi geçmiyor. PDF Kendi kendine devam ediyor. Referans vermeye devam edin. Dosya Dosya yükleme, e-posta veya depolama adımlarından herhangi birinin tetikleyicisinden.
Zapier SwissQR Kodunu Oku eylemi Kurulum eylem paneli, Dosya gerekli ve Dosya Adı isteğe bağlı alanlarını göstermektedir.

Eylem paneli kurulumu: Sadece Dosya alanı zorunludur, Dosya Adı alanı isteğe bağlıdır.

Parametreler​

Gereklidir Zapier UI: Dosya. Dosya adı isteğe bağlıdır.

ParametreGerekliNe işe yarar?Örnek
FileRequiredThe PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.1. File
File NameOptionalName for the response file. If left blank, the name is picked from the source URL.invoice.pdf

Çıktı​

Bu işlem dosya meta verilerini ve bir adet veri alanı döndürür. Belge Metni, A JSON Dizeyi ayrıştırarak her bir İsviçreliye ulaşın. QR-Tablonun altında listelenen fatura alanları.

AlanTipİçeriğinde neler var?
File NameStringName of the generated response file, from File Name or picked from the source URL.
File ExtensionStringExtension of the response file, .json.
Full File NameStringComplete filename including extension.
File Alternate UrlStringURL to the generated JSON response file.
Document IdStringUnique identifier for this processing run.
File SizeNumberSize of the response file in bytes.
Doc TextString (JSON)The decoded Swiss QR-bill payload as a JSON string. Parse it to reach IBAN, creditor, debtor, amount, currency, and reference fields.

Belge Metin Alanları (sonrasında) JSON.parse)​

Alanİçeriğinde neler var?
QRType, Version, CodingTypeSwiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBANCreditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_CountryCreditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_CountryUltimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, CurrencyPayment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_CountryUltimate debtor (payer) name and address.
ReferenceType, ReferenceReference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfoFree-text payment message and structured billing information, when present on the bill.

SwissQR kodunu nasıl okuyabilirim? Zapier?​

  1. Eklemek PDF4me Zap'ınızda eylem uygulaması olarak şunu seçin ve belirleyin SwissQR kodunu okuyun.
  2. Bağlantınızı kurun. PDF4me Hesabınızı açın veya mevcut bir bağlantıyı seçin.
  3. Harita Dosya İsviçre'ye QR-fatura PDF Tetikleyicinizden veya önceki bir adımdan. İsteğe bağlı olarak eşleme yapın. Dosya adı.
  4. Adımı test edin ve inceleyin. Belge Metni Veri çıkışı panelinde, bu bir JSON sicim.
  5. Ekle Kodlayan: Zapier (JavaScript Çalıştır) Belge metnini alan ve çalıştıran adım JSON.parseve ihtiyacınız olan belirli alanı döndürür (ud_Name, cr_Adı, IBAN, Referans(veya diğerleri).
  6. Ayrıştırılan değeri haritaya dönüştüren Dosya Yükle (yeniden adlandırma için), bir Filtrele veya Yollar (Yönlendirme için) bir adım veya bir elektronik tablo/muhasebe işlemi.

İsviçre nedir? QR-Bill ve Neden Özel Bir Okuyucuya İhtiyaç Duyuyor?​

İsviçre QR-fatura (QR-Rechnung, 30 Eylül 2022'de eski turuncu ve kırmızı ödeme fişlerinin yerini alan ve İsviçre'de geçerli tek ödeme fişi formatı haline gelen İsviçre Ödeme Standartları formatıdır. Alacaklıyı, borçluyu, IBANmiktar ve referans verileri bir QR kod kullanarak SPC (İsviçre Ödeme Kodu) yapısı, genel bir barkodun veya QR Tarayıcı metni ham metin olarak okur ancak adlandırılmış alanlara eşleme yapamaz. SwissQR Code bu kodu çözer. SPC yapıyı oluşturur ve onu adlandırıldığı şekilde döndürür. JSON tarlalar.

Tipik Kurulumlar​

İş Akışı ÖrnekleriCommon Zapier patterns using Read SwissQR Code.
Faturaları borçlu adına göre otomatik olarak yeniden adlandır.
  1. Klasörde Yeni Dosya Oluşturma tetikleyicisi (Dropbox, Google Drive, SharePointİsviçre'de yeni bir ateş açılıyor. QR-fatura PDF.
  2. SwissQR kodunu, tetikleyici tarafından eşleştirilen Dosya ve Dosya Adı ile çalıştırarak Belge Metni döndürür.
  3. Bir Kod tarafından Zapier Bu adım, Doc Text'i ayrıştırır ve ud_Name'i (borçluyu) döndürür.
  4. Yüklenen dosya aynı şekilde kaydedilir. PDF Dosyaların ödeme yapan kişiye göre aranabilmesi için, ayrıştırılmış isimle içerik oluşturulur.
Gelen ödemeleri muhasebe kayıtlarıyla eşleştirin
  1. Bir e-posta veya klasör tetikleyicisi İsviçre usulü bir teslimat gerçekleştirir. QR-fatura PDF.
  2. SwissQR Code, Doc Text'ten kod özetlerini okuyarak kodu çıkarır. Zapier adım ayrıştırmaları IBANMiktar ve Referans.
  3. Muhasebe sisteminde (QuickBooks, Xero veya özel bir veritabanı) bir arama adımı, Referansı açık bir faturayla eşleştirir.
  4. Sonraki adımda fatura ödenmiş olarak işaretlenir ve işlem kaydedilir.
Miktar veya referans türüne göre rota
  1. SwissQR Code, gelen bir fatura üzerinde çalışır ve Belge Metni döndürür.
  2. Bir Kod tarafından Zapier Bu adım, Miktar ve ReferansTürü'nü ayrıştırır.
  3. Paths adımı, yüksek değerli ödemeleri manuel onay kuyruğuna yönlendirir ve QRR-Otomatik kayıt işlemine yönlendirilen ödemeler.

Pratik İpuçları​

Doc Text always needs a parse step
There is no built-in field mapping for individual Swiss QR-bill values. Budget for a Code by Zapier step in every Zap that uses this action.
cr_ vs ud_ vs ucr_ is easy to mix up
cr_ is the creditor (who gets paid), ud_ is the ultimate debtor (who is paying), ucr_ is the ultimate creditor and is usually blank. Double-check which prefix your workflow actually needs.
ReferenceType tells you the reference format
QRR means a 27-digit QR reference, SCOR means a Creditor Reference (ISO 11649), NON means no structured reference, only UnstructuredMessage. Branch your parsing logic on ReferenceType if you support more than one format.
Amount can be null for open-amount bills
Some Swiss QR-bills are issued without a fixed Amount, letting the payer enter it. Handle a null or missing Amount in your Code by Zapier step rather than assuming it is always present.
The action reads, it does not validate compliance
This action decodes whatever SPC data is embedded in the QR code. It does not certify Swiss banking regulatory compliance, that responsibility stays with however the bill was originally issued.

Kopya Kağıdı​

AlanDeğer
ActionRead SwissQR Code
FileRequired, Swiss QR-bill PDF
File NameOptional
Output payloadDoc Text (JSON string)
Common parsed fieldsIBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step neededCode by Zapier, JSON.parse(Doc Text)
Counterpart actionCreate SwissQR Bill (generates the QR-bill instead of reading it)

Sıkça Sorulan Sorular​

What does Read SwissQR Code actually return?+
The action returns Doc Text, a JSON string containing the decoded Swiss QR-bill fields: QRType, Version, CodingType, IBAN, creditor fields (cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country), ultimate creditor fields (ucr_*), Amount, Currency, ultimate debtor fields (ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country), ReferenceType, Reference, UnstructuredMessage, and BillingInfo. It also returns file metadata (File Name, File Extension, Full File Name, File Alternate Url, Document Id, File Size) for the generated JSON response file.
Do I need a separate step to parse the output?+
Yes. Doc Text is a single JSON string, not individually mapped fields. Add a Code by Zapier (Run JavaScript) step, run JSON.parse on the Doc Text value, and return the specific field you need such as data.ud_Name or data.IBAN so later steps in the Zap can map it directly.
What is the Swiss QR-bill and why does it need a special reader?+
The <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/qr-bill.html" target="_blank" rel="noopener noreferrer">Swiss QR-bill (QR-Rechnung)</a> is the Swiss Payment Standards format that became the only valid Swiss payment slip on 30 September 2022. It encodes structured payment data (IBAN, creditor, debtor, amount, reference) inside a QR code using the SPC data format, a fixed field order that a generic barcode or QR scanner cannot parse into named fields without knowing that structure.
Can I use the extracted data to rename or route the PDF?+
Yes. A common pattern parses Doc Text for ud_Name (debtor) or cr_Name (creditor) and uses that value as the filename in an Upload File step, or checks Reference or Amount in a Filter or Paths step to route the invoice. Use the original File field from your trigger for the file content, this action's output only carries data, not the PDF. See <a href="https://www.iso20022.org/" target="_blank" rel="noopener noreferrer">ISO 20022</a> for background on the structured payment messaging standard the Swiss QR-bill builds on.

İlgili Eylemler​

Sektör Kullanım Örnekleri ve Uygulamaları​

  • Ödeme İşlemiOtomatik ödeme işlemleri ve işlem yönetimi için SwissQR kodlarını okuyun.
  • İşlem YönetimiÖdeme verilerini çıkararak kapsamlı işlem süreçlerini ve mutabakatını gerçekleştirin.
  • Uyumluluk RaporlamasıÇözümlenmiş referans ve miktar verilerini dahili denetim izleme kayıtlarına aktarın.
  • Müşteri HizmetleriMüşteri ödemelerini ve sorularını otomatik SwissQR kod tanıma sistemiyle işleyin.

Yardım Alın​

Zapier IntegrationGet your API KeyZapier Documentation