SwissQRコードを読み取る Zapier

SwissQRコードを読み取る は Zapier アクション PDF4me スイスの暗号を解読する QR-法案は PDF 債権者、債務者に返還し、 IBAN量、および参照データとして JSONこれを使用すると、請求書の自動名前変更、支払いと会計記録の照合、金額や参照番号による文書のルーティングなどを、手動でのデータ入力なしで行うことができます。

関連ブログ記事(1)

DropboxにスイスのQRコードが溜まっていませんか？ZapierのCode by Zapierを使って自動的に名前を変更しましょう。

ZapierでスイスQRコード付き請求書PDFの自動リネーム：フォルダに新規ファイルを作成 → PDF4meでスイスQRコードを読み取り → Zapierでコードを取得（JSONを解析し、債務者/債権者を抽出）→ ファイルをアップロード。ファイル検索の手順は不要です。Dropboxのスクリーンショット付きで手順を詳しく解説。SharePoint、Google Driveにも対応しています。

投稿を読む →

このアクションが何をするか

PDF4me SwissQRコードを読み取る 1つ取る PDF を含む スイス QR-請求書 （QR-請求書） そして、Zap 内に構造化された支払いデータを返します。 ファイルアクションが戻ります ドキュメントテキスト、 JSON 文字列 IBAN、債権者、最終債権者、債務者、金額、通貨、および参照フィールド。コードを使用して解析します。 Zapier 請求書の名称変更、支払いの照合、または会計の自動化を推進するためのステップ。

認証 API リクエスト

アクセスするには PDF4me ウェブ API を通して Zapierすべてのリクエストには、適切な認証情報を含める必要があります。

Get your API Key

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

ドキュメントテキストは JSON 文字列であり、個々のフィールドではない

このアクションは1つのフィールドを返します。 ドキュメントテキスト復号化されたペイロード全体を JSON 文字列。コードが必要です。 Zapier (JavaScript を実行) ステップ JSON.parse 個々の値をマッピングする前に、 IBAN または ud_Name。

フィールド名には cr_/ucr_/ud_ の接頭辞を使用します

cr_ 債権者は、 ucr_ 最終債権者（多くの場合空白）であり、 外_ スイス支払基準に準拠した最終債務者（SPC）フィールド名。 cr_Name そして ud_Name これらは、ほとんどのワークフローで使用される2つのフィールドです。

元のファイルを使用する PDFこのアクションの出力ではありません

SwissQRコードを読み取ると、データに関する PDF通過しない PDF それ自体が先へ進む。参照し続ける ファイル ファイルアップロード、メール送信、ストレージ保存などのステップのトリガーから実行します。

アクションパネルの設定：ファイルのみ必須、ファイル名は任意

パラメータ

必須 Zapier UI: ファイル。ファイル名は省略可能です。

パラメータ	必須	その機能	例
File	Optional	The PDF containing the Swiss QR-bill to decode. Map from your trigger or a previous step.	1. File
File Name	Optional	Name for the response file. If left blank, the name is picked from the source URL.	invoice.pdf
File URL (Either provide File or File URL)	Optional	Link to the PDF containing the Swiss QR-bill, as an alternative to File. Map a file URL from a previous step.

出力

このアクションはファイルメタデータと1つのペイロードフィールドを返します。 ドキュメントテキスト、 JSON 文字列。それを解析して個々のスイス人にアクセスします。 QR請求書の項目は、以下の表に記載されています。

分野	タイプ	内容物
documentId	Text	ID PDF4me gives the resulting document.
errorMessage	Text	Error message when PDF4me could not process the file; empty otherwise.
fileAlternateUrl	Text	Alternative download link of the resulting file, with the file name at the end of the URL.
fileExtension	Text	Extension of the resulting file, for example `.pdf`.
fileName	Text	Name of the resulting file, without extension.
fileUrl	Text	Download link of the resulting file. Map it into any later step that needs the file, for example an upload to Google Drive, Dropbox or OneDrive.
fullFileName	Text	Name of the resulting file, with extension.
jobId	Text	ID of the PDF4me job that processed the request.
traceId	Text	Trace ID of the request, when PDF4me returns one. Give it to PDF4me support when reporting a problem.
docText	Text	Billing data read from the Swiss QR code, as text returned by PDF4me.

ドキュメントテキストフィールド（後） JSON.parse)

分野	内容物
QRType, Version, CodingType	Swiss Payment Standards header data identifying this as an SPC QR payload and its version.
IBAN	Creditor IBAN the payment settles to.
cr_Name, cr_StreetOrAddressLine1, cr_PostalCode, cr_City, cr_Country	Creditor (biller) name and address.
ucr_Name, ucr_StreetOrAddressLine1, ucr_PostalCode, ucr_City, ucr_Country	Ultimate creditor fields, populated only when the creditor differs from the ultimate payee.
Amount, Currency	Payment amount and currency (CHF or EUR).
ud_Name, ud_StreetOrAddressLine1, ud_PostalCode, ud_City, ud_Country	Ultimate debtor (payer) name and address.
ReferenceType, Reference	Reference type (QRR, SCOR, or NON) and the reference number itself.
UnstructuredMessage, BillingInfo	Free-text payment message and structured billing information, when present on the bill.

SwissQRコードを読み取る設定方法 Zapier？

1. 追加 PDF4me Zap のアクション アプリとして選択し、 SwissQRコードを読み取る。
2. 接続 PDF4me アカウントを作成するか、既存の接続を選択してください。
3. 地図 ファイル スイスへ QR-請求書 PDF トリガーまたは前のステップから。必要に応じてマッピングします。 ファイル名。
4. ステップをテストして検査します ドキュメントテキスト データ出力パネルでは、 JSON 弦。
5. 追加する コード作成者 Zapier (JavaScriptを実行) ドキュメントテキストを受け取るステップを実行する JSON.parse、そして必要な特定のフィールドを返します（ud_Name、 cr_Name、 IBAN、 参照（またはその他）。
6. 解析された値をマップして ファイルのアップロード （改名のため） フィルター または パス ステップ（ルーティング用）、またはスプレッドシート／会計処理。

スイスとは何ですか QR-ビル、そしてなぜ特別な読者が必要なのか？

スイス人 QR-請求書 （QR-Rechnung) は、2022 年 9 月 30 日に唯一の有効なスイスの支払伝票となり、古いオレンジ色と赤色の支払伝票に取って代わったスイス支払標準フォーマットです。債権者、債務者、 IBAN、量、および内部の参照データ QR 使用するコード SPC （スイス決済コード）構造、一般的なバーコードまたは固定フィールドの順序 QR スキャナーは生のテキストとして読み取りますが、名前付きフィールドにマッピングできません。SwissQRコードを読み取ると、 SPC 構造体として返し、名前付きで返します。 JSON 分野。

典型的な構成

ワークフローの例Common Zapier patterns using Read SwissQR Code.

債務者名に基づいて請求書の自動名前変更を行う

1. フォルダー内の新しいファイル トリガー (Dropbox、Google Drive、 SharePoint）スイスの新国で発砲 QR-請求書 PDF。
2. SwissQRコードの読み取りは、トリガーからマッピングされたファイルとファイル名を使用して実行され、ドキュメントテキストを返します。
3. コード Zapier このステップはドキュメントテキストを解析し、ud_Name（債務者）を返します。
4. ファイルのアップロードは同じものを保存します PDF 解析された名前でコンテンツを構成することで、支払者ごとにファイルを検索できるようにします。

入金された支払いを会計記録と照合する

1. メールまたはフォルダのトリガーによりスイスが配信されます QR-請求書 PDF。
2. SwissQRコードから抽出したドキュメントテキストを読み取って、 Zapier ステップ解析 IBAN、金額、および参照番号。
3. 会計システム（QuickBooks、Xero、またはカスタムデータベース）の検索ステップでは、参照番号を未払いの請求書と照合します。
4. 次のステップとして、請求書が支払い済みとしてマークされ、取引が記録されます。

金額または参照タイプによる経路指定

1. スイスQRコード読み取り機能は、受信した請求書に対して実行され、ドキュメントテキストを返します。
2. コード Zapier ステップは、AmountとReferenceTypeを解析します。
3. パスステップでは、高額支払いを手動承認キューに分岐し、 QRR- 自動記帳への参照支払い。

実践的なヒント

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.

チートシート

分野	価値
Action	Read SwissQR Code
File	Required, Swiss QR-bill PDF
File Name	Optional
Output payload	Doc Text (JSON string)
Common parsed fields	IBAN, cr_Name, ud_Name, Amount, Currency, Reference
Parse step needed	Code by Zapier, JSON.parse(Doc Text)
Counterpart action	Create SwissQR Bill (generates the QR-bill instead of reading it)

よくある質問

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.

関連アクション

SwissQR紙幣を作成する

対応するアクションは、スイスを生成します QR-請求書 PDF から IBAN債権者と金額のデータを1つずつ読み込むのではなく、それらすべてのデータを表示します。

文書を分類する

受信データをソートする PDFs まずタイプ別に分け、次にスイスQRコードとして分類されたもののみに「Read SwissQR Code」を実行します。 QR法案。

ドキュメントを解析する

スイスの領収書のない請求書の場合 QR-請求書の場合、マッピングされた解析テンプレートを使用して明細項目とヘッダーデータを抽出します。

業界におけるユースケースとアプリケーション

Swiss Banking & Financial Services

• 支払い処理SwissQRコードを読み取ることで、自動決済処理と取引処理が可能になります。
• 取引管理: 包括的な取引処理と照合のために支払いデータを抽出します
• コンプライアンス報告: デコードされた参照データと金額データを内部監査証跡レコードにフィードする
• 顧客サービス: 自動SwissQRコード認識により、顧客の支払いと問い合わせを処理します。

Swiss Business & Professional Services

• 請求書処理請求書からSwissQRコードを読み取り、自動決済処理と会計処理を行います。
• クライアント管理顧客への請求および支払い追跡のために支払い情報を抽出します。
• 財務管理: 包括的な財務管理のためのSwissQRコード読み取りの自動化
• 文書自動化SwissQRコード読み取り機能を統合し、ビジネス文書処理を効率化します。

Swiss E-commerce & Retail

• 注文処理SwissQRコードを読み取ることで、注文処理と支払いの自動回収が可能になります。
• 支払い追跡: 注文と支払いの包括的な追跡のために支払いデータを抽出します
• 顧客体験: 自動化されたSwissQRコード処理により、顧客の決済体験を向上させます。
• 在庫管理支払いデータを在庫管理および注文処理と連携させる

Swiss Government & Public Sector

• 公共サービス政府サービスおよび公共部門の支払い処理のためのSwissQRコードを読み取る
• 税務行政税金支払いおよび政府手数料処理のための支払いデータを抽出します。
• 記録管理: 復号化された支払いデータを公共部門の会計のための内部記録管理システムに入力する
• デジタルサービスSwissQRコードの自動化により、公共部門の決済処理を近代化する

ヘルプが必要な場合

Zapier IntegrationGet your API KeyZapier Documentation