メインコンテンツへスキップ
PDF4me API統合AIとSDK知識ベース拡張機能APIテスターブログ

SwissQRコードを読み取る Make

SwissQRコードを読み取る は Make スイスの文字を読み取るモジュール QR コードから PDF 請求書を自動的に作成し、 QR-請求書 （QR（請求書）ペイロード： IBAN、金額、通貨（CHF/EUR）、債権者、債務者、および参照番号。これを使用して、スイスの請求書の買掛金と支払照合を自動化します。 Make 手動でのデータ入力は不要です。

このモジュールの機能

PDF4meSwissQRコードを読み取る スイスの QR-請求書 （QR-Rechnung) ペイロードは、どのペイロードからでも PDF 請求書は Make シナリオ。すべての支払いフィールドを構造化してすぐに使用できる状態で返します。 IBAN金額、通貨、債権者名と住所、債務者の詳細、参照番号、およびその他の請求情報などが含まれるため、請求書データを手動で読み取ったり入力したりすることなく、買掛金、照合、または支払い開始のワークフローを実行できます。

関連ブログ記事(1)

認証 API リクエスト​

毎 PDF4me モジュール Make 有効な 繋がり. 作成または選択して、 PDF4me API キーによりシナリオはスイスを認証できます QR リクエストを安全にデコードします。

Get your API Key

見逃してはならない重要な事実​

スイスの3つの参照タイプすべてがサポートされています。
このモジュールは以下を処理します QRR （27桁） QR 自動銀行照合に使用される参照情報） SCOR （ISO 11649 債権者照会）、 NON （参照なし）。出力の「参照タイプ」フィールドには、請求書で見つかったフォーマットが正確に表示されるため、後続の処理ロジックで各ケースを正しく処理できます。
QR コードはどのページでも自動的に見つかります
モジュールにスイスのページを指示する必要はありません QR コードが表示されます。 PDF そして QR請求書が1ページでも複数ページでも、自動的に請求処理を行います。つまり、複数ページの請求書も処理できます。 PDF事前分割やページ番号の設定なしで。
追加情報にはSwico S1会計データが含まれる場合があります
請求書発行者が Swico S1 構造化請求情報を含めた場合 QR ペイロードの場合、追加情報フィールドには非構造化メッセージテキストとともにそれが返されます。Swico S1には以下を含めることができます。 VAT 料金、支払い条件、会計参照など、コアとなる支払いフィールドを超える追加データで、自動化に役立つもの AP 予約。
PDF4meのSwissQRコード読み取りモジュールを作成し、接続をTestUser01に設定し、ファイルをステップ1でマッピングされたファイル名とドキュメントフィールドを持つマップに設定します。

ファイルは次のように設定されています Map ファイル名を渡して PDF 以前のモジュールからのバッファ。モジュールはすべてのページをスキャンし、完全なスイスの QR-請求書支払いペイロード。

パラメータ​

必須： 接続、ファイル名、およびドキュメントはすべて指定する必要があります。 PDF 有効なスイスの QR-モジュールが支払いデータを返すための請求書。

パラメータ必須その機能例
ConnectionRequiredPDF4me API connection. Click Add and paste your API key if connecting for the first time.Your PDF4me connection
FileRequiredHow the source PDF reaches the module. The radio lists your connected storage actions (for example Dropbox - Download a File) and Map. Choose Map to wire the fields below from earlier modules: File Name and Document only appear once Map is selected.Map
File NameRequiredSource PDF filename including the .pdf extension. Map from the prior module's file name output.swiss_invoice_2024.pdf
DocumentRequiredBinary PDF buffer from a prior module: cloud storage download (Dropbox, Google Drive, SharePoint), email attachment, or HTTP response. The PDF must contain a Swiss QR-bill on any page.1. Data

出力​

このモジュールは 3 つのフィールドを返し、それらはすべて後続のモジュールでマッピングに使用できます。請求データ自体はテキストとして届きます。 バーコードテキスト。

分野タイプ内容物
NameFile nameFile name of the processed document.
DocumentFile (binary data)Content (binary data) of the processed document.
Barcode TextTextThe billing data read from the Swiss QR code.

請求データの内容​

バーコードテキスト エンコードされた支払い値を保持します Swiss QR コード。そのテキストを下流で解析して、各値を個別に取得します。

価値タイプ内容物
IBANStringInternational Bank Account Number of the payee. 21-character Swiss IBAN starting with CH or LI.
AmountStringPayment amount as a string (e.g. "1250.00"). Convert to Number in Make if arithmetic is needed downstream.
CurrencyStringCHF or EUR. The Swiss Payment Standard allows only these two values.
CreditorObjectCreditor name, address type (K or S), street/PO box, building number, postcode, town, and country.
DebtorObjectDebtor (payer) name and address fields, same structure as Creditor. May be empty if the invoice omits debtor data.
ReferenceStringThe reference number: 27-digit QRR, ISO 11649 SCOR, or empty string for NON reference type.
Reference TypeStringQRR, SCOR, or NON. Identifies the reference format so your downstream logic can branch accordingly.
Additional InfoStringUnstructured message text and Swico S1 structured billing data (VAT rates, payment conditions, accounting codes) when included by the invoice issuer.

SwissQRコードを読み取る設定方法を教えてください Make？​

  1. 追加 PDF4me → SwissQRコードを読み取る あなたの Make シナリオ。
  2. 選択 繋がり （またはクリック） 追加 あなたと一緒に作成する API 鍵）。
  3. 地図 ファイル名 そして 書類 前のモジュールから: メール添付ファイルの監視、クラウドストレージのファイル取得、または HTTP ダウンロード。
  4. クリック 保存 そしてシナリオを実行します。出力フィールドは次のとおりです。 IBAN、 額、 通貨、 債権者、 債務者、 参照、 参照タイプ、 そして 追加情報: これらはすべて、下流モジュールにマッピングするために利用可能です。

スイスQRコード読み取りはいつ使用すべきですか？ Make？​

ワークフローの例Common Make scenario patterns using Read SwissQR Code.
スイスからの請求書に基づいて買掛金処理を自動化する
  1. メールウォッチは、スイスのサプライヤー請求書が届いたときに作動します。 QR請求書が届きます。
  2. SwissQRコードの抜粋を読む IBAN金額、参照番号、および債権者の詳細。
  3. 1 HTTP モジュールは支払いデータを会社の銀行または ERP API。
  4. Google スプレッドシートの行が作成され、請求書の参照番号、金額、債権者が記録されます。 AP 登録する。
入金された銀行支払いを未払い請求書と照合する
  1. 銀行取引明細書のダウンロード処理は、スケジュールされたトリガーによって毎日実行されます。
  2. Read SwissQR Codeは、照合されていない支払いごとに、対応する送信済み請求書から参照番号を抽出します。 PDF。
  3. 参照番号はデータベース内の未払い請求書記録と照合され、一致した請求書は自動的に支払い済みとしてマークされます。
  4. 要約メールが送信されます AR チームは、その日のマッチング済みおよび未マッチングの支払いを一覧表示しました。
債権者名で請求書を整理する QR データ
  1. Dropbox ウォッチ フォルダーは、新しいスイスの請求書が届いたときにトリガーされます PDF 受信トレイフォルダにドロップされます。
  2. SwissQRコードを読み取ると、債権者名と参照番号が抽出されます。 QR ペイロード。
  3. Googleドライブは、債権者用のフォルダを作成し（存在しない場合）、参照番号をファイル名として請求書をアップロードします。
  4. Slackの通知は、 AP 新しい請求書が提出され、承認準備が整ったことをチームに通知します。

よくある質問​

What is a Swiss QR-bill and which reference types does this module support?+
A Swiss QR-bill (QR-Rechnung) is the standardised Swiss invoice format defined by the <a href="https://www.six-group.com/en/products-services/banking-services/payment-standardization/standards/qr-bill.html" target="_blank" rel="noopener noreferrer">SIX Group Swiss Payment Standard</a> that replaced payment slips in 2020. It carries a machine-readable QR code encoding all payment fields. This module supports all three reference types defined in the Swiss Payment Standard: QRR (27-digit numeric QR reference for automatic bank matching), SCOR (ISO 11649 creditor reference), and NON (no reference number). The Reference Type output field identifies which was detected. For more on Make scenario setup, see the <a href="https://www.make.com/en/help/apps/pdf4me" target="_blank" rel="noopener noreferrer">Make PDF4me integration docs</a>.
Does it work on scanned Swiss invoices?+
Yes. The module processes both digitally generated PDFs and scanned paper invoices. For reliable QR extraction from scanned documents, a minimum resolution of 200 DPI is recommended. The module scans every page of the PDF automatically: you do not need to specify the page number where the QR-bill appears.
What currencies are supported?+
The Swiss Payment Standard defines exactly two valid currencies: CHF (Swiss Franc) and EUR (Euro). The Currency output field will always contain one of these two values as encoded in the QR payload.
What does the Additional Info field contain and is it useful for accounting?+
The Additional Info field returns two types of data: unstructured payment message text (a free-text note the invoice issuer has added) and Swico S1 structured billing information when present. Swico S1 can include VAT rates, payment conditions, and accounting reference codes: AP-relevant data that goes well beyond the core payment fields and is useful for automated invoice booking.
How do I use the extracted IBAN and amount to initiate a payment?+
Map the IBAN and Amount output fields into a banking integration module or HTTP request that connects to your payment gateway or ERP. You can also write them to a Google Sheet or database row as a pending payment record and route it through a manager approval workflow before the actual payment is triggered.

関連モジュール​

ヘルプが必要な場合​

Make IntegrationGet your API KeyMake Documentation