---
name: invoice-organizer-jp
description: 画像（JPG/PNG）・PDF・CSV・Excel等あらゆる形式のレシート・請求書を読み込み、日本の確定申告・青色申告の費目区分とインボイス制度（適格請求書）に対応したExcelスプレッドシートに自動整理する経費精算スキル。
---

# Invoice Organizer (日本語版)

このスキルは、レシート・請求書が混在した雑然としたフォルダを、確定申告・青色申告にそのまま使えるExcel(.xlsx)台帳に変換します。

元スキル: [invoice-organizer](https://github.com/ComposioHQ/awesome-claude-skills/tree/master/invoice-organizer)（Apache License 2.0）を日本語環境向けに翻案したものです。

## このスキルを使う場面

- 確定申告・青色申告に向けて経費を整理したい
- 複数の取引先からの請求書・レシートを管理したい
- メールでダウンロードしたPDF請求書がフォルダに溜まっている
- インボイス制度対応の記録（登録番号・税率区分）を残したい
- 税理士に渡すための経費一覧を作りたい

## このスキルが行うこと

1. **あらゆる形式のファイルを読み込む**
   - 画像（JPG / PNG）のレシート・請求書
   - PDF請求書
   - CSV（カード会社・銀行の利用明細エクスポート等）
   - Excel（既存の経費メモ等、取り込み用）

2. **各ファイルから情報を抽出する**
   - 日付
   - 取引先名
   - 金額（税込・税抜）
   - 適用税率（10% / 8% / 非課税）
   - 適格請求書発行事業者の登録番号（`T`+13桁、記載があれば）
   - 内容・品目

3. **日本の費目区分に分類する**
   - 旅費交通費
   - 会議費
   - 接待交際費
   - 消耗品費
   - 通信費
   - 新聞図書費
   - 広告宣伝費
   - 支払手数料
   - その他

4. **Excel(.xlsx)台帳を出力する**
   - 1ファイル1行の経費一覧シート
   - 集計シート（費目別・税率別の小計）
   - 元ファイルへの相対パスを記録（原本はリネーム・移動せず保持）

## 元スキルからの主な変更点（翻案ポイント）

| 項目 | 元スキル（米国版） | 翻案後（日本版） |
|---|---|---|
| 対象形式 | PDF・JPG・PNG中心 | 画像・PDF・CSV・Excelすべてに対応 |
| 費目区分 | Software / Office / Travel 等（米国の会計慣行） | 青色申告決算書（一般用）の正式な経費区分（租税公課・旅費交通費・通信費・接待交際費・消耗品費・外注工賃・地代家賃等）+ 内訳管理用の独立区分（会議費・新聞図書費・支払手数料） |
| 出力形式 | CSV | Excel(.xlsx)（集計シート付き） |
| 税制対応 | なし | インボイス制度対応：登録番号列・税率10%/8%区分列を追加 |

## 使い方

### 基本

整理したいフォルダに移動し、Claude Codeに依頼します。

```
cd ~/Desktop/レシート整理
```

```
このフォルダのレシート・請求書を確定申告用に整理して
```

### 具体的な指示例

```
このフォルダの画像・PDF・CSVファイルを読み込んで、
日付・取引先・金額・税率・登録番号を抽出し、
青色申告決算書の費目区分（旅費交通費・通信費・接待交際費・消耗品費・外注工賃等）に分類して、
インボイス対応のExcel台帳(expense-summary.xlsx)を作って
```

## 実行手順

ユーザーから経費整理を依頼されたら、以下の手順で進める。

### 1. フォルダのスキャン

対象ファイルを検出する:

```bash
find . -type f \( -iname "*.pdf" -o -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.png" -o -iname "*.csv" -o -iname "*.xlsx" -o -iname "*.xls" \) -print
```

報告する内容:
- ファイル総数と形式ごとの内訳（画像/PDF/CSV/Excel）
- 日付範囲（ファイル名やプロパティから推測できる場合）
- 既存の整理状況

### 2. 各ファイルから情報を抽出

**画像・PDFのレシート・請求書から**:
- 日付（「発行日」「取引日」「Date」等の表記を探す）
- 取引先名（通常はヘッダー部分）
- 金額（「合計」「税込金額」「小計」等）
- 税率の内訳（10%対象・8%対象・非課税の区分表記を探す）
- 登録番号（`T`+13桁の表記。インボイス制度の適格請求書発行事業者番号）
- 品目・内容

**CSV（カード・銀行明細）から**:
- 利用日・利用先・金額の列をそのまま読み込む
- 税率・登録番号の情報がない場合は「不明」として記録し、後述の「確認が必要なファイル」に分類する

**Excel（既存メモ等）から**:
- 既存のシート構成を読み取り、同じ形式で取り込む

**情報が不明瞭な場合のフォールバック**:
- ファイル名から推測
- ファイルの作成日・更新日を使用
- 重要情報が欠落している場合は「確認が必要」フラグを立てる

### 3. 費目区分への分類

取引先・品目の内容から、以下のいずれかに分類する。これは国税庁の**青色申告決算書（一般用）損益計算書**の経費欄の正式な費目（個人事業主が実際に確定申告で使う区分）に準拠している:

- 租税公課（個人事業税・印紙税・自動車税等の事業分）
- 荷造運賃（梱包材・配送料等）
- 水道光熱費（事務所の電気・水道・ガス等）
- 旅費交通費（電車・タクシー・出張費・宿泊費等）
- 通信費（電話・インターネット・郵送料等）
- 広告宣伝費（広告出稿・販促物・ホームページ制作費等）
- 接待交際費（取引先との会食・贈答・お祝い金等）
- 損害保険料（事業用の火災保険・自動車保険等）
- 修繕費（事業用設備・車両の修理費等）
- 消耗品費（事務用品・10万円未満の備品等）
- 減価償却費（10万円以上の固定資産の年間償却費）
- 福利厚生費（従業員の慰安・健康診断費等）
- 給料賃金（従業員への給与・賞与）
- 外注工賃（外部への業務委託費）
- 利子割引料（事業用借入の利息）
- 地代家賃（事務所・店舗の賃料）
- 貸倒金（回収不能になった売掛金等）
- 会議費（打ち合わせ時の飲食・会議室利用料等。決算書上は「雑費」または「その他」に含めることが多いが、経営者が支出の内訳を追いやすいよう独立した区分として残す）
- 新聞図書費（書籍・雑誌・有料記事等。同上の理由で独立区分として残す）
- 支払手数料（決済手数料・銀行振込手数料・士業への手数料等。同上の理由で独立区分として残す）
- 雑費（上記のいずれにも当てはまらない少額の費用）

分類に迷う場合はユーザーに確認する。会議費・新聞図書費・支払手数料は決算書の正式な印刷欄には無いが、内訳管理のために独立区分として残している。最終的に税理士へ渡す・申告書に転記する際は、これらを「雑費」にまとめるかどうかをユーザーに確認すること。

### 4. Excel台帳の生成

`scripts/generate_expense_xlsx.py` を使ってExcel台帳を生成する（openpyxlが必要。`pip install openpyxl`）。

```bash
python3 scripts/generate_expense_xlsx.py --input extracted_data.json --output expense-summary.xlsx
```

抽出した情報は以下の列構成のJSONとしてまとめてからスクリプトに渡す:

```json
[
  {
    "date": "2026-04-15",
    "vendor": "○○商事株式会社",
    "description": "事務用品購入",
    "amount_incl_tax": 3300,
    "tax_rate": 10,
    "category": "消耗品費",
    "registration_number": "T1234567890123",
    "file_path": "originals/2026-04-15_office-supplies.jpg",
    "needs_review": false
  }
]
```

生成されるExcelの構成:
- **経費一覧シート**: 日付・取引先・内容・税込金額・税抜金額・税率・登録番号・費目区分・元ファイルパス・確認フラグの列
- **集計シート**: 費目区分別の小計、税率（10%/8%/非課税）別の小計、登録番号なし（インボイス対象外の可能性がある取引）の件数

### 5. 完了報告

```markdown
# 整理完了

## サマリー
- 処理件数: [X]件
- 期間: [最古の日付] 〜 [最新の日付]
- 合計金額（税込）: ¥[合計]
- うち登録番号の記載がない取引: [Y]件（インボイス対象外の可能性、要確認）

## 費目別小計
| 費目区分 | 件数 | 金額（税込） |
|---|---|---|
| 旅費交通費 | ... | ¥... |
| 消耗品費 | ... | ¥... |
| ... | ... | ... |

## 出力ファイル
- `expense-summary.xlsx` — 経費一覧＋集計シート

## 確認が必要なファイル
[情報が完全に抽出できなかったファイルを列挙]
```

## 特殊ケースの扱い

### 登録番号が読み取れない場合
- 取引先が適格請求書発行事業者でない可能性があるため、「登録番号なし」として記録し、集計シートでまとめて確認できるようにする（経過措置・免税事業者からの仕入の場合の扱いはユーザーに確認）

### 税率の記載がない、または読み取れない場合
- 「税率不明」として記録し、確認フラグを立てる。標準10%と推測して処理を進めることはしない

### 同一請求書の重複
- ファイルハッシュを比較し、高品質な方を残す。重複は集計シートの備考に記録

### 複数ページに分かれた請求書
- 必要に応じてPDFを結合し、一貫した命名規則で保存