Tax and register numbers · Japan

Corporate Number Field for Gravity Forms

Corporate Number Field for Gravity Forms brings a field for the Japanese Corporate Number (法人番号) into Gravity Forms, the form plugin for WordPress. The field checks the thirteen-digit number against its check digit on your own server on submission and so catches typos before the number ends up in your data. A check digit is a digit calculated from the other digits that reveals typos.

In the ISO 6523 identifier list, an international list of identifier types for organizations, this number has the scheme number 0188. If you have entered an App ID, the field also asks the Japanese National Tax Agency whether the number has been issued. The App ID is an access code that the National Tax Agency issues for its lookup interface.

How it works
View the manual

Who it is for

Who benefits.

The field is for forms in which business customers or suppliers from Japan enter their details, for example for billing addresses or for onboarding new suppliers. It is also for developers who need a validated Corporate Number in the settings of their own plugin.

The benefit for you is clean data. Typos and wrong numbers are caught on submission, so your entries contain only numbers in the correct form. Your customer data, your invoices and your e-invoices (invoices as structured files that software can read) can rely on that.

The table shows the two stages of the check. The first always runs, the second you add when you need it.

On your server only Plus the lookup with the National Tax Agency
Thirteen digits and check digit ✓ ✓
The number has been issued – ✓
What the check on your server catches and what the lookup with the National Tax Agency adds.

The field works without an App ID, too. It then checks the length of the number and the check digit.


What the field does for you

  • You find the field Corporate Number (Japan) in the form editor in the field group e-Invoicing Fields and add it to your form like any other field.
  • It checks every number on your server. It must have exactly thirteen digits, and the first digit must match the others as the check digit.
  • If you want, it also confirms the number with the National Tax Agency. This confirms that the number is not only correctly formed but actually issued. The lookup runs either directly through the agency’s Web-API, that is, its lookup interface, or through your invoicePress account.
  • Developers get the same check as a field type for the settings pages of their own plugins. They can use the field outside a form, too, and do not have to rebuild the rules themselves.

What it does not do

  • It does not fill in other fields of the form. It does not copy the name or address from the register.
  • It does not store the responses from the National Tax Agency.
  • It does not make your form depend on the National Tax Agency. If the National Tax Agency is unreachable at the moment or the App ID is missing, your customer can still submit the form.
  • It does not check the Japanese registration number for consumption tax (T number). That is a different number from the Corporate Number.

How it works

From entry to saved record

1 · Entry
your customer types the number
2 · Check on your server
thirteen digits, check digit
3 · Optional: tax agency
Has the number been issued?
4 · Saved
with a checked number
How the field checks an entry on submission: first on your server, then, if you want, with the National Tax Agency, and after that the entry is saved.

We do not offer a demo on this page yet. To make setup easy anyway, the manual describes every step.


Requirements

What you need.

WordPress a running WordPress installation
PHP version 7.4 or newer
Gravity Forms version 2.5 or newer, installed and active
Check with the National Tax Agency A free App ID for the Web-API of the 法人番号システム, the Corporate Number system of the National Tax Agency. Alternatively, the lookup can run through your invoicePress account with an API key from invoicePress, that is, an access code.

Manual

Everything explained step by step.

From installation and first steps to every setting and special cases, the manual covers it all. It applies to version 1.0.2 of the plugin.

View the manual
Manual as PDF

Deutsches Handbuch · PDF


Goes well with

Fields that go well with it

EU VAT ID · EU

VAT ID Field for Gravity Forms brings a field for the VAT identification number of the EU, called USt-IdNr. in Germany. If you want, it confirms the number with VIES, the lookup system of the European Commission.

Learn more

LEI · worldwide

LEI Field for Gravity Forms brings a field for the Legal Entity Identifier (LEI), a worldwide identifier for companies and other legal entities that is issued only once. If you want, it confirms the identifier in the GLEIF register.

Learn more

ISO 6523 (ICD) · worldwide

ISO6523 ICD Field for Gravity Forms brings a field for organization identifiers according to ISO 6523. An e-invoice uses this list of identifier types to identify the seller and the buyer.

Learn more

EN16931 fields

Gravity Forms EN16931 Fields brings the code lists of the e-invoice into Gravity Forms as ready-made choices. A code list is a defined list of allowed values, for example the currency codes.

Learn more

All identifier fields · All extensions


Request it now, coming soon to the shop.

This plugin will be available in the shop on invoicePress.de shortly. Until then, you can get it on request. Simply request it, along with other identifier fields from this series if you like.

Request the plugin