# AIによる通帳OCRインポート機能

### 概要

銀行明細書の紙や画像をOCR（光学文字認識）技術で読み取り、預かり金口座の取引データとして自動的にシステムにインポートする機能です。手動でのデータ入力作業を削減し、財務データの入力効率を大幅に向上させることができます。

この機能は、Google Cloud Vision APIによる高精度な日本語テキスト認識と、AI（Claude API）による構造化データ解析を組み合わせることで、銀行明細書から正確に取引情報を抽出します。

※後見事件ファイル限定機能です（2025年11月20日現在）

### 主な機能

#### OCRによる自動データ抽出

通帳の見開き一ページや銀行明細書画像をアップロードするだけで、以下の情報を自動的に抽出します：

* **取引日**: 日本語の日付形式（令和・平成を含む）を自動認識
* **摘要**: 取引の内容や相手先名
* **金額**: 入金は正の値、出金は負の値として自動判定
* **残高**: 各取引後の口座残高

#### プレビューと編集機能

インポート前に抽出されたデータをプレビュー画面で確認でき、必要に応じて以下の操作が可能です：

* 取引の収支内容の登録
* データの編集（日付、金額、摘要の修正）
* 不要な取引の選択解除
* エラーや警告が設定された取引の確認
* データの妥当性チェック結果の確認

#### データ検証と重複チェック

システムが自動的に以下の検証を実行します：

* 必須フィールド（取引日、金額）の存在確認
* 日付の妥当性チェック
* 金額の異常値チェック
* 重複取引の自動検出

#### 一括インポート

検証済みのデータを一括でデータベースに保存します。エラー発生時は全ての変更が自動的にロールバックされ、データの整合性が保証されます。

### 利用方法

#### 1. インポート画面へのアクセス

1. firmeeにログインします
2. 後見等の事件ファイルを選択します
3. 「経費」タブから「預かり金口座」を選択します
4. 「銀行明細書をインポート」ボタンをクリックします

#### 2. 画像のアップロード

1. インポート画面で「ファイルを選択」ボタンをクリックします
2. 銀行明細書の画像ファイルを選択します
   * **対応形式**: JPEG、PNG
   * **ファイルサイズ**: 最大20MB
   * **推奨**: 通帳の見開き一ページずつアップロード
3. 「アップロード」ボタンをクリックします

#### 3. 処理の待機

システムが自動的に以下の処理を実行します（通常10〜30秒）：

1. Google Cloud Vision APIによるテキスト抽出
2. AI（Claude API）による取引データの構造化
3. データの妥当性検証

#### 4. プレビューと編集

抽出された取引データがプレビュー画面に表示されます：

1. 各取引の内容を確認します
2. 必要に応じて取引をクリックして編集します
3. 不要な取引はチェックボックスを外して除外します
4. エラーや警告がある取引は黄色または赤色でハイライト表示されます

#### 5. インポート実行

1. 全ての取引データを確認したら「インポート実行」ボタンをクリックします
2. システムが選択された取引を一括でデータベースに保存します
3. 成功メッセージとインポート件数が表示されます
4. 預かり金口座の取引一覧画面に自動的に移動します

### 対応する銀行明細書

#### 対応している形式

* 通帳のスキャン画像（見開き一ページ）
* スマートフォンで撮影した通帳の写真

#### 画像品質の推奨事項

より高い精度でOCR処理を行うために、以下の点にご注意ください：

* **解像度**: 300dpi以上を推奨
* **明るさ**: 明るく鮮明に撮影
* **角度**: 真正面から撮影し、歪みを最小限に
* **ピント**: 文字がはっきりと読める状態
* **影**: 影が入らないように注意

### 注意事項

#### セキュリティとプライバシー

* アップロードされた画像ファイルは処理完了後、即座にシステムから削除されます
* 画像データは暗号化された通信（HTTPS）で送信されます
* 処理中の画像は一時的にサーバーの安全な領域に保存され、他のユーザーからアクセスすることはできません

#### データの正確性

* OCR技術は高精度ですが、100%の正確性を保証するものではありません
* インポート前に必ずプレビュー画面でデータを確認してください
* 特に金額や取引日については慎重にご確認ください

#### 重複データの防止

* システムは同一の取引日・金額・口座IDを持つ取引を重複として自動検出します
* 重複が検出された取引は自動的にインポートがスキップされます
* 意図的に同一の取引を複数回インポートすることはできません

#### エラー発生時の対応

エラーが発生した場合、システムは具体的なエラーメッセージと対処方法を表示します：

* **「テキストが検出されませんでした」**: 画像が鮮明であることを確認し、再度アップロードしてください
* **「数分後に再度お試しください」**: 外部APIが混雑しています。時間をおいて再試行してください
* **「しばらく時間をおいてから再度お試しください」**: APIのレート制限に達しました。少し時間をおいてから再試行してください

### よくある質問（FAQ）

#### Q1. 一度に複数ページをアップロードできますか？

A1. 現在のバージョンでは、一度に一ページ（見開き一ページ）のみアップロード可能です。複数ページをインポートする場合は、ページごとに繰り返しアップロードしてください。

#### Q2. OCR処理にかかる時間はどれくらいですか？

A2. 通常10〜20秒程度で処理が完了します。取引件数が多い場合はやや時間がかかる場合があります。

#### Q3. 手書きの明細書には対応していますか？

A3. 印刷された文字の認識に最適化されており、手書き文字の認識精度は低い場合があります。印刷された明細書のご利用を推奨します。

#### Q4. インポート後にデータを修正できますか？

A4. はい、インポート後も預かり金口座の取引一覧画面から各取引を編集できます。

#### Q5. 外貨建ての取引には対応していますか？

A5. 現在は日本円建ての取引のみに対応しています。外貨建ての取引は手動で入力してください。

#### Q6. インポートに失敗した場合、データはどうなりますか？

A6. インポート処理はトランザクション内で実行されるため、エラーが発生した場合は全ての変更が自動的にロールバックされ、データベースには何も保存されません。安心して再試行できます。

####

### トラブルシューティング

#### 画像がアップロードできない

**原因**:

* ファイルサイズが20MBを超えている
* サポートされていないファイル形式

**対処方法**:

* 画像を圧縮してファイルサイズを小さくする
* JPEG、PNG形式に変換する

#### テキストが検出されない

**原因**:

* 画像の解像度が低い
* 画像がぼやけている、または暗い
* 文字が小さすぎる

**対処方法**:

* より高解像度で撮影する
* 明るい場所で撮影する
* カメラを通帳に近づけて撮影する

#### 金額や日付が正しく認識されない

**原因**:

* 画像の品質が低い
* 文字が欠けている、またはかすれている

**対処方法**:

* プレビュー画面で手動で修正する
* より鮮明な画像で再度アップロードする

#### インポート実行時にエラーが発生する

**原因**:

* 必須フィールドが不足している
* データ型が不正

**対処方法**:

* エラーメッセージで指摘されたフィールドを確認する
* プレビュー画面で該当の取引を修正する
* 不正なデータの取引を選択解除してインポートから除外する

### 関連機能

* 経費（実費と預かり金）
* 一括インポート機能
* 事件ファイル

### サポート

この機能に関するご質問やお困りの点がございましたら、firmeeサポートチームまでお問い合わせください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.firmee.com/fnc/ai-ocr-import.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.