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

請求額を2か所へ転記する処理をCodexで作った。途中停止と訂正を検証

請求書に金額を入力し、口座振替のシステムにも同じ金額を入力する。会計にも登録する。元の請求額が一つでも、登録先が増えるほど「どこまで入力したか」の確認が必要になります。

Dignowaでは、架空の請求一覧から、会計と口座振替の2か所へ登録する処理をCodexで作りました。片方の受付が失敗した後に再開し、会計側へ6件、振替側へ5件を重複なく登録できました。

ただ、追加検査では不具合も見つかりました。古い請求を確認待ちにしても、以前に用意した送信待ちデータが残り、そのまま登録されていたのです。この記事では、その修正まで報告します。

実装・実行はCodexが担当しました。入力も受付も独自のダミーです。実際の銀行や会計ソフトには接続せず、引落や会計計上も行っていません。

金額の転記と、その後の確認が続く仕事

Coopelの社会保険労務士法人アーツ導入事例では、請求書の作成・送付から、口座振替システムへの登録、会計登録までの作業を自動化したと紹介されています。振替金額は、別システムの画面から取得しているそうです。

同法人はDignowaの顧客ではありません。今回の請求、金額、契約番号、受付の仕様は独自に作りました。出典の取引データや実装を再現したものではなく、複数の登録先へ同じ請求を転記する仕事を題材にしています。

16請求から、両方へ登録する5件と会計だけの1件を分けた

入力は19レコード、請求番号は16種類です。重複と旧版を含めて、金額が違う同じ版、取消、対象月違い、登録先が分からない請求も用意しました。

登録候補は、口座振替と会計の両方へ渡す5件と、会計だけへ渡す1件になりました。残りは確認待ち7件、対象外3件です。

会計だけにしたI03は、支払方法が銀行振込の請求です。口座振替の対象には含めません。契約が見つからない、複数の契約候補がある、会計側の対応コードがない場合は、この実験では請求単位で両方への登録を保留しました。

I01とI02は、どちらも会社名を「株式会社サンプル」にしています。会社名だけで探す比較用処理では、I02にもI01の契約番号を選んでしまいました。今回の処理では顧客IDで対応付け、契約番号000041と000042へ分けています。I12の000052も、先頭の0を残して渡しました。

会計だけ成功したところで、振替側を止めた

登録は、請求ごとに会計、口座振替の順に行います。最初のI01は両方で受け付け、次のI02は会計側だけ受け付けたところで、振替側が503エラーを返す条件にしました。

1回再試行しても失敗したため、処理は停止しました。この時点で受付は3件です。I02の会計登録は済んでいますが、振替登録は済んでいません。後続の7登録は送信待ちで残りました。

すべての登録を最初からやり直すと、すでに成功した会計側にも同じ請求を送ることになります。そこで、SQLiteに登録先ごとの状態と受付番号を保存し、再開時には未完了の登録を進めるようにしました。

受付直後に止まっても、同じ登録を増やさない

次に振替側を復旧させ、I02を受け付けた直後、手元へ受付番号を保存する前に処理を止めました。受付側には記録がありますが、手元ではまだ受付済みと確認できていない状態です。

ここでは、請求番号、改訂番号、登録先を含む識別キーを使いました。模擬受付は、同じキーと同じ内容が再び届いたら、保存済みの受付番号を返します。受付側もSQLiteへ保存しているので、サーバーを一度止めて起動し直した後も、4件の受付記録が残りました。

再開後は、I02を重複登録せずに後続へ進めました。I12では受付後に通信だけ切れる条件も試し、再送されても受付が増えないことを確認しています。同じ入力でもう一度実行した際は、新たな登録要求は0件でした。

503、中断、通信切断は、動きを確かめるために用意した条件です。実際の銀行や会計ソフトで起きた障害を報告しているわけではありません。

49,865円と44,365円でも、転記ミスとは限らない

再開を終えた結果、会計側は6件・49,865円、振替側は5件・44,365円になりました。全体の金額だけを比べると、5,500円の差があります。

差額は、会計だけへ登録した銀行振込のI03です。振替対象の5請求にそろえると、会計側も振替側も44,365円で一致しました。

件数や合計の一致だけで済ませず、受付結果の請求番号、改訂番号、金額、対応コードを元の登録内容と比較しています。確認用に振替側の受付金額を1円増やした条件では、44,366円と44,365円の違いを検出し、検査を失敗として終了しました。改変は検証のために行い、その後で元へ戻しています。

訂正は、送信前か受付後かで分けた

送信前の別の検証では、I09を9,000円から9,500円へ訂正し、I12を取り消しました。古い送信予定4件を使わない状態に変え、新しい9登録だけを受付へ渡せました。

受付後は同じ扱いにできません。I01を取消、I16を3,000円から3,500円へ訂正して再実行すると、2請求を確認待ちに残し、新たな登録はしませんでした。元の受付も消していません。

これは訂正を完了したという結果ではありません。すでに送ったデータがあるため、自動で新しい金額を追加せず止めた、という結果です。実サービスで必要になる取消、変更、再登録の手続きは今回の実装に含めていません。

確認待ちにしたのに、送信待ちが動いた

最初の49項目の検査は通りました。その後、一覧全体は新しくても、一部の請求だけ古い版に戻っている条件を追加しました。

I09の第2版を送信待ちに置いた後、第1版しか含まない一覧を渡したところ、請求の分類は確認待ちになりました。しかし、SQLiteに残っていた第2版の送信待ちを止めていませんでした。そのため、会計と振替の両方へ登録され、追加検査が失敗しました。

修正では、古い版を検出した際に、その請求の送信待ちも保留へ変えるようにしました。同じ条件で再実行し、I09の2登録が保留になり、受付へ渡らないことを確認しています。

確認待ちという分類を付けるだけでは、送信を止められませんでした。送信待ちデータにも保留の状態を反映する必要がありました。この不具合は今回作った処理で実際に見つかったもので、実顧客の二重請求事故ではありません。

Codex、Python、SQLiteをどう使ったか

Codexが、架空入力、登録処理、模擬受付、検査コードを作り、コマンドで実行しました。Pythonの標準ライブラリでHTTP通信を行い、SQLiteへ送信待ちと受付記録を保存しています。追加のPythonライブラリは使っていません。

生成AIは開発と検証に使いました。請求金額や契約の対応は、IDと明示したルールで扱っています。今回のAI駆動開発で作ったのは、2か所への登録状況を追い、途中停止から再開する処理です。両方のサービスをまとめて一度に確定する仕組みではありません。

修正後の最終実行は16回、検査は52項目です。HTTPの取得要求18回、登録要求43回を記録しました。登録先の受付は、通常の再開11件、送信前訂正9件、同一版の矛盾9件、旧版混入9件の別々の検証です。合計38件を、実業務で処理した請求件数とは扱っていません。

入力はJSONファイルで、実画面からの取得、実サービスへの接続、仕訳や税区分の判定、引落の実行は未検証です。実際に使うには、登録先の仕様、契約の状態、締切、訂正手順を確認する必要があります。検証用の受付サーバーは停止しました。

入力、登録結果、不具合の修正前後を確認する

16請求の分類と11件の受付結果で、登録先ごとの結果を見られます。修正前の旧版検査と修正後の記録には、I09の登録状態の違いを残しました。

コード・架空入力・実行記録のZIP、52項目の検査結果、HTTP履歴も掲載しています。登録後の実取消や再請求まで検証した資料ではありません。