銀行接続

このガイドでは、銀行へのライブ接続 (PSD2オープンバンキング) について説明します。接続方法、銀行口座と元帳の紐付け方法、同期のたびにインポートテンプレートを通じて取引先 (partner) の作成、請求書の消込 (matching)、および手数料の計上を行う方法、そして同期の戻り値について解説します。APIの詳細については、銀行および決済のインポートを参照してください。ライブ接続ではなくステートメントファイルを使用する場合は、銀行明細のインポート (camt.053)を参照してください。

1. 銀行を接続する

[銀行 (Bank)] → [接続 (Connections)] に移動し、国を選択して [銀行を表示 (Show banks)] をクリックします。銀行と口座名義人の種別 (法人または個人) を選択し、[接続 (Connect)] をクリックします。銀行自身の同意画面に遷移するため、そこでログインしてアクセスを承認します。その後、銀行から Nordlet にリダイレクトされます。接続が一覧に追加され、同意の有効期限が表示されます。同意の有効期限は銀行によって定められており (通常は90日または180日)、期限が切れた場合は再度接続を行ってください。

銀行の一覧は、Nordlet インスタンスに設定されているオープンバンキングプロバイダーから取得されます。国に銀行が表示されない場合、そのプロバイダーはまだその国をカバーしていません。

2. 銀行口座を紐付ける

接続の下に、銀行が公開している各口座が IBAN と通貨とともに一覧表示されます。それぞれについて、元帳内の既存の銀行口座を選択するか、[新しい銀行口座を作成 (Create a new bank account)] を選択し、必要に応じて同期開始日を設定して、[紐付け (Link)] をクリックします。紐付けられた口座のみが同期されます。同期開始日が指定されていない場合、最初の同期では過去 90 日分のデータが取得されます。

3. インポートテンプレートを作成する

[銀行 (Bank)] → [インポートテンプレート (Import templates)] に移動し、[新しいインポートテンプレート (New import template)] をクリックします。タイプとして [銀行接続 (Bank connection)] を選択し、名前を入力します。行は、銀行フィードが取引ごとに返す属性を表します。「ファイルで必須 (Required in file)」のチェックボックスは完全性のために保持されていますが、ライブフィードがこれに対して検証されることはありません。

勘定科目 (Ledger account): 単純な金額行 transaction_amount.amount およびルール行を勘定科目に割り当てることができます。割り当てられた行から生成された同期済みの取引は即座に計上され、仕訳帳のエントリと消込済みとしてマークされます。ルール行は、銀行取引コードまたは方向によって取引を抽出します。

行	抽出対象	標準的な勘定科目
銀行手数料 (コード CHRG)	コードファミリーが CHRG の取引	支払手数料 (標準勘定科目表の 6800)
利息 (コード INTR)	コードファミリーが INTR	受取利息または支払利息
税金 (コード TAXE)	コードファミリーが TAXE	納税
その他の出金	その他のすべての借方	購入請求書の消込を行えるよう「未計上 (Not posted)」のままにする
その他の入金	その他のすべての貸方	売上請求書の消込を行えるよう「未計上 (Not posted)」のままにする
transaction_amount.amount	ルールに一致しなかったすべての取引	通常は「未計上 (Not posted)」

取引は、一致した最初の行の勘定科目に計上されます (コードファミリー、次に方向、最後に単純な金額行の順に評価されます)。コードは銀行の bank_transaction_code から取得されます。コードを送信しない銀行の場合、コード行には一致するものがありません。

不足している顧客・仕入先の作成 (Create missing customers / suppliers): 入金側の debtor.name 行で [不足している顧客を作成 (Create missing customers)] にチェックを入れると、未知の支払人ごとに顧客が作成されます。同様に、出金側の creditor.name 行で [不足している仕入先を作成 (Create missing suppliers)] にチェックを入れると、未知の受取人ごとに仕入先が作成されます。取引先は、IBAN (debtor_account.iban / creditor_account.iban、取引先の銀行口座に保存されます)、次に完全一致する名前によって認識されます。名前で検出された取引先には IBAN が追加されます。新しい取引先は、名称に法的形態 (UAB, MB, SIA, GmbH, Ltd, …) が含まれている場合は法人となり、そうでない場合は個人になります。

銀行用の取引先を作成 (Create partner for the bank): 銀行手数料のルール行でこれにチェックを入れます。同期により、接続された銀行の名前を持つ仕入先が一度だけ作成され、その取引先を使用してすべての手数料が仕訳帳に記録されます。

この項目で請求書を紐付ける (Link invoices by this field): remittance_information または reference_number 行でこれにチェックを入れます。送金テキストまたは参照番号に、未決済の発行済み売上請求書 (入金) または登録済みの受取請求書 (出金) の番号が含まれている新しい取引はすべてその請求書と消込が行われ、支払いが計上されます。支払人が保存された IBAN、正確な取引先名、またはコードによって既知の取引先である場合、その請求書はその取引先のものでなければなりません。未知の支払人からの支払いは、残高と同額であり、かつ請求書番号にシリーズのプレフィックスが含まれている場合にのみ消込が行われます。残高を超える支払いは決して消込されません。これらのチェックに失敗した取引は未消込のまま残り、手動で消込を行うことができます。[未消込の入金に対して前受請求書を作成 (Create advance invoices for unmatched incoming payments)] オプションを有効にすると、既知の取引先からの未消込の入金が、支払日を起算日とし、指定されたVAT税率または選択されたカタログアイテムに基づいた発行済みの前受請求書に変換されます。これを利用するには、取引先を特定できる [不足している顧客を作成 (Create missing customers)] が有効である必要があります。

テンプレートを保存します。

4. テンプレートを適用し、スケジュールを選択する

[銀行 (Bank)] → [接続 (Connections)] に戻ると、紐付けられた各口座にテンプレートの選択項目とスケジュールの選択項目が表示されます。テンプレートを選択し、[手動同期 (Sync manually)]、[日次同期 (Sync daily)]、[週次同期 (Sync weekly)]、または [月次同期 (Sync monthly)] のいずれかを選択して、[適用 (Apply)] をクリックします。テンプレートが設定されていない紐付け済みの口座も同期は行われますが、取引の記録のみとなり、計上、消込、作成は一切行われません。

日次、週次、または月次のスケジュールを設定すると、API が自動的に口座を同期します。1時間に1回、前回の同期から設定期間 (24時間、7日、または30日) 以上が経過している口座を検出し、[今すぐ同期 (Sync now)] を実行した場合と同様に正確に同期を行い、その後にテンプレートを実行します。スケジュールされた同期は、手動同期と同様に利用枠にカウントされます (取得された取引 10 件ごとに 1 リクエスト)。同意の有効期限切れなどにより銀行が同期を拒否した場合、接続にはエラーが表示され、再接続するまでスキップされます。

5. 同期する

接続に対して [今すぐ同期 (Sync now)] をクリックします。Nordlet は紐付けられたすべての口座について、新しく計上された取引を取得します。未確定の取引は、銀行によって計上されるまでスキップされます。(遅延した計上の見落としを防ぐため、1週間の重複を持たせて前回の同期以降のデータが取得されます。) 取引は一度だけ記録され (取引は銀行のエントリ参照によって識別されます)、その後口座のテンプレートが実行されます。結果行には、インポートされた取引の数と既に存在していた取引の数が報告されます。API経由の同期ではさらに、計上された移動、作成された取引先、紐付けおよび作成された請求書、消込が行われた支払い、および消込できなかった支払いに関する警告の数も返されます。

同期は、スケジュールに従って API (bank/feeds/sync) からトリガーすることもできます。取得された取引 10 件ごとに 1 回の API リクエストとしてカウントされます。

6. 同期後の確認場所

• [銀行 (Bank)] → [取引 (Transactions)] - 口座ごとのタブで、同期されたすべての取引を確認できます。消込済みの取引からは請求書や仕訳帳エントリへのリンクが表示されます。
• [請求書 (Invoices)] - 未消込の入金に対して作成された前受請求書。
• [取引先 (Partners)] - 作成された顧客および仕入先。それぞれ銀行口座の下に IBAN が紐付けられています。
• [総勘定元帳 (Ledger)] → [仕訳帳 (Journal)] - 手数料 (銀行を取引先とする)、利息、税金、および支払いの仕訳。

接続が動作しなくなった場合

同期が失敗すると、接続に銀行のエントリのエラーメッセージが表示されます。通常は同意の有効期限切れが原因です。同じ銀行に対して再度 [接続 (Connect)] をクリックしてアクセスを承認してください。紐付けられた口座とそのテンプレートは維持されます。[接続解除 (Disconnect)] を実行すると、接続とその口座の紐付けは削除されますが、すでに記録済みの取引は削除されません。