jp-corporate インボイス 登録番号 API
登録番号の照合を、サイトを開かずに AI へ
請求書に書かれた T から始まる登録番号を、AI エージェントにそのまま聞けます。国税庁の公表データにもとづく登録の有無と登録日が、出典とデータの基準日つきで返ります。
できること
インボイス登録番号の照合でできること
T から始まる登録番号を照合する
verify_invoice_number は、T+13桁の適格請求書発行事業者登録番号を照合します。例では T1180301018771 に対して「登録あり、登録日 2023-10-01」が返ります。
例: verify_invoice_number {"invoiceNumber": "T1180301018771"}
登録ありの応答には、法人番号データから取れた法人名と所在地も付きます(法人番号表に無い場合は null)。出典とデータの基準日も一緒に返ります。
取消・失効を日付つきで区別する
登録が取消されていれば取消日を、失効していれば失効日を付けて返します。登録・取消・失効・未発見を状態として区別します。
見つからない番号を無効と断定しない
公表データに見当たらない番号には「公表データに見当たらない」と返します。本サービスは法人(h)・人格のない社団等(j)のデータのみを取り込み、個人事業者(k)のデータは取り込まないため、個人事業者の番号はここでは見つかりません。これは番号が無効・不存在であるという断定ではありません。
桁が足りないなど形式が違う番号は invalid_input で返します。T+13桁で指定してください。
請求書の一覧をまとめて渡す
search_invoice_batch なら T+13桁の登録番号を最大100件まで1回の呼び出しで照合できます。結果は入力順に1件ずつ返り、月次の回数は1回の呼び出しとして数えます。
例: search_invoice_batch {"invoiceNumbers": ["T1180301018771", "T1180301018772"]}
人間の聞き方:
「T1180301018771 は登録されてる?」
「この番号は取消されてる?失効してる?」
「今月の請求書の登録番号をまとめて照合して」 返答の根拠
返答には出典と基準日が付きます
出典: 国税庁適格請求書発行事業者公表サイト(https://www.invoice-kohyo.nta.go.jp/ )を加工して作成。返答にはデータの基準日も付きます。AIエージェントの答えをうのみにせず、出典元で確かめられます。
すべての返答に出典が付きます。重要な判断では一次情報も確認してください。
国税庁 Web-API との違い
申請なしで、会話のまま照合する
アプリケーションIDの発行を待たない
plugrail は接続先 URL を追加するだけですぐ使えます。認証は任意で、ログインしなくても月100回まで使えます。
月100回まで無料で使える
匿名でも無料アカウントでも、暦月(日本時間)で月100回までカード不要です。月次の回数をなくしたい場合はプロ(月額9,800円・税込)もあります。
会話のまま一覧を渡せる
登録番号の一覧を貼って「照合して」と頼むだけで、AIエージェントがツールを呼び出して結果を整理します。法人番号や会社プロファイルの確認は、jp-corporate のページもご覧ください。
13桁の法人番号や法人名からの照会は、法人番号 API 無料のページにまとめています。
つなぎ方
接続は3ステップ
- 無料キー登録でアカウントを作る(ログインしなくても月100回まで使えます/キーの管理は /dashboard/)
- 下のコマンドで MCP サーバーを追加する(接続先URL:
https://jp-corporate.plugrail.dev/mcp) - AI エージェントに上の「人間の聞き方」の質問を投げる
Claude Code の場合は、ターミナルで次のコマンドを実行します。
claude mcp add --transport http jp-corporate https://jp-corporate.plugrail.dev/mcp 料金と上限
無料ではじめる
匿名・無料アカウントとも月100回まで無料です(暦月・日本時間、カード不要)。回数は日本時間の毎月1日にリセットされます。数えるのはツールの呼び出し(tools/call)だけです。
- 短時間の集中利用には分あたりの上限があります(ログインなしは1分あたり10回、無料アカウントは60回)。
- プロは月次の回数制限がなく、毎分600回まで使えます(月額9,800円・税込)。
- SLA は設けていません。
プランの比較は料金のページにもまとめています。
質問
よくある質問
-
どのAIエージェントで使えますか
MCP 対応のクライアントから使えます。接続先URLはリモート MCP(Streamable HTTP)方式です。
-
個人事業者の登録番号も照合できますか
本サービスは法人・人格のない社団等のデータのみを取り込んでおり、個人事業者のデータは取り込んでいません。公表サイトの番号検索では確認できる場合があります。
-
見つからない番号は未登録という意味ですか
いいえ。「公表データに見当たらない」という意味で、無効・不存在の断定ではありません。
-
取消・失効の番号はどう返りますか
取消日または失効日を付けて、登録とは別の状態として返します。
-
月100回で足りますか
1件ずつ照合する場合は1件につき1回です。30件なら30回分です。まとめて照合する
search_invoice_batchなら最大100件を1回として数えます。100回を使い切ったら、日本時間の翌月1日のリセットを待ってください。
注意
ご利用前に
- 無料枠で数えるのはツールの呼び出し(tools/call)だけです。回数は日本時間の毎月1日にリセットされます。ログインなしは IP アドレス単位、アカウントでは所有者単位で数えます。
- 元データは国税庁適格請求書発行事業者公表サイトの公表情報です。国税庁における登録・変更・登録取消・失効・公表の撤回が本サービスに反映されるまでには時間差が生じます。
- 取引先の確認や下調べを手早く済ませるためのサービスです。登録の有無が税額に関わる場面など大事な判断では、公表サイトの原本もあわせて確かめてください。
- 出典: 国税庁適格請求書発行事業者公表サイト(https://www.invoice-kohyo.nta.go.jp/ )を加工して作成。
- SLA は設けていません。
エラーが出たとき
よくあるエラーと対処
| 返ってくる内容 | 原因 | 対処 |
|---|---|---|
| HTTP 401「認証に失敗しました。」 | APIキーの形式が違うか、失効している | 管理画面でキーを確かめ、Authorization: Bearer <キー> で送り直す。キーなしでも月100回までは使える |
| HTTP 429「レート制限を超過しました。」 | 1分あたりの上限(ログインなし10回・無料60回・プロ600回)に達した | 返ってきた Retry-After の秒数だけ待って再試行する |
| 「今月の無料枠(100回)を超えました。」 | 日本時間の今月、ツール呼び出しが100回を超えた | 翌月1日に回数が戻る。続けて使うならプロ(月額9,800円・税込)へ |
invalid_input | 番号の桁が足りないなど、入力の形が違う | ページ上部の入力例の形に合わせる |
まず動くか確かめる(curl)
curl -s https://jp-corporate.plugrail.dev/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ツールの一覧が返れば接続はできています。
次の一歩
まず1件、登録なしで照会してみる
手元の請求書の登録番号を1件、AI エージェントに聞いてみてください。キー登録は後からでもできます。