Dignowa / Codexで業務改善 012 / ローカル確認用

入金と請求残高をCodexで照合した。合算・分割・100円の差額をどう残したか

入金明細を開き、振込名義を見て、請求書を探す。同じ金額が見つかっても、それだけで相手や請求を特定できるとは限りません。

Dignowaでは、架空の銀行明細17行と請求台帳12件を用意し、Codexで照合処理を実装・実行しました。重複を整理すると取引番号は15種類。5取引から6行の配分候補を作り、10取引は確認待ちに残しました。

この記事はDignowa編集部の実験報告です。実装・実行はCodexが担当しました。実銀行や会計ソフトには接続せず、すべて未承認の候補として出力しています。会計上の消込、振込、返金は行っていません。

銀行明細と会計システムを見比べる仕事

freeeのキンキダンボール導入事例には、銀行入金明細と会計システムを照合する消込作業の負担が書かれています。2024年6月時点の取材内容です。

同社はDignowaの顧客ではありません。今回の請求と入金は独自に作った架空データです。出典にある作業時間や改善効果を、今回の実績として扱ってはいません。

金額だけで選ぶと、確認が必要な4件も候補になった

まず比較用に、入金額と同じ金額の請求を探し、最初の1件を選ぶ処理を試しました。対象の4件では、名義が未登録、名義が複数社に登録、同じ相手に同額の請求が2件、請求と名義の取引先が違う、という問題を見逃して候補を選びました。

例えばT014は22,000円です。同額の請求I002はありますが、入金名義を登録した取引先と、I002の取引先は違います。今回作った照合処理では、この入金を保留にしました。

T007の「ヤマダ」は、名義対応表に2社分を登録しています。請求番号があっても、名義を一意に特定できないため止めました。登録済みの名義を使って相手を確認し、その後に請求番号や残額を照合する順番です。

この4件は、金額だけを見る方法の問題を確かめるために用意した比較条件です。実際の顧客の入金を誤って消し込んだ記録ではありません。

55,000円の合算入金を、2件の請求へ分けた

T002には、請求番号I002とI003を明記しました。請求残は22,000円と33,000円で、合計55,000円。入金も55,000円だったため、2件への配分候補を作りました。

今回は、請求番号が明記され、同じ取引先で、請求残の合計と入金が一致する場合だけを合算として扱います。番号のない入金から、金額が合う組み合わせを推測する処理は入れていません。

T002はCSVに同じ内容で2回入れていますが、取引番号と内容が一致する重複1行を除き、55,000円を一度だけ配分しました。

44,000円の請求へ、20,000円と24,000円が別々に入る

I004の請求残は44,000円です。T003の20,000円を配分候補にすると、候補を適用した場合の残額は24,000円になります。次のT004の24,000円も同じ請求への入金として照合し、残額を0円と計算できました。

ここでの0円は、未承認の候補を適用した場合の残額です。元の請求残44,000円は保持し、消込確定額は0円のままにしています。CSVの行を逆順に並べた別実行でも、日付と取引番号で処理するため、配分と集計結果は変わりませんでした。

100円足りなくても、手数料とは決めない

I005の請求残55,000円に対し、T005の入金は54,900円です。54,900円を配分候補にし、差額100円は請求残として残しました。

その100円が手数料なのか、振込額の間違いなのかは、明細だけでは判断していません。今回の処理は差額を消さず、理由が未確定であることを出力します。

逆に、I006の66,000円に対して67,000円が入ったT006では、66,000円までを配分候補にし、1,000円を未配分にしました。同じ請求へさらに入ったT013の5,000円は、候補を配分した後の残額がないため保留です。ほかの請求へ自動的に回すことはしていません。

取り消す明細がある入金を、候補へ残さない

T001の11,000円には、その取引を取り消す条件として、T011のマイナス11,000円を対応付けました。処理では両方を保留し、T001を請求へ配分しませんでした。

これは、負数明細に元の取引番号を持たせた独自の検証形式です。実際の銀行データに同じ項目があるとは限りません。負数取引の会計処理や、取消の正当性も今回の処理では決めていません。

同じ取引番号で金額が違う2行は、集計と分けた

T012には、100,000円と101,000円の2行を入れました。単なる重複として片方を選ばず、金額を未確定とし、元の行番号を2つとも残しています。

この取引を除き、同じ内容の重複を1件にまとめたプラスの入金は566,900円です。配分候補219,900円と未配分347,000円に分かれ、合計が一致しました。負数の11,000円は別に表示しています。

566,900円は、取り込んだ全行をそのまま合計した金額ではありません。金額不一致のT012を別枠にした集計です。未確定の取引があることを隠さず、金額が分かっている範囲で配分を検算しました。

確認項目 初回の結果
CSVのデータ行数 ヘッダーを除き17行
取引番号の種類 15種類
照合候補・確認待ち 5取引・10取引
請求への配分候補 6行、219,900円
未配分の入金 347,000円
取消請求を除いた元の請求残 661,000円
候補を適用した場合の請求残 441,100円

後から100円が入った場合も、元の結果を残して再計算

追加の入金T016として、I005向けの100円を加えました。同じ出力先へ実行すると、入力が変わったことを検出して停止します。別の出力先で再計算すると、配分候補は220,000円になり、I005の候補適用後の残額は0円になりました。

元の6行の配分は変わらず、100円の候補が1行追加されています。入力を変えない再実行では追加出力0件。保存後の結果を書き換えた条件でも、その変化を検出して停止しました。

Excelは保存できたが、生成処理の終了時に異常が出た

結果を確認しやすいように、「入金照合」「請求残」「配分候補」の3シートを持つExcelを作りました。合計や残額は数式でつなぎ、候補額を変更すると関連する集計も変わることを確認しています。確認後は元の値へ戻しました。

ただし、書き出し完了の記録が出た後、生成に使ったNode.jsのプロセスは異常終了コードを返しました。原因は特定できていません。正常終了したとは扱わず、保存されたExcelを別のライブラリで開き直して検査しました。

ファイルの破損チェック、全15取引、12請求、6行の配分、合計値、数式の保存を確認し、8項目の検査を通過しています。3シートの画像も確認しました。Excelアプリ自体での操作確認は未実施です。

実際に作成した入金照合Excelの表示。取引15件と配分候補・未配分・保留理由を掲載

Codexで動かした範囲と、実務へ進める前の確認

CodexがPythonで照合処理と検査を作り、実行しました。銀行明細を模したCSVはCP932、請求台帳と名義対応表はJSONです。文字の表記を整える処理にはunicodedataを使い、取引先との対応は登録済みの名義表で確認します。金額は整数の円で扱っています。

照合処理はCLIを6回実行し、34項目の検査を通過しました。取引ごとの配分額と未配分額、請求ごとの残額、重複、取消に対応する入金、再実行を確認しています。生成AIは開発・実行に使いました。入金の照合には、名義や請求番号、残額を確認する決まったルールを使っています。

実際の銀行CSVや会計ソフトの仕様への対応は未検証です。名義の登録、合算時の請求番号の受け取り方、同日入金の順序、負数取引や訂正明細の表し方を確認する工程が残ります。現場での時間削減も、まだ測っていません。

今回のAI駆動開発では、合算・分割の候補を作る処理と、分からない金額や相手を確認待ちに残す処理を試しました。Excelの表示や集計が整っていても、消込を確定できるかは別の確認として残しています。

Excelと実行記録を確認する

確認用Excelと15取引の結果一覧を掲載しました。Excelは今回の結果見本で、銀行明細を追加すると自動で照合し直す完成システムではありません。

コード・入力・実行記録のZIPには、元の架空CSVと請求台帳、追加入金後の結果、Excel生成時の異常終了記録を含めています。照合の検査結果JSONと初回結果JSONからも内訳を確認できます。