銀行同期・照合

銀行同期は、Plaid 経由でビジネス銀行口座を Invotify に接続し、取引を取り込み、入金を未払い請求書に照合する機能です。支払い済みの請求書は自動的に「支払済」としてマークされます。手動の照合作業から解放されます。

銀行同期でできること： - Plaid のホスト型ログインフローを通じて安全に銀行を接続 - 新しい取引を毎日自動的に Invotify に取り込み - 各入金を未払い請求書に対してスコアリングし、高信頼度のマッチを自動確定 - 低信頼度の候補をワンクリックで確認できる候補として表示 - 顧客支払いでない取引を無視またはアーカイブ

利用場所： 銀行の接続・切断は 設定 → 連携 で行います。取引フィードは銀行ページ（/dashboard/bank）で確認でき、要確認（候補と判断待ちの取引）、照合済み、無視済み のビューに整理されています。

プランの制限： 銀行同期は Pro 機能です（Lifetime にも含まれます）。Starter では、銀行ページにアップグレードのプロンプトが表示されます。すべての銀行 API 呼び出しはサーバー側でゲートされており、UI だけでなく実際にロックされています。

銀行の接続は Plaid が処理する短いガイド付きフローです。Invotify は Plaid が返すデータのみを受け取り、銀行ログインには一切関与しません。

Plaid がサポートする地域： 接続は アメリカ合衆国・イギリス・カナダ の銀行をサポートしており、Plaid 経由で大手国内銀行・地域銀行・信用組合など数千の金融機関をカバーしています。

接続の仕組み： 1. Invotify がアカウント用の Plaid Link トークンをリクエストします。 2. Plaid の安全なポップアップが開きます。銀行を選び、Plaid と直接 ログインします。Invotify は認証情報の間に入りません。 3. 連携するアカウントを選択します。 4. Plaid が一時的なパブリックトークンを返し、Invotify はそれを長期のアクセストークンと交換して会社に紐づけて保存します。 5. 接続が保存され、金融機関名・口座名・マスクされた口座番号が表示され、同期の準備が整います。

銀行が接続されて取引が同期されると、Invotify に取引が取り込まれ、照合プロセスの進捗に応じて整理されます。

フィードの構成： - 要確認 — 照合エンジンが見つけたが自動確定するほど信頼度が高くなかった候補マッチ（信頼度スコアとワンクリック確認ボタン付きで表示）と、まだ候補がない取引。各取引を請求書に照合するか無視します。 - 照合済み — 照合エンジンにより自動的に、またはユーザーが手動で、請求書に対して確定された取引。 - 無視済み — 顧客支払いでない（手数料・送金・仕入先への支払いなど）として脇に置いた取引。

各取引に表示される情報： 取引ごとに金額・通貨・日付・説明・加盟店名（銀行が提供する場合）・カテゴリー、および現在の照合ステータスと照合済み請求書が表示されます。候補マッチにはさらに信頼度スコアが表示されます。入金（クレジット）が照合エンジンの対象です。出金はフィードに表示されるだけです。

フィードの読み方： 取引は新しい順に表示されます。大量の取引履歴は一度にすべて読み込まず、ページ分割で管理しやすいサイズで表示されます。

Invotify の照合エンジンは各入金を未払い請求書と比較して信頼度スコアを算出します。スコアによって、照合が自動的に確定されるか、ユーザーの確認待ちになるかが決まります。

スコアの算出方法： 取引の 通貨 と 金額（わずかな丸め許容誤差内）が一致するすべての未払い請求書に対して、Invotify は 3 つのシグナルを合算します：

金額 — スコアの最大の部分です。取引は許容誤差内で請求書の合計と一致する場合のみ候補になります。

日付の近さ — 請求書の期日に近い支払いは、遠い支払いよりも高いスコアになります。日付が近いほどシグナルが高くなり、期日から大きく離れた支払いはこのシグナルに貢献しません。

顧客名 — 取引の説明に請求書の顧客名またはビジネス名が含まれている場合、スコアが上がります。銀行の説明は不規則なことが多いため、3 つのうちの 1 つのインプットとして機能します。

自動確定 vs 候補： 3 つのシグナルを合算した総合信頼度が高いしきい値を超えると、Invotify は照合を自動的に確定し、支払いを記録して請求書を更新します。しきい値未満の候補は 候補 マッチとして保存され、要確認の下にスコア付きで表示されます。ワンクリックで確認するか、別の請求書を選ぶか、無視することができます。候補は同期のたびに再確認されます。候補の請求書が別の方法で支払われた場合、古い候補は取り下げられます。

照合確定時の処理： 照合が確定されると（エンジンまたはユーザーによる）、Invotify は取引金額分の支払いを請求書に記録し、残高を再計算します。残高が 0 になると請求書は 支払済 になります。一部だけ支払われた場合、請求書は 一部支払い となり、残額が開いたままになります。手動照合はアクティビティログに記録されます。

手動照合： 取引から請求書を手動で照合することもできます。手動照合は完全な信頼度として扱われ、自動照合と同じように支払いが記録されます。

銀行フィードのすべての明細が顧客支払いというわけではありません。手数料・送金・仕入先への返金・自社の出金もすべて表示されます。Invotify はそれらを照合ビューから除外するクリーンな方法を提供します。

取引を無視する： 任意の取引を 無視 としてマークすると、無視済みビューに移動して邪魔にならなくなります。顧客支払いでないものはすべてここに移動して、フィードには本当の判断が必要な取引だけが残るようにします。取引を無視しても請求書には影響しません。フィードを整理するための操作です。

無視済みビューをアーカイブとして活用： 無視した取引は削除されません。無視済みに残り続けます。これにより、口座を通過したすべてのものの完全な記録が残りながら、収金に関係する取引に集中できます。

銀行の切断： 設定 → 連携 からいつでも銀行接続を削除できます。切断はソフトな操作です。接続は切断済みとマークされて同期が停止し、アクティビティログにイベントが記録されます。すでに取り込まれた取引はフィードに残ります。

銀行同期は自動的に実行されます。何もしなくてもフィードは常に最新に保たれ、高信頼度の照合は自動的に行われます。

毎日の自動同期： 接続されているすべての銀行は 毎日 1 回 自動的に同期されます。トリガーしたりスケジュールしたりする必要はありません。新しい取引は毎朝フィードに表示され、すでに照合エンジンを通過しています。

増分カーソルベース同期： Invotify は Plaid のカーソルベース同期を使用しているため、各日次実行では前回以降の新しいものだけを取得します。履歴全体を再ダウンロードすることはありません。新しい取引が追加され、カーソルが保存されるので、次回の実行は前回終了した地点から正確に続きます。これにより同期が高速化され、重複エントリが防止されます。取引は銀行識別子でキー管理されています。

同期中の自動照合： 接続の新しい取引を取得した後、同期は保留中の入金に照合エンジンを実行します。高信頼度のマッチは確定され、支払いが請求書に記録され、請求書ステータスが更新されます。すべてユーザーの操作なしに行われます。低信頼度の候補は要確認に候補としてキューに入れられ、既存の候補はリフレッシュされます（候補の請求書が別の方法で支払われた場合は取り下げられます）。

接続単位の耐障害性： 同期中に 1 つの銀行接続に問題が発生した場合、Invotify はその接続のみをエラーとしてマークし、残りの接続を続行します。1 つの銀行の問題が他の接続をブロックすることはありません。エラーが発生した接続は設定から再接続できます。各接続には最後に同期した日時が記録されます。