産業廃棄物・資源の受入れで、トラックスケールの計量票を読み取り、車番・品目・総重量・空車重量を受入の台帳に転記して、マニフェストの数量と照らす

処理の起点を決める

計量所で計量票とマニフェストをスキャンし、Cloud Storage のバケットに保存したことを起点にします。 これまでは昼と夕方に紙を事務所へ運んでいましたが、計量所でその場でスキャンすれば、出場から数分で読み取りが終わります。 当日の受入の量が、その日のうちに台帳に入ります。

スキャンは1台分ずつにします。計量票1枚と、その搬入のマニフェストを続けてスキャンし、1つのPDFにします。計量の番号が仕分けの鍵になるので、計量票を先頭にします。

処理が終わったファイルは処理済みの場所へ移し、移すのは成功したときだけにします。 残っているファイルが、そのまま未処理の数です。

入力データを集める

質を決めるのは、2つの辞書です。 計量票の項目名は計量器の機種で決まりますが、品目の手書きは担当ごとに言い方が違います。 「ミンチ」と書く人と「混合廃棄物」と書く人がいて、辞書が無いと同じ品目が別々に集計されます。

取引先と車両の一覧は、車番の書き直しを見つけるために持ちます。 印字の車番がその搬入元の車両の一覧に無く、手書きの車番が一覧にあれば、打ち間違えを書き直した票だと分かります。

データの取得方法を決める

読み取りは、Python から Form Parser のプロセッサにPDFを送るだけです。1台分のPDFは計量票とマニフェストで数ページなので、オンライン（同期）の要求で足ります。 プロセッサ一覧では、オンライン・同期の要求の上限は15ページで、画像なしのモードを有効にすると30ページまでとされています。

チェックボックスは、項目名との結び付きを確かめます。 公式ページでは、チェックボックスは最も近い文字を項目名にしたキーと値のペアとして取り出され、valueType でオンかオフかが示されるとされています。一方で、ラジオボタンには対応せず、検出したチェックボックスの一部には対応するキーが無い場合があるとも書かれています。キーが無いチェックは位置で判断せず、照合要確認 にします。

応答の中では、キーと値のペアはページごとの formFields に、表は tables に入ります。 応答の扱いの公式ページでは、チェックボックスがオンなら formFields の fieldValue の valueType が filled_checkbox、オフなら unfilled_checkbox になるとされています。「再計量あり」のチェックは、この値だけで判定します。 印字の文字の濃さや、チェックの近くの手書きから推し量りません。

電子マニフェストの分は、照会の画面から1日分を書き出して読みます。 紙のマニフェストとちがい、OCRを通しません。取り方は利用している環境によるので、書き出しの形を最初に決めます。

AIへ渡す前に整形する

1. 計量票とマニフェストを分ける … 先頭のページを計量票、続くページをマニフェストとして分け、計量の番号でひも付けます
2. 向きと傾きを確かめる … 計量票は細長い紙のことが多く、横向きにスキャンされがちです。向きを直してから送ります
3. 解像度を確かめる … 感熱紙の印字は薄くなりやすいので、300dpiでスキャンします
4. TIFF の形式を確かめる … 公式ページの制限事項では、TIFF の古い JPEG 圧縮には対応していないとされています。PDF でスキャンします
5. ページ数を確かめる … 1台分が15ページを超えることはまずありませんが、まとめてスキャンされたものは1台ずつに分けます
6. 二重のスキャンを見つける … 同じ計量の番号の票が直近にあれば、二重に処理しません

3番目を軽く見ないでください。 計量票の多くは感熱紙で、日に当たったり時間がたったりすると印字が薄くなります。 計量所でその場でスキャンするのは、事務所に運ぶあいだに薄くならないうちに読むためでもあります。

AIに処理させる

Form Parser にさせるのは、計量票とマニフェストに書かれていることを、項目名と値の組にすることだけです。 そのあとの対応づけ、計算、照合は、すべてプログラムが規則で行います。

2行目が、この構成でいちばん効く確かめです。 3つの数字のうち1つを読み違えれば、計算が合わなくなります。読み取りの信頼度に頼らなくても、計算で読み違えを見つけられます。 計量票ならではの強みです。

ただし、控除を手で書き足した票は、計算が合わないのが普通です。 印字の正味は控除を引く前の値だからです。控除がある票は、控除を引いた値を台帳の正味とし、追記あり要確認 で人に見せます。

3行目を外さないでください。 マニフェストの数量と計量の重さの差が大きいとき、マニフェストの誤りのことも、計量の誤りのことも、荷の取り違えのこともあります。 この構成が出すのは差があるという事実だけで、どれなのかは担当が排出事業者と確かめます。

指示内容を固定する

この構成では生成AIに指示文を渡しません。読み取りのあとの処理は、項目名の辞書と照合の規則です。 項目名の辞書は、計量票とマニフェストに出てくる言い方と、台帳の項目を1行に1つ対応させます。

# 項目名の辞書（読み取ったキー → 台帳の項目）
総重量, 総重, 入場重量, GROSS        → gross_kg
空車重量, 空車, 出場重量, TARE        → tare_kg
正味重量, 正味, 差引重量, NET         → net_printed_kg
車両番号, 車番, 車輌番号              → vehicle_no
搬入者, 搬入元, 取引先, 業者名         → supplier
異物控除, 控除, 引き                  → deduction_kg
再計量, 再計                          → reweigh_kg

# 照合の規則
- net_calc = gross_kg - tare_kg - deduction_kg（控除が無ければ 0）
- 控除が無い票で net_calc と net_printed_kg が一致しなければ「照合要確認」
- 手書きの領域に数字があれば「追記あり要確認」
- 品目が品目の辞書に無ければ「照合要確認」。近い品目を自動で当てない
- マニフェストの単位が kg または t のときだけ差の割合を出す
  差の割合 = |net_calc - manifest_qty_kg| / net_calc
  品目ごとに決めた割合（例：設定ファイルの tolerance）を超えれば「照合要確認」
- マニフェストの単位が m3・台・個のときは、差を出さず「単位が違う」と記録する

「近い品目を自動で当てない」を規則に書いているのは、意図してのことです。 「木くず」と「木くず（抜根）」は処理の方法も料金も違うことがあり、辞書に無い書き方を近い品目に寄せると、違う品目の料金で請求が出ます。 辞書に無いものは人が決めて、決めたものを辞書に足します。

差の割合の許容は、品目ごとに受入の担当が決めます。 汚泥のように水分で重さが大きく変わる品目と、金属くずのように変わりにくい品目で、同じ割合を使うと、片方は毎回引っかかり、片方はいつも素通りします。

出力形式を固定する

1台分ごとに、次の形のJSONにまとめ、確認の一覧と台帳の書き出しの元にします。

{
  "weigh_no": "",
  "weighed_at": "",
  "vehicle_no": { "printed": "", "handwritten": "", "master_match": "matched | not_found | corrected" },
  "supplier": "",
  "item": { "written": "", "item_code": "", "dictionary_match": true },
  "weights": {
    "gross_kg": 0, "tare_kg": 0, "net_printed_kg": 0,
    "deduction_kg": 0, "reweigh_kg": null, "net_calc_kg": 0,
    "net_consistent": true
  },
  "handwritten_fields": ["deduction_kg"],
  "manifest": { "type": "paper | electronic | none", "issue_no": "",
                "item": "", "qty": 0, "unit": "kg | t | m3 | 台",
                "diff_ratio": null, "unit_mismatch": false },
  "confidence_min": 0,
  "verdict": "台帳へ | 追記あり要確認 | 照合要確認"
}

1つ目の理由は、printed と handwritten を別に持てることです。 車番も重さも、計量器が出した値と人が書いた値を並べておけば、担当は画像を開く前に、何が書き直されたかを読めます。

2つ目は、net_calc_kg と net_consistent で計算の確かめが残ることです。 台帳に入る正味は net_calc_kg で、印字との一致は net_consistent に記録されます。

3つ目は、unit_mismatch で比べられない搬入を分けられることです。 単位が違うものは差を出さず、差が無いのではなく比べていないことを、一覧の上で区別します。

システムへ連携する

受入の台帳へは、この構成から書き込みません。 台帳は請求と支払いの元になるので、読み違えた重さが確かめる前に入る経路を作りません。

計量器にも、電子マニフェストにも書き込みません。 電子マニフェストの報告は、これまでどおり担当が画面で行います。

人が確認する

事務所の担当が開くのは 追記あり要確認 と 照合要確認 の票だけです。 台帳へ の票は、一覧で車番・品目・正味を流し見て、まとめて台帳に移します。

1. 照合要確認 の正味の不一致を先に見る … 計量票の画像で、3つの数字のどれを読み違えたかを確かめます。印字そのものがかすれていれば、計量所に計量の記録を確かめます
2. 追記あり要確認 の手書きを見る … 控除・再計量・車番の書き直しを画像で確かめ、値を直します。読めない手書きは、書いた計量所の担当に聞きます
3. マニフェストとの差を見る … 品目違いや差の大きいものは、計量所の担当と営業に確かめ、必要なら排出事業者に連絡します
4. 辞書に無い品目を決める … 台帳の品目コードを決め、品目の辞書に足します
5. 直したら記録する … どの値を、何から何へ直したかを残します

1番目を省かないでください。 正味の計算が合わない票は、読み違えたまま台帳に入れると、請求か支払いの額がそのままずれます。

目標は、1,500件をならして1件0.8分です。 要確認に回るのは2割前後という想定で、それより多い月は、感熱紙の印字の薄さか、品目の辞書の不足を疑います。

例外に対処する

上の2行は、感熱紙と票の作りの問題です。 計量所でその場でスキャンし、チェック欄の横に必ず文字を印字する様式に変えるほうが、読み取りの工夫より効きます。

記録を残す

• 計量票とマニフェストの画像、スキャンした日時
• Form Parser が返した結果の全文（キーと値のペア、表、信頼度）
• 判定の結果（JSONの全体）と、そのとき使った項目名の辞書・品目の辞書・許容の割合の版
• 人が値を直した記録 … どの値を、何から何へ
• 台帳へ移した日時と、移した担当
• マニフェストとの差について、だれに何を確かめたか
• 品目ごとの差の割合の分布

3つ目で辞書と許容の割合の版を残すのは、後から変えるためです。 許容の割合を見直すと、過去の照合の結果の意味が変わります。 当時の割合が残っていないと、なぜ素通りしたのかを説明できません。

最後の行は、許容の割合を決め直す材料になります。 品目ごとに差の分布を見れば、どこまでが普通の差なのかが、担当の経験ではなく数字で分かります。