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

出荷番号があっても完了にしない。Codexで直送20明細を照合してみた

10個の注文に、4個分の出荷報告と伝票番号が届いている。番号が入ったことだけを見て完了にすると、残り6個の確認が抜けてしまいます。

Dignowaでは、直送商品の出荷報告を受注と照合する処理をCodexで実装・実行しました。架空の受注明細20行に対して、用意した報告は22行。全数の報告がそろった4明細と、期限を過ぎても報告が足りない6明細を区別し、問い合わせ下書き3件を作りました。

この記事はDignowa編集部による実験報告です。実装と実行はCodexが担当しています。出荷報告の照合までを試したもので、実際の荷物の追跡や配達確認はしていません。

直送商品の伝票番号を集める仕事

サイボウズが公開する東急の導入事例では、産地直送の商品について、取引先がkViewerを使って伝票番号を入力し、受注明細へ出荷実績を登録する運用が紹介されています。

この公開事例を参考に、今回は受注と出荷報告を照合する部分を試しました。東急はDignowaの顧客ではなく、今回の入力や処理も同社のものではありません。問い合わせに何時間かかっていたか、という実測値は持っていません。

注文番号だけでは、別の仕入先の明細まで消えてしまう

入力は、受注一覧、出荷報告、確認時点と仕入先の設定を記した3つのJSONファイルです。受注には注文番号、仕入先ID、明細番号、数量、報告期限、取消の有無を入れました。報告には、それらの識別情報と出荷数量、伝票番号、報告ID、訂正版の番号、受信日時を持たせています。

照合には注文番号・仕入先ID・明細番号の3つを使いました。例えばO012には、A社が担当する3個の明細と、B社が担当する4個の明細があります。A社の3個の報告が届いても、B社の4個は報告待ちとして残ります。

比較用に「同じ注文番号に伝票番号が一つでもあれば完了」とする処理も実行しました。この不十分な条件では、分納、取消、仕入先の違いなどを見落とし、12明細を誤って完了扱いにしています。意図的に簡単な方法と比べた結果であり、実際の顧客で起きた事故ではありません。

20明細を分けると、確認すべき6明細が残った

確認時点は2026年10月4日17時、各明細の報告期限は指定日の18時と決めました。実際の会社の締め時刻を調べて採用したものではなく、実験用の条件です。

照合結果 明細数 今回の扱い
全数の出荷報告あり 4 報告数量が受注数量と一致
一部報告・期限超過 2 残数を問い合わせ下書きへ
有効な報告なし・期限超過 4 報告の確認を下書きへ
期限前 2 未報告1明細と一部報告1明細を待機
要確認 7 不一致などの理由付きで人の確認へ
注文取消 1 問い合わせ対象から除外

O002は10個中4個の報告なので、残り6個を確認対象にしました。一方、O005は4個と6個の別々の出荷報告があり、合計10個として扱えています。

ここでの残数は「有効な出荷報告を確認できていない数量」です。倉庫に残っている実在庫や、未出荷が確定した数量ではありません。報告の入力だけが遅れている可能性を、この照合だけでは判断できません。

同じ報告の再送と、数量訂正を足し込まない

同じ報告を2行入れたO009は、重複分を一度だけ除外し、6個のまま扱えました。O010では、最初に6個と報告した後、訂正版で4個へ変更しています。6個と4個を足さず、訂正版の4個を採用しました。

O018は、いったん届いた報告を取り消した例です。最新の版が取消だったため、報告数量は0個へ戻ります。注文自体の取消と、出荷報告の取消は分けています。

同じ報告ID・同じ版番号に6個と7個が混在したO019は、どちらかを選ばず確認待ちにしました。受信順だけで採用する処理にはしていません。

7明細は、自動で問い合わせに回さなかった

確認待ちにしたのは、取消済みの注文への報告、数量超過、伝票番号の空欄、仕入先の不一致、同じ伝票番号の共有、訂正内容の矛盾です。伝票番号の共有が2明細あるため、合計7明細になります。

同じ伝票番号を使うこと自体が誤りとは限りません。複数の注文を一つの荷物にまとめた場合も考えられます。今回のデータには同梱の指定を持たせていないため、自動判定せず保留しました。

また、受注に存在しない注文番号の報告は、別の未照合一覧に残しました。こうした報告を無視して「全件処理済み」とはしていません。

出荷報告が追加されると、問い合わせ対象も減った

期限を過ぎた6明細から、A社宛て3明細、B社宛て2明細、C社宛て1明細の下書きを作りました。下書きには、受注数量、照合できた報告数量、残数、報告期限を入れています。メールアドレスは使わず、未送信のテキストファイルとして保存しました。

次に、A社からO002の残り6個と、O003の6個が届いた条件で再実行しました。確認時点を17時45分へ進めると、この2明細が問い合わせ対象から外れます。全体の対象は6明細から4明細となり、A社の新しい下書きにはO010だけが残りました。

古い結果の保存先を指定した場合は、入力の変更を検出して停止させています。新しい結果は別の場所へ保存しました。ただし、担当者の手元へコピーした古い下書きを回収する機能までは作っていません。送る直前に最新版を確認する工程は残ります。

CodexとPythonで、どこまで実行したか

Codexが照合ルールをコードにし、Pythonの標準機能でJSONの読込、数量の集計、日時の比較、下書きの保存を行いました。生成AIを開発に使っていますが、実行中にAIが荷物の状態を推測する処理はありません。

CLIを6回実行し、全20明細の判定・報告数量・問い合わせ対象を、あらかじめ決めた期待値と照合しました。再実行、入力変更、下書きの書き換え、タイムゾーンの欠落、期限ちょうどと1秒後の違いも含め、33の検査を通過しています。別々の33業務を検証したという意味ではありません。

今回、実装中に自然に発生した処理エラーは記録されていません。失敗として扱ったのは、伝票番号の有無だけで完了にする比較処理の誤判定です。入力を不正にした検査では、想定どおり停止することを確認しました。

実務に入れるなら、報告を受け取る場所から合わせる

今回は整えたJSONを入力にしています。仕入先のメールから本文を抽出する処理や、報告用フォーム、kintoneとの接続は作っていません。報告された数量が真実か、伝票番号が運送会社で有効かも確認していません。

実務で進める場合は、まず現在の受注データと出荷報告を見て、注文番号・仕入先・明細を共通の項目で照合できるか確認します。入力漏れが多いなら報告フォームを用意するなど、報告の受け取り方も合わせて考えます。取引先との期限や分納のルールを決めたうえで、少数の注文から照合結果を確認する進め方です。

今回できたのは、報告を集めた後に、どの明細を確認すればよいか絞り込むところまでです。報告を催促して届くまでの時間や、実際の作業時間の削減はまだ測っていません。

実行結果と配布資料

20明細の照合結果と問い合わせ下書きを掲載しました。初回の結果と、出荷報告を追加した後の変化を確認できます。伝票番号はすべて検証用の文字列で、実在の荷物には使っていません。

コード・入力・全実行記録のZIP、検査結果JSON、初回の照合結果JSONも用意しています。下書きには未出荷を断定せず、報告内容の確認を求める文面を入れました。