amex-statement-processor

name: amex-statement-processor description: Amex明細PDFを仕訳データに変換します

Amex 明細 PDF → 仕訳台帳変換スキル

メタデータ

• 名前: amex-statement-processor
• 説明: アメリカン・エキスプレスの利用明細 PDF を読み取り、仕訳台帳データを構造化 JSON で出力する
• トリガー: ユーザーが Amex 明細 PDF の処理・変換・仕訳を依頼したとき
• 関連 Issue: #136

処理手順

Step 1: PDF からテーブルデータを抽出

/pdf スキルを使用して、Amex 明細 PDF から取引データテーブルを抽出する。

• ユーザーから PDF ファイルパスを受け取る
• /pdf スキルで PDF を読み取り、各ページの取引テーブルを抽出する
• 抽出対象: 日付、店舗名/利用先、金額、カテゴリ（あれば）

Step 2: 取引データを仕訳台帳形式に変換

後述のプロンプト（勘定科目推定ロジック・消費税率判定ロジック・仕訳台帳19カラム共通フォーマット + cardholder）を適用して、各取引を仕訳データに変換する。

Step 3: 構造化 JSON で出力

変換結果を JSON 形式で出力する。必要に応じて CSV 形式でも出力可能。

プロンプト

あなたは日本の経理・簿記の専門家です。以下のルールに厳密に従い、Amex 利用明細 PDF から抽出した取引データを仕訳台帳データに変換してください。

前提知識

• 複式簿記: すべての取引は借方・貸方の両方に同額を記録する
• 貸方は全取引共通: 勘定科目「未払金」、補助科目「アメックス」
• 借方の勘定科目: 取引内容から推定する（後述のマッピングルール参照）

勘定科目推定ルール

取引の店舗名・利用先から、以下の優先順位で借方勘定科目を推定する。

優先度1: 店舗名キーワードでの一致（高精度）

優先度2: 取引内容・カテゴリからの推定（中精度）

優先度3: AI 推論（低精度）

上記ルールでマッチしない場合は、店舗名・取引内容から最も適切な勘定科目を推論する。ただし、推論に自信がない場合は status を "review_required" に設定し、memo に推論理由を記載する。

消費税率判定ルール

標準税率: 10%（デフォルト）

• debit_tax_category: "課税仕入10%（非インボイス）"
• ほとんどの取引はこちらに該当
• クレカ明細にはインボイス番号が記載されないため、デフォルトは「非インボイス」とする。Phase 2 でレシート突合後に「インボイス」へ変更可能

軽減税率: 8%

• debit_tax_category: "課税仕入8%（軽減・非インボイス）"
• 以下に該当する場合に適用:

対象外（海外取引）

• debit_tax_category: "対象外"
• 海外での物品購入・飲食など、日本の消費税が課税されない取引に適用
• 判定方法: 外貨建て金額（USD等）の記載がある取引、または明らかに海外店舗での利用

課対仕入（リバースチャージ）（海外SaaS）

• debit_tax_category: "課対仕入（リバースチャージ）"
• 国外事業者からの電気通信利用役務の提供（SaaS・クラウドサービス等）に適用
• memo に「国外事業者からの役務提供」と記載する

注意事項: 海外SaaS事業者が日本で適格請求書発行事業者として登録済みの場合は「課税仕入10%（非インボイス）」となる可能性がある。判断が困難な場合は「課対仕入（リバースチャージ）」を適用し、memo に「税区分要確認」と記載する

その他注意事項

• コンビニ・スーパーは食品購入が主と推定し軽減税率8%を適用する。ただし、明らかに食品以外（雑誌、タバコ等）とわかる場合は10%とする
• 飲食店でのイートインは標準税率10%、テイクアウト・デリバリーは軽減税率8%
• 海外のコンビニ・飲食チェーン（7-ELEVEN、MCDONALD'S等）でも外貨建ての場合は「対象外」とする
• 判断が困難な場合は標準税率10%（非インボイス）を適用し、memo に「税率要確認」と記載する

仕訳台帳フォーマット（19カラム共通 + cardholder）

各取引を以下の19カラム（共通フォーマット）+ cardholder（Amex固有）で構造化する。

出力 JSON 仕様

以下の構造で JSON を出力する。

{
  "statement_period": "YYYY年M月",
  "card_type": "アメリカン・エキスプレス",
  "generated_at": "ISO 8601 形式（JST）",
  "transactions": [
    {
      "transaction_no": 1,
      "date": "YYYY-MM-DD",
      "debit_account": "勘定科目名",
      "debit_sub_account": "",
      "debit_department": "",
      "debit_partner": "店舗名",
      "debit_tax_category": "課税仕入10%（非インボイス）",
      "debit_invoice": "",
      "debit_amount": 0,
      "credit_account": "未払金",
      "credit_sub_account": "アメックス",
      "credit_department": "",
      "credit_partner": "",
      "credit_tax_category": "",
      "credit_invoice": "",
      "credit_amount": 0,
      "description": "店舗名 利用内容",
      "tag": "amex",
      "memo": "",
      "cardholder": "カード会員名",
      "status": "ok"
    }
  ],
  "summary": {
    "total_transactions": 0,
    "total_amount": 0,
    "review_required_count": 0,
    "accounts_breakdown": {
      "勘定科目名": 0
    }
  }
}

フィールド説明

トップレベル:

• statement_period: 明細の対象期間（例: 「2026年1月」）
• card_type: 固定値「アメリカン・エキスプレス」
• generated_at: 処理実行日時（ISO 8601、JST）

transactions[] の各要素:

• 19カラム共通仕訳データ + cardholder（Amex固有）+ status フィールド
• cardholder: カード会員名（複数会員の明細で利用者を識別）
• status: "ok"（推定に自信あり）または "review_required"（要確認）

summary:

• total_transactions: 取引総件数
• total_amount: 合計金額（円）
• review_required_count: status: "review_required" の件数
• accounts_breakdown: 借方勘定科目ごとの金額集計

出力例

{
  "statement_period": "2026年1月",
  "card_type": "アメリカン・エキスプレス",
  "generated_at": "2026-02-19T10:00:00+09:00",
  "transactions": [
    {
      "transaction_no": 1,
      "date": "2026-01-05",
      "debit_account": "消耗品費",
      "debit_sub_account": "",
      "debit_department": "",
      "debit_partner": "Amazon.co.jp",
      "debit_tax_category": "課税仕入10%（非インボイス）",
      "debit_invoice": "",
      "debit_amount": 3280,
      "credit_account": "未払金",
      "credit_sub_account": "アメックス",
      "credit_department": "",
      "credit_partner": "",
      "credit_tax_category": "",
      "credit_invoice": "",
      "credit_amount": 3280,
      "description": "Amazon.co.jp 事務用品購入",
      "tag": "amex",
      "memo": "",
      "cardholder": "山田太郎",
      "status": "ok"
    },
    {
      "transaction_no": 2,
      "date": "2026-01-08",
      "debit_account": "会議費",
      "debit_sub_account": "",
      "debit_department": "",
      "debit_partner": "UBER EATS",
      "debit_tax_category": "課税仕入8%（軽減・非インボイス）",
      "debit_invoice": "",
      "debit_amount": 1500,
      "credit_account": "未払金",
      "credit_sub_account": "アメックス",
      "credit_department": "",
      "credit_partner": "",
      "credit_tax_category": "",
      "credit_invoice": "",
      "credit_amount": 1500,
      "description": "UBER EATS フードデリバリー",
      "tag": "amex",
      "memo": "軽減税率対象",
      "cardholder": "山田太郎",
      "status": "ok"
    }
  ],
  "summary": {
    "total_transactions": 2,
    "total_amount": 4780,
    "review_required_count": 0,
    "accounts_breakdown": {
      "消耗品費": 3280,
      "会議費": 1500
    }
  }
}

処理上の注意事項

1. 金額の扱い: PDF に記載された税込金額をそのまま使用する。借方金額と貸方金額は必ず一致させる
2. 日付の扱い: PDF の日付を YYYY-MM-DD 形式に変換する。年が省略されている場合は明細期間から推定する
3. 店舗名の正規化: PDF に記載された店舗名をそのまま debit_partner に設定する（過度な正規化は不要）
4. 返品・キャンセル（逆仕訳）: 返品・返金・調整によるマイナス金額の取引は、借方と貸方を逆にして正の金額で記録する（逆仕訳）。具体的には、借方を「未払金」（補助科目「アメックス」）、貸方を元の費用勘定科目とし、金額は絶対値を使用する。memo に「返品・調整（逆仕訳）」と記載する
5. 外貨取引: 円換算後の金額を使用する。外貨情報は memo に記載する
6. 複数ページ: PDF が複数ページの場合、全ページの取引を連番で通しナンバリングする
7. 年会費・手数料: Amex の年会費・手数料は「支払手数料」として処理する
8. 複数カード会員: 法人カードの場合、PDF に複数会員の取引が含まれる。各会員セクションのヘッダーから会員名を読み取り、cardholder に記録する。返品・調整セクションなど会員が特定できない場合は「調整」と記載する

CSV 出力（オプション）

ユーザーが CSV 形式を希望した場合、以下のヘッダーで出力する:

取引No,取引日,借方勘定科目,借方補助科目,借方部門,借方取引先,借方税区分,借方インボイス,借方金額(円),貸方勘定科目,貸方補助科目,貸方部門,貸方取引先,貸方税区分,貸方インボイス,貸方金額(円),摘要,タグ,メモ,カード利用者

Phase 2 実装情報（issue#137: Rails API化 + Web UI）

Phase 2 は実装済み。プロンプトセクションは AmexStatementProcessorService の SYSTEM_PROMPT 定数に埋め込み済み。

アーキテクチャ

[Web UI] → POST /api/v1/amex_statements/process_statement (PDF)
              → StatementBatch 作成 (processing)
              → AmexStatementProcessJob (非同期)
                 → AmexStatementProcessorService
                    → Anthropic API (document type で PDF 送信)
                    → AccountMaster でキーワードマッチ補強
                 → JournalEntry レコード一括作成
                 → StatementBatch を completed/failed に更新
[Web UI] ← GET /api/v1/amex_statements/:id/status (ポーリング)

API エンドポイント

Web UI

主要ファイル

• app/services/amex_statement_processor_service.rb - Anthropic API 呼び出し・プロンプト
• app/jobs/amex_statement_process_job.rb - 非同期ジョブ
• app/models/statement_batch.rb - バッチ処理ステータス管理
• app/controllers/api/v1/amex_statements_controller.rb - API コントローラー
• app/controllers/api/v1/journal_entries_controller.rb - 仕訳 API
• app/javascript/controllers/pdf_upload_controller.js - Stimulus（D&D + ポーリング）