適格請求書発行事業者公表システムWeb-API機能
Web-API機能は、利用者が保有するシステムからリクエストを送信することで、指定した登録番号で抽出した情報、指定した期間で抽出した更新(差分)情報を取得するためのシステム間連携インターフェース(データ授受の方式)を提供する機能です。
本ページは、Web-API機能について次の構成で説明を行います。
1.概要
Web-APIの設計方式は、REST方式です。利用者のシステムから適格請求書発行事業者公表システム(以下、インボイス公表システムという。)に指定した条件でリクエストを送信すると、指定された条件に基づき、インボイス公表システムで動的にデータを生成し、データを応答します。
令和3年10月から、以下の3つの機能を提供しています。
※指定した条件のリクエストに基づき生成されるファイル形式でデータを応答します。
2.利用方法
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にインボイスWeb-APIの権限を追加する場合
アプリケーションIDの発行を受ける前に提出した登録情報の変更や、「法人番号用アプリケーションID」を取得した後に「インボイスWeb-API」の権限を追加することができます。この場合、次の「登録情報変更届出」ボタンからメールアドレスを仮登録してください。仮登録したメールアドレスに届いたURLから変更する登録情報等の入力を行ってください。国税庁では、入力いただいた情報で審査を行い、不備がなければ、ご希望に応じた情報の更新を行います。入力いただいた情報に不備があった場合には、国税庁から基本情報等の連絡先に連絡を行い、ご登録内容の確認を行う場合があります。
利用停止を行う場合
アプリケーションIDの利用を停止する場合には、次の「停止届出」ボタンからメールアドレスを仮登録してください。
仮登録したメールアドレスに届いたURLから停止届出を提出してください。
情報取得元の明示
Web-API機能を使用したサービスを公開される場合には、下記の情報の取得元の明示をお願いします。
「このサービスは、適格請求書発行事業者公表システムWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない」
利用される方が参照できる場所であれば、表示場所の指定はありません。
3.詳細仕様
Web-API機能の利用方法等については、次の資料を参照してください。
第二編:リクエストの設定方法及び提供データの内容について(PDF:4,385KB)
提供するデータ項目及びデータ形式等については、次のリンク先の「リソース定義書」を参照してください。
4.検証環境
国税庁では、利用者が構築するシステムとのインターフェース検証テストのために、検証用の法人、団体又は個人の名称を利用したWeb-API検証環境を提供しています。
検証環境の利用にあたっては、「インボイス用アプリケーションID」が必要となります。
検証環境の利用方法は次のリンク先を参照してください。
5.お問い合わせ
Web-API仕様に関するお問い合わせは、以下の方法で受け付けています。なお、回答はメールで行います。
1 アプリケーションIDを取得済みの場合
「Web-APIに関するお問い合わせ」のフォームよりお問い合わせください。
2 アプリケーションIDを取得未済の場合
invoice-web-api@nta.go.jp宛にメールでお問い合わせください。


