請求書の郵送準備をCodexで試した。二重依頼と発送結果の取り違えを検証
請求書を折り、封筒に入れ、郵便に出す。電子送付へ移れない取引先が残ると、紙の作業も残ります。郵送を外部へ任せる場合も、何を依頼し、どこまで進んだかを確認する仕事は必要です。
Dignowaでは、架空の請求書10件から郵送候補5件を作り、このPC上に用意した模擬の郵送受付へ送る処理を実装しました。受付後に接続が切れた1件を再試行しても、登録は5件のまま。受付番号を取得した後の発送結果も照合しました。
この記事はDignowa編集部の実験報告です。Codexが実装・実行を担当しています。実在の郵送代行サービスは使っていません。PDFと依頼データの受け渡しは実際に動かしましたが、印刷・折り・封入・発送は行っていません。
月末に請求書を折って封入していた事例
freeeが公開するキンキダンボールの事例では、月末に集中する請求書の印刷、三つ折り、封入、発送が負担になっていたと説明されています。2024年6月時点の取材内容です。
キンキダンボールはDignowaの顧客ではありません。出典は実在する仕事を確認するために参照し、今回の入力や仕組みは独自に作りました。出典にある作業時間や料金を、今回の成果や現在の相場として扱ってはいません。
10件から、紙で送る候補5件を取り出した
入力には、取引先ID、請求番号、郵便番号、住所、受取方法、原本同封の有無と、請求書PDFを用意しました。すべて架空データです。
郵送候補にしたのはM001からM005の5件。2ページの請求書が2件あるため、合計7ページです。住所が空欄のM006、郵便番号が6桁のM007、原本同封を指定したM008は保留しました。電子送付のM009と取消のM010は対象外にしています。
原本同封は、PDFだけを渡す今回の処理では扱えません。その指定がある請求書を自動的に通常の郵送候補へ混ぜず、別の対応が必要なものとして残しました。
M001の郵便番号「0123456」は文字列で持ち、先頭の0を保持しました。確認したのは7桁という形式だけで、実在する郵便番号か、住所と対応するかは検査していません。

同じ住所でも、別の取引先なら別の依頼
M001とM003には、同じ架空の住所を設定しました。取引先IDと宛名は異なります。住所が一致しただけで同じ封筒へまとめず、それぞれのPDFと宛先を別の依頼データにしました。
候補のPDFは、元ファイルとバイト単位で一致しています。取引先ID・請求番号・版・ページ数・金額も本文と照合しました。依頼ごとにPDFと宛先を組にしたため、宛先一覧とファイルを別々に受け取って対応を推測する必要はありません。
受け付けた直後に通信が切れたら、もう一度頼んでよいか
模擬受付には、M002を登録した直後に接続を切る条件を入れました。受付側には依頼が残っていますが、依頼する側は受付番号を受け取れません。この状態で別の依頼として送り直すと、同じ請求書を二重に依頼する可能性があります。
今回は「M002-v1」という同じ依頼キーを付けて再試行しました。模擬受付は、同じキーと同じ内容なら、先ほど登録した依頼の受付番号を返す仕様です。
実際に動かした結果、5件に対して通信上の依頼は6回になりましたが、受付側の登録は5件でした。M002を2件に増やさず、最初の受付番号を取得できています。
これは、こちらで作った模擬APIの仕様を検証した結果です。利用予定の郵送代行でも同じことができるとは限りません。同じ依頼を識別する方法や、応答がなかったときの照会方法は、接続先ごとに確認する必要があります。
受付記録を失った場合と、宛先が変わった場合も試した
手元の受付記録がない状態を作り、5件をもう一度依頼しました。模擬受付から返ったのは、先に発行された5件の受付番号です。登録数は増えませんでした。手元に受付記録が残っている通常の再実行では、依頼の通信自体が0回でした。
一方、同じ依頼キーのままM001の宛先を変更すると、模擬受付はHTTP409で拒否しました。以前と違う内容を、同じ依頼として受け付けないためです。登録後の宛先訂正や取消の処理は、今回実装していません。
通信切断は意図して起こした検証条件で、実サービスの障害を観測したものではありません。自然に起きた実装エラーも、今回の実行記録にはありません。
5件の受付番号があっても、発送報告があるのは1件だった
受付番号の取得後、模擬受付から11行の結果報告を取得しました。発送・印刷・受付・拒否を混ぜ、古い報告が後から届く順番にしています。同じ報告の重複、取引先IDが違う報告、知らない受付番号の報告も入れました。
| 請求番号 | 照合後の状態 | 確認した内容 |
|---|---|---|
| M001 | 模擬の発送報告あり | 順番が前後しても連番3の発送を採用 |
| M002 | 模擬の印刷報告まで | 発送したという報告はまだない |
| M003 | 模擬受付後に拒否 | 対応が必要なものとして残す |
| M004 | 受付番号のみ | その後の報告が届いていない |
| M005 | 受付報告まで | 発送報告の取引先IDが違うため採用しない |
受付番号があれば発送済みとする比較処理では、M002からM005の4件を誤って発送扱いにしました。今回の処理では、受付番号だけでなく、請求番号、取引先ID、依頼内容のハッシュも報告と照合しています。
重複した1行は除き、不一致の報告と知らない受付番号の報告は、それぞれ確認用の記録へ残しました。表の「発送報告あり」も模擬データの状態であり、実際に郵便物を発送した実績ではありません。
後から正しい報告が来ても、過去の不一致は消さない
次にM005へ、取引先IDなどが一致する新しい発送報告を追加しました。模擬の発送報告がある件数は、1件から2件へ変わりました。それでも、先に届いた不一致の記録は残り、M005は確認が必要なものとして表示しています。
同じ連番で内容の違う報告が届く条件も試しました。この場合は矛盾する報告を採用せず、最後に確認できた状態を残します。また、発送報告の後に新しい連番で受付報告が来ても、発送から受付へ戻さず、不自然な状態の変化として記録しました。
これらの連番と状態のルールも、実験用に決めたものです。実サービスの報告仕様や訂正ルールへ接続する工程は残っています。
Codexが作ったものと、まだ試せていないもの
CodexがPythonで候補作成、依頼、受付記録、結果照合の処理を作りました。架空PDFはReportLabで作成し、pypdfで本文を確認しています。HTTP通信と模擬受付にはPythonの標準機能を使いました。生成AIは開発・実行に使い、件別の採否は決めた条件で判定しています。
CLIを7回実行し、38の検査を通過しました。依頼の再試行、受付記録の復元、宛先変更の拒否、結果報告の照合を確認しています。候補5件の全7ページも画像に変換して表示を確認しました。実験後に模擬サーバーは停止しています。
今回のAI駆動開発で試せたのは、郵送用データの準備と模擬受付への依頼、返ってきた状態の照合までです。実サービスの取込形式、宛名窓への位置合わせ、折り位置、印刷品質、封入、発送、配達は未検証です。物理作業を代行できたとは扱っていません。
模擬受付の依頼記録はメモリーに置いています。今回の再試行や記録復元は、同じサーバーが動いている間の検証です。サーバーを再起動しても受付記録を保持する処理は、まだ作っていません。
実務へ進める場合は、契約中の請求書サービスや郵送代行が受け取れる形式と、返す結果を確認します。その仕様に合わせて小さな試験を行い、紙で残す対象と、担当者が確認する例外を決める工程が必要です。
依頼データと結果を確認する
候補と模擬受付の結果一覧に、5件のPDF、受付記録、照合前後の結果を掲載しています。コード・入力・実行記録のZIPから再現用データも取得できます。
38検査の結果JSONと通信記録JSONには、再試行と受付記録復元などを含む依頼12回、結果取得2回を記録しています。この14回は検証全体の通信数で、最初の5件を依頼したときの6回とは別です。