適格請求書発行事業者公表システム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の発行手続を行ってください。
なお、適格請求書発行事業者公表システムWeb-API機能(以下「インボイスWeb-API」といいます。)を利用できるアプリケーションIDをお持ちの方は、「法人番号システムWeb-API」も同じIDで利用することが可能です。
法人番号システムWeb-APIの情報は、以下のリンク先を参照してください。
「法人番号システムWeb-API」のアプリケーションIDをお持ちの方へ
令和4年12月15日にお知らせしているとおり、令和5年1月20日から「法人番号システムWeb-API」のアプリケーションIDをお持ちの方であっても、国税庁に対して「適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書」を提出し、国税庁の承認を受けていないとインボイスWeb-APIを利用することはできなくなりました。
なお、法人番号システムWeb-APIは令和5年1月20日以降も、上記発行申請書を提出しなくても利用することができます。
発行手続を行う場合はこちら
適格請求書発行事業者の登録番号の発行をご希望の方へ
登録番号(Tから始まる13桁の数字)の発行をご希望の方は、国税庁ホームページ内のインボイス制度特設サイトをご覧ください。
国税庁インボイス制度特設サイト(外部サイト)
登録の申請手続(外部サイト)
アプリケーションID発行手続きの流れ
アプリケーションID発行手続きの流れは次のとおりとなります。
- 「アプリケーションID発行届出」ボタンをクリックし、仮登録画面からメールアドレスを入力し送信してください。
- 送信後、入力したメールアドレス宛に「アプリケーションID発行届出フォーム」画面のURLが送付されます。
- 本画面にアプリケーションID届出情報を入力し送信してください。
- 適格請求書発行事業者の情報を取得されたい方は5.に進んでください。法人番号の指定を受けた者の1.商号又は名称、2.本店又は主たる事務所の所在地、3.法人番号(基本3情報)のみ取得されたい方は【法人番号システムWeb-APIのみ利用をご希望の方】に進んでください。
- 「適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書」(エクセル:28KB)及び添付書類を国税庁軽減税率・インボイス制度対応室宛てにメールにてご提出ください。
なお、発行申請書を提出される際は、発行申請書の下記の項番についてご留意願います。
原則として、下記の内容に該当しない場合は、申請書の承認ができません。
・項番2.6.1「取得した公表情報について、利用者の情報又は使用取得状況等を把握できる」については、「はい」であること。
・項番2.6.2「2.6.1.で「はい」と回答した場合、その方法」が、ログの解析等の具体的な方法により把握できること。
・項番2.7.「添付書類」について、顧客の方も利用されるプログラム・システムの場合は適格請求書発行事業者の登録番号により公表情報の検索を行い、登録番号以外からの検索ができない仕様だと分かる資料であること。 - 上記5の「適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書」及び添付書類のご提出後、当室で審査を行うため、アプリケーションID新規発行のお知らせの送信まで1か月程度要しております(発行申請書の内容について確認する点があった場合は、さらにお時間を要します。)。
【法人番号システムWeb-APIのみ利用をご希望の方】
上記1.から3.までの手続きを終えた上で、国税庁軽減税率・インボイス制度対応室宛てにメール( invoice-web-api@nta.go.jp )にて、次の事項をご連絡ください。
- アプリケーションID発行届出フォームで入力した利用者の氏名又は名称
- アプリケーションID発行届出フォームで入力したメールアドレス
- 法人番号システムWeb-APIのみの利用希望である旨
また、法人番号システムWeb-APIのみ利用できるアプリケーションIDの発行には、上記メールを当室で受信後、1か月程度要することがありますので、ご了承ください。
適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書(エクセル:28KB)
提出先 : 国税庁 軽減税率・インボイス制度対応室 ( invoice-web-api@nta.go.jp )
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方へ
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方がインボイスWeb-APIをご利用になりたい場合、アプリケーションID発行届出フォームの入力は行わずに、上記「適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書」及び添付書類を国税庁軽減税率・インボイス制度対応室宛てにメールにてご提出ください。
インボイスWeb-APIがご利用できるようになるまで1か月から1か月半程度要することがありますので、お早めにご提出ください。
届出フォームの利用停止期間
毎月、アプリケーションID発行届出フォームがご利用できなくなる期間があります
詳しくはお知らせの「アプリケーションID届出フォームの利用停止について」をご覧ください。
発行済のアプリケーションIDの登録情報を変更する場合はこちら
届出フォームの利用停止期間
毎月、アプリケーションID発行届出フォームがご利用できなくなる期間があります
詳しくはお知らせの「アプリケーションID届出フォームの利用停止について」をご覧ください。
適格請求書発行事業者公表システムWeb-API機能アプリケーションID変更申請書(エクセル:28KB)
「適格請求書発行事業者公表システムWeb-API機能アプリケーションID発行申請書」に記載した事項に変更があった時にご提出ください。
提出先 : 国税庁 軽減税率・インボイス制度対応室 ( invoice-web-api@nta.go.jp )
なお、メールアドレス、担当者氏名又は担当者連絡先の変更のみの場合は、変更申請書の提出は不要です。
上記「アプリケーションID登録情報変更届出」フォームから届け出てください。
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方へ
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方は、上記「アプリケーションID登録情報変更届出」フォームはご利用いただけません。
(アプリケーションIDと登録済みのメールアドレスを入力した時にエラーとなります。)
登録情報の変更をご希望の方は、下記の「Web-APIに関するお問い合わせ」フォームから以下の事項を入力の上、送信してください。
- 変更前の情報
- 変更後の情報
- アプリケーションID
- メールアドレス(変更する場合は変更後のメールアドレス)
なお、登録情報の変更にお時間を要する場合がございますのでご了承ください。
登録情報
個人の方:氏名、氏名(カナ)、電話番号及びメールアドレス
法人の方:法人番号、法人名、担当部署名、担当者氏名、担当者氏名(カナ)、電話番号及びメールアドレス
発行済のアプリケーションIDを停止する場合はこちら
届出フォームの利用停止期間
毎月、アプリケーションID発行届出フォームがご利用できなくなる期間があります
詳しくはお知らせの「アプリケーションID届出フォームの利用停止について」をご覧ください。
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方へ
法人番号システムWeb-APIのみ利用できるアプリケーションIDをお持ちの方は、上記「アプリケーションID停止届出」フォームはご利用いただけません。
(アプリケーションIDと登録メールアドレスを入力した時にエラーとなります。)
利用停止をご希望の方は、下記の「Web-APIに関するお問い合わせ」フォームから以下の事項を入力の上送信してください。
- 利用停止する旨
- アプリケーションID
情報の取得元の明示
Web-API機能を使用したサービスを公開される場合には、下記の情報の取得元の明示をお願いします。
「このサービスは、国税庁適格請求書発行事業者公表システムのWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない」
利用される方が参照できる場所であれば、表示場所の指定はございません。
Web-APIの詳細について
Web-APIの利用手続、リクエストの設定方法及び提供データの内容等については、「適格請求書発行事業者公表システムWeb-API機能の利用手続について」及び「適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について(Ver.1.0)」を参考に利用する機能に応じたバージョンの仕様書を参照してください。
また、提供するデータ項目及びデータ形式等については、「公表情報ダウンロード-ダウンロードファイルのデータ定義」の「リソース定義書」を参照してください。
適格請求書発行事業者公表システムWeb-API機能の利用手続について(PDF:1,508KB)
適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について(Ver.1.0)
Web-APIの検証
国税庁では、利用者が構築するシステムとのインターフェース検証テストのために、検証用の法人、団体又は個人の名称を利用したWeb-API検証環境を提供しております。
検証環境の利用にあたっては、アプリケーションIDが必要となります。
検証環境の利用方法はこちらをご参照ください。
お問い合わせ
Web-API仕様に関するお問い合わせは、以下の方法で受け付けております。なお、回答はメールで行います。
1 アプリケーションIDを取得されている場合
「Web-APIに関するお問い合わせ」のフォームよりお問い合わせください。
2 アプリケーションIDを取得されていない場合
invoice-web-api@nta.go.jp宛にメールでお問い合わせください。