traygerbig ┌─────────────────────────────────────────────────────┐
│ ╔╦╗╦╔═╗╔═╗╔═╗╔═╗ │
│ ║║║║╚═╗║ ║║ ╠═╣ │
│ ╩ ╩╩╚═╝╚═╝╚═╝╩ ╩ Agent │
│ │
│ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │
│ │請求書 │──│見積書 │──│納品書 │──│入金 │ │
│ │Invoice│ │Quote │ │Deliver│ │Payment│ │
│ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ │
│ └──────────┴──────────┴──────────┘ │
│ 弥生グループ Misoca API │
│ Claude Code × 日本の帳票管理 │
└─────────────────────────────────────────────────────┘
claude-code misoca invoice billing japan
Misoca請求書・見積書管理エージェント — 弥生グループのクラウド帳票サービスMisocaをClaude Codeから完全操作。請求書の作成から送付、入金確認、弥生会計連携まで、日本の商慣習とインボイス制度に完全対応した帳票自動化スキル。
Overview
Misoca Agentは、弥生グループが提供するクラウド請求書作成サービス「Misoca」のAPIをClaude Codeから直接操作するためのスキルです。日本の商慣習に根ざした請求書・見積書・納品書の作成、送付、入金管理をコマンドラインから一括で行えます。2023年10月から施行された適格請求書等保存方式（インボイス制度）にも完全対応し、登録番号の自動付与、税率ごとの区分記載、端数処理まで自動で行います。
アーキテクチャ概要
┌──────────────────────────────────────────────────────────────┐
│ Claude Code Terminal │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ misoca invoice create / quote / delivery / payment │ │
│ └───────────────────────┬─────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────▼─────────────────────────────────┐ │
│ │ Misoca Agent Core │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │ │
│ │ │Auth │ │Document │ │Payment │ │Export │ │ │
│ │ │Manager │ │Builder │ │Tracker │ │Engine │ │ │
│ │ │(OAuth2) │ │(帳票生成)│ │(入金管理)│ │(CSV/PDF) │ │ │
│ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬─────┘ │ │
│ │ └─────────────┴────────────┴─────────────┘ │ │
│ └───────────────────────┬─────────────────────────────────┘ │
│ │ HTTPS / REST API │
│ ┌───────────────────────▼─────────────────────────────────┐ │
│ │ Misoca API (api.misoca.jp) │ │
│ │ invoices / quotes / delivery_slips / contacts │ │
│ └───────────────────────┬─────────────────────────────────┘ │
│ │ 弥生ID連携 │
│ ┌───────────────────────▼─────────────────────────────────┐ │
│ │ 弥生会計オンライン / やよいの青色申告 │ │
│ │ (仕訳データ自動連携) │ │
│ └─────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
処理フロー
見積書作成 ──→ 受注確定 ──→ 納品書発行 ──→ 請求書発行 ──→ 入金確認
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
PDF生成 ステータス 発送記録 メール送付 消込処理
メール送信 更新 在庫連動 郵送代行 弥生連携
System Prompt（行動指針）
Misoca Agentとして動作する際、以下のガイドラインに厳密に従うこと。
- すべての金額は日本円（JPY）を基本単位とする。 小数点以下は切り捨てを標準とし、端数処理方法はユーザー設定に従う。
- インボイス制度（適格請求書等保存方式）に完全準拠する。 登録番号（T+13桁数字）は必ず記載し、税率ごとの区分経理を行う。
- 消費税率は標準税率10%と軽減税率8%を正確に区分する。 混在する場合は税率ごとに小計と消費税額を個別計算する。
- 請求書番号は年度ベースの連番を自動採番する。 形式は「INV-2026-0001」とし、見積書は「QUO-」、納品書は「DLV-」を接頭辞とする。
- 取引先マスタを常に最新に保つ。 新規取引先の登録時は、登録番号・住所・担当者・メールアドレスを必須項目とする。
- PDFテンプレートはMisocaの標準テンプレートを使用する。 カスタムテンプレートが登録されている場合はそちらを優先する。
- メール送信時は必ず送信先と件名をユーザーに確認する。 自動送信モードが有効な場合を除き、確認なしの送信は禁止する。
- 入金消込は銀行口座のCSVインポートまたは手動入力で行う。 部分入金にも対応し、残高を自動計算する。
- 弥生会計との連携データは仕訳日記帳形式で出力する。 勘定科目は弥生会計の標準科目コードに準拠する。
- 月次・年次の売上レポートは自動集計する。 取引先別、品目別、月別の3軸で集計可能とする。
- 見積書から請求書への変換時は、すべての明細行を引き継ぐ。 数量・単価の変更がある場合はユーザーに確認する。
- 支払期限は発行日から30日後をデフォルトとする。 取引先ごとにカスタム期限を設定可能とする。
- 源泉徴収税の自動計算に対応する。 報酬区分に応じて10.21%または20.42%を自動適用する。
- エラー発生時はMisoca APIのエラーコードと日本語の説明を同時に表示する。 リトライ可能なエラーは自動リトライする。
- すべての操作ログを保持する。 請求書の作成・編集・送付・削除の履歴を監査証跡として記録する。
- 電子帳簿保存法の要件を満たすデータ保存を行う。 タイムスタンプ、改ざん防止、検索要件に対応する。
- 複数事業所の管理に対応する。 事業所ごとに請求書テンプレート、振込先、ロゴを切り替え可能とする。
Environment Variables
| 変数名 | 必須 | 説明 | 例 |
|---|---|---|---|
MISOCA_CLIENT_ID |
Yes | MisocaアプリケーションのクライアントID | msc_cid_a1b2c3d4e5f6g7h8i9j0 |
MISOCA_CLIENT_SECRET |
Yes | Misocaアプリケーションのクライアントシークレット | msc_sec_k1l2m3n4o5p6q7r8s9t0 |
MISOCA_REDIRECT_URI |
Yes | OAuth2コールバックURI | http://localhost:8920/callback |
MISOCA_ACCESS_TOKEN |
No | 取得済みアクセストークン（自動更新） | msc_at_u1v2w3x4y5z6... |
MISOCA_REFRESH_TOKEN |
No | リフレッシュトークン（自動保存） | msc_rt_a9b8c7d6e5f4... |
MISOCA_DEFAULT_TEMPLATE |
No | デフォルトの請求書テンプレートID | tpl_standard_001 |
MISOCA_SENDER_NAME |
No | 差出人名（会社名） | 株式会社はなびテック |
MISOCA_SENDER_EMAIL |
No | 差出人メールアドレス | billing@hanabi-tech.co.jp |
MISOCA_INVOICE_PREFIX |
No | 請求書番号の接頭辞 | INV |
MISOCA_TAX_REGISTRATION |
No | 適格請求書発行事業者登録番号 | T1234567890123 |
MISOCA_BANK_NAME |
No | 振込先銀行名 | 三菱UFJ銀行 渋谷支店 |
MISOCA_BANK_ACCOUNT |
No | 振込先口座番号 | 普通 1234567 |
MISOCA_STORAGE_DIR |
No | ローカルデータ保存先 | ~/.misoca-agent/data |
Commands
1. misoca invoice create — 請求書作成
新規請求書を作成し、PDFを生成します。
misoca invoice create --client "株式会社サンプル商事" \
--items "Webサイト制作:1:550000:10" "ロゴデザイン:1:110000:10" \
--due-date 2026-03-31 \
--note "お振込手数料はご負担ください"
出力例:
╔══════════════════════════════════════════════════════════╗
║ 請求書作成完了 ║
╠══════════════════════════════════════════════════════════╣
║ 請求書番号: INV-2026-0042 ║
║ 取引先: 株式会社サンプル商事 ║
║ 発行日: 2026-03-01 ║
║ 支払期限: 2026-03-31 ║
║ ║
║ ┌──────────────────┬────┬──────────┬────┬──────────┐ ║
║ │ 品目 │数量│ 単価 │税率│ 金額 │ ║
║ ├──────────────────┼────┼──────────┼────┼──────────┤ ║
║ │ Webサイト制作 │ 1│ 550,000│ 10%│ 550,000│ ║
║ │ ロゴデザイン │ 1│ 110,000│ 10%│ 110,000│ ║
║ ├──────────────────┼────┼──────────┼────┼──────────┤ ║
║ │ 小計 │ │ │ │ 660,000│ ║
║ │ 消費税(10%) │ │ │ │ 66,000│ ║
║ │ 合計 │ │ │ │ 726,000│ ║
║ └──────────────────┴────┴──────────┴────┴──────────┘ ║
║ ║
║ 登録番号: T1234567890123 ║
║ PDF: ~/.misoca-agent/data/invoices/INV-2026-0042.pdf ║
╚══════════════════════════════════════════════════════════╝
2. misoca quote — 見積書作成
取引先向けの見積書を作成します。
misoca quote create --client "合同会社テストカンパニー" \
--items "コンサルティング:10:50000:10" "交通費:5:2000:10" \
--valid-until 2026-04-30 \
--title "業務改善コンサルティング見積書"
出力例:
見積書作成完了
番号: QUO-2026-0018
取引先: 合同会社テストカンパニー
有効期限: 2026-04-30
合計: ¥572,000（税込）
明細:
1. コンサルティング 10h × ¥50,000 = ¥500,000 (税10%)
2. 交通費 5件 × ¥2,000 = ¥10,000 (税10%)
小計: ¥510,000 / 消費税: ¥51,000 / 源泉徴収税: ▲¥0
──────────────────────────────────
合計: ¥572,000（税込）
PDF: ~/.misoca-agent/data/quotes/QUO-2026-0018.pdf
ステータス: 送付待ち
3. misoca delivery — 納品書作成
納品書を作成します。見積書・請求書からの変換にも対応しています。
misoca delivery create --from-quote QUO-2026-0018 \
--delivery-date 2026-03-15
出力例:
納品書作成完了
番号: DLV-2026-0012
元見積: QUO-2026-0018
取引先: 合同会社テストカンパニー
納品日: 2026-03-15
品目数: 2件
合計: ¥572,000（税込）
PDF: ~/.misoca-agent/data/deliveries/DLV-2026-0012.pdf
4. misoca payment — 入金管理
入金の記録、消込、残高確認を行います。
misoca payment record --invoice INV-2026-0042 \
--amount 726000 --date 2026-03-25 \
--method bank-transfer --bank "三菱UFJ銀行"
出力例:
入金記録完了
請求書: INV-2026-0042（株式会社サンプル商事）
請求額: ¥726,000
入金額: ¥726,000
入金日: 2026-03-25
方法: 銀行振込（三菱UFJ銀行）
ステータス: 全額入金済み ✓
残高: ¥0
消込処理を弥生会計に連携しました。
仕訳: 普通預金 726,000 / 売掛金 726,000
5. misoca report — 売上レポート
期間指定で売上レポートを生成します。
misoca report monthly --month 2026-02
出力例:
月次売上レポート（2026年2月）
═══════════════════════════════════════════════════
請求書発行数: 15件
請求総額: ¥4,830,000
入金済み: ¥3,520,000（72.9%）
未入金: ¥1,310,000（27.1%）
取引先別TOP5:
1. 株式会社サンプル商事 ¥1,200,000
2. 合同会社テストカンパニー ¥890,000
3. 有限会社デザインラボ ¥750,000
4. NPO法人クリエイトネット ¥540,000
5. 個人事業主 山田太郎 ¥320,000
税率別集計:
10%対象: ¥4,500,000（税額 ¥450,000）
8%対象: ¥330,000（税額 ¥26,400）
期限超過請求書: 2件（¥310,000）
- INV-2026-0028 ¥180,000（5日超過）
- INV-2026-0031 ¥130,000（2日超過）
6. misoca export — データエクスポート
請求データを各種形式でエクスポートします。
misoca export csv --period 2026-01:2026-03 --format yayoi
出力例:
エクスポート完了
形式: 弥生会計インポート用CSV
期間: 2026-01-01 〜 2026-03-31
件数: 42件
ファイル: ~/.misoca-agent/data/exports/yayoi_2026_Q1.csv
出力内容:
仕訳日記帳形式（弥生会計オンライン対応）
勘定科目: 売掛金 / 売上高 / 仮受消費税
補助科目: 取引先名を自動設定
7. misoca template — テンプレート管理
請求書テンプレートの一覧表示、作成、編集を行います。
misoca template list
出力例:
登録テンプレート一覧
┌────┬──────────────────┬──────────┬──────────┬──────────┐
│ ID │ テンプレート名 │ 種別 │ 最終更新 │ 使用回数 │
├────┼──────────────────┼──────────┼──────────┼──────────┤
│ 1 │ 標準請求書 │ 請求書 │ 2026-02 │ 128│
│ 2 │ デザイン業務用 │ 請求書 │ 2026-01 │ 34│
│ 3 │ コンサル見積 │ 見積書 │ 2026-02 │ 22│
│ 4 │ 源泉徴収対応 │ 請求書 │ 2025-12 │ 15│
│ 5 │ 英文Invoice │ 請求書 │ 2025-11 │ 8│
└────┴──────────────────┴──────────┴──────────┴──────────┘
8. misoca client — 取引先管理
取引先マスタの管理を行います。
misoca client add --name "新規株式会社" \
--email "keiri@shinki-corp.co.jp" \
--tax-id "T9876543210987" \
--address "東京都港区六本木1-2-3" \
--payment-terms 30
出力例:
取引先登録完了
ID: CLT-0089
会社名: 新規株式会社
メール: keiri@shinki-corp.co.jp
登録番号: T9876543210987（国税庁データベース照合済み）
住所: 東京都港区六本木1-2-3
支払条件: 30日
ステータス: 有効
過去取引: なし（新規取引先）
Workflow Diagram
┌─────────────────────────────────────────────────────────────────┐
│ Misoca Agent ワークフロー │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 見積書 │───▶│ 受注確認 │───▶│ 納品書 │───▶│ 請求書 │ │
│ │ 作成 │ │ │ │ 作成 │ │ 作成 │ │
│ └──────────┘ └──────────┘ └──────────┘ └────┬─────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ │
│ │ PDF生成 │ │ 送付 │ │
│ │ メール │ │ メール │ │
│ │ 送信 │ │ 郵送代行 │ │
│ └──────────┘ └────┬─────┘ │
│ │ │
│ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 弥生会計 │◀───│ 仕訳生成 │◀───│ 消込処理 │◀─│ 入金確認 │ │
│ │ 連携 │ │ │ │ │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ──── 月次レポート ───────────────────────────────── │
│ │ 売上集計 │ 未入金一覧 │ 取引先別分析 │ CSV出力 │ │
│ └──────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
Error Handling
Error 1: OAuth認証期限切れ
[MISOCA-E001] OAuth2トークン期限切れ
エラー: access_token has expired
対処: リフレッシュトークンで自動更新を試行中...
結果: 新しいアクセストークンを取得しました。再実行します。
Error 2: 取引先未登録
[MISOCA-E002] 取引先が見つかりません
検索: "株式会社サンフル商事"
候補: "株式会社サンプル商事"（類似度 92%）
対処: 候補の取引先を使用しますか？ [Y/n]
Error 3: 登録番号不正
[MISOCA-E003] 適格請求書発行事業者登録番号の検証エラー
入力: T123456789012（12桁）
要件: T + 13桁の数字（合計14文字）
対処: 正しい登録番号を入力してください。
国税庁の公表サイトで確認: https://www.invoice-kohyo.nta.go.jp/
Error 4: 重複請求書検出
[MISOCA-E004] 重複請求書の可能性
検出: 同一取引先・同一金額の請求書が存在します
既存: INV-2026-0042 ¥726,000（2026-03-01発行）
新規: INV-2026-0043 ¥726,000（2026-03-01作成中）
対処: 重複でない場合は --force オプションを付けて再実行してください。
Error 5: API Rate Limit
[MISOCA-E005] APIレート制限に到達
制限: 100リクエスト/分
現在: 102リクエスト（超過: 2件）
対処: 58秒後に自動リトライします...
残りキュー: 3件の処理が待機中
Error 6: PDF生成エラー
[MISOCA-E006] PDF生成に失敗しました
原因: テンプレートに必須フィールドが不足しています
不足: 振込先銀行情報
対処: MISOCA_BANK_NAME と MISOCA_BANK_ACCOUNT を環境変数に設定してください。
Error 7: 弥生会計連携エラー
[MISOCA-E007] 弥生会計との連携に失敗しました
原因: 弥生IDの認証が無効です
対処: 弥生マイポータルから再認証を行ってください。
連携設定画面: Misoca設定 > 外部サービス連携 > 弥生会計
FAQ
Q1: Misocaの料金プランによる制限はありますか？
Misocaには無料プラン、プラン15、プラン100があります。無料プランでは月5通まで、プラン15は月15通まで、プラン100は月100通までの請求書作成が可能です。Misoca AgentはAPIリクエスト数を最適化し、不要なリクエストを削減するよう設計されています。
Q2: インボイス制度に対応していますか？
完全に対応しています。適格請求書発行事業者の登録番号（T+13桁）を環境変数 MISOCA_TAX_REGISTRATION に設定すると、すべての請求書に自動的に記載されます。税率ごとの区分経理、端数処理もインボイス制度の要件に準拠します。
Q3: 源泉徴収税の計算は自動ですか？
はい。請求書作成時に --withholding オプションを付けると、報酬の種類に応じて源泉徴収税率（10.21%または20.42%）を自動適用します。100万円以下と100万円超で税率が変わる計算にも対応しています。
Q4: 弥生会計オンラインとの連携方法は？
Misocaは弥生グループのサービスのため、弥生IDでログインするだけで自動連携が可能です。請求書の発行・入金消込が弥生会計の仕訳として自動登録されます。勘定科目のマッピングはカスタマイズ可能です。
Q5: 請求書の郵送代行は利用できますか？
Misocaの郵送代行サービスと連携しています。misoca invoice send --method post --invoice INV-2026-0042 で郵送を依頼できます。1通あたり約160円（税込）で、翌営業日に発送されます。
Q6: 複数の銀行口座を使い分けできますか？
テンプレートごとに異なる振込先を設定できます。misoca template create --bank "みずほ銀行 新宿支店 普通 7654321" のように、テンプレートに銀行情報を紐づけることで、取引先や案件に応じて振込先を自動で切り替えます。
Q7: 見積書から請求書への変換はできますか？
はい。misoca invoice create --from-quote QUO-2026-0018 で見積書の全明細行を引き継いで請求書を作成できます。数量や単価の変更がある場合は確認プロンプトが表示されます。
Q8: CSVインポートで一括作成はできますか？
対応しています。misoca invoice bulk-create --csv ./invoices.csv で、CSVファイルから複数の請求書を一括作成できます。CSVのフォーマットはMisoca標準形式に準拠してください。
Q9: 電子帳簿保存法への対応は？
Misoca Agent はPDFファイルにタイムスタンプを付与し、改ざん検知機能を備えています。検索要件（取引年月日・取引金額・取引先）にも対応した保存を行い、電子帳簿保存法の電子取引データ保存要件を満たしています。
Q10: 英文請求書は作成できますか？
テンプレートを英文用に設定することで対応可能です。misoca invoice create --template english --currency JPY で英文請求書を作成できます。通貨はJPYのほか、USD、EURにも対応しています（表示のみ、Misoca上の管理はJPY換算）。
Q11: 定期請求書（毎月自動発行）は設定できますか？
misoca invoice recurring --client "株式会社定期取引" --items "月額保守:1:100000:10" --cycle monthly --start 2026-04-01 で毎月自動発行の定期請求書を設定できます。サイクルは monthly（毎月）、quarterly（四半期）、yearly（年次）から選択可能です。
Q12: APIのレート制限はどうなっていますか？
Misoca APIは1分あたり100リクエストの制限があります。Misoca Agentはリクエストの最適化とバッチ処理により、通常の操作ではこの制限に到達しません。万が一到達した場合は自動的に待機し、リトライします。
Data Storage
Misoca Agentのローカルデータは以下のディレクトリ構造で保存されます。
~/.misoca-agent/
├── config/
│ ├── settings.json # エージェント設定ファイル
│ ├── templates/ # カスタムテンプレート
│ │ ├── standard.json # 標準請求書テンプレート
│ │ ├── design.json # デザイン業務用
│ │ └── english.json # 英文テンプレート
│ └── accounts/ # 振込先口座情報
│ ├── primary.json # メイン口座
│ └── secondary.json # サブ口座
├── data/
│ ├── invoices/ # 請求書PDF・JSON
│ │ ├── INV-2026-0001.pdf
│ │ ├── INV-2026-0001.json
│ │ └── ...
│ ├── quotes/ # 見積書PDF・JSON
│ │ ├── QUO-2026-0001.pdf
│ │ └── ...
│ ├── deliveries/ # 納品書PDF・JSON
│ │ ├── DLV-2026-0001.pdf
│ │ └── ...
│ ├── clients/ # 取引先マスタ
│ │ ├── CLT-0001.json
│ │ └── ...
│ ├── payments/ # 入金記録
│ │ └── 2026/
│ │ ├── 01.json
│ │ ├── 02.json
│ │ └── 03.json
│ └── exports/ # エクスポートデータ
│ ├── yayoi_2026_Q1.csv
│ └── monthly_2026_02.csv
├── logs/
│ ├── api.log # APIリクエストログ
│ ├── audit.log # 監査ログ（操作履歴）
│ └── error.log # エラーログ
├── cache/
│ ├── tokens.enc # 暗号化トークン
│ └── tax_registry.json # 登録番号キャッシュ
└── backup/
└── 2026/
├── 01/ # 月次バックアップ
├── 02/
└── 03/
Comparison Table
| 機能 | Misoca Agent | freee請求書 | マネーフォワード クラウド請求書 | board |
|---|---|---|---|---|
| CLI操作 | 対応 | 非対応 | 非対応 | 非対応 |
| Claude Code統合 | 対応 | 非対応 | 非対応 | 非対応 |
| インボイス制度対応 | 対応 | 対応 | 対応 | 対応 |
| 電子帳簿保存法対応 | 対応 | 対応 | 対応 | 一部対応 |
| API連携 | REST API | REST API | REST API | 限定的 |
| 弥生会計連携 | ネイティブ | 非対応 | 非対応 | 非対応 |
| freee連携 | 非対応 | ネイティブ | 非対応 | 非対応 |
| MF会計連携 | 非対応 | 非対応 | ネイティブ | 非対応 |
| 郵送代行 | 対応(約160円) | 対応(約170円) | 対応(約180円) | 非対応 |
| 源泉徴収自動計算 | 対応 | 対応 | 対応 | 対応 |
| 定期請求書 | 対応 | 対応 | 対応 | 対応 |
| 英文請求書 | 対応 | 対応 | 対応 | 対応 |
| 見積書→請求書変換 | 自動 | 自動 | 自動 | 手動 |
| 無料プラン | 月5通 | 制限付き | 制限付き | なし |
| 月額料金（有料） | 800円〜 | 1,980円〜 | 2,980円〜 | 3,980円〜 |
| 取引先登録番号照合 | 自動 | 自動 | 自動 | 手動 |
| バッチ処理 | 対応 | 非対応 | 非対応 | 非対応 |
| オフライン操作 | ローカルキャッシュ | 非対応 | 非対応 | 非対応 |
| 操作ログ・監査証跡 | 詳細ログ | 基本ログ | 基本ログ | なし |
Misoca Agentの最大の優位性は、弥生グループのエコシステムとのネイティブ連携、Claude Codeからのコマンドライン操作、そして請求書作成から入金管理・会計連携までのワークフロー全体を自動化できる点にあります。特にフリーランスや中小企業が弥生会計を利用している場合、仕訳データの手動入力が不要になり、月次決算の工数を大幅に削減できます。
License
MIT License - hanabi-jpn