Customize

Get Eligible Billing Vendor Information (Japan Only)

Summary

Acquire company information from the National Tax Agency’s Eligible Invoice Issuing Business Announcement System .

How to use

No prior application to the National Tax Agency is required for use. However, when executing this action, a record of “who and when obtained the qualified invoice issuer public information” will be stored on the gusuku server. Please use this action only if you agree with the note above.

When you execute this action, it retrieves the public information of the business from the Web API function of the National Tax Agency’s invoice system qualified invoice issuer publication site. The obtained information is stored as the result of the action and can be referenced in the expression.

Please refer to the API documentation for the structure of the obtained data. The contents including item number 7, “Serial Number,” to item number 30, “Common Name / Former Name” will be retrieved. For example, the action “Get Eligible Billing Vendor Information” is the first action that attempts to retrieve “Head Office or Principal Place of Business Address (for corporations).” In the resource definition document mentioned earlier, the resource name for this item is “address.” Therefore, you can write the following expression:

= $1.address

If the registration number does not exist, or if you try to obtain a business that has already expired with the “do not obtain expired businesses” setting, the result of the action will be empty. The result can be determined by leaving the comparison value blank using the condition “If the Result of Action is a Specified Value.”

Parameters

Set Gusuku API Key, Registration Number, Base Date, and Whether to Get Revoked Info.

Gusuku API Key

Specify the API key for gusuku.

Please note that this is not about the API token on the Kintone app.

Registration Number

Specify the registration number of the entity to obtain. Typically, it will be “T” followed by a 13-digit number.

Base Date

Specify at what point in time to obtain.

To obtain information as of the action execution date and time, specify it in the formula as follows.

= today()

Whether to Get Revoked Info

Select whether to obtain information about the specified entity if that information has expired or been canceled as of the “Base Date.”

To determine if the entity qualifies as an invoice-issuing business as of the “Base Date,” select “Do Not Get Revoked.” You can assess this by checking if the result of the action is empty or not.

If you want to retrieve information regardless of its expiration status, please choose “Get Revoked.”

Precautions

This service is created using information from the National Tax Agency’s qualified invoice issuance entity publication system via their Web API function. However, the content of this service is not guaranteed by the National Tax Agency.