海外の再保険会社から毎月届く英文の再保険精算書を読み取り、保険料・手数料・回収保険金を出再台帳と照合して、差異を理由の候補付きで出す

処理の起点を決める

受付フォルダ（Amazon S3）に精算書が保存されたことを起点にします。 再保険部の共有のメールアドレスに届いた添付を受付フォルダに入れる仕組みを置き、ファイル名の先頭に出再契約のコードを付けます。コードが分からない精算書は「未特定」のフォルダに入れ、契約名の読み取りの結果から候補を出します。

届いた順に1通ずつ処理します。 月末にまとめて処理すると、照会の回答を待つ時間が無くなります。届いた日のうちに差異と理由の候補が出ていれば、その週のうちに照会を送れます。

さらに、月の第3営業日に「まだ届いていない精算書」の一覧を出します。 出再台帳の契約ごとの精算の周期から、今月届くはずの精算書を数え、届いた分と突き合わせます。

入力データを集める

質を決めるのは、向きの規則表です。 同じ Cr でも、自社から見た貸方か、相手から見た貸方かで意味が逆になります。規則表に無い相手の精算書は、符号を付けずに人に回します。

項目名の対応表も同じくらい大事です。 Commission と Profit Commission と Brokerage は別の項目で、寄せると手数料の料率の検算が成り立ちません。対応表にある書き方だけを使い、無いものは unmapped として人に見せます。

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

読み取りは StartDocumentAnalysis にS3の場所と FeatureTypes を渡して始めます。完了は NotificationChannel に指定した Amazon SNS のトピックに通知され、状態が SUCCEEDED なら GetDocumentAnalysis で結果を取ります。

質問の答えが見つからなければ空のまま返ります。 期間が空なら、表題や全文から Quarter、Period、Month を含む行を探し、それでも無ければ missing にします。期間を受け取った月で埋めません。 期間のずれは差異の理由の型の1つで、埋めるとその型が検算できなくなります。

明細の表は、セルの行と列の番号で組み立て直します。 列見出しから 100% の列と自社のシェアの列、Debit と Credit の列を決め、行ごとに「項目名・100％の値・シェアの値・向き」の組にします。 合計の行の種類が付いたセルは、明細と分けて残高の照合に使います。

結果は1回最大1,000ブロックで区切られます。NextToken が返る限り呼び直し、別ページの明細が抜けないようにします。

出再台帳は再保険の管理の仕組みからCSVで出し、Python が読みます。生成AIには渡しません。

AIへ渡す前に整形する

1. 形式の確認 … JPEG、PNG、PDF、TIFF であることを確かめます
2. パスワードの確認 … PDFはパスワードで保護されていてはいけないとされています。保護されたものは相手に解除したものを頼みます
3. サイズとページ数の確認 … 非同期の処理で、PDFとTIFFは500MB・3,000ページまでです
4. スキャンの解像度の確認 … 文字の高さは最小15ピクセルで、150 DPIで8ポイントの文字に相当します。明細の小さな数字は、ファクスやスキャンの精算書で下回りやすい箇所です
5. 契約の特定 … ファイル名のコードで出再台帳の契約を引き、項目名の対応表と向きの規則表を選びます
6. 同じ精算書の再送の検知 … 同じ契約・期間・残高のものがすでにあれば、再送として印を付けます。残高が違えば訂正版として扱い、前の版と並べます

6番目の訂正版の扱いを先に決めておいてください。 精算書は訂正されて再送されることがあり、前の版の差異の理由が、訂正版で消えていることがあります。

AIに処理させる

させるのは、明細の各行を社内の勘定の区分に対応付け、金額と向きの書き方を原文のまま書き出すことです。 符号を付けること、照合と検算はさせません。

向きは、書き方を原文のまま取り出させるだけです。 括弧が付いているか、どの列に入っているか、表紙にどう書かれているか。それを正の数か負の数かに直すのは、規則表を持つ Python です。 AIに符号まで付けさせると、精算書がどちらから見た向きかを推測で決めてしまいます。

100％の値とシェアの値を分けるのも、同じ理由です。 列見出しで区別できないときは、どちらかに寄せず ambiguous にします。

3行目がいちばん起きやすい失敗です。 差異の金額を見せて「理由を考えて」と頼むと、為替や期間のそれらしい理由を書いてきます。検算で当てはまっていない理由が1行あると、担当者はそれを信じて照会をしなくなります。

指示内容を固定する

あなたは損害保険会社の再保険部で、海外の再保険会社・ブローカーから届いた
英文の再保険精算書を、照合用の行にそろえる担当です。
OCRの読み取り結果だけを使ってください。推測で埋めないでください。

【取り出す項目】
header：treaty_name_raw、period_raw、period_start、period_end、currency、
        our_share_raw、balance_raw、balance_direction_raw
lines：明細の各行について、次を入れてください。
  item_raw（原文の項目名）、account_code（項目名の対応表の社内の区分）、
  amount_100_raw、amount_share_raw、direction_raw（Dr / Cr / parentheses /
  minus / none と、その原文）、status、source（ページと表の行・列）

【厳守事項】
- 金額は書かれた数字の文字列のまま入れてください。符号を付けたり、
  括弧を外して正の数にしたりしないでください。
- 向きは direction_raw に書き方をそのまま入れてください。
  どちらが支払うかを解釈しないでください。
- 100%の列とシェアの列を区別できない場合は、どちらにも入れず
  status を ambiguous にしてください。
- シェアの値が無いときに、100%の値とシェアから計算しないでください。
- account_code は項目名の対応表にある書き方のときだけ入れ、
  無ければ空にして status を unmapped にしてください。
- 期間が書かれていなければ missing にしてください。
- 差異やその理由を書かないでください。

【読み取り結果】{textract_tables_forms_queries}
【項目名の対応表】{item_alias_table}

「括弧を外さない」を明記しないと、外します。 (12,345.00) を 12345.00 として返し、負の数だったという情報がその場で消えます。 原文の文字列を残しておけば、規則表で何度でも読み直せます。

出力形式を固定する

Claude API の構造化出力（output_config.format に json_schema を指定）で、次の形のJSONを受け取ります。

{
  "file": "",
  "treaty_code": "",
  "header": { "treaty_name_raw": "", "period_raw": "Q2 2026", "currency": "USD",
              "our_share_raw": "15%", "balance_raw": "48,210.55", "balance_direction_raw": "Balance due to you" },
  "lines": [
    { "item_raw": "Premium", "account_code": "PREM", "amount_100_raw": "1,250,000.00",
      "amount_share_raw": "187,500.00", "direction_raw": "Cr", "status": "ok", "source": "p2:T1:R4" }
  ]
}

1つ目の理由は、符号と照合をプログラムの側に置けることです。 Python が規則表で符号を付け、出再台帳の同じ期間の値と項目ごとに照合します。

2つ目は、差異の型ごとの検算ができることです。 差異のある項目について、Python が順に次の検算を行い、当てはまった型を付けます。

3つ目は、理由の説明文の材料が検算の結果だけになることです。 AIが説明文を書くのは、explained の型と検算の数字を渡されたときだけで、型の無い差異については何も書かせません。

システムへ連携する

出再台帳と会計システムへは書き込みません。 差異の処理と計上は、責任者が決めてから人が行います。照会も自動では送りません。 照会の英文は下書きまでです。

人が確認する

再保険の経理の担当者が開くのは、matched 以外の印が付いた精算書です。 matched の精算書は、残高と期間を並べた一覧で流し見て確定します。

1. needs_human を先に片付ける … 向きの規則表に無い相手なら規則を1行足し、unmapped なら対応表に足すかを決めます
2. explained の検算を確かめる … 型と検算の数字を画像と見比べ、その型で本当に説明がつくかを担当者が判断します
3. unexplained を責任者に上げる … 照会の下書きを直し、送るかを決めてもらいます
4. 処理を決めた結果を残す … どの差異を、どう処理したかを照合結果の一覧に書きます

2番目を流さないでください。 型が当てはまっても、それが本当の理由とは限りません。シェアで説明できる差異が、実は台帳のシェアの入力の誤りだった、ということもあります。

例外に対処する

上から5行目が、相手を1社足すたびに出ます。 規則を1行足せば次からは自動で符号が付くので、最初の数か月で規則表を育てるのが、この構成のいちばんの仕事です。

記録を残す

• 元の精算書と、受け取った日時、出再契約のコード、訂正版かどうか
• AWS Textract が返したJSONの全文と、使った質問の一覧
• Claude API が返したJSON（明細の全行の原文と対応付け）
• Python の照合と検算の結果と、そのとき使った向きの規則表・項目名の対応表・出再台帳の版
• 担当者が型や印を覆した記録 … どの項目を、どう判断したか
• 照会と回答、処理の決定とその理由

規則表の版を残すのは、規則を直すと過去の符号の意味が変わるためです。 当時の規則が残っていないと、前の四半期の差異がなぜその向きで出たのかを説明できません。