医療費レシートOCRからExcel自動入力まで -- Gemini APIで87件を一括処理した記録

やりたかったこと

確定申告の医療費控除に向けて、手元に溜まったレシート画像87件を国税庁の医療費集計フォーム（Excel、v3.1）に入力する必要があった。手作業だと1件あたり数分かかるので、OCRで読み取ってExcelに自動入力する仕組みを作った。

レシート画像87件をGemini APIに投げてOCR処理した。読み取り対象は以下の項目。

結果、87件すべてエラーなしで読み取り完了。手書きレシートや感熱紙でかすれたものも含まれていたが、Geminiの画像認識精度が高く、目視確認で修正が必要だったのは数件程度だった。

医療費集計フォーム v3.1 は、シートの保護やセル結合が多く、プログラムから書き込む際にいくつかハマりどころがあった。

最初の実装ではExcelの日付型（シリアル値）で書き込んでいた。しかし、国税庁フォームは日付セルを文字列として扱う想定になっており、シリアル値だと表示がずれる。

修正として、日付を文字列「YYYY/M/D」形式（例: 2026/1/15）で書き込むように変更した。月・日のゼロ埋めなし形式が国税庁フォームの表示と一致する。

この処理を繰り返し使えるように、/import-medical-receipts というスラッシュコマンドとして実装した。

tax-assistant の既存パターンをベースにした構成で、以下の機能を持つ。

OCR後にレシート画像を整理しやすくするため、命名規則を決めてリネームを行った。

{患者名}_{医療機関名}_{YYYYMMDD}_{金額}円.jpg

例: 山田太郎_A内科_20260115_1520円.jpg

バックアップを先に取ることで、リネーム中のエラーで元ファイルが失われるリスクを避けた。

レシートによっては患者名が印字されていないものがある。その場合は以下のルールで推定した。

完全に推定できないケースはファイル名に「不明」を入れて、後から手動で確認できるようにした。

同じレシートを二重に入力しないよう、以下の条件で重複判定を行った。

4項目すべて一致した場合に重複と判定し、スキップする。同日・同医療機関でも金額が異なれば別レシートとして扱う（再診料と検査料が別レシートになるケースがある）。

Excelに集計用のシートを追加した。Google Spreadsheetで先に作っていた集計表のレイアウトを参考に、患者別の合計金額を表示するシートを生成する。

集計内容:

国税庁のExcelフォームは「元ファイルを直接変更しない」運用とした。

こうすることで、スクリプトのバグで書き込みが壊れた場合でもやり直せる。確定申告関連のファイルは特に慎重に扱いたい。