Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install traygerbig-clawhub-skills-finance-accounting-pack-japan-invoicegit clone https://github.com/traygerbig/clawhub-skills.gitcp clawhub-skills/SKILL.MD ~/.claude/skills/traygerbig-clawhub-skills-finance-accounting-pack-japan-invoice/SKILL.md---
name: japan-invoice
description: インボイス制度(適格請求書)対応エージェント - 適格請求書の作成・登録番号検証・消費税計算・仕入税額控除管理をClaude Codeで一元管理するスキル
version: "1.0.0"
author: hanabi-jpn
tags:
- invoice
- tax
- japan
- consumption-tax
- qualified-invoice
- nta
- accounting
- business
- compliance
- digital
---
```
┌─────────────────────────────────────────────────────┐
│ ┌──────┐ ┌──────────────────────────────────────┐ │
│ │ ╔══╗ │ │ JAPAN INVOICE AGENT │ │
│ │ ║適║ │ │ ━━━━━━━━━━━━━━━━━━━━ │ │
│ │ ║格║ │ │ インボイス制度対応エージェント │ │
│ │ ╚══╝ │ │ Qualified Invoice System for JP │ │
│ │ ┌──┐ │ │ │ │
│ │ │T │ │ │ ◆ 適格請求書作成 │ │
│ │ │ 登│ │ │ ◆ 登録番号検証 │ │
│ │ │ 録│ │ │ ◆ 消費税計算(標準/軽減) │ │
│ │ │ 番│ │ │ ◆ 仕入税額控除管理 │ │
│ │ └──┘ │ │ ◆ 経過措置計算 │ │
│ └──────┘ └──────────────────────────────────────┘ │
│ Powered by Claude Code + NTA Public API │
└─────────────────────────────────────────────────────┘
```
`claude-code` `invoice` `consumption-tax` `compliance` `japan`
[](https://github.com/hanabi-jpn/clawhub-skills)
[](https://github.com/hanabi-jpn/clawhub-skills/blob/main/LICENSE)
[](https://www.invoice-kohyo.nta.go.jp/)
[](https://github.com/hanabi-jpn/clawhub-skills)
[](https://claude.ai)
> **インボイス制度(適格請求書等保存方式)対応エージェント** -- 2023年10月施行のインボイス制度に完全対応。適格請求書の作成、登録番号のリアルタイム検証、標準税率・軽減税率の自動区分計算、仕入税額控除の適正管理、経過措置の自動適用まで、消費税に関わるすべての業務をClaude Codeから一元操作します。
---
## Overview
Japan Invoice Agentは、日本のインボイス制度(適格請求書等保存方式)に完全準拠した請求書管理・消費税計算スキルです。国税庁の適格請求書発行事業者公表システムAPIと連携し、取引先の登録番号をリアルタイムで検証します。標準税率10%と軽減税率8%の自動区分、税率ごとの消費税額計算、端数処理(切捨て/切上げ/四捨五入)、仕入税額控除の管理、免税事業者からの仕入に対する経過措置計算など、インボイス制度の複雑な要件をすべて自動化します。
適格請求書の法定記載事項(発行事業者の登録番号、取引年月日、取引内容、税率ごとの対価の合計額と消費税額、交付先の名称)を漏れなく含む請求書を生成し、PDF/CSV/JSON形式でのエクスポートに対応しています。
### アーキテクチャ図
```
┌────────────────────────────────────────────────────────────────┐
│ Claude Code CLI │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Japan Invoice Agent Core │ │
│ │ ┌────────────┐ ┌────────────┐ ┌──────────────────────┐ │ │
│ │ │ 請求書 │ │ 消費税 │ │ 仕入税額控除 │ │ │
│ │ │ ジェネレータ│ │ 計算エンジン│ │ マネージャー │ │ │
│ │ └─────┬──────┘ └─────┬──────┘ └──────────┬───────────┘ │ │
│ │ │ │ │ │ │
│ │ ┌─────▼──────────────▼────────────────────▼───────────┐ │ │
│ │ │ 登録番号検証レイヤー │ │ │
│ │ │ ┌──────────┐ ┌──────────┐ ┌──────────────────────┐ │ │ │
│ │ │ │ NTA API │ │ キャッシュ│ │ 有効性判定 │ │ │ │
│ │ │ │ クライアント│ │ 管理 │ │ (登録/失効/取消) │ │ │ │
│ │ │ └────┬─────┘ └────┬─────┘ └──────────┬───────────┘ │ │ │
│ │ └───────┼────────────┼──────────────────┼─────────────┘ │ │
│ │ │ │ │ │ │
│ │ ┌───────▼────────────▼──────────────────▼─────────────┐ │ │
│ │ │ 出力フォーマッター │ │ │
│ │ │ PDF │ CSV │ JSON │ テンプレート印刷 │ │ │
│ │ └────────────────────────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────▼─────────────────────────────────────────────────┐ │
│ │ 国税庁 適格請求書発行事業者公表システム │ │
│ │ https://www.invoice-kohyo.nta.go.jp/ │ │
│ └────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────┘
```
---
## System Prompt / Behavioral Guidelines
このスキルを使用する際、エージェントは以下のガイドラインに従います。
1. 適格請求書の記載事項は消費税法第57条の4に定める6項目(発行事業者の氏名又は名称及び登録番号、取引年月日、取引内容、税率ごとに区分した対価の額の合計額及び適用税率、税率ごとに区分した消費税額等、書類の交付を受ける事業者の氏名又は名称)を必ず含める
2. 登録番号の検証は国税庁の適格請求書発行事業者公表システムWeb-APIを使用し、番号の有効性・登録日・事業者名を確認する
3. 消費税の税率区分は標準税率10%と軽減税率8%を正確に区分し、飲食料品(酒類を除く)と新聞(週2回以上発行、定期購読契約)には軽減税率を自動適用する
4. 消費税額の端数処理は1請求書につき税率ごとに1回のみ行い、切捨て・切上げ・四捨五入のいずれかを事業者の選択に従って適用する(デフォルト: 切捨て)
5. 仕入税額控除は適格請求書の保存を要件とし、免税事業者からの仕入については経過措置の控除割合(2026年9月30日まで80%、2029年9月30日まで50%)を自動適用する
6. 少額特例(1万円未満の課税仕入れ)の適用対象事業者(基準期間の課税売上高が1億円以下または特定期間の課税売上高が5千万円以下)を自動判定する
7. 簡易課税制度を選択している事業者に対しては、みなし仕入率による消費税計算を行い、事業区分(第1種~第6種)ごとのみなし仕入率を正しく適用する
8. 返還インボイス(適格返還請求書)の作成にも対応し、値引き・返品・割戻し時の消費税額の調整計算を行う
9. 請求書テンプレートは業種別(製造業、小売業、サービス業、建設業等)のプリセットを用意し、カスタマイズ可能とする
10. すべての金額は日本円で表示し、外貨建て取引の場合はTTS/TTBレートによる円換算を行う
11. 請求書データの保存期間は法定保存期間(7年間、欠損金繰越控除の適用がある場合は10年間)に準拠する
12. 登録番号のキャッシュは24時間有効とし、失効・取消の情報を定期的にリフレッシュする
13. 課税期間をまたぐ取引(前受金、長期請負工事等)の消費税処理は、権利確定主義に基づいて適切な課税期間に帰属させる
14. 電子帳簿保存法(電帳法)の要件を満たすタイムスタンプとハッシュ値を請求書データに付与する
15. 税務調査に備え、すべての請求書発行・受領・検証のログを操作日時とともに保存する
16. マイナンバーや銀行口座情報などの機密データは暗号化して保存し、平文出力時は部分マスクを適用する
17. APIリクエストは国税庁公表システムの利用規約に準拠し、過度なリクエスト頻度(1秒あたり10リクエスト以上)を避ける
---
## Environment Variables
| 変数名 | 必須 | 説明 | 取得方法 |
|--------|------|------|----------|
| `INVOICE_ISSUER_NUMBER` | はい | 自社の適格請求書発行事業者登録番号(T+13桁数字) | 税務署への登録申請後に通知される登録番号 |
| `NTA_API_KEY` | はい | 国税庁公表システムWeb-APIの利用キー | 国税庁公表システムサイトでアプリケーション登録後に発行 |
| `INVOICE_DEFAULT_TAX_RATE` | いいえ | デフォルト税率(10または8) | デフォルト: 10(標準税率) |
| `INVOICE_ROUNDING_METHOD` | いいえ | 端数処理方法(floor/ceil/round) | デフォルト: floor(切捨て) |
| `INVOICE_COMPANY_NAME` | いいえ | 自社名(請求書ヘッダー用) | 任意の会社名 |
| `INVOICE_COMPANY_ADDRESS` | いいえ | 自社住所(請求書ヘッダー用) | 任意の住所 |
| `INVOICE_BANK_NAME` | いいえ | 振込先銀行名 | 任意の銀行名 |
| `INVOICE_BANK_ACCOUNT` | いいえ | 振込先口座番号 | 任意の口座番号 |
| `INVOICE_TEMPLATE` | いいえ | デフォルト請求書テンプレート名 | デフォルト: standard |
| `INVOICE_FISCAL_YEAR_START` | いいえ | 事業年度開始月(1-12) | デフォルト: 4(4月開始) |
---
## Commands
### 1. `invoice create`
適格請求書を作成します。
```bash
# 適格請求書の作成
invoice create --to "株式会社サンプル商事" --items "Webサイト制作費:550000:10,サーバー保守費:110000:10,記事執筆料:88000:10"
# 出力:
# ✅ 適格請求書作成完了
# ┌──────────────────────────────────────────────────────────┐
# │ 適 格 請 求 書 │
# │ │
# │ 請求書番号: INV-2026-0301-001 │
# │ 発行日: 2026年3月1日 │
# │ │
# │ 株式会社サンプル商事 御中 │
# │ │
# │ 登録番号: T1234567890123 │
# │ │
# │ ┌───────────────────┬──────────┬──────┬───────────────┐ │
# │ │ 品目 │ 数量 │ 税率 │ 金額(税込) │ │
# │ ├───────────────────┼──────────┼──────┼───────────────┤ │
# │ │ Webサイト制作費 │ 1 │ 10% │ ¥550,000 │ │
# │ │ サーバー保守費 │ 1 │ 10% │ ¥110,000 │ │
# │ │ 記事執筆料 │ 1 │ 10% │ ¥88,000 │ │
# │ ├───────────────────┼──────────┼──────┼───────────────┤ │
# │ │ 10%対象 小計 │ │ │ ¥748,000 │ │
# │ │ うち消費税額 │ │ │ ¥68,000 │ │
# │ ├───────────────────┼──────────┼──────┼───────────────┤ │
# │ │ 合計金額 │ │ │ ¥748,000 │ │
# │ └───────────────────┴──────────┴──────┴───────────────┘ │
# │ │
# │ お支払期限: 2026年3月31日 │
# │ 振込先: みずほ銀行 渋谷支店 普通 1234567 │
# │ │
# │ 保存先: ~/.japan-invoice/invoices/2026/INV-2026-0301-001 │
# └──────────────────────────────────────────────────────────┘
```
```bash
# 軽減税率を含む適格請求書
invoice create --to "有限会社フードサービス" --items "弁当(軽減):864:8,お茶(軽減):129:8,配送料:330:10" --quantity "弁当(軽減):50,お茶(軽減):50,配送料:1"
# 出力:
# ✅ 適格請求書作成完了(複数税率)
# ┌──────────────────────────────────────────────────────────┐
# │ 適 格 請 求 書 │
# │ │
# │ 請求書番号: INV-2026-0301-002 │
# │ 発行日: 2026年3月1日 │
# │ │
# │ 有限会社フードサービス 御中 │
# │ │
# │ 登録番号: T1234567890123 │
# │ │
# │ ┌──────────────────┬──────┬──────┬───────────────┐ │
# │ │ 品目 │ 数量 │ 税率 │ 金額(税込) │ │
# │ ├──────────────────┼──────┼──────┼───────────────┤ │
# │ │ ※弁当 │ 50 │ 8% │ ¥43,200 │ │
# │ │ ※お茶 │ 50 │ 8% │ ¥6,450 │ │
# │ │ 配送料 │ 1 │ 10% │ ¥330 │ │
# │ ├──────────────────┼──────┼──────┼───────────────┤ │
# │ │ 8%対象 小計(※) │ │ │ ¥49,650 │ │
# │ │ うち消費税額 │ │ │ ¥3,677 │ │
# │ │ 10%対象 小計 │ │ │ ¥330 │ │
# │ │ うち消費税額 │ │ │ ¥30 │ │
# │ ├──────────────────┼──────┼──────┼───────────────┤ │
# │ │ 合計金額 │ │ │ ¥49,980 │ │
# │ └──────────────────┴──────┴──────┴───────────────┘ │
# │ │
# │ ※は軽減税率(8%)対象品目 │
# └──────────────────────────────────────────────────────────┘
```
### 2. `invoice verify`
取引先の登録番号を検証します。
```bash
# 登録番号検証
invoice verify --number "T1234567890123"
# 出力:
# ✅ 登録番号検証結果
# ┌──────────────────────────────────────────────────┐
# │ 登録番号: T1234567890123 │
# │ ステータス: 有効(登録中) │
# │ │
# │ ■ 事業者情報 │
# │ 氏名又は名称: 株式会社サンプル商事 │
# │ 法人番号: 1234567890123 │
# │ 本店所在地: 東京都渋谷区神宮前一丁目1番1号 │
# │ 登録年月日: 2023年10月1日 │
# │ 処分年月日: -(取消・失効なし) │
# │ │
# │ 検証日時: 2026-03-01 15:00:00 JST │
# │ データソース: 国税庁適格請求書発行事業者公表API │
# └──────────────────────────────────────────────────┘
```
```bash
# 一括検証
invoice verify --file "vendors.csv"
# 出力:
# ✅ 一括検証結果(15件)
# ┌────┬───────────────────┬─────────────────┬──────────┐
# │ # │ 事業者名 │ 登録番号 │ 結果 │
# ├────┼───────────────────┼─────────────────┼──────────┤
# │ 1 │ 株式会社サンプル商事│ T1234567890123 │ ✅ 有効 │
# │ 2 │ 合同会社テスト │ T9876543210987 │ ✅ 有効 │
# │ 3 │ 個人事業主A │ T1111222233334 │ ❌ 無効 │
# │ 4 │ 株式会社フード │ T5555666677778 │ ✅ 有効 │
# │ 5 │ 有限会社建設 │ T4444333322221 │ ⚠️ 失効 │
# │ .. │ ... │ ... │ ... │
# │ 15 │ NPO法人支援 │ T7777888899990 │ ✅ 有効 │
# └────┴───────────────────┴─────────────────┴──────────┘
# 結果: 有効 12件 / 無効 1件 / 失効 2件
# ⚠️ 無効・失効の事業者からの仕入は仕入税額控除の対象外です
```
### 3. `invoice tax-calc`
消費税額の計算を行います。
```bash
# 消費税計算(税込→税抜変換)
invoice tax-calc --amount 1100000 --rate 10 --direction "tax-inclusive"
# 出力:
# 🧮 消費税計算結果
# ┌──────────────────────────────────────────────────┐
# │ 計算方式: 税込金額 → 税抜金額 │
# │ 税率: 10%(標準税率) │
# │ │
# │ 税込金額: ¥1,100,000 │
# │ 税抜金額: ¥1,000,000 │
# │ 消費税額: ¥100,000 │
# │ │
# │ 端数処理: 切捨て(floor) │
# │ 計算式: 1,100,000 × 10/110 = 100,000 │
# └──────────────────────────────────────────────────┘
```
```bash
# 複数税率の消費税一括計算
invoice tax-calc --items "制作費:500000:10,食品仕入:200000:8,広告費:300000:10" --summary
# 出力:
# 🧮 消費税一括計算結果
# ┌──────────────────────────────────────────────────┐
# │ ■ 明細 │
# │ ┌──────────────┬──────────┬──────┬──────────────┐ │
# │ │ 品目 │ 税抜金額 │ 税率 │ 消費税額 │ │
# │ ├──────────────┼──────────┼──────┼──────────────┤ │
# │ │ 制作費 │ ¥500,000│ 10% │ ¥50,000 │ │
# │ │ 食品仕入 │ ¥200,000│ 8% │ ¥16,000 │ │
# │ │ 広告費 │ ¥300,000│ 10% │ ¥30,000 │ │
# │ └──────────────┴──────────┴──────┴──────────────┘ │
# │ │
# │ ■ 税率別集計 │
# │ 10%対象: 税抜 ¥800,000 / 消費税 ¥80,000 │
# │ 8%対象: 税抜 ¥200,000 / 消費税 ¥16,000 │
# │ │
# │ ■ 合計 │
# │ 税抜合計: ¥1,000,000 │
# │ 消費税合計: ¥96,000 │
# │ 税込合計: ¥1,096,000 │
# └──────────────────────────────────────────────────┘
```
### 4. `invoice deduction`
仕入税額控除の管理・計算を行います。
```bash
# 仕入税額控除の計算
invoice deduction calculate --period "2025-04 to 2026-03"
# 出力:
# 📊 仕入税額控除計算結果(2025年4月~2026年3月)
# ┌──────────────────────────────────────────────────────────┐
# │ ■ 課税仕入の区分 │
# │ │
# │ 適格請求書あり(全額控除): │
# │ 10%対象: ¥12,500,000 → 控除税額 ¥1,250,000 │
# │ 8%対象: ¥3,200,000 → 控除税額 ¥256,000 │
# │ │
# │ 免税事業者等からの仕入(経過措置80%): │
# │ 10%対象: ¥800,000 → 控除税額 ¥64,000 │
# │ 8%対象: ¥150,000 → 控除税額 ¥9,600 │
# │ (本来の控除税額の80%を適用) │
# │ │
# │ 適格請求書なし(控除不可): │
# │ 10%対象: ¥200,000 → 控除税額 ¥0 │
# │ │
# │ ■ 仕入税額控除合計 │
# │ 控除可能額: ¥1,579,600 │
# │ 控除不可額: ¥20,000 │
# │ │
# │ ■ 課税売上の消費税額(参考) │
# │ 売上消費税額: ¥2,340,000 │
# │ 納付税額概算: ¥760,400 │
# └──────────────────────────────────────────────────────────┘
```
### 5. `invoice transition`
経過措置の計算・管理を行います。
```bash
# 経過措置の適用状況確認
invoice transition status
# 出力:
# 📋 インボイス制度 経過措置状況
# ┌──────────────────────────────────────────────────┐
# │ ■ 免税事業者からの仕入に係る経過措置 │
# │ │
# │ 現在の適用期間: │
# │ 2023/10/01 ~ 2026/09/30: 仕入税額の80%控除可 │
# │ → 残り214日(2026/09/30まで) │
# │ │
# │ 次の期間: │
# │ 2026/10/01 ~ 2029/09/30: 仕入税額の50%控除可 │
# │ │
# │ 最終期間後: │
# │ 2029/10/01以降: 控除不可(0%) │
# │ │
# │ ■ 2割特例(小規模事業者向け) │
# │ 適用可能期間: 2023/10/01 ~ 2026/09/30 │
# │ 納税額 = 売上税額 × 20% │
# │ → 残り214日で終了 │
# │ │
# │ ■ 少額特例(1万円未満帳簿保存のみ) │
# │ 適用可能期間: 2023/10/01 ~ 2029/09/30 │
# │ 要件: 基準期間の課税売上高1億円以下 │
# │ 自社判定: ✅ 適用可能 │
# └──────────────────────────────────────────────────┘
```
### 6. `invoice report`
消費税に関するレポートを生成します。
```bash
# 月次消費税レポート
invoice report monthly --month "2026-02"
# 出力:
# 📊 月次消費税レポート(2026年2月)
# ┌──────────────────────────────────────────────────┐
# │ ■ 売上(課税売上) │
# │ 10%対象売上: ¥4,500,000(税額 ¥450,000) │
# │ 8%対象売上: ¥800,000(税額 ¥64,000) │
# │ 合計税額: ¥514,000 │
# │ │
# │ ■ 仕入(課税仕入) │
# │ 適格請求書あり: │
# │ 10%対象: ¥2,100,000(税額 ¥210,000) │
# │ 8%対象: ¥400,000(税額 ¥32,000) │
# │ 経過措置適用: │
# │ 10%対象: ¥300,000(控除税額 ¥24,000 / 80%) │
# │ 仕入税額控除合計: ¥266,000 │
# │ │
# │ ■ 月次差引 │
# │ 売上消費税: ¥514,000 │
# │ 仕入税額控除: ¥266,000 │
# │ 差引税額: ¥248,000 │
# │ │
# │ 年度累計(4月~2月): ¥2,680,000 │
# └──────────────────────────────────────────────────┘
```
### 7. `invoice template`
請求書テンプレートの管理を行います。
```bash
# テンプレート一覧
invoice template list
# 出力:
# 📄 請求書テンプレート一覧
# ┌────┬──────────────┬──────────────┬──────────┐
# │ # │ テンプレート名 │ 業種 │ 最終更新 │
# ├────┼──────────────┼──────────────┼──────────┤
# │ 1 │ standard │ 汎用 │ 2026-01 │
# │ 2 │ it-service │ IT・Web制作 │ 2026-02 │
# │ 3 │ construction │ 建設業 │ 2026-01 │
# │ 4 │ retail │ 小売業 │ 2026-01 │
# │ 5 │ food-service │ 飲食・食品 │ 2026-02 │
# │ 6 │ consulting │ コンサル │ 2026-01 │
# └────┴──────────────┴──────────────┴──────────┘
```
### 8. `invoice export`
請求書データのエクスポートを行います。
```bash
# 月次データのCSVエクスポート
invoice export --format csv --period "2026-02" --output "invoices-202602.csv"
# 出力:
# 📥 エクスポート完了
# ┌──────────────────────────────────────────────────┐
# │ 形式: CSV │
# │ 対象期間: 2026年2月 │
# │ 請求書数: 23件 │
# │ ファイル: ~/.japan-invoice/exports/ │
# │ invoices-202602.csv │
# │ ファイルサイズ: 45 KB │
# │ │
# │ 含まれるフィールド: │
# │ 請求書番号, 発行日, 取引先名, 登録番号, │
# │ 品目, 数量, 単価, 税率, 税込金額, │
# │ 消費税額, 合計金額, 支払期限 │
# │ │
# │ ハッシュ値(SHA-256): │
# │ a3f2b8c9...(電子帳簿保存法対応) │
# └──────────────────────────────────────────────────┘
```
---
## Workflow Diagram
```
┌─────────────────────────────────────────────────────────────────┐
│ Japan Invoice Agent 請求書発行ワークフロー │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 取引発生 │
│ │ │
│ ▼ │
│ ┌─────────────┐ ┌──────────────┐ ┌───────────────────┐ │
│ │ 取引先 │───→│ 登録番号 │───→│ 税率区分判定 │ │
│ │ 情報入力 │ │ 検証(NTA API)│ │ (10% or 8%) │ │
│ └─────────────┘ └──────────────┘ └────────┬──────────┘ │
│ │ │ │
│ 登録番号無効 │ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 免税事業者 │ │ 品目・金額 │ │
│ │ フラグ設定 │ │ 入力 │ │
│ │ (経過措置) │ │ │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ └──────────┬───────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 消費税額 │ │
│ │ 計算・端数 │ │
│ │ 処理 │ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 適格請求書 │ │
│ │ 生成 │ │
│ └──────┬───────┘ │
│ │ │
│ ┌──────────┼──────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │ PDF │ │ JSON │ │ 印刷 │ │
│ │ 出力 │ │ 保存 │ │ 出力 │ │
│ └────────┘ └────────┘ └────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ 仕入税額 │ │
│ │ 控除台帳 │ │
│ │ 更新 │ │
│ └──────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## Error Handling
### 1. 登録番号検証エラー
```
❌ エラー: 登録番号が無効です
┌──────────────────────────────────────────────────┐
│ エラーコード: INVOICE_VERIFY_001 │
│ 登録番号: T0000000000000 │
│ │
│ 原因: 国税庁公表システムに該当する登録番号が │
│ 見つかりませんでした │
│ │
│ 対処方法: │
│ 1. 登録番号(T+13桁数字)を再確認してください │
│ 2. 取引先に正しい登録番号を問い合わせてください │
│ 3. 国税庁公表サイトで直接検索してください │
│ https://www.invoice-kohyo.nta.go.jp/ │
│ 4. 番号が正しい場合、登録申請中の可能性が │
│ あります(反映まで数日かかる場合があります) │
└──────────────────────────────────────────────────┘
```
### 2. 税率区分エラー
```
❌ エラー: 税率の区分が不正です
┌──────────────────────────────────────────────────┐
│ エラーコード: TAX_RATE_002 │
│ 入力値: 5% │
│ │
│ 原因: 有効な消費税率は10%(標準)または │
│ 8%(軽減)のみです │
│ │
│ 対処方法: │
│ 1. 税率を10(標準税率)または8(軽減税率)に │
│ 修正してください │
│ 2. 軽減税率8%の対象: │
│ ・飲食料品(酒類を除く) │
│ ・新聞(週2回以上発行、定期購読契約) │
│ 3. 上記以外はすべて標準税率10%が適用されます │
└──────────────────────────────────────────────────┘
```
### 3. 端数処理不整合エラー
```
❌ エラー: 消費税額の端数処理に不整合があります
┌──────────────────────────────────────────────────┐
│ エラーコード: ROUNDING_003 │
│ │
│ 原因: 1つの請求書内で同一税率の消費税額に対して │
│ 複数回の端数処理が検出されました │
│ │
│ インボイス制度では、1請求書につき税率ごとに │
│ 1回のみ端数処理を行う必要があります │
│ │
│ 対処方法: │
│ ・品目ごとではなく、税率ごとの合計額に対して │
│ 端数処理を適用してください │
│ ・「invoice create」コマンドを使用すると │
│ 正しい端数処理が自動適用されます │
└──────────────────────────────────────────────────┘
```
### 4. NTA API接続エラー
```
❌ エラー: 国税庁公表システムAPIに接続できません
┌──────────────────────────────────────────────────┐
│ エラーコード: NTA_API_004 │
│ │
│ 考えられる原因: │
│ ・NTA_API_KEYが無効または期限切れ │
│ ・国税庁システムのメンテナンス中 │
│ ・ネットワーク接続の問題 │
│ │
│ 対処方法: │
│ 1. NTA_API_KEYの有効性を確認してください │
│ 2. 国税庁公表システムの稼働状況を確認 │
│ https://www.invoice-kohyo.nta.go.jp/ │
│ 3. ネットワーク接続を確認してください │
│ 4. キャッシュされた検証結果を使用する場合は │
│ 「--use-cache」オプションを追加してください │
└──────────────────────────────────────────────────┘
```
### 5. 必須記載事項不足エラー
```
❌ エラー: 適格請求書の必須記載事項が不足しています
┌──────────────────────────────────────────────────┐
│ エラーコード: REQUIRED_FIELDS_005 │
│ │
│ 不足している記載事項: │
│ ・交付先の氏名又は名称(--to オプション) │
│ │
│ 適格請求書の必須記載事項(6項目): │
│ ✅ 1. 発行事業者の氏名又は名称及び登録番号 │
│ ✅ 2. 取引年月日 │
│ ✅ 3. 取引の内容 │
│ ✅ 4. 税率ごとに区分した対価の額の合計額及び税率 │
│ ✅ 5. 税率ごとに区分した消費税額等 │
│ ❌ 6. 書類の交付を受ける事業者の氏名又は名称 │
│ │
│ 対処方法: │
│ ・「--to "取引先名"」オプションを追加してください │
└──────────────────────────────────────────────────┘
```
---
## FAQ
**Q1: インボイス制度とは何ですか?**
A1: 2023年10月1日から施行された「適格請求書等保存方式」のことです。消費税の仕入税額控除を受けるためには、適格請求書発行事業者が交付する「適格請求書(インボイス)」の保存が必要となりました。
**Q2: 登録番号はどこで確認できますか?**
A2: 税務署に「適格請求書発行事業者の登録申請書」を提出後、通知される「登録通知書」に記載されています。法人の場合は「T+法人番号(13桁)」、個人事業主の場合は「T+新規付番の13桁」です。
**Q3: 軽減税率が適用される品目を教えてください**
A3: 飲食料品(食品表示法に規定する食品で、酒税法に規定する酒類を除く。外食やケータリングを除く)と、週2回以上発行される新聞の定期購読契約に基づく新聞に8%の軽減税率が適用されます。
**Q4: 免税事業者からの仕入はどう処理されますか?**
A4: 経過措置として、2026年9月30日までは仕入税額の80%、2029年9月30日までは50%が控除可能です。2029年10月1日以降は控除不可となります。本スキルは経過措置の控除率を自動適用します。
**Q5: 端数処理のルールを教えてください**
A5: インボイス制度では、1つの適格請求書につき、税率ごとに1回の端数処理を行います。品目ごとの端数処理は認められません。切捨て・切上げ・四捨五入のいずれかを事業者が任意に選択できます。
**Q6: 簡易課税制度を利用している場合は?**
A6: 簡易課税制度の場合、仕入側の適格請求書の保存は不要です。ただし、売上側として適格請求書を発行する義務は免除されません。`invoice tax-calc --simplified --business-type 5` で簡易課税計算が可能です。
**Q7: 返品や値引きの場合はどうしますか?**
A7: 適格返還請求書(返還インボイス)を発行する必要があります。`invoice create --type return --original INV-2026-0201-005 --amount 50000` で返還インボイスを作成できます。ただし、1万円未満の少額な値引き等は交付義務が免除されています。
**Q8: 電子インボイスに対応していますか?**
A8: はい。Peppol(ペポル)ネットワーク対応のデジタルインボイス形式(JP PINT)でのエクスポートに対応しています。`invoice export --format peppol` で出力可能です。
**Q9: 他の会計ソフトとの連携は可能ですか?**
A9: CSV、JSON、Peppol形式でのエクスポートに対応しているため、freee、マネーフォワード、弥生などの主要会計ソフトへのインポートが可能です。また、e-tax-agentスキルとの連携により、消費税確定申告書の作成もシームレスに行えます。
**Q10: 登録番号の検証にAPI費用はかかりますか?**
A10: 国税庁の適格請求書発行事業者公表システムWeb-APIは無料で利用できます。ただしアプリケーション登録が必要で、APIキーの発行にはメールアドレスの登録が必要です。利用規約に基づき、過度なアクセス頻度は避けてください。
**Q11: 2割特例とは何ですか?**
A11: インボイス制度を機に免税事業者から課税事業者になった小規模事業者向けの特例で、納税額を売上税額の2割とする制度です。2026年9月30日を含む課税期間まで適用可能です。`invoice tax-calc --two-tenths-rule` で計算できます。
---
## Data Storage
```
~/.japan-invoice/
├── config/
│ ├── settings.json # 基本設定(登録番号、端数処理方法等)
│ ├── company-info.json # 自社情報(名称、住所、口座情報)
│ ├── tax-rates.json # 税率テーブル(標準/軽減)
│ └── templates/
│ ├── standard.json # 汎用テンプレート
│ ├── it-service.json # IT・Web制作テンプレート
│ ├── construction.json # 建設業テンプレート
│ ├── retail.json # 小売業テンプレート
│ ├── food-service.json # 飲食・食品テンプレート
│ └── consulting.json # コンサルテンプレート
├── invoices/
│ ├── 2026/
│ │ ├── INV-2026-0301-001/
│ │ │ ├── invoice.json # 請求書データ
│ │ │ ├── invoice.pdf # PDF出力
│ │ │ └── hash.sha256 # 電帳法対応ハッシュ
│ │ └── INV-2026-0301-002/
│ │ └── ...
│ └── 2025/
│ └── ...
├── received/
│ ├── 2026/
│ │ ├── RCV-2026-0215-001/
│ │ │ ├── invoice.json # 受領請求書データ
│ │ │ ├── original.pdf # 原本PDF
│ │ │ ├── verified.json # 登録番号検証結果
│ │ │ └── hash.sha256 # 電帳法対応ハッシュ
│ │ └── ...
│ └── 2025/
│ └── ...
├── vendors/
│ ├── vendor-list.json # 取引先一覧
│ └── registration-cache.json # 登録番号キャッシュ(24h有効)
├── deductions/
│ ├── 2025-2026/
│ │ ├── qualified.json # 適格請求書ありの仕入
│ │ ├── transitional.json # 経過措置適用の仕入
│ │ └── non-deductible.json # 控除不可の仕入
│ └── summary.json # 控除額集計
├── reports/
│ ├── monthly/
│ │ ├── 2026-01.json # 月次レポート
│ │ ├── 2026-02.json
│ │ └── ...
│ └── annual/
│ └── 2025-2026.json # 年次レポート
├── exports/
│ ├── invoices-202602.csv # CSVエクスポート
│ └── invoices-202602.json # JSONエクスポート
└── logs/
├── audit.log # 操作監査ログ(7年保持)
├── verification.log # 登録番号検証ログ
└── errors.log # エラーログ
```
---
## Comparison vs Competitors
| 機能 | Japan Invoice Agent | freeeインボイス | マネーフォワードインボイス | 弥生インボイス |
|------|--------------------|--------------|-----------------------|--------------|
| Claude Code統合 | 自然言語で全操作可能 | 非対応 | 非対応 | 非対応 |
| 適格請求書作成 | CLI/テンプレート/複数税率自動区分 | Web GUI | Web GUI | Web/デスクトップGUI |
| 登録番号検証 | NTA API即時検証、一括検証対応 | 手動入力、API連携 | API連携あり | 手動入力 |
| 消費税計算 | 税率自動区分、端数一括処理、経過措置自動適用 | 自動計算 | 自動計算 | 自動計算 |
| 仕入税額控除管理 | 控除区分自動判定、経過措置80%/50%自動適用 | freee会計と連携 | MF会計と連携 | やよい会計と連携 |
| 経過措置計算 | 自動適用、残日数表示、2割特例対応 | 基本対応 | 基本対応 | 基本対応 |
| 電子インボイス | Peppol(JP PINT)対応 | Peppol対応 | Peppol対応予定 | 未対応 |
| 電帳法対応 | タイムスタンプ、ハッシュ値自動付与 | 対応 | 対応 | 対応 |
| エクスポート | PDF/CSV/JSON/Peppol | PDF/CSV | PDF/CSV | PDF/CSV |
| 料金 | 無料(Claude API費用のみ) | 月額2,680円~ | 月額2,980円~ | 月額1,980円~ |
| e-Tax連携 | e-tax-agentスキルとシームレス連携 | freee確定申告と連携 | MF確定申告と連携 | やよい確定申告と連携 |
| 操作方式 | CLI(自然言語コマンド) | Webブラウザ | Webブラウザ | デスクトップ/Web |
| 一括処理 | CSVインポート、一括検証、バッチ処理 | 制限あり | 制限あり | 基本的 |
### Japan Invoice Agentの優位性
1. **コスト効率**: 本スキル自体は無料で、月額サブスクリプションの会計SaaS費用を大幅に削減できます。Claude APIの従量課金のみで運用可能です
2. **自動化の深度**: 登録番号検証から請求書作成、消費税計算、仕入税額控除管理、経過措置適用まで、インボイス制度に関わるすべてのプロセスをコマンドライン上で完結させます
3. **プログラマブルな請求業務**: シェルスクリプトやCIパイプラインとの統合により、定期的な請求書発行や取引先登録番号の一括検証を完全自動化できます
4. **他スキルとのエコシステム**: e-tax-agent(確定申告)、freee-agent(会計連携)、moneyforward-agent(経理連携)等と組み合わせることで、税務・経理業務全体をClaude Code上で統合管理できます
5. **制度変更への柔軟な対応**: 経過措置の期間変更や税率改正などの制度変更に対し、設定ファイルの更新のみで即座に対応可能です
---
## License
MIT License - hanabi-jpn