適格請求書発行事業者公表システムWeb-API機能

 Web-API機能は、利用者が保有するシステムからリクエストを送信することで、指定した登録番号で抽出した情報、指定した期間で抽出した更新(差分)情報を取得するためのシステム間連携インターフェース(データ授受の方式)を提供する機能です。

 本ページは、Web-API機能について次の構成で説明を行います。

1.概要

 Web-APIの設計方式は、REST方式です。利用者のシステムから適格請求書発行事業者公表システム(以下、インボイス公表システムという。)に指定した条件でリクエストを送信すると、指定された条件に基づき、インボイス公表システムで動的にデータを生成し、データを応答します。
 令和3年10月から、以下の3つの機能を提供しています。
 ※指定した条件のリクエストに基づき生成されるファイル形式でデータを応答します。

登録番号の指定

取得期間の指定

登録番号と日付の指定

2.利用方法

Web-API機能の利用規約について

 Web-API機能を利用するにあたっては、「Web-API機能の利用規約」に同意いただくことが必要です。
 まずはこちらをご覧ください。

Web-API機能の利用規約へ


アプリケーションIDについて

 Web-APIを利用するためには、アプリケーションIDが必要です。

 アプリケーションIDをお持ちでない方は、アプリケーションIDの発行申請を行ってください(発行無料)。

種類

 アプリケーションIDには「インボイスWeb-API」及び「法人番号システムWeb-API」※を利用できるアプリケーションID(以下「インボイス用アプリケーションID」といいます。)と、「法人番号システムWeb-API」のみ利用できるアプリケーションID(以下「法人番号用アプリケーションID」といいます。)の2種類があります。
 ※ 法人番号システムWeb-APIの情報は、以下のリンク先ページをご参照ください。

外部サイトへリンク 新規ウインドウで開きます。法人番号公表サイトへ

発行申請手続を行う場合

 「インボイス用アプリケーションID」の発行を受ける場合、次の「発行届出」ボタンからメールアドレスを仮登録してください。仮登録したメールアドレスに届いたURLから基本情報等の入力を行い、「公表情報の取得方法及び利用方法」が分かる資料を提出してください(これを「本登録」といいます。)。本登録後、国税庁で審査を行い、不備がなければ「インボイス用アプリケーションID」を発行します。本登録の内容に不備があった場合には、国税庁から基本情報の連絡先に連絡を行い、ご登録内容の確認を行う場合があります。
 「法人番号用アプリケーションID」の発行を受ける場合、次の「発行届出」ボタンからメールアドレスを仮登録してください。次に、仮登録したメールアドレスに届いたURLから基本情報等の入力を行うと1か月程度で「法人番号用アプリケーションID」を発行します。

アプリケーションIDを発行を届け出たい方はこちら

登録情報を変更する場合、法人番号用アプリケーションIDにインボイスWeb-APIの権限を追加する場合

 アプリケーションIDの発行を受ける前に提出した登録情報の変更や、「法人番号用アプリケーションID」を取得した後に「インボイスWeb-API」の権限を追加することができます。この場合、次の「登録情報変更届出」ボタンからメールアドレスを仮登録してください。仮登録したメールアドレスに届いたURLから変更する登録情報等の入力を行ってください。国税庁では、入力いただいた情報で審査を行い、不備がなければ、ご希望に応じた情報の更新を行います。入力いただいた情報に不備があった場合には、国税庁から基本情報等の連絡先に連絡を行い、ご登録内容の確認を行う場合があります。

登録情報変更届出へ

利用停止を行う場合

 アプリケーションIDの利用を停止する場合には、次の「停止届出」ボタンからメールアドレスを仮登録してください。
 仮登録したメールアドレスに届いたURLから停止届出を提出してください。

停止届出へ

情報取得元の明示

Web-API機能を使用したサービスを公開される場合には、下記の情報の取得元の明示をお願いします。

「このサービスは、適格請求書発行事業者公表システムWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない」

 利用される方が参照できる場所であれば、表示場所の指定はありません。

3.詳細仕様

 Web-API機能の利用方法等については、次の資料を参照してください。

提供するデータ項目及びデータ形式等については、次のリンク先の「リソース定義書」を参照してください。

4.検証環境

 国税庁では、利用者が構築するシステムとのインターフェース検証テストのために、検証用の法人、団体又は個人の名称を利用したWeb-API検証環境を提供しています。

 検証環境の利用にあたっては、「インボイス用アプリケーションID」が必要となります。
 検証環境の利用方法は次のリンク先を参照してください。

5.お問い合わせ

 Web-API仕様に関するお問い合わせは、以下の方法で受け付けています。なお、回答はメールで行います。
 
 1 アプリケーションIDを取得済みの場合

「Web-APIに関するお問い合わせ」のフォームよりお問い合わせください。

 2 アプリケーションIDを取得未済の場合

invoice-web-api@nta.go.jp宛にメールでお問い合わせください。