金券ショップが持ち込まれた商品券・切手の写真を Gemini で読み、券種・額面・枚数の買取の明細と古物の帳簿の下書きを作る

処理の起点を決める

担当が買取の台に並べ終えて「読み取る」を押したときに動きます。 写真は書画カメラから窓口の端末に入り、受付の番号と一緒にサーバーに送られます。 並べている途中で読ませないよう、ボタンは担当が押します。

並べ方を決めておきます。 台には升目を印刷したマットを敷き、1つの升に1枚、券種ごとに行を分けて並べます。 重ねない、裏返さない、帯や封筒から出す。この決まりが、枠の数を実物の枚数に近づけます。

切手のシートは、シートのまま1枚として置きます。 シートの面の数は Gemini に数えさせ、枠はシート全体に1つ、面の数は別の欄で返させます。 バラの切手は、升に1枚ずつ置きます。

この構成を使うのは窓口の担当と店長だけで、全員が18歳以上の社員です。 Gemini API の規約は、18歳以上であることを利用の条件とし、18歳未満の人に向けた、または使う見込みのあるアプリでの利用を認めていません。 お客様が端末を触ったり、AIの結果を直接見たりすることはありません。

入力データを集める

質を決めるのは、券種の一覧です。 券面には発行元の名前、券の種類、額面、注意書きが小さく印刷されていて、似た名前の券が何種類もあります。 一覧に「券面の表記」と「表の行の名前」の対を持たせておけば、Gemini が読んだ文字を表の行に結び付けられます。

相手方の情報は、AIに渡しません。 お客様の名前・住所・年齢・身分証の写真は、買取の写真とは別の画面で扱い、Gemini API に送る写真には含めません。 買取の台の上に身分証を置かないことも、窓口の決まりにします。

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

写真は書画カメラから窓口の端末を通して、サーバーに直接届きます。 受付の番号のフォルダに元の写真を保存し、保存が終わってから AI を呼びます。

Gemini API へは、台の写真1枚ごとに1回呼びます。 台を分けて撮ったときは写真ごとに呼び、サーバーが写真の番号と枠の番号を組み合わせて明細にします。 1回に複数の写真を入れることもできますが、枠がどの写真のものかが混ざらないよう、1枚ずつにします。

券種の一覧と買取率の表は、サーバーが朝に1回読み込みます。 店長が表を直したら読み直し、その版の番号を、明細の下書きと一緒に記録します。

有料の利用枠で使い、store を false にします。 Gemini API の規約では、有料のサービスではプロンプトと応答が製品の改善に使われないとされています。Interactions API は既定でやり取りを保存し（有料の枠で55日）、store=false で保存しない動きにできると案内されています。

AIへ渡す前に整形する

1. 向きの補正 … 端末の写真の向きの情報で回転しているだけのものは、画素を回転させます
2. 大きさの確認 … 券面の小さな文字が読めるよう、縮めすぎません。写真と指示の文を合わせて20MBを超えないかを見ます
3. 写り込みの塗りつぶし … 台の外に写ったお客様の手、身分証、レシートを塗りつぶします
4. 升目のマットの検出 … マットの四隅が写っていない写真は、その場で撮り直してもらいます
5. 明るさとぶれの確認 … 暗い・ぶれている写真は、AIに渡さずにその場で撮り直してもらいます

4番目は、枠の数を確かめる手がかりのためです。 升目が写っていれば、サーバーは升の数と枠の数を比べられます。 升に券が置かれているのに枠が無い、1つの升に枠が2つある、という食い違いを先に印にできます。

照明の映り込みにも気をつけます。 商品券の中には、券面に光沢のある箔や印刷が使われているものがあります。真上の照明が箔に映ると、額面の数字がその部分だけ白く飛びます。 書画カメラの照明は斜めから当て、映り込みで読めない件が続く券種は、券種の一覧に「斜めから撮る」と書いておきます。

AIに処理させる

させるのは、券面に印刷された文字を写すことと、1枚ずつの位置を枠で返すことです。

右端の列が大事です。 unreadable は「券面にあるはずの文字が読めない」、none_printed は「期限の印刷が見当たらない」で、前者は撮り直すか担当が読むもの、後者は券種の一覧で期限の有無を確かめるものです。 混ぜると、期限のある券を期限なしとして買い取ることになります。

5行目がいちばん起きやすい失敗です。 百貨店の商品券は1,000円が多いので、額面が指で隠れていても1,000円と返したくなります。 読めないものは unreadable にさせ、担当が実物で読みます。

1行目を AI に任せないのは、写真で分かることではないからです。 古物営業法は、古物を買い受けようとする場合に不正品の疑いがあると認めるときは、直ちに警察官にその旨を申告しなければならないとしています。疑いを持つのは担当で、AI の結果は判断の材料にしません。

指示内容を固定する

あなたは金券ショップの買取の窓口で、買取の台の写真を見る補助です。
写真には升目のマットの上に、商品券・ギフト券・切手・はがき・印紙が並んでいます。
写真に写っているものだけを答えてください。推し量って埋めないでください。

【返すこと】
1. 1枚ずつ（切手のシートはシート全体で1つ）の位置を box_2d で返す
2. 券面に印刷された発行元の名前・券種・額面・有効期限を、印刷のとおりに写す
3. 切手のシートのときは、見えている面の数を返す
4. 破れ・汚れ・記名・スタンプ・書き込みの候補を返す

【厳守事項】
- 額面・期限が指や他の券で隠れている、ぼやけている場合は unreadable にしてください。
  券種から額面を推し量らないでください。
- 期限の印刷が見当たらない場合は none_printed にしてください。
  見当たらないことを「期限なし」と言い換えないでください。
- 2枚以上が重なっている場合は、重なりの印（overlap）を付けてください。
- 本物かどうか、買い取れるかどうか、金額は答えないでください。
- 券面の文字を、ほかの名前に言い換えたり、正式な名前に直したりしないでください。
- 傷みは見えるものだけを候補として挙げ、迷ったら uncertain にしてください。
- 金券ではない物（身分証、レシート、封筒）が写っていたら、other として位置だけ返してください。

【券種の一覧の表記（参考）】{voucher_names}

「期限なしと言い換えない」を明記しないと、期限の印刷が見つからない券を「無期限」と返します。 券によっては裏面に期限があり、表の写真に無いだけかもしれません。 券種の一覧で期限の有無を確かめるのは Python と担当です。

券種の一覧の表記を参考に渡すのは、読みの手がかりにするためです。 ただし「正式な名前に直さない」と書いておかないと、似た名前の別の券に寄せて返すことがあります。 照らし合わせは Python が行います。

出力形式を固定する

次の形のJSONで受け取ります。

{
  "photo_id": "",
  "items": [
    {
      "no": 1,
      "box_2d": [0, 0, 0, 0],
      "kind": "gift_card | stamp_single | stamp_sheet | postcard | revenue_stamp | other",
      "issuer_text": "",
      "type_text": "",
      "face_value_text": "",
      "face_value_status": "ok | unreadable",
      "expiry_text": "",
      "expiry_status": "ok | none_printed | unreadable",
      "sheet_count": 0,
      "sheet_status": "ok | partial | not_sheet",
      "damage": ["tear | stain | name_written | stamp_mark | writing | uncertain"],
      "overlap": false
    }
  ]
}

1つ目の理由は、文字と状態を分けて持てることです。 face_value_text は券面の文字、face_value_status は読めたかどうか。Python は ok のものだけを表と照らし、unreadable のものは担当の確認の行に回します。

2つ目は、枠に番号があることです。 画面の写真の枠に no を描き、明細の行にも同じ番号を付けます。担当は「7番の額面が読めていない」と、写真と明細を行き来せずに確かめられます。

3つ目は、kind を決まった値に絞れることです。 スキーマの enum で stamp_sheet などに限れば、Python がシートの面の数を使うか、1枚として数えるかを機械的に分けられます。

Python は、次の形の明細の下書きにします。

受付 2611-0457 ／ 買取率の表 版 2026-11-04-1
| 枠 | 券種（表の行） | 額面 | 枚数・面数 | 期限 | 傷み | 買取率 | 金額 | 確認 |
| 1〜12 | 百貨店共通商品券 | 1,000円 | 12 | 印刷なし（一覧：期限なし） | なし | （表） | （計算） | 要：枠と実物 |
| 13 | ギフト券 ○○ | 読めない | 1 | － | 汚れ | － | － | 要：額面を担当が読む |
| 14 | 切手シート | 84円 | 10面 | － | なし | （表） | （計算） | 要：面の数 |

システムへ連携する

買取の管理の画面へは、下書きとして返すだけです。 金額を確定させるのは、担当が確かめて「確定」を押したときです。確定しないまま代金が払われる経路は作りません。

古物の帳簿へも、下書きを作るまでです。 古物営業法は、古物を受け取ったときに、取引の年月日、古物の品目及び数量、古物の特徴、相手方の住所・氏名・職業・年齢、とった確認の措置の区分を帳簿等に記載するか電磁的方法で記録することを求めています。下書きが埋めるのは品目及び数量と特徴までで、相手方の欄と確認の措置は担当が書きます。

人が確認する

1. 枠と実物を見比べる … 枠の数と台の上の枚数が同じか、重なりの印が無いかを見ます
2. unreadable の行を実物で読む … 額面と期限を担当が読み、明細を直します
3. 期限と傷みを確かめる … 期限切れの印と傷みの候補を実物で見て、買い取らないものを分けます
4. 本物かどうかを実物で確かめる … 店の決まりの見方で、担当が実物を手に取って見ます
5. 金額を伝える前に合計を見る … 合計が1万円以上なら、相手方の確認が要ることを担当が確かめます

5番目は、古物営業法の決まりから来ています。 法は、古物を買い受けようとするときに相手方の真偽を確認する措置をとることを求め、対価の総額が国家公安委員会規則で定める金額未満である取引は除くとしています。その金額は、古物営業法施行規則で1万円と定められています。画面には、合計が1万円以上の明細に確認が要る印を出します。 確認そのものは担当が行います。

4番目は、写真の結果と切り離して行います。 枠と明細の下書きがどれだけ整っていても、本物かどうかは実物の手ざわりや透かしで見るものです。 画面が速くなったぶん、担当が実物を手に取る時間を削らないよう、窓口の手順書では4番目を独立した手順として書きます。

目標は、900件をならして1件2分です。 枠と実物が一致し、読めない行の無い件は1分ほど、読めない行や重なりの多い件、シートの多い件は4分ほどかかります。

例外に対処する

最後の行のために、手で数える手順を残しておきます。 窓口は止められないので、API が止まっても今までのやり方で受けられることが前提です。 画面には手で打ち込む欄を残します。手で受けた件も受付の番号で残し、API が戻ったあとに写真を撮って明細と見比べておけば、手で数えた件の数え違いもあとから拾えます。

記録を残す

• 元の写真と、塗りつぶした後の写真
• Gemini が返したJSONの全文と、呼んだ日時
• 明細の下書きと、担当が直したところ（どの枠の何を、どう直したか）
• 使った買取率の表の版の番号
• 確定した明細と、帳簿の下書きと、担当が書き足した欄
• 枠と実物が食い違った件と、撮り直しの回数

3つ目の「担当が直したところ」を残すのは、指示と並べ方を直す材料にするためです。 同じ券種で額面が読めない件が続くなら、並べ方か、券種の一覧の表記に理由があります。

帳簿の記録は、法の決まりの期間残します。 古物営業法は、帳簿等を最終の記載をした日から3年間備え付けること、電磁的方法による記録は3年間直ちに書面に表示できるようにして保存することを求めています。写真と明細の保存の期間も、店長がこれに合わせて決めます。