適格請求書発行事業者公表システムWeb-API検証環境の提供について

　国税庁では、利用者が構築するシステムのインターフェース検証テストのために、検証環境を提供しています。

　検証環境では、利用者が構築するシステムからのリクエストに対し、Web-APIの検証用サーバより、サンプルデータ（架空の適格請求書発行事業者のデータ）を応答します。

　国税庁からお知らせした「アプリケーションID」を以下のリクエストフォーマットに設定し送信することで検証環境を利用することができます。リクエストフォーマットに設定する「バージョン」及び「条件」は本番環境と同様となりますので、当サイトで公開している「適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について（Ver.1.0）」を参照してください。

1. Web-API機能別リクエストフォーマット

2. HTTPステータスコード及びエラーコード

　リクエストに誤りがある場合などには、HTTPステータスコードのほか、エラーコード及びエラーメッセージをCSV形式で応答します。

　エラーコードの値や内容については、当サイトで公開している「適格請求書発行事業者公表システムWeb-API機能のリクエストの設定方法及び提供データの内容について（Ver.1.0）」を参照してください。

　Web-API検証環境では、当サイトで公開しているサンプルデータと同様のデータで検証することができます。

　なお、サンプルデータの「最終更新年月日」は令和５年11月13日としています。
　サンプルデータをご利用いただく際には、以下の事項にご留意ください。

1. 検証環境で「取得期間を指定して情報を取得する機能」を利用して指定した期間において更新された登録年月日、取消年月日及び失効年月日に係る履歴情報を取得し、データの更新を検証する場合には、事前に、当サイトで公開しているサンプルデータから、全件データを取り込む必要があります。

ファイル格納場所：k-sample-dl-r0310 ⇒ 01_ダウンロード機能 ⇒ 01_全件データ

2. 別添「全件データの概要」及び「差分データの概要」に記載されているデータのうち、以下のレコードは、仕様上、Web-APIで取得するデータには含まれません。

　現在、当サイトで公開している以下の利用規約等は、検証環境においても適用されますので、事前に利用規約等をご一読いただき、利用規約等に同意された場合にのみ、検証環境をご利用ください。
　なお、以下の利用規約等は「適格請求書発行事業者公表システムWeb-API機能の利用手続について」でもご確認いただけます。