Invoice Organizer
このスキルは、請求書、領収書、財務書類が散らかったフォルダを、手間をかけずに確定申告に使える整理されたファイリングシステムに変えます。
このスキルを使用するタイミング
- 確定申告シーズンの準備で、整理された記録が必要なとき
- 複数の取引先にわたる事業経費を管理しているとき
- 散らかったフォルダやメールのダウンロードフォルダから領収書を整理しているとき
- 継続的な簿記のために請求書の自動ファイリングを設定しているとき
- 財務記録を年やカテゴリごとにアーカイブしているとき
- 経費の清算のために支出を照合しているとき
- 会計士向けの書類を作成しているとき
このスキルの機能
-
請求書の内容を読み取る:PDF、画像、ドキュメントから情報を抽出します。
- 取引先/会社名
- 請求書番号
- 日付
- 金額
- 製品またはサービスの説明
- 支払い方法
-
ファイル名を統一する:標準化されたファイル名を作成します。
- 形式:
YYYY-MM-DD 取引先 - 書類種類 - 製品・サービス.pdf - 例:
2024-03-15 Adobe - Invoice - Creative Cloud.pdf
- 形式:
-
カテゴリ別に整理する:論理的なフォルダに分類します。
- 取引先別
- 経費カテゴリ別(ソフトウェア、オフィス用品、旅費交通費など)
- 期間別(年、四半期、月)
- 税区分別(控除対象、個人など)
-
複数の形式に対応する:以下の形式で動作します。
- PDFの請求書
- スキャンした領収書(JPG、PNG)
- メールの添付ファイル
- スクリーンショット
- 銀行取引明細書
-
原本を保持する:整理されたコピーを作成しつつ、元のファイルを保存します。
使用方法
基本的な使い方
散らかった請求書フォルダに移動します。
cd ~/Desktop/receipts-to-sort
次に、Claude Codeに依頼します。
これらの請求書を税金用に整理して
または、より具体的に指定します。
このフォルダ内のすべての請求書を読み込んで、ファイル名を
"YYYY-MM-DD 取引先 - 書類種類 - 製品.pdf"形式に変更し、
取引先ごとに整理してください
高度な整理
これらの請求書を整理してください。
1. 各ファイルから日付、取引先、説明を抽出
2. 標準形式にファイル名を変更
3. 経費カテゴリ(ソフトウェア、オフィス用品、旅費交通費など)ごとにフォルダに分類
4. すべての請求書詳細を含むCSVスプレッドシートを作成して会計士に渡す
手順
ユーザーが請求書の整理を依頼した場合:
-
フォルダをスキャンする
すべての請求書ファイルを特定します。
# 請求書関連のファイルをすべて検索 find . -type f \( -name "*.pdf" -o -name "*.jpg" -o -name "*.png" \) -print結果を報告します。
- ファイルの総数
- ファイルの種類
- 日付の範囲(ファイル名から判別できる場合)
- 現在の整理状況(またはその欠如)
-
各ファイルから情報を抽出する
各請求書について、以下を抽出します。
PDF請求書から:
- テキスト抽出を使用して請求書の内容を読み取る
- 一般的なパターンを探す:
- "Invoice Date:", "Date:", "Issued:"
- "Invoice #:", "Invoice Number:"
- 会社名(通常は上部)
- "Amount Due:", "Total:", "Amount:"
- "Description:", "Service:", "Product:"
画像の領収書から:
- 画像から可視テキストを読み取る
- 取引先名を特定する(多くの場合上部)
- 日付を探す(一般的な形式)
- 合計金額を特定する
不明瞭なファイルのフォールバック:
- ファイル名の手がかりを使用する
- ファイルの作成日/変更日を確認する
- 重要な情報が不足している場合は手動レビュー用にフラグを付ける
-
整理戦略を決定する
指定がない場合、ユーザーの好みを尋ねます。
[日付範囲]の請求書を[X]件見つけました。 どのように整理しますか? 1. **取引先別**(Adobe/、Amazon/、Stripe/など) 2. **カテゴリ別**(ソフトウェア/、オフィス用品/、旅費交通費/など) 3. **日付別**(2024/Q1/、2024/Q2/など) 4. **税区分別**(控除対象/、個人/など) 5. **カスタム**(構造を記述してください) または、デフォルトの構造(年/カテゴリ/取引先)を使用することもできます。 -
標準化されたファイル名を作成する
各請求書に対して、以下のパターンに従ったファイル名を作成します。
YYYY-MM-DD 取引先 - 書類種類 - 説明.ext例:
2024-03-15 Adobe - Invoice - Creative Cloud.pdf2024-01-10 Amazon - Receipt - Office Supplies.pdf2023-12-01 Stripe - Invoice - Monthly Payment Processing.pdf
ファイル名のベストプラクティス:
- ハイフン以外の特殊文字を削除する
- 取引先名は適切に大文字にする
- 説明は簡潔で意味のあるものにする
- ソートのために一貫した日付形式(YYYY-MM-DD)を使用する
- 元のファイル拡張子を保持する
-
整理を実行する
ファイルを移動する前に、計画を表示します。
# 整理計画 ## 提案構造請求書/ ├── 2023/ │ ├── ソフトウェア/ │ │ ├── Adobe/ │ │ └── Microsoft/ │ ├── サービス/ │ └── オフィス用品/ └── 2024/ ├── ソフトウェア/ ├── サービス/ └── オフィス用品/
## 変更例 変更前:`invoice_adobe_march.pdf` 変更後:`2024-03-15 Adobe - Invoice - Creative Cloud.pdf` 保存先:`請求書/2024/ソフトウェア/Adobe/` 変更前:`IMG_2847.jpg` 変更後:`2024-02-10 Staples - Receipt - Office Supplies.jpg` 保存先:`請求書/2024/オフィス用品/Staples/` [X]個のファイルを処理しますか?(yes/no)承認後:
# フォルダ構造を作成 mkdir -p "請求書/2024/ソフトウェア/Adobe" # 元のファイルを保持するためにコピー(移動しない) cp "original.pdf" "請求書/2024/ソフトウェア/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf" # またはユーザーが希望する場合は移動 mv "original.pdf" "new/path/standardized-name.pdf" -
サマリーレポートを生成する
すべての請求書詳細を含むCSVファイルを作成します。
日付,取引先,請求書番号,説明,金額,カテゴリ,ファイルパス 2024-03-15,Adobe,INV-12345,Creative Cloud,52.99,ソフトウェア,請求書/2024/ソフトウェア/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf 2024-03-10,Amazon,123-4567890-1234567,オフィス用品,127.45,オフィス用品,請求書/2024/オフィス用品/Amazon/2024-03-10 Amazon - Receipt - Office Supplies.pdf ...このCSVは以下の用途で役立ちます。
- 会計ソフトへのインポート
- 会計士との共有
- 経費の追跡と報告
- 確定申告の準備
-
完了サマリーを提供する
# 整理完了! 📊 ## サマリー - **処理済み**: [X] 件の請求書 - **日付範囲**: [最も古い日付] から [最も新しい日付] - **合計金額**: $[合計](金額が抽出できた場合) - **取引先**: [Y] 社の固有取引先 ## 新しい構造請求書/ ├── 2024/ (45ファイル) │ ├── ソフトウェア/ (23ファイル) │ ├── サービス/ (12ファイル) │ └── オフィス用品/ (10ファイル) └── 2023/ (12ファイル)
## 作成されたファイル - `/請求書/` - 整理された請求書 - `/請求書/請求書サマリー.csv` - 会計用スプレッドシート - `/請求書/原本/` - 元のファイル(コピーした場合) ## 確認が必要なファイル [情報が完全に抽出できなかったファイルをリスト] ## 次のステップ 1. `請求書サマリー.csv`ファイルを確認する 2. 「確認が必要」フォルダのファイルを確認する 3. CSVを会計ソフトにインポートする 4. 今後の請求書のために自動整理を設定する 確定申告の準備完了! 🎉
例
例1:確定申告の準備(Martin Merschrothより)
ユーザー: 「税金用の請求書が散らかったフォルダがあります。整理して適切に名前を変更してください。」
プロセス:
- フォルダをスキャン:147個のPDFと画像を発見
- 各請求書を読み取り、以下を抽出:
- 日付
- 取引先名
- 請求書番号
- 製品/サービスの説明
- すべてのファイル名を変更:
YYYY-MM-DD 取引先 - 書類種類 - 製品.pdf - 分類:
2024/ソフトウェア/、2024/旅費交通費/など - 会計士向けに
請求書サマリー.csvを作成 - 結果:数分で確定申告に使える整理済みの請求書
例2:月次経費の照合
ユーザー: 「先月の事業用領収書をカテゴリ別に整理してください。」
出力:
# 2024年3月 整理済み領収書
## カテゴリ別
- ソフトウェアとツール: $847.32 (12件の請求書)
- オフィス用品: $234.18 (8件の領収書)
- 旅費交通費と食事代: $1,456.90 (15件の領収書)
- 専門サービス: $2,500.00 (3件の請求書)
合計: $5,038.40
すべての領収書の名前を変更し、以下の場所にファイルしました。
`事業用領収書/2024/03-3月/[カテゴリ]/`
CSVエクスポート: `2024年3月経費.csv`
例3:複数年にわたるアーカイブ
ユーザー: 「3年分のランダムな請求書があります。年別に整理し、次に取引先別に整理してください。」
出力: 以下の構造を作成:
請求書/
├── 2022/
│ ├── Adobe/
│ ├── Amazon/
│ └── ...
├── 2023/
│ ├── Adobe/
│ ├── Amazon/
│ └── ...
└── 2024/
├── Adobe/
├── Amazon/
└── ...
各ファイルは日付と説明付きで適切に名前が変更されています。
例4:メールダウンロードのクリーンアップ
ユーザー: 「Gmailから請求書をダウンロードしました。すべて 'invoice.pdf'、'invoice(1).pdf' などという名前です。この混乱を修正してください。」
出力:
89個のファイルがすべて「invoice*.pdf」という名前で見つかりました
各ファイルを読み取り、実際の情報を抽出しています...
名前変更例:
- invoice.pdf → 2024-03-15 Shopify - Invoice - Monthly Subscription.pdf
- invoice(1).pdf → 2024-03-14 Google - Invoice - Workspace.pdf
- invoice(2).pdf → 2024-03-10 Netlify - Invoice - Pro Plan.pdf
すべてのファイルの名前を変更し、取引先ごとに整理しました。
一般的な整理パターン
取引先別(シンプル)
請求書/
├── Adobe/
├── Amazon/
├── Google/
└── Microsoft/
年別とカテゴリ別(税務向き)
請求書/
├── 2023/
│ ├── ソフトウェア/
│ ├── ハードウェア/
│ ├── サービス/
│ └── 旅費交通費/
└── 2024/
└── ...
四半期別(詳細な追跡)
請求書/
├── 2024/
│ ├── Q1/
│ │ ├── ソフトウェア/
│ │ ├── オフィス用品/
│ │ └── 旅費交通費/
│ └── Q2/
│ └── ...
税区分別(会計士向け)
請求書/
├── 控除対象/
│ ├── ソフトウェア/
│ ├── オフィス用品/
│ └── 専門サービス/
├── 一部控除対象/
│ └── 食事代・旅費交通費/
└── 個人/
自動化設定
継続的な整理のために:
~/Downloads/invoices フォルダを監視し、新しい請求書ファイルが
到着したら、標準の命名規則とフォルダ構造を使用して自動的に
整理するスクリプトを作成してください。
これにより、請求書が届くと同時に整理する永続的なソリューションが作成されます。
プロのヒント
- メールをPDFにスキャン: Previewまたは同様のツールを使用して、メールの請求書を最初にPDFとして保存する
- ダウンロードの統一: バッチ処理のためにすべての請求書を1つのフォルダに保存する
- 毎月のルーティン: 年単位ではなく、毎月請求書を整理する
- 原本のバックアップ: 再整理する前に元のファイルを保存する
- CSVに金額を含める: 予算追跡に役立つ
- 控除可能性でタグ付け: どの経費が税控除の対象かを記録する
- 領収書は7年間保管: 標準的な監査期間
特別なケースへの対応
情報不足
日付/取引先が抽出できない場合:
- 手動レビュー用にファイルにフラグを付ける
- フォールバックとしてファイルの変更日を使用する
- 「確認が必要」フォルダを作成する
重複した請求書
同じ請求書が複数回出現する場合:
- ファイルハッシュを比較する
- 最も高品質なバージョンを保持する
- サマリーに重複を記載する
複数ページの請求書
ファイルが分割された請求書の場合:
- 必要に応じてPDFを結合する
- パーツに一貫した命名を使用する
- 請求書が分割されている場合はCSVに記載する
非標準形式
珍しい領収書形式の場合:
- 可能なものを抽出する
- 標準化できるものを標準化する
- 重要な情報が不足している場合はレビュー用にフラグを付ける
関連ユースケース
- 経費精算のための経費報告書の作成
- 銀行取引明細書の整理
- 取引先契約の管理
- 古い財務記録のアーカイブ
- 監査の準備
- サブスクリプション費用の経時的な追跡