AirtableベースからスイスのQRコード付き請求書を作成、添付、メール送信する（PDF4me使用）
PDF4meでスイスのQRコード付き紙幣を作成 これは、支払いの詳細をスイスのQRコード付き請求書画像に変換するMakeモジュールです。Airtableベースに接続され、行から債権者、債務者、QR-IBANを読み取り、完成した伝票を添付ファイルとして同じレコードに戻し、債務者にメールで送信します。
Airtableで請求書を作成できるかと尋ねると、正直なところ、支払可能な請求書は作成できない、というのが答えです。Airtableは債権者、債務者、金額、QR-IBANを完璧に保持しますが、スイスのQR請求書は仕様が定められています。つまり、定義されたレイアウト、切り取り線、正しい形式の参照、そして銀行アプリが実際に受け入れるQRコードが必要です。通常は、Airtableを閉じて銀行のポータルを開き、行を再入力するようにアドバイスされます。このシナリオではその逆を行い、データは既に保存されているデータベースから決して離れません。
誰かがAirtableテーブルに、債権者、債務者、金額、QR-IBANを含む行を追加し、ステータスを「新規」に設定します。Makeがそれを検知し、PDF4meがスイスのQR請求書をレンダリングし、その画像が添付ファイルとして直接レコードに送り返されます。債務者はそれをメールで受け取ります。5つのモジュールだけで、銀行ポータルは不要。請求書データは、チームが既に編集しているベースデータに保持されます。
なぜ？という問いに対する質疑応答
なぜ支払いデータをAirtableに保存するのですか？ 多くの小規模な財務チームにとって、それは既に顧客記録や関連プロジェクトの横に存在しているからです。それを会計パッケージに移動して支払伝票を1枚作成するということは、同じ顧客情報を2つのシステムで管理することを意味します。また、行の修正は、技術的な知識のない同僚でも誰にも頼らずにできるものです。
なぜ画像をフォルダに入れるのではなく、レコード本体に戻すのですか？ フォルダ内のファイルは、それを生成したオブジェクトとの関連性を失ってしまうためです。PNGファイルを同じ行の「ドキュメント」フィールドに添付することで、伝票、作成に使用された数量、ステータスがすべて一緒に移動され、その行を見た人は他の場所に移動することなく成果物を確認できます。
すべてを監視するのではなく、ステータスに基づいてトリガーをフィルタリングする理由は？ そうでなければ、ウォッチレコードは、未完了の行も含め、追加するすべての行でトリガーされてしまうからです。トリガーの数式によって、「新規」は明確な指示となります。つまり、行が完了し、準備が整った状態になります。また、ステータスを元に戻すことで、伝票を安全に再発行する方法も提供されます。
QR-IBANは送信前になぜクリーニングされるのですか？ 人々はIBANにスペースを入れて入力する傾向があるため、仕様ではスペースのないアカウント情報を求めています。IBANフィールドでは、スペースを削除する置換処理が行われます。これにより、銀行アプリが読み取れる伝票と拒否される伝票の違いが生じます。金額についても同様で、生データではなく小数点以下2桁にフォーマットされます。
得られるもの
入力： 債権者、債務者、金額、通貨、QR-IBANを含むAirtableの行で、ステータスが「新規」に設定されている。 出力： 同じ記録に添付されたスイスのQRコード付き紙幣のPNG画像と、その伝票を添付した債務者へのメール。
請求書1枚につき1行。ここにある各列は、スイスのQRコード仕様で要求されるフィールドに対応しています。
左側に領収書、右側に支払い欄、その間にハサミ線。
債務者が受け取るものは、すべてその行から構成される。
必要なもの
- アカウントを作成する。 オープンメイク標準アプリには5つのモジュールが搭載されており、プレミアムプランは不要です。
- PDF4me APIキー。 APIキーを取得してくださいPDF4meへの接続は1つで、すべてのシナリオに対応できます。
- Airtableベース占領された基地は
PDF4me Live Automationsテーブル名Swiss QR Requests債権者ブロック、債務者ブロック、QRIBAN、参照、金額、通貨、メッセージ、電子メール、ステータスフィールド、および添付ファイルフィールドが必要です。Document完成した伝票用。 - Gmailアカウント 配送のため、Makeに接続されています。
- 本物のQR-IBAN ご利用の銀行から発行されます。これは通常のIBANとは異なります。スイスのQR-IBANは専用の金融機関範囲に属し、構造化されたQRコード参照を機能させるものです。銀行はリクエストに応じて発行します。
シナリオの概要
- 記録を見る （Airtable）は新しい行を取得します
Swiss QR Requests。 - スイスのQRコード紙幣を作成する (PDF4me)は、その伝票をPNG形式でレンダリングします。
- 添付ファイルをアップロードする （Airtable）はそれを
Document同じ行にあるフィールド。 - 記録を更新する （Airtableは）結果を行に書き戻します。
- メールを送信する （Gmail）が債務者に伝票を送付します。
シナリオの概要全体
Airtableモジュールが3つ、PDF4meモジュールが1つ、Gmailモジュールが1つ。ベースは送信元と送信先の両方の役割を果たします。
ステップ1：Airtableの行からシナリオをトリガーするにはどうすればよいですか？
これまでの流れ： まだ何も起きていない。これが引き金だ。
「準備完了」とマークされた行がリクエストなので、Make はそれを監視します。
- 追加 エアテーブル > 記録を見る 引き金として。
- 設定する:
- ベース:
PDF4me Live Automations - テーブル:
Swiss QR Requests - トリガーフィールド:
Created - ラベルフィールド:
Title - 制限:
10 - 式:
{Status}='New'
- ベース:
ウォッチレコードの設定
この数式は、未完了の行でシナリオが実行されないようにするものです。
ヒント。 トリガーフィールド 作成日時または最終更新日時フィールドである必要があります。Makeモジュールにもその旨が記載されています。このフィールドがないと、トリガーはレコードをソートできず、予期しない動作をする可能性があります。テーブルにこのフィールドがない場合は、この後のコードを作成する前にフィールドを追加してください。
ステップ2：行をスイスのQRコード紙幣に変換するにはどうすればよいですか？
これまでの流れ： Airtableのトリガー。
これは伝票を作成するモジュールです。ほとんどのフィールドは行から直接マッピングされますが、2つのフィールドは式が必要です。
- 追加 PDF4me > スイスのQRコード紙幣を作成する。
- 設定する 出力を左右する設定：
- フォーマットタイプ:
PNG - 参照タイプ:
QRR - 言語:
English - 分離ライン:
Line With Scissor - 債権者住所の種類:
S
- フォーマットタイプ:
- 支払いデータをマッピングする トリガーから:
- 額:
formatNumber(1.Amount; 2; "."; "") - IBAN:
replace(1.QRIBAN; " "; "") - 債権者名債権者欄から、番地、郵便番号、都市、国を入力してください。
- 債務者 債務者欄の氏名と住所、そして 参照 列から
- 額:
スイスのQRコード請求書の設定を作成する
パネルはここにスクロールされます。債権者名の下には、債権者の住所の残りの部分と債務者ブロック全体が表示されます。
各設定が決定する内容
| 分野 | ここで価値 | それが制御するもの |
|---|---|---|
| フォーマットタイプ | PNG | PDFではなく画像なので、Airtableのセルに添付してインラインでプレビューできます。 |
| 参照タイプ | QRR | 構造化されたQR参照とは、QR-IBANが必要なタイプのことです。代替案は以下のとおりです。 SCOR そして NON |
| 分離ライン | Line With Scissor | 領収書と支払い部分の間に切り取り線を引きます |
| 債権者住所の種類 | S | 構造化された住所、つまり自由記述ではなく、番地、郵便番号、市区町村を別々のフィールドに入力する。 |
| 額 | formatNumber(...) | 小数点以下2桁、桁区切り記号なし。これは仕様で求められている形式です。 |
| IBAN | replace(...) | 口座が検証される前に、人々がIBANに入力したスペースを削除します。 |
ヒント。 参照タイプとアカウントは一致している必要があります。 QRR QR-IBANと27桁のQR参照が必要です。通常のIBANには QRR 参照は、生成された伝票の検証に失敗する最も一般的な理由です。まだQR-IBANをお持ちでない場合は、 NON 銀行から参照番号が発行されるまで、参照番号欄は空欄のままにしておいてください。
ステップ3：どのようにして伝票を記録に戻しますか？
これまでの流れ： トリガーとPDF4meモジュール。
その列が請求書を要求したのだから、その列が請求書を運ぶべきだ。
- 追加 エアテーブル > 添付ファイルをアップロードする。
- 設定する:
- ベース そして テーブルステップ1と同様
- レコードID: その
idトリガーから - 添付ファイル欄:
Document - ファイル: 出力 PDF4me - スイスのQRコード付き紙幣を作成
- ファイル名:
QRBill_プラス タイトル 行プラスから.png - データ: その 書類 モジュール2の出力
- コンテンツタイプ:
PNG image
添付ファイルの設定をアップロードします
レコードIDはトリガーから取得されるため、伝票はそれを要求した行に配置されます。
ステップ4：行に結果をどのように記録しますか？
これまでの流れ： すべて添付ファイルアップロードを通じて行います。
ファイルを添付したからといって、作業が完了したわけではありません。結果は別途更新して報告する必要があります。
- 追加 エアテーブル > 記録を更新する。
- 設定する:
- ベース そして テーブルステップ1と同様
- レコードID: その
idトリガーから - 記録書き戻したいフィールドに入力してください。ステータスはトリガー式が読み取る重要な項目なので、特に重要です。また、OutputLink列は共有可能なURLを入力するのに便利な場所です。
レコード構成を更新する
このパネルには、表のすべての列が表示されます。上書きしたくない項目は空白のままにしてください。
ヒント。 変更するフィールド以外はすべて空白のままにしてください。マッピングされているが空のフィールドはセルをクリアしてしまうため、一見正常に動作しているように見えるシナリオでも、債権者の住所を簡単に消去できてしまう可能性があります。キャプチャされた実行ではパネルがスクロールされ、表示されているフィールドはすべて空になっているため、表示されている内容をコピーするのではなく、意図的にステータスを設定してください。
ステップ5：債務者に請求書を送付するにはどうすればよいですか？
これまでの流れ： 記録更新を通じてすべて。
最後のモジュールは、行に記載されている住所に伝票を配達します。
- 追加 Gmail > メールを送信する。
- 設定する:
- に: その メール トリガーからの列
- 主題:
Your Swiss QR billプラス タイトル - 体型:
Raw HTML - コンテンツ債務者、請求書、金額を記載した短いHTML本文
- 添付ファイルを追加してください：
- ファイル: その PDF4me - スイスのQRコード付き紙幣を作成 出力
- ファイル名:
QRBill_プラス タイトル プラス.png - データ: その 書類 モジュール2の出力
メール設定を送信
添付ファイルはモジュール2からバイトデータを取得するため、Airtableのデータは読み戻されません。
ヒント。 メール本文の金額を確認してください。キャプチャされたメッセージは次のとおりです。 金額：100.5スイスフラン 伝票自体にはこう書かれている 100.50なぜなら、QRコードが通過する間、本体は生の列をマッピングするからである。 フォーマット番号顧客に違いを説明するのが面倒でない限り、両方の箇所で同じ表現を使用してください。
シナリオを実行して検証する
- 保存 シナリオを作成して、一度実行してください。
- 行を追加
Swiss QR Requests債権者、債務者、金額、QR-IBAN、ステータスNew。 - 5つのモジュールが点灯するのを確認してください。それぞれが1つの動作を報告するはずです。
- 行を開く:
Documentこのフィールドには、タイトルと同じ名前のPNG画像が格納されている必要があります。 - 添付ファイルを開いて、両方の部分を確認してください。領収書部分と支払部分には、同じ口座番号、参照番号、金額が記載され、両者の間に折り目線（ハサミ線）が入っている必要があります。
- メール欄の受信トレイで、メッセージとその添付ファイルを確認してください。
キャプチャされた実行では、行 INV-1003 チューリッヒ市バーンホフ通り1番地、郵便番号8001にあるMuster AG宛ての、口座番号CH44 3199 9123 0008 8901 2、参照番号21 00000 00003 13947 14300 09017の伝票が発行され、チューリッヒ市ゼー通り10番地、郵便番号8002にあるTest Kunde AGが100.50スイスフランを支払うことになっています。
実際に何を作ったのですか？ チームが既に利用しているデータベース内に構築された支払伝票生成ツールです。銀行ポータルにログインする必要も、IBANを再入力する必要もありません。生成された伝票は、それを生成したレコードに紐付けられるため、1か月後でもどの行がどの請求書に紐づいているかを確認できます。
再構築せずに追加できる一般的なバリエーション
これは、スイスのQRコード紙幣を作成する他の方法と比べてどうなのか
各行はそれぞれ異なる選択肢を示しています。最後の行はこのシナリオを表しています。
| 比較 | 誰が運営しているのか | データの出所 | あなたが維持するもの |
|---|---|---|---|
| 銀行ポータルとこのシナリオの比較 | 一人ずつ、一度に一つのミスを犯す | 手書きで再入力 | 何もないが、請求書は誰にとっても数分かかる。 |
| スイスQRエクスポート機能付き会計パッケージとこのシナリオの比較 | 金融、その商品の中に | 製品独自の台帳 | 顧客にとってのサブスクリプションであり、第二の家となるもの |
| 開発者ライブラリとこのシナリオの比較 | アプリケーション内の開発者 | コードを通してデータベースを | コード、仕様の更新、リリース |
| このシナリオ | Airtableの行を追加できる人 | チームが既に維持しているベース | 5つのモジュールとQR-IBAN |
よくある質問
スイスのQRコード紙幣とは何ですか？
スイスのQRコード付き請求書は、スイスで従来使われていたオレンジ色と赤色の支払用紙に代わる新しい支払い用紙です。債権者、債務者、金額、参照番号などの情報を含むQRコードが印刷されているため、支払者は銀行アプリでこのコードをスキャンするだけで済み、何も入力する必要がありません。
領収書と支払いの2つの部分に分かれており、カットラインで区切られ、レイアウトは SIXが発行したスイスの実施ガイドラインだからこそ、それを生成することは設計上の問題ではなく、仕様上の問題となるのです。
スイスにおけるQR-IBAN番号とは何ですか？
QR-IBANは、通常のIBANとは別に銀行が発行する2つ目の口座番号で、その金融機関識別子が予約済みの範囲内にあるため識別できます。これは、銀行が入金された支払いに構造化されたQRコードが含まれていることを認識し、請求書と自動的に照合できるようにするために存在します。
このシナリオの実用ルール: 参照タイプを QRR 必ずQRコード付きIBANを使用してください。通常のIBANコードは使用できません。両方を混ぜると、見た目は正しくてもスキャンできない伝票が作成されます。
スイスのQRコードを使った請求書の支払い方法は？
支払者は銀行アプリを開き、支払い画面のQRコードをスキャンし、画面上の金額を確認して確定する。何も入力する必要がないのが、このフォーマットの最大の利点だ。
郵便局の窓口で支払うことも、印刷された欄に手動で入力することもできます。そのため、支払い欄には口座番号、参照番号、金額がコードの横に読みやすいテキストとして繰り返し記載されています。
Airtableで請求書を作成できますか？
Airtable単体ではできません。Airtableはデータを保存し、インターフェースや印刷可能なビューにレイアウトすることはできますが、支払い基準を満たすドキュメントを作成する方法も、その仕様に準拠したスキャン可能なQRコードを生成する方法もありません。
その強みは、信頼できる情報源となることです。このシナリオでは、その役割分担が維持されます。Airtableが行を保持し、PDF4meが準拠した成果物を生成し、その結果が添付ファイルとして行に返されます。
トラブルシューティング
アカウントと参照タイプを一緒に確認してください。 QRR 参照には QR-IBAN が必要です。通常の IBAN には スコア または 非次に、IBANが実際にスペースなしでモジュールに到達したかどうかを確認します。 交換する 表現は、そのために存在する。
トリガー式が指定されていないか、一致しません。 {Status}='新規' 大文字と小文字は区別されます。また、フィールドは単一選択フィールドまたは値が「New」と完全に一致するテキストフィールドである必要があります。さらに、トリガーフィールドが作成日時または最終更新日時フィールドであることを確認してください。
モジュール3のレコードIDを確認してください。これはトリガーから取得したものでなければならず、PDF4meモジュールから取得したものであってはなりません。次に、コンテンツタイプがフォーマットタイプと一致していることを確認してください。モジュール2のPNGファイルをPDFファイルとしてアップロードすると、添付されてプレビューが拒否されます。
モジュール4では、テーブル内のすべてのフィールドが一覧表示されます。マッピングされているものの値が空のフィールドは、セルをクリアします。意図的に書き込む場合を除き、何も変更しないでください。
次のステップ
既にお持ちのデータベースは、見た目以上に完成された支払い書類に近い状態になっていることが多いです。必要なのは、仕様に沿った記述を追加することだけです。