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

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

適格請求書発行事業者公表システムWeb-APIの概要

 Web-APIのアーキテクチャスタイルは、REST方式です。企業等のシステムから適格請求書発行事業者公表システムに条件を指定してリクエストを送信すると、指定された条件に基づき、適格請求書発行事業者公表システムに動的にデータを生成し、データを応答します。

提供する機能及び取得可能なデータ

登録番号を指定して情報を取得する機能 【Ver.1】

 登録番号を指定しリクエストすることで、指定した登録番号の公表情報を取得することができます。

登録番号を指定して情報を取得する機能
 

取得期間を指定して情報を取得する機能 【Ver.1】

 指定された期間内に更新された適格請求書発行事業者の公表情報を取得することができます。
 (注)Web-API機能では全件データを取得することはできません。

取得期間を指定して情報を取得する機能

登録番号と日付を指定して情報を取得する機能 【Ver.1】

 指定された日付時点の当該事業者が該当する最新情報又は公表情報を取得することができます。

登録番号と日付を指定して情報を取得する機能

Web-APIのバージョンについて

Ver.1

 令和3年10月から、3つの機能(「登録番号を指定して情報を取得する機能」、「取得期間を指定して情報を取得する機能」、「登録番号と日付を指定して情報を取得する機能」)についてサービスを提供しています。

Web-APIの利用にあたって

利用規約

 Web-API機能は、どなたでもご利用いただけます。「Web-APIの利用規約」に同意いただいた上で、ご利用ください。

アプリケーションID

 Web-APIを利用するためには、アプリケーションIDが必要です。(アプリケーションIDの発行に費用は掛かりません。)アプリケーションIDをお持ちでない方は、利用規約を確認していただき、アプリケーションIDの発行手続を行ってください。
 なお、アプリケーションIDは「法人番号システムWeb-API」と共通化されており、この本サイトから取得したアプリケーションIDを「法人番号システムWeb-API」で利用することが可能です。
 また、既に法人番号システムWeb-APIのアプリケーションIDをお持ちの方は、お持ちのアプリケーションIDで適格請求書発行事業者公表システムWeb-APIを利用することができます。
 法人番号システムWeb-APIの情報は、以下のリンク先を参照してください。

発行手続を行う場合はこちら

アプリケーションID発行届出

発行済のアプリケーションIDの登録情報を変更する場合はこちら

アプリケーションID登録情報変更届出

発行済のアプリケーションIDを停止する場合はこちら

アプリケーションID停止届出

情報の取得元の明示

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

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

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

Web-APIの詳細について

 Web-APIの利用手続、リクエストの設定方法及び提供データの内容等については、「適格請求書発行事業者公表システムWeb-API機能の利用手続について」及び「適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について(Ver.1.0)」を参考に利用する機能に応じたバージョンの仕様書を参照してください。
 また、提供するデータ項目及びデータ形式等については、「公表情報ダウンロード-ダウンロードファイルのデータ定義」の「リソース定義書」を参照してください。

適格請求書発行事業者公表システムWeb-API機能の利用手続について

ダウンロードのリンク 新規ウインドウで開きます。ダウンロード(PDF:1,199KB)

適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について(Ver.1.0)

Web-API仕様書ダウンロード

Web-APIの検証

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

 検証環境の利用にあたっては、アプリケーションIDが必要となります。
 検証環境の利用方法はこちらをご参照ください。

お問い合わせ

 Web-API仕様に関するお問い合わせは、以下の方法で受け付けております。なお、回答はメールで行います。
 1 アプリケーションIDを取得されている場合
   「Web-APIに関するお問い合わせ」のフォームよりお問い合わせください。
 2 アプリケーションIDを取得されていない場合
   invoice-web-api@nta.go.jp宛にメールでお問い合わせください。