海外から日本へ連れてくる犬・猫の英文の健康証明書と狂犬病の予防接種の証明書を読み取り、マイクロチップ・接種日・抗体検査の日を案件台帳に転記して、輸入の条件に照らした不足を到着前に拾う

処理の起点を決める

起点は、受付フォルダ（Amazon S3）にPDFが保存されたことです。 共有受信箱のルールで、案件ごとに登録した飼い主と現地の獣医師のアドレスから届いたメールの添付を、件名の案件番号を付けてS3へ転送します。保存の通知で AWS Lambda が動き、読み取りから台帳への記録までを済ませます。

書類は少しずつ届くので、届くたびにその案件の全書類で計算をやり直します。 先に届いた書類だけで数えた結果は「途中」と印を付け、確定した結果と混ぜません。

毎朝8時にも1回動かします。 日付が進むことで変わる印があるからです。

入力データを集める

質を決めるのは、下から3つ目と2つ目の表です。 規則の表に起点の扱い（その日を0日目とする）を書いておかないと、プログラムも人と同じ取り違えをします。指定検査施設は、指定が取り消された例があります。 一覧には指定の状態と、確かめた日を持たせます。

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

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

答えが空の項目は、全文から欄の見出しの語を探し、無ければ missing にします。

接種の記録は TABLES の表から行ごとに取ります。 質問の答えは1つの値しか返らないことがあるので、突き合わせに使います。

手書きの欄は TextType が HANDWRITING として返るので、確認の優先度を上げて一覧に出します。規則の表、指定検査施設の一覧、案件台帳は Python が読み、生成AIには渡しません。

AIへ渡す前に整形する

1. 形式の確認 … JPEG、PNG、PDF、TIFF であることを確かめます
2. パスワードの確認 … PDFはパスワードで保護できないとされています。保護されたものは送り元に解除したものを頼みます
3. サイズとページ数の確認 … 非同期の処理で、PDFとTIFFは500MB・3,000ページまでです
4. 書類の振り分け … 1ページ目の見出しの語（Form AC、ATTACH、Vaccination、Rabies Antibody、FAVN、Microchip）で振り分けます
5. 言語の確認 … 6言語に入らない書類は読み取りに回さず、担当者が目で見る一覧に入れます
6. 文字の大きさの確認 … 検出できる文字の高さは15ピクセル以上で、150DPIで8ポイントに当たるとされています。写真で届いたものはスキャンし直してもらいます
7. 案件の特定 … 件名の案件番号と、書類のマイクロチップの番号で、案件台帳の行を引きます

7番目で番号を先に引くのは、2頭の案件で書類の個体の取り違えが起きるからです。 番号が台帳に無ければ、案件を決めずに人へ回します。

AIに処理させる

させるのは、各欄を原文のまま取り出し、値が何を表すかを書き出すことです。 日付の計算と条件の照合はさせません。

日付は、原文と解釈を両方持たせます。 月が英語の名前で書かれているか、書類に日付の書式（DD/MM/YYYY など）が明記されているときだけ解釈を入れ、決まらなければ解釈を空にして ambiguous にします。 案件の出発地から日付の順序を推すことはさせません。米国にいる欧州の獣医師もいるからです。

4行目がいちばん起きやすい失敗です。 2つの書類を一緒に渡すと、Form AC の空いた欄を病院の証明書の値で埋めて返し、Form AC の書き漏れが消えます。 書類は1通ずつ渡します。

指示内容を固定する

あなたはペットの輸送代行会社で、犬・猫の輸入に使う英文の書類の
記載を記録する担当です。
OCRの読み取り結果だけを使ってください。推測で埋めないでください。
渡すのは1通の書類だけです。他の書類の値で埋めないでください。

【取り出す項目】
document_type、animal（species_raw、name_raw、birth_date_raw、birth_date、age_raw）、
microchip（number_raw、implant_date_raw、implant_date）、
vaccinations（配列：date_raw、date、valid_until_raw、validity_raw、
  vaccine_type_raw、product_raw、manufacturer_raw）、
antibody（blood_date_raw、blood_date、titre、titre_unit_raw、lab_name_raw）、
clinical_exam（date_raw、date、finding_raw）、
endorsement（signature_detected、authority_raw）、
handwritten_fields（配列）、date_format_stated（書類に書かれた日付の書式）

【status の選び方】
- ok ............. 値が読み取れており、その欄として解釈できる
- blank .......... 欄はあるが空
- missing ........ 欄そのものが見当たらない
- unreadable ..... 文字は検出されているが値として確定できない
- ambiguous ...... 候補が複数ある、または日付の日と月の順序が決まらない
- unit_unknown ... 抗体価の単位が決まらない

【厳守事項】
- 日付は、月が英語の名前で書かれているか、書類に日付の書式が明記されて
  いるときだけ YYYY-MM-DD で解釈を入れてください。決まらなければ解釈を
  空にし、ambiguous にしてください。国や地域から推さないでください。
- 日数を数えないでください。条件を満たすかも書かないでください。
- マイクロチップの番号は、読めた数字だけをそのまま入れてください。
  桁を補わないでください。
- 予防液の種類は、書かれた語をそのまま写してください。
  製品名から種類を推さないでください。
- 抗体価は数値と単位を分けてください。単位を換算しないでください。
- 接種が複数あるときは、書かれた順に配列に入れてください。
- 輸入できるか、係留が要るかを書かないでください。
- 犬・猫の輸入の書類でないと判断した場合は、項目を取り出さず
  document_type に種類を書いてください。

【書類の種類の見込み】{document_type_hint}
【読み取り結果】{textract_result}

「国や地域から推さない」を書かないと、米国の案件の 04/05/2026 を4月5日と決めて返します。 獣医師が欧州の書き方なら、待機の日数が1か月ずれます。

出力形式を固定する

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

{
  "file": "",
  "document_type": "form_ac",
  "microchip": { "number_raw": "392141000123456", "implant_date_raw": "12 Jan 2026", "implant_date": "2026-01-12" },
  "vaccinations": [
    { "date_raw": "12 Jan 2026", "date": "2026-01-12", "validity_raw": "1 year",
      "vaccine_type_raw": "Inactivated", "product_raw": "", "manufacturer_raw": "" }
  ],
  "antibody": { "blood_date_raw": "03/03/2026", "blood_date": "", "titre": 2.1,
                "titre_unit_raw": "IU/ml", "lab_name_raw": "" },
  "endorsement": { "signature_detected": false, "authority_raw": "" },
  "items": [
    { "item": "antibody.blood_date", "status": "ambiguous", "confidence": 0, "source": "" }
  ]
}

構造化出力では、数値の最小・最大の制約をスキーマに書けません。 公式のページでは、minimum や maximum といった数値の制約は対象外とされています。抗体価が0.5以上かどうかは、スキーマではなく Python の規則で見ます。

1つ目の理由は、日数の計算をプログラムの側に置けることです。 Python が案件の全書類を集め、規則の表に沿って数えて印を付けます。

2つ目の理由は、起点の扱いを規則に書けることです。 規則の表に「採血日を0日目」のように起点を書き、Python は差の日数をそのまま比べます。

システムへ連携する

動物検疫所への届出と、飼い主・獣医師への連絡は、この構成からは行いません。 届出はNACCSか届出書で担当者が出します。届出の内容は、担当者が確かめた台帳の値から作ります。

人が確認する

担当者は全件を一覧で確かめます。 一覧には、案件ごとに日付の計算の結果、欄の埋まり方、手書きの欄、裏書きの有無を1行で出します。

1. sequence_issue を最初に片付ける … 処置のやり直しが要るかもしれない案件です。飼い主と現地の獣医師に事実を伝え、動物検疫所への相談を勧めます
2. deadline_near を見る … 届出の期限が近い案件は、書類がそろっていなくても届出の準備を先に進めます
3. conflict の正しい値を確かめる … 現地の獣医師にどちらが正しいかを確かめ、Form AC を直してもらいます。証明書の訂正に修正テープや修正液を使わないよう、あわせて伝えます
4. needs_human の値を画像で確定させる … 日付の順序、手書きの数字、検査施設名を確かめます

1番目で「やり直しが必要」と断定しないでください。 条件付きで認められる場合もあるとされており、伝えるのは数えた事実までです。

例外に対処する

記録を残す

• 元の書類と、受け取った日時、送り元、メールの件名
• AWS Textract が返したJSONの全文と、使った質問の一覧
• Claude API が返したJSON（原文と解釈の両方）
• 日付の計算の結果と、そのとき参照した規則の表と指定検査施設の一覧の版
• 担当者が印を覆した記録と、飼い主・獣医師への問い合わせの回答
• 届出を出した日と、届出受理書を受け取った日