第二編

適格請求書発行事業者公表システム
Web-API機能のリクエストの設定方法及び提供データの内容について（Ver.1.0）－ 1.5版 －令和６年５月
国税庁
課税部軽減税率・インボイス制度対応室

改版履歴
項番

版数

作成年月

変更内容

変更理由等

1

初版

令和３年６月

-

-

2

1.1版

令和３年８月-3

1.2版

令和３年10月

4

1.3版

令和４年３月5

1.4版

令和４年12月

６

1.5版

令和６年５月発行者を「国税庁課税部軽減税率・インボイス制度対応室」に改訂。
「別紙１ リソース定義書」を1.1版から1.2版へ更新。
誤記を修正。
「別紙１ リソース定義書」を1.2版から1.3版へ更新。
「2.1.2.アプリケーション
ID」の記載を変更（3.1.2及び4.1.2も同様）「別紙１ リソース定義書」を1.4版から1.5版へ更
新。

-

-

Web-API機能の利
用規約の改正を行っ
たため。
-

－

目 次

－

１． 解説書の構成について ............................................................ 1
２． 登録番号を指定して情報を取得する機能について .................................... 2
2.1. リクエストのフォーマット ........................................................ 2
2.1.1. バージョン .................................................................... 2
2.1.2. アプリケーションID ............................................................ 2
2.1.3. 条件 .......................................................................... 2
2.2. 応答結果 ........................................................................ 3
2.3. リクエスト例と応答結果のサンプル ................................................ 3
2.3.1. 履歴情報を含めない場合 ........................................................ 3
2.3.2. 履歴情報を含める場合 ......................................................... 10
2.4. 一連番号の設定（ソート順） ..................................................... 15
３． 取得期間を指定して情報を取得する機能について ................................... 16
3.1. リクエストのフォーマット ....................................................... 16
3.1.1. バージョン ................................................................... 16
3.1.2. アプリケーションID ........................................................... 16
3.1.3. 条件 ......................................................................... 16
3.2. 応答結果 ....................................................................... 173.3. リクエスト例と応答結果のサンプル ............................................... 17
3.4. 一連番号の設定（ソート順） ..................................................... 22
3.5. 応答結果の分割について ......................................................... 22
４． 登録番号と日付を指定して情報を取得する機能について ............................. 24
4.1. リクエストのフォーマット ....................................................... 24
4.1.1. バージョン ................................................................... 24
4.1.2. アプリケーションID ........................................................... 24
4.1.3. 条件 ......................................................................... 24
4.2. 応答結果 ....................................................................... 24
4.3. リクエスト例と応答結果のサンプル ............................................... 25
4.4. 一連番号の設定（ソート順） ..................................................... 29
５． エラーコード及びHTTPステータスコード ........................................... 30
別紙１ 適格請求書発行事業者公表システムリソース定義書
別紙２ HTTP ステータスコード、エラーコード及びエラーメッセージ一覧＜公表サイト＞

１．

解説書の構成について

適格請求書発行事業者公表システムWeb-API機能（以下「Web-API機能」と言います。
）の解説書は本書を含め、以下のとおり２編で構成しています。
本書ではWeb-API機能のリクエストフォーマット、リクエスト例及び応答結果のサンプル（データ）並
びにエラーコード及びHTTPステータスコードの概要について説明しています。
第一編 適格請求書発行事業者公表システムWeb-API機能の利用手続について
第二編

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

本書

1

２．

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

2.1. リクエストのフォーマット
登録番号を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーションID」、「登録番号」、「応答形式」及び「履歴情報要否」にセットする値について説明します。
https://web-api.invoice-kohyo.nta.go.jp/バージョン/num?id=アプリケーションID&number=登録番号（１件目）,登録番号（２件目） ,…&type=応答形式&history=履歴情報要否2.1.1. バージョン「バージョン」には、バージョン値（「1」（半角））をセットします。
2.1.2. アプリケーション ID「アプリケーションID」には、アプリケーションID発行届出・申請後、国税庁がメールによりお知らせするアプリケーションID（13桁）をセットします。
2.1.3. 条件
条件は下表の項目について、各項目ID に対応する項目値を「項目ID＝項目値」という形式でセットし、各条件を「&」でつなぐことで設定できます。
下表の各項目の欄に【必須】と記載されている条件は必ず設定してください。

項目ID

項目値

number

登録番号

項目値の説明項目【必須/任意】
登録番号
【必須】

応答形式
【必須】

type

01
11
21

"T"＋13桁の登録番号を指定します。カンマ区切りで複数（最大10件）の登録番号を指定できます。
リクエストに対して応答するデータのファイル形式
を指定します。文字コードは全てUnicode（JIS第一～第四水準）です。
CSV形式
XML形式
JSON形式
公表情報の登録、取消、失効に係る履歴情報を取得す

履歴情報要否【任意】

history

るかどうかを指定できます。
指定しない場合は、「0」（履歴情報なし）として処理され、リクエスト時点の最新情報のみ応答します。

0

履歴情報なし1

履歴情報あり22.2. 応答結果
「応答形式」で指定したファイル形式で、データが応答します。
応答するデータ項目等については、「別紙１ 適格請求書発行事業者公表システムリソース定義書（ダウンロードファイル、Web-API機能）1.4版」の「提供項目_Web-API」欄（以下「リソース定義書」といいます。）が「○」の項目をご確認ください。
2.3. リクエスト例と応答結果のサンプル
登録番号を「T8040001999011」と指定して情報を取得する場合のリクエスト例と応答結果のサンプルについて、説明します。
2.3.1. 履歴情報を含めない場合
リクエスト条件に履歴情報を含めない場合の応答結果のサンプルです。

3

(1) ケース１応答形式をCSV形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=01&history=0（リクエスト指定条件）
条件

条件の内容

&number=T8040001999011&type=01&history=0

登録番号「T8040001999011」1件のみ。
応答形式は「CSV形式」とする。
履歴情報を含めない。

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダ情報
データ項目

1
2

2021-11-01,1,1,1
1,"T8040001999011",01,0,2,1,1,2023-10-01,2021-11-01,,,"
北海道札幌市中央区大通西１０丁目",01,101,"",,,"","株式会社インボイス公表","",,,"",""（応答結果の内容）
イ ヘッダ情報
CSVファイルの1行目に下表の４項目が応答します。
項目名最終更新年月日
総件数
分割番号
分割数

データ値
2021-11-01
1
1
1

4

ロ 公表情報
CSVファイルの２行目から、リクエストに対応するデータが応答します。データ項目名及びデータ値は下表のとおりです。
項目名

データ値

一連番号
1
登録番号
T8040001999011
事業者処理区分
01
訂正区分
0
人格区分
2
国内外区分
1
最新履歴
1
登録年月日
2023-10-01
更新年月日
2021-11-01
取消年月日
失効年月日
本店又は主たる事務所の所在 北海道札幌市中央区大通西１０丁目
地（法人）
本店又は主たる事務所の所在 01
地都道府県コード（法人）
本店又は主たる事務所の所在 101
地市区町村コード（法人）
本店又は主たる事務所の所在
地（公表申出）本店又は主たる事務所の所在地都道府県コード（公表申出）
本店又は主たる事務所の所在
地市区町村コード（公表申出）
日本語（カナ）
氏名又は名称
株式会社インボイス公表
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地都道府県コード
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在
地市区町村コード
主たる屋号
通称・旧姓

5

(2) ケース２応答形式をXML形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=11&history=0（リクエスト指定条件）
条件&number=T8040001999011&type=11&history=0

条件の内容
登録番号「T8040001999011」1件のみ。
応答形式は「XML形式」とする。
履歴情報を含めない。

6

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><announcements><lastUpdateDate>2021-11-01</lastUpdateDate>
ヘッダ情報<count>1</count><divideNumber>1</divideNumber><divideSize>1</divideSize><announcement><sequenceNumber>1</sequenceNumber>

公表情報<registratedNumber>T8040001999011</registratedNumber><process>01</process><correct>0</correct><kind>2</kind><country>1</country><latest>1</latest><registrationDate>2023-10-01</registrationDate><updateDate>2021-11-01</updateDate><disposalDate></disposalDate><expireDate></expireDate><address>北海道札幌市中央区大通西１０丁目</address><addressPrefectureCode>01</addressPrefectureCode><addressCityCode>101</addressCityCode><addressRequest></addressRequest><addressRequestPrefectureCode></addressRequestPrefectureCode><addressRequestCityCode></addressRequestCityCode><kana></kana><name>株式会社インボイス公表</name>(中略)<tradeName></tradeName><popularName_previousName></popularName_previousName></announcement></announcements>(注) サンプルデータの構造は視覚的に見やすく表記していますが、実際の応答結果のインデントや改行と必ずしも一致するものではありません。以降の応答結果のサンプルも同様です。

7

（応答結果の内容）
イ ヘッダ情報
XMLの最上位の構成要素である<announcements>タグの下位要素として、下表の４項目からなるヘッダ情報が応答します（以降のXML形式による応答結果のサンプルも同様です）。
データ値の内容は、ケース１と同様です。
項目名最終更新年月日
総件数
分割番号
分割数

タグ
<lastUpdateDate><count><divideNumber><divideSize>

ロ 公表情報指定した検索条件に該当する情報は、<announcement>の下位要素として、各データ値が応答します。
データ値の内容は、ケース１と同様です。
(3) ケース３
応答形式をJSON形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=21&history=0（リクエスト指定条件）
条件&number=T8040001999011&type=21&history=0

条件の内容
登録番号「T8040001999011」1件のみ。
応答形式は「JSON形式」とする。
履歴情報を含めない。

8

（応答結果のサンプル）{"lastUpdateDate" : "2021-11-01",
ヘッダ情報"count" : "1","divideNumber" : "1","divideSize" : "1","announcement" : [ {公表情報"sequenceNumber" : "1","registratedNumber" : "T8040001999011","process" : "01","correct" : "0","kind" : "2",
"country" : "1","latest" : "1","registrationDate" : "2023-10-01","updateDate" : "2021-11-01","disposalDate" : "","expireDate" : "","address" : "北海道札幌市中央区大通西１０丁目","addressPrefectureCode" : "01","addressCityCode" : "101","addressRequest" : "","addressRequestPrefectureCode" : "","addressRequestCityCode" : "","kana" : "","name" : "株式会社インボイス公表","addressInside" : "","addressInsidePrefectureCode" : "","addressInsideCityCode" : "","tradeName" : "","popularName_previousName" : ""
} ]
}

9

（応答結果の内容）
イ ヘッダ情報
下表の４項目からなるヘッダ情報が応答します。
データ値の内容は、ケース１と同様です。
項目名最終更新年月日
総件数
分割番号
分割数

タグ
"lastUpdateDate""count""divideNumber""divideSize"

ロ 公表情報指定した検索条件に該当する情報は、"announcement"の下位要素として、各データ項目値が応答されます。
データ値の内容は、ケース１と同様です。
2.3.2. 履歴情報を含める場合
リクエスト条件に履歴情報を含める場合の応答結果のサンプルです。
(1) ケース４
応答形式をCSV形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=01&history=1（リクエスト指定条件）
条件

条件の内容

&number=T8040001999011&type=01&history=1

登録番号「T8040001999011」1件のみ。
応答形式は「CSV形式」とする。
履歴情報を含める。

10

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダ情報
データ１
デ
ー
タ
項 データ２目

1
22024-11-01,2,1,1
1,"T8040001999011",01,0,2,1,0,2023-10-01,2021-11-01,,,"
北海道札幌市中央区大通西１０丁目",01,101,"",,,"","株式会社インボイス公表","",,,"",""
2,"T8040001999011",03,0,2,1,1,2023-10-01,2024-1101,,2024-11-01," 北 海 道 札 幌 市 中 央 区 大 通 西 １ ０ 丁 目",01,101,"",,,"","株式会社インボイス公表","",,,"",""

3（応答結果の内容）
イ ヘッダ情報
CSVファイルの１行目に下表の４項目が応答します。
項目名

データ値

最終更新年月日

2024-11-01

総件数

2

分割番号

1

分割数

1

ロ 公表情報CSVファイルの２行目から、リクエストに対応するデータが応答します。履歴情報があるた
め、履歴の古い順に２件のデータが応答します。
「最新履歴」のデータ値「１」は、そのデータが最新情報であること、「０」の場合は、過去情報であることを意味します。
データ値

項目名

データ１

データ２

一連番号
登録番号
事業者処理区分1
T8040001999011
01

2
T8040001999011
03

訂正区分

0

0

人格区分

2

2

国内外区分

1

1

最新履歴

0

1

登録年月日

2023-10-01

2023-10-01

更新年月日

2021-11-01

2024-11-01

取消年月日
失効年月日
本店又は主たる事務所の所在地（法人）
本店又は主たる事務所の所在地都道府県コード（法人）

2024-11-01
北海道札幌市中央区大通西１０
丁目
01

11

北海道札幌市中央区大通西１０
丁目
01

データ値

項目名

データ１

本店又は主たる事務所の所在地市区町村コード（法人）
本店又は主たる事務所の所在地（公表申出）
本店又は主たる事務所の所在地都道府県コード（公表申出）
本店又は主たる事務所の所在地市区町村コード（公表申出）
日本語（カナ）
氏名又は名称
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地都道府県コード
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地市区町村
コード
主たる屋号
通称・旧姓

データ２

101

101

株式会社インボイス公表

株式会社インボイス公表(2) ケース５
応答形式をXML形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=11&history=1（リクエスト指定条件）
条件&number=T8040001999011&type=11&history=1

条件の内容
登録番号「T8040001999011」1件のみ。
応答形式は「XML形式」とする。
履歴情報を含める。

12

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><announcements><lastUpdateDate>2024-11-01</lastUpdateDate>
ヘッダ情報<count>2</count><divideNumber>1</divideNumber><divideSize>1</divideSize><announcement>

公表情報１<sequenceNumber>1</sequenceNumber><registratedNumber>T8040001999011</registratedNumber><process>01</process><correct>0</correct>(中略)</announcement><announcement><sequenceNumber>2</sequenceNumber>

公表情報２(最終)<registratedNumber>T8040001999011</registratedNumber><process>03</process><correct>0</correct>(中略)</announcement></announcements>（応答結果の内容）
イ ヘッダ情報
XMLの最上位の構成要素である<announcements>タグの下位要素として、４項目からなるヘッ
ダ情報が応答します。
データ値の内容は、ケース４と同様です。
ロ 公表情報指定した検索条件に該当する情報は、<announcement>の下位要素として、各データ値が応答します。
ケース５の場合、該当するデータが２件あるため、<announcement>タグは２回繰り返し応答
します。
データ値の内容は、ケース４と同様です。

13

(3) ケース６応答形式をJSON形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/num?id=アプリケーションID&number=
T8040001999011&type=21&history=1（リクエスト指定条件）
条件&number=T8040001999011&type=21&history=1

条件の内容
登録番号「T8040001999011」1件のみ。
応答形式は「JSON形式」とする。
履歴情報を含める。

（応答結果のサンプル）{"lastUpdateDate" : "2024-11-01",
ヘッダ情報"count" : "2","divideNumber" : "1","divideSize" : "1","announcement" : [ {公表情報１"sequenceNumber" : "1","registratedNumber" : "T8040001999011","process" : "01","correct" : "0",
(中略)
}
, {

公表情報２(最終)"sequenceNumber" : "2","registratedNumber" : "T8040001999011","process" : "03","correct" : "0",
(中略)
} ]
}

14

（応答結果の内容）
イ ヘッダ情報
４項目からなるヘッダ情報が応答します。
データ値の内容は、ケース４と同様です。
ロ 公表情報指定した検索条件に該当する情報は、"announcement"の下位要素として、各データ値が応答します。
ケース６の場合、２件目は"announcement"ではなく","で繰り返し応答します。データ値の内容は、ケース４と同様です。
2.4. 一連番号の設定（ソート順）
登録番号を指定して情報を取得する機能で提供するデータは、① 登録番号（昇順）② 登録年月日、取消年月日、失効年月日の履歴情報（古い順）（履歴情報を取得する場合のみ）にソートして、一連番号を設定します。

15

３．

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

3.1. リクエストのフォーマット
取得期間を指定し、当該期間内に「更新年月日」が含まれる公表情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーションID」
、
「取得期
間開始日」
、
「取得期間終了日」、「応答形式」、「人格区分」及び「分割番号」にセットする値について説明します。
https://web-api.invoice-kohyo.nta.go.jp/バージョン/diff?id=アプリケーションID&from=取得期間開始日&to=取得期間終了日&type=応答形式&division=人格区分&divide=分割番号
3.1.1. バージョン「バージョン」には、バージョン値（「1」（半角））をセットします。
3.1.2. アプリケーション ID「アプリケーションID」には、アプリケーションID発行届出・申請後、国税庁がメールによりお知らせするアプリケーションID（13 桁）をセットします。
3.1.3. 条件
条件は下表の項目について、各項目ID に対応する項目値を「項目ID＝項目値」という形式でセットし、各条件を「&」でつなぐことで設定できます。
下記の各項目の欄に【必須】と記載されている条件は必ず設定してください。
項目【必須/任意】

項目ID

項目値

取得期間開始日【必須】

from

YYYY-MM-DD

取得期間終了日【必須】

toYYYY-MM-DD

応答形式
【必須】

type

01
11
21
-

人格区分
【任意】

division

分割番号
【任意】

divide12
1から
999999まで設定可能

項目値の説明指定する取得期間の開始日を指定します。
なお、適格請求書発行事業者の登録申請書の提出が可能となる令和３年10月１日より前の日付を指定するとエラー（エラーコード0104)となります。
指定する取得期間の終了日を指定します。
取得期間の指定可能な最大日数は50日のため、取得期
間終了日は取得期間開始日から50日以内の任意の日を指定します。
リクエストに対して応答するデータのファイル形式
を指定します。文字コードは全てUnicode（JIS第一～第四水準）です。
CSV形式
XML形式
JSON形式
人格区分を指定できます。
指定しない場合は、個人・法人の両方が検索されます。
個人
法人
分割番号を指定できます。
指定しない場合は、「1」で処理されます。

16

3.2. 応答結果
「応答形式」で指定したファイル形式で、データが応答します。
応答するデータ項目等については、「別紙１ 適格請求書発行事業者公表システムリソース定義書（ダウンロードファイル、Web-API機能）1.4版」の「提供項目_Web-API」欄（以下「リソース定義書」といいます。）が「○」の項目をご確認ください。
3.3. リクエスト例と応答結果のサンプル
取得期間開始日及び取得期間終了日に令和６年10月１日を指定して情報を取得する場合のリクエ
スト例と応答結果のサンプルについて、説明します。
(1) ケース７
応答形式をCSV形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/diff?id=アプリケーションID&from=2024-10-01&to=2024-10-01&type=01（リクエスト指定条件）
条件

条件の内容

&from=2024-10-01&to=2024-10-01&type=01

更新年月日が令和６年10月１日のデータを取得する。
応答形式は「CSV形式」とする。

（応答結果のサンプル）
データ種類
ヘッダ情報
デ データ１
ー
タ
項
目
データ８

行番号

応答結果

1
2

2024-10-01,8,1,1
1,"T8040001999011",01,0,1,1,1,2024-10-01,2024-10-01,,,"
北海道札幌市中央区大通西１０丁目",01,101,"",,,"","国税太郎","",,,"",""（中略）
8,"T8040001999018",03,0,1,1,1,2023-10-01,2024-1001,,2024-10-01,"",,," 沖 縄 県 沖 縄 市 東 ２ 丁 目 １ － １",47,211,"","公表太郎","",,,"公表店","インボイス"

9（応答結果の内容）
イ ヘッダ情報
CSVファイルの１行目に下表の４項目が応答します。
項目名最終更新年月日
総件数
分割番号
分割数

データ値
2024-10-01
8
1
1

17

ロ 公表情報
CSVファイルの２行目から、リクエストに対応するデータが応答します。データ項目名及びデータ値は下表のとおりです。
データ値

項目名
一連番号
登録番号
事業者処理区分
訂正区分
人格区分
国内外区分
最新履歴
登録年月日
更新年月日
取消年月日
失効年月日
本店又は主たる事務所の所在地（法人）本店又は主たる事務所の所在地都道府県コード（法人）
本店又は主たる事務所の所在
地市区町村コード（法人）
本店又は主たる事務所の所在
地（公表申出）本店又は主たる事務所の所在地都道府県コード（公表申出）
本店又は主たる事務所の所在
地市区町村コード（公表申出）
日本語（カナ）
氏名又は名称
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地都道府県コード
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在
地市区町村コード
主たる屋号
通称・旧姓

データ１

データ８

1
T8040001999011
01
0
1
1
1
2024-10-01
2024-10-01

8T8040001999018
03
0
1
1
1
2023-10-01
2024-10-01

北海道札幌市中央区大通西
１０丁目
012024-10-01
沖縄県沖縄市東２丁目１－
１
47

101

211

国税太郎

公表太郎

公表店
インボイス

18

(2) ケース８応答形式をXML形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/diff?id=アプリケーションID&from=2024-10-01&to=2024-10-01&type=11（リクエスト指定条件）
条件

条件の内容

&from=2024-10-01&to=2024-10-01&type=11

更新年月日が令和６年10月１日のデータを取得する。
応答形式は「XML形式」とする。

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><announcements><lastUpdateDate>2024-10-01</lastUpdateDate>
ヘッダ情報<count>8</count><divideNumber>1</divideNumber><divideSize>1</divideSize><announcement><sequenceNumber>1</sequenceNumber>

公表情報１<registratedNumber>T8040001999011</registratedNumber><process>01</process><correct>0</correct>(中略)</announcement>(中略)<announcement><sequenceNumber>8</sequenceNumber>

公表情報８(最終)<registratedNumber>T8040001999018</registratedNumber><process>03</process><correct>0</correct>(中略)</announcement></announcements>19（応答結果の内容）
イ ヘッダ情報
XMLの最上位の構成要素である<announcements>タグの下位要素として、４項目からなるヘッ
ダ情報が応答します。
データ値の内容は、ケース７と同様です。
ロ 公表情報指定した検索条件に該当する情報は、<announcement>の下位要素として、各データ値が応答します。
ケース８の場合、該当するデータが８件あるため、<announcement>タグは８回繰り返し応答
します。
データ値の内容は、ケース７と同様です。
(3) ケース９応答形式をJSON形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/diff?id=アプリケーションID&from=2024-10-01&to=2024-10-01&type=21（リクエスト指定条件）
条件&from=2024-10-01&to=2024-10-01&type=21

条件の内容
更新年月日が令和６年10月１日のデータを取得する。
応答形式は「JSON形式」とする。

20

（応答結果のサンプル）{"lastUpdateDate" : "2024-10-01",
ヘッダ情報"count" : "8","divideNumber" : "1","divideSize" : "1","announcement" : [ {公表情報１"sequenceNumber" : "1","registratedNumber" : "T8040001999011","process" : "01","correct" : "0",
(中略)
}
(中略)
, {

公表情報８(最終)"sequenceNumber" : "8","registratedNumber" : "T8040001999018","process" : "03","correct" : "0",
(中略)
} ]
}
（応答結果の内容）
イ ヘッダ情報
４項目からなるヘッダ情報が応答します。
データ値の内容は、ケース７と同様です。
ロ 公表情報指定した検索条件に該当する情報は、"announcement"の下位要素として、各データ値が応答します。
ケース９の場合、２件目以降は"announcement"ではなく","で繰り返し応答します。
データ値の内容は、ケース７と同様です。

21

3.4. 一連番号の設定（ソート順）
取得期間を指定して情報を取得する機能で提供するデータは、① 更新年月日（昇順）② 登録番号（昇順）③ 登録年月日、取消年月日、失効年月日の履歴情報（昇順）の順にソートして、一連番号を設定します。
3.5. 応答結果の分割について
取得期間を指定して情報を取得する機能では、大容量データの送信による性能低下を防止する観点から、該当するデータが500 件を超過する場合に、リクエストの応答結果を分割して提供します。
応答結果の分割では、分割されたファイルの総数（分母）にあたるデータ項目を「分割数」と定義し、分割されたファイルの通し番号（分子）を表すデータ項目を「分割番号」と定義しています。
リクエストの送信後、応答するデータのヘッダ情報にある分割数の値を参照し、分割数の値が「１」以外の場合は、応答結果が分割されるため、分割番号が分割数と一致するまで分割番号をカウントアップしてリクエストを送信することで、リクエスト条件に合致する全ての情報を取得できます（次頁の「応答結果の分割時の処理イメージ」を参照してください。
）
。

22

図

応答結果の分割時の処理イメージ

利用者
Web-APIを利用するシステム①

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

Web-API 1回目のリクエスト

差分情報データ
取得リクエスト
取得データ：500件
総件数：3000件
分割番号：1
分割数：6

差分情報データ
作成処理
取得データ：500件
総件数：3000件
分割番号：1
分割数：6

④

②

③

⑤
ヘッダ部の
データ項目を判定⑥
差分情報データ（ 分割番号2）の取得リクエスト

取得データ：500件
総件数：3000件
分割番号：2
分割数：6⑧⑦

更新件数:3000件

Web-API 2回目のリクエスト⑥

差分情報データで501～ 1000件目のデータ作成処理

取得データ：500件
総件数：3000件
分割番号：2
分割数：6⑩

以下、分割番号が６になるまで繰り返し。

23

⑨

４．

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

4.1. リクエストのフォーマット
登録番号と日付を指定して情報を取得する機能（登録番号及び指定された日付を基準日とした直近の登録年月日、取消年月日、失効年月日に紐づく情報を取得）のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーションID」、「登録番号」、「判定基準日」及び「応答形式」にセットする値について説明します。
https://web-api.invoice-kohyo.nta.go.jp/バージョン/valid?id=アプリケーションID&number=登録番号（１件目）,登録番号（２件目）,…&day=判定基準日&type=応答形式
4.1.1. バージョン「バージョン」には、バージョン値（「1」（半角））をセットします。
4.1.2. アプリケーション ID「アプリケーションID」には、アプリケーションID発行届出・申請後、国税庁がメールによりお知らせするアプリケーションID（13桁）をセットします。
4.1.3. 条件
条件は下表の項目について、各項目ID に対応する項目値を「項目ID＝項目値」という形式でセットし、各条件を「&」でつなぐことで設定できます。
下記の各項目の欄に【必須】と記載されている条件は必ず設定してください。

項目【必須/任意】
登録番号
【必須】
判定基準日
【必須】

項目ID

項目値

number

登録番号day

YYYY-MM-DD
-

応答形式
【必須】

type

01
11
21

項目値の説明"T"＋13桁の登録番号を指定します。カンマ区切り
で複数（最大10件）の登録番号を指定できます。
登録状況を確認したい日付を指定します。
リクエストに対して応答するデータのファイル形式を指定します。文字コードは全てUnicode（JIS第一～第四水準）です。
CSV形式
XML形式
JSON形式

4.2. 応答結果「応答形式」で指定したファイル形式で、データが応答します。
応答するデータ項目等については、「別紙１ 適格請求書発行事業者公表システムリソース定義書（ダウンロードファイル、Web-API機能）1.4版」の「提供項目_Web-API」欄（以下「リソース定義書」といいます。）が「○」の項目をご確認ください。

24

4.3. リクエスト例と応答結果のサンプル
登録番号が「T8040001999011」、「T8040001999012」、かつ令和５年12月１日を基準日とした直近情報を取得する場合のリクエスト例と応答結果のサンプルについて、説明します。
(1) ケース１０
応答形式をCSV形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/valid?id=アプリケーションID&
number=T8040001999011,T8040001999012&day=2023-12-01&type=01（リクエスト指定条件）
条件

条件の内容

&number=T8040001999011,
T8040001999012&day=2023-12-01&type=01

登録番号「T8040001999011」「T8040001999012」の２件。
令和５年12月１日を基準日として直近のデータを取得する。
応答形式は「CSV形式」とする。

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダ情報
データ１
デ
ー
タ
項 データ２目

1
22021-12-01,2,1,1
1,"T8040001999011",01,0,2,1,1,2023-10-01,2021-10-01,,,"
北海道札幌市中央区大通西１０丁目",01,101,"",,,"","株式会社インボイス公表","",,,"",""
2,"T8040001999012",01,0,2,1,1,2023-10-01,2021-12-01,,,"
東京都北区王子３丁目２２－１５",13,117,"",,,"","株式会社
インボイス登録","",,,"",""

3（応答結果の内容）
イ ヘッダ情報
CSVファイルの1行目に下表の4項目が応答します。
項目名最終更新年月日
総件数
分割番号
分割数

データ値
2021-12-01
2
1
1

25

ロ 公表情報
CSVファイルの２行目から、リクエストに対応するデータが応答します。データ項目名及びデータ値は下表のとおりです。
データ値

項目名
一連番号
登録番号
事業者処理区分
訂正区分
人格区分
国内外区分
最新履歴
登録年月日
更新年月日
取消年月日
失効年月日
本店又は主たる事務所の所在地（法人）本店又は主たる事務所の所在地都道府県コード（法人）
本店又は主たる事務所の所在
地市区町村コード（法人）
本店又は主たる事務所の所在
地（公表申出）本店又は主たる事務所の所在地都道府県コード（公表申出）
本店又は主たる事務所の所在
地市区町村コード（公表申出）
日本語（カナ）
氏名又は名称
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地都道府県コード
国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在
地市区町村コード
主たる屋号
通称・旧姓

データ１

データ２

1
T8040001999011
01
0
2
1
1
2023-10-01
2021-10-01

2
T8040001999012
01
0
2
1
1
2023-10-01
2021-12-01

北海道札幌市中央区大通西
１０丁目
01

東京都北区王子３丁目２２
－１５
13

101

117

株式会社インボイス公表

株式会社インボイス登録26

(2) ケース１１応答形式をXML形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/valid?id=アプリケーションID&
number=T8040001999011,T8040001999012&day=2023-12-01&type=11（リクエスト指定条件）
条件&number=T8040001999011,
T8040001999012&day=2023-12-01&type=11

条件の内容
登録番号「T8040001999011」「T8040001999012」の２件。
令和５年12月１日を基準日とした直近のデータを取得する。
応答形式は「XML形式」とする。

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><announcements><lastUpdateDate>2021-12-01</lastUpdateDate>
ヘッダ情報<count>2</count><divideNumber>1</divideNumber><divideSize>1</divideSize><announcement><sequenceNumber>1</sequenceNumber>

公表情報１<registratedNumber>T8040001999011</registratedNumber><process>01</process>(中略)</announcement><announcement><sequenceNumber>2</sequenceNumber>

公表情報２（最終）<registratedNumber>T8040001999012</registratedNumber><process>01</process>(中略)</announcement></announcements>（応答結果の内容）
イ ヘッダ情報
XMLの最上位の構成要素である<announcements>タグの下位要素として、４項目からなるヘッ
ダ情報が応答します。
データ値の内容は、ケース１０と同様です。

27

ロ 公表情報
指定した検索条件に該当する情報は、<announcement>の下位要素として、各データ値が応答します。
ケース１１の場合、該当するデータが２件あるため、<announcement>タグは２回繰り返し応答します。
データ値の内容は、ケース１０と同様です。
(3) ケース１２応答形式をJSON形式と指定する場合（リクエスト例）
https://web-api.invoice-kohyo.nta.go.jp/1/valid?id=アプリケーションID&
number=T8040001999011,T8040001999012&day=2023-12-01&type=21（リクエスト指定条件）
条件&number=T8040001999011,
T8040001999012&day=2023-12-01&type=21

条件の内容
登録番号「T8040001999011」「T8040001999012」の２件。
令和５年12月１日を基準日とした直近のデータを取得する。
応答形式は「JSON形式」とする。

28

（応答結果のサンプル）{"lastUpdateDate" : "2021-12-01",
ヘッダ情報"count" : "2","divideNumber" : "1","divideSize" : "1","announcement" : [ {公表情報１"sequenceNumber" : "1","registratedNumber" : "T8040001999011","process" : "01",
(中略)
}
,{

公表情報２（最終）"sequenceNumber" : "2","registratedNumber" : "T8040001999012","process" : "01",

(中略)
} ]
}
（応答結果の内容）
イ ヘッダ情報
４項目からなるヘッダ情報が応答されます。
データ値の内容は、ケース１０と同様です。
ロ 公表情報指定した検索条件に該当する情報は、"announcement"の下位要素として、各データ値が応答されます。
ケース１２の場合、２件目は"announcement"ではなく","で繰り返し応答します。
データ値の内容は、ケース１０と同様です。
4.4. 一連番号の設定（ソート順）
登録番号と日付を指定して情報を取得する機能で提供するデータは、ソートは行いません（リクエストに設定された登録番号順）
。

29

５．

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

リクエストに誤りがある場合などには、HTTP ステータスコードのほか、エラーの詳細が分かるよ
う、エラーコード及びエラーメッセージがCSV 形式で応答します。
エラー情報を応答した場合は、「別紙２ HTTP ステータスコード、エラーコード及びエラーメッセージ一覧」の内容を確認し、リクエスト指定条件を修正するなどして、リクエストを再送信してく
ださい。

30

別紙１

適格請求書発行事業者公表システムリソース定義書（ダウンロードファイル、Web-API機能）1.5版

令和６年５月
国税庁
課税部 軽減税率・インボイス制度対応室

改版履歴
項番

版数

作成年月

変更箇所

変更内容

変更理由等

1

初版

令和３年６月

－

－

－

2

1.1版

令和３年８月表紙

発行者を「国税庁課税部軽減税率・インボイス制度対応室」に
改訂。

－

3

1.2版

令和３年10月

凡例
リソース定義「表2 XML形式エスケープ対象文字」の表名の誤りを修正。
項番15更新年月日の「項目の説明」の記載を修正。

－
エスケープ対象文字として記載していた以下の文字について、各項目の項目値として格納されることはな
いため記載を削除した。
「"」（クォーテーションマーク（半角））「&」（アンパサンド（半角））「<」（less-than（半角））「>」（greater-than（半角））

4

1.3版

令和４年３月

凡例

5

1.4版

令和４年12月

凡例
リソース定義個人のダウンロードファイルに限り、「●」の項目は空文字として 令和４年９月26日から個人のダウンロードファイルにいる旨を追記。
ついて、氏名などの項目の値を削除することしたた
項番21～30までダウンロードファイルの記号を「●」に変更。
め。

6

1.5版

令和６年５月リソース定義個人のCSV形式ダウンロードファイルについては、50MBを超過するごとに分割して提供する旨を追記。

「出力項目値のエスケープについて」の記載を削除。

－

リソース定義書（目次）
項目名

項番

Web-API機
能で情報を
取得した際
にヘッダ情
報として出
力される項
目。

名称

リソース名

ページ

項目名

項番

名称

リソース名

1

ルート要素

announcements

16

取消年月日

disposalDate2

最終更新年月日

lastUpdateDate

17

失効年月日

expireDate

3

総件数

count

18

4

分割番号

divideNumber

19

5

分割数

divideSize

20

6

公表情報

announcement

21

7

一連番号

sequenceNumber

8

登録番号

registratedNumber

1

2

22

本店又は主たる事務所の所
addressRequestPrefectureC
在地都道府県コード（公表申
ode
出）

23

本店又は主たる事務所の所
在地市区町村コード（公表申 addressRequestCityCode出）

24

日本語（カナ）

kana

25

氏名又は名称name3
9

事業者処理区分

process10

訂正区分

correct4

本店又は主たる事務所の所
address
在地（法人）
本店又は主たる事務所の所
addressPrefectureCode
在地都道府県コード（法人）
本店又は主たる事務所の所
addressCityCode
在地市区町村コード（法人）
本店又は主たる事務所の所
addressRequest
在地（公表申出）

11

人格区分

kind

26

国内において行う資産の譲渡等に係る事務所、事業所
addressInside
その他これらに準ずるものの
所在地

12

国内外区分

country27

国内において行う資産の譲渡等に係る事務所、事業所 addressInsidePrefectureCod
その他これらに準ずるものの e
所在地都道府県コード

5
13

最新履歴

latest28

国内において行う資産の譲渡等に係る事務所、事業所
addressInsideCityCode
その他これらに準ずるものの所在地市区町村コード

14

登録年月日

registrationDate

29

主たる屋号

tradeName

15

更新年月日

updateDate

30

通称・旧姓

popularName_previousName

ページ

5

6

7

リソース定義書の見方
・国税庁適格請求書発行事業者公表サイトの公表情報ダウンロード画面よりダウンロードしたダウンロードファイル及びWeb-API機能により取得したデータには、項目名_名称が入っておりませんので、各データが何を意味するのか確認したい場合に本書をご利用ください。
・ダウンロードファイルの場合、本書１ページ以降の「提供項目_ダウンロード」欄に「○」又は「●」が入ったデータ項目が格納されています。
なお、個人のダウンロードファイルに限り、「●」のデータ項目は空文字となっております。
・Web-API機能の場合、本書１ページ以降の「提供項目_Web-API」欄に「○」が入ったデータ項目が格納されています。

凡例
凡例

項番

凡例の説明
インターネットの技術標準を議論するIETFによる、RFC3339に則った形式。

YYYY-MM-DD 令和3年10月1日（2021年10月1日）の場合は、「2021-10-01」と設定する。

凡例

Z

0から9の半角数字を意味する。上位（左側）の桁が「0」の場合には、設定されない。

9

NULL値でない場合、上位（左側）の桁の有無に関わらず、0から9の半角数字が設定さ
れる。

全角文字
全半角混在
CSV形式で取得する場合、ダブルクォーテーション「"」で囲む。

半角英数記号
半角英字

リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名
項番
名称
1 ルート要素2

最終更新年月
日

3 総件数

リソース名

形式
(凡例参照)

announcements

-

項目値
桁数
-

コード
-

提供項目

項目値
名称

ダウン
ロード

-

○

WebAPI○

ルート要素は、XML文書に必要な要素で、データ階層構造の最上位に位置する要素。
このルート要素は、CSV形式又はJSON形式で取得する場合は設定されない。

lastUpdateDate

YYYY-MM-DD

10

-

-

-

○

Web-API機能で情報を取得した際に、ヘッダ情報として出力される情報。
この最終更新年月日は、公表用のデータベースを最後に更新した日付を表
す。

count

ZZZZZZZ9

1～8

-

-

-

○

Web-API機能で情報を取得した際に、ヘッダ情報として出力される情報。
総件数は、指定した条件に合致したデータの総件数を表す。

4 分割番号

divideNumber

ZZZZZ9

1～6

-

-

-

○

5 分割数

divideSize

ZZZZZ9

1～6

-

-

-

○

6 公表情報項目の説明

announcement

-

-

-

-

○

○

Web-API機能で情報を取得した際に、ヘッダ情報として出力される情報。
応答結果が500件を超過する場合に、リクエストの応答結果を分割して提供する際の、分割されたファイルの通し番号（分子）。
リクエストの送信後、応答するデータのヘッダ情報にある「分割数」の値を参照
し、次項の「分割数」の値が「１」以外の場合は、「分割数」と当該データ項目（「分割番号」）が一致するまで「分割番号」リクエストを送信することで、条件に合致する情報を取得できる。
Web-API機能で情報を取得した際に、ヘッダ情報として出力される情報。
分割されたファイルの総数（分割番号の分母）。
XML文書のデータ階層構造上、項番7「一連番号」から項番30「通称・旧姓」までの上位に位置する親要素。
【全件データのダウンロード（注１）・差分データのダウンロード（注２）ファイルの場合】
CSV形式及びJSON形式で取得する場合は設定されない。
【Web-APIの場合】
CSV形式で取得する場合は設定されない。
（注１）全件データのダウンロードファイル
前月末時点において公表している最新情報のダウンロードファイル（注２）差分データのダウンロードファイル
日次の更新情報の日別ダウンロードファイル5リソース定義書（ダウンロードファイル、Web-API機能）1.5版
項目名
項番
名称

7

一連番号

リソース名

sequenceNumber

データ形式等形式(凡例参照)ZZZZZZZ9

項目値
桁数

1～8

コード

-

提供項目

項目値
名称

ダウン
ロード

-

○

6

WebAPI○

項目の説明
Web-API機能で取得したデータ全体又はダウンロードファイル内データ全体に対して付される通し番号。
なお、提供するデータのソート番号は以下のとおり。
【ダウンロードファイルの場合】
第１ソートキー 登録番号（昇順）
第２ソートキー 履歴情報（登録年月日、取消年月日、失効年月日のいずれかの日付）（昇順）【Web-API機能の場合】①登録番号を指定した場合
第１ソートキー 登録番号（昇順）
第２ソートキー 履歴番号（登録年月日、取消年月日、失効年月日のいずれかの日付）（昇順）②取得期間を指定した場合
第１ソートキー 更新年月日（昇順）
第２ソートキー 登録番号（昇順）
第３ソートキー 履歴番号（登録年月日、取消年月日、失効年月日のいずれかの日付）（昇順）③登録番号と日付を指定した場合
ソートは行わず、リクエストに設定された登録番号順に設定
また、データを分割して取得した場合の一連番号の付番方法は以下のとおり。
【ダウンロードファイルの場合】①法人に係るダウンロードファイル
ダウンロードファイルを、地域ごとに５グループに分割して提供するが、分割されたファイルごとに一連番号を付す。
②人格のない社団等及び個人に係るファイル
ダウンロードファイルを、データ容量が500MBを超過するごとに分割して提供するが（個人のCSV形式については、50MBを超過するごとに分割して提供する）、分割前のデータ全体で一連番号を付す。
【Web-API機能の場合】
データ件数が500件を超過するごとに分割して提供するが、分割されたファイルごとに一連番号を付す。

リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名項番
名称
8 登録番号

形式(凡例参照)

リソース名

registratedNumbe"T"+9999999999999
r

項目値

提供項目

桁数

コード

項目値
名称

ダウン
ロード

WebAPI

14

-

-

○

○

-

-

項目の説明
適格請求書発行事業者として登録された事業者の登録番号。

適格請求書発行事業者に生じた「登録」、「公表内容の変更」、「登録の失効」
及び「登録の取消」を意味する。
適格請求書発行事業者として登録されたことを意味する。

01

新規

02

公表内容の変更

03

登録の失効

適格請求書発行事業者に係る公表内容が変更されたことを意味する。

適格請求書発行事業者に係る登録の効力が失われたことを意味する。

9

事業者処理区分

process

99

2

○
04

○

適格請求書発行事業者に係る登録が取消されたことを意味する。

登録の取消
登録簿からの削除を意味する。
「差分データのダウンロードファイル（注１）」のみ作成され、「全件データのダウ
ロードファイル（注２）」及び「Web-API機能」の場合は作成されない。

99（注１）差分データのダウンロードファイル
日次の更新情報の日別ダウンロードファイル（注２）全件データのダウンロードファイル
前月末時点において公表している最新情報（履歴情報含む）のダウンロード
ファイル

削除

7

リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

提供項目

項目値
名称

コード

-

ダウン
ロード

WebAPI

項目の説明
公表情報の変更（※）があった場合に設定する。
【ダウンロードファイルの場合】①差分データのダウンロードファイルの場合
公表情報に変更・追加があった場合には訂正区分に「１（訂正）」を設定する。
本システムの利用者において既に取得済みのデータを更新するために利用することができる。
②全件データのダウンロードファイルの場合
公表情報に変更・追加があった場合であっても、取得する情報が最新となっていることから、訂正区分に「０（訂正以外）」を設定する。
【Web-API機能の場合】
公表情報に変更・追加があった場合であっても、取得する情報が最新となっていることから、訂正区分に 「０（訂正以外）」を設定する。

-（※）公表情報の変更については、「適格請求書発行事業者登録簿の登載事項
変更届出書」の提出による公表情報の変更のほか、「適格請求書発行事業者の公表事項の公表（変更）申出書」の提出による新たに公表又は既に公表されている事項の変更を含む。

10 訂正区分

correct

9

1

○

0

訂正以外

○

【差分データのダウンロードファイルの場合】「事業者処理区分」が「01（新規）」、「03（登録の失効）」、「04（登録の取消）」の場合、「0（訂正以外）」を設定する。
【全件データのダウンロードファイル・Web-API機能の場合】
全てのデータについて、「0（訂正以外）」を設定する。
【差分データのダウンロードファイルの場合】「事業者処理区分」が「02（公表内容の変更）」の場合、「１（訂正）」を設定す
る。

1

訂正

【全件データのダウンロードファイル・Web-API機能の場合】設定されない。
【差分データのダウンロードファイルの場合】「事業者処理区分」が「99（削除）」の場合、「空文字」を設定する。

空文字 削除【全件データのダウンロードファイル・Web-API機能の場合】設定されない。

8リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名
項番
名称

11 人格区分

12 国内外区分

13 最新履歴

形式(凡例参照)

リソース名

kind

countrylatest

9

9

9

項目値
桁数

1

コード

項目値
名称

-

-

1

個人

2

法人

提供項目
ダウン
ロード

○

○

適格請求書発行事業者の国内外区分を意味する。

-

-

1

国内事業者

2

特定国外事業者

3

特定国外事業者以外の国外事業者

-

-

0

過去情報

1

最新情報

国内事業者の情報であることを意味する。
○○

特定国外事業者の情報であることを意味する。
特定国外事業者以外の国外事業者の情報であることを意味する。
当該データが、最新情報か過去情報かを意味する。

○○

過去情報であることを意味する。
最新情報であることを意味する。

registrationDate

YYYY-MM-DD

10

-

-

○

○

15 更新年月日

updateDate

YYYY-MM-DD

10

-

-

○

○

16 取消年月日

disposalDate

YYYY-MM-DD

10

-

-

○

○

17 失効年月日

expireDate

YYYY-MM-DD

10

-

-

○

○

本店又は主たる事務所の所
19 在地都道府県コード（法人）

個人事業者の情報であることを意味する。
法人（「人格のない社団等」を含む）の情報であることを意味する。

14 登録年月日

本店又は主たる事務所の所
18
在地（法人）

項目の説明
適格請求書発行事業者の人格区分を意味する。

1

1

WebAPI

適格請求書発行事業者として登録された年月日を表す。
Web-API又はダウンロード機能で取得した適格請求書発行事業者の情報を更新したシステム上の日付を表す。
適格請求書発行事業者としての登録が取消された年月日を表す。
適格請求書発行事業者としての登録の効力が失われた年月日を表す。
法人（人格のない社団等を除く）の本店又は主たる事務所の所在地を表す。

address

全角文字

addressPrefectur
99
eCode

600
(最大)

2

-

-

-

○

-

○

9

○

○

法人（人格のない社団等を除く）の本店又は主たる事務所の所在地の都道府
県コードを表す。
都道府県コードの詳細については、以下のURL※（日本産業標準調査会／
データベース検索）を参照のこと。
※（https://www.jisc.go.jp/）

リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名
項番
名称
本店又は主たる事務所の所
20 在地市区町村
コード（法人）

本店又は主たる事務所の所
21
在地（公表申出）
本店又は主たる事務所の所
22 在地都道府県コード（公表申出）

形式(凡例参照)

リソース名

addressCityCode 999

addressRequest

全角文字

項目値
桁数

3

600
(最大)

コード

-

-

提供項目

項目値
名称

ダウン
ロード

-

○

-

●

項目の説明

WebAPI○○

法人（人格のない社団等を除く）の本店又は主たる事務所の所在地の市区町
村コードを表す。
都道府県コードの詳細については、以下のURL※（日本産業標準調査会／
データベース検索）を参照のこと。
※（https://www.jisc.go.jp/）
・個人の場合「適格請求書発行事業者の公表事項の公表（変更）申出書」に記載された「主たる事務所の所在地等」を表す。
・人格のない社団等の場合「適格請求書発行事業者の公表事項の公表（変更）申出書」に記載された「本店又は主たる事務所の所在地」を表す。
項番21に係る都道府県コード。

addressRequestP
99
refectureCode

2

-

-

●

○

項番21に係る市区町村コード。

本店又は主たる事務所の所
23 在地市区町村
コード（公表申出）

addressRequestC
999
ityCode24 日本語（カナ）

kana

25 氏名又は名称

name

国内において行う資産の譲渡等に係る事務所、
26 事業所その他こ addressInside
れらに準ずるも
のの所在地

3

-

-

●

○

全角文字

500
(最大）

-

-

●

○

全角文字

300
(最大）

-

-

●

○

全角文字

国内において行う資産の譲渡等に係る事務所、事業所その他こ addressInsidePref
27
99
れらに準ずるも ectureCodeのの所在地都
道府県コード300(最大）適格請求書発行事業者のうち、国外事業者に係る「氏名又は名称」の「日本語（カナ）表記」を表す。
適格請求書発行事業者の「氏名又は名称」を表す。
適格請求書発行事業者のうち、特定国外事業者以外の国外事業者に係る「国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるものの所在地」を表す。

-

-

●

○

項番26に係る都道府県コード。

2

-

-

●

10

○

リソース定義書（ダウンロードファイル、Web-API機能）1.5版
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

国内において行う資産の譲渡等に係る事務所、事業所その他こ addressInsideCity
28
999
れらに準ずるも Codeのの所在地市
区町村コード29 主たる屋号

tradeName

全角文字

項目値
桁数

コード

提供項目

項目値
名称

ダウン
ロード

項目の説明

WebAPI
項番26に係る市区町村コード。

3

-

-

●

○

200
(最大）

-

-

●

○

「適格請求書発行事業者の公表事項の公表（変更）申出書」に記載された「主たる屋号」を表す（個人の場合に限る）。
「適格請求書発行事業者の公表事項の公表（変更）申出書」に記載された「通称」又は「旧姓（旧氏）」を表す（個人の場合に限る）。

30 通称・旧姓popularName_pre
全角文字
viousName

200
（最大）

-

-

●

11

○