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ステップ

  1. 無料キー登録でアカウントを作る(ログインしなくても月100回まで使えます/キーの管理は /dashboard/)
  2. 下のコマンドで MCP サーバーを追加する(接続先URL: https://jp-corporate.plugrail.dev/mcp)
  3. 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 は設けていません。

プランの比較は料金のページにもまとめています。

質問

よくある質問

注意

ご利用前に

  • 無料枠で数えるのはツールの呼び出し(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 エージェントに聞いてみてください。キー登録は後からでもできます。