Tax and register numbers · Finland

Y-tunnus Field for Gravity Forms

Y-tunnus Field for Gravity Forms brings a field for the Finnish company identifier Y-tunnus (Business ID in English) into Gravity Forms, the form plugin for WordPress. The identifier consists of seven digits and a check digit. The field checks it on your own server on submission and so catches typos before the identifier 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 identifier has the scheme number 0037. If you want, the field also checks the open data of the Finnish Patent and Registration Office (PRH) and the business information system YTJ to see whether the identifier has been issued.

How it works
View the manual

Who it is for

Who benefits.

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

You gain two things. Typos and wrong identifiers are caught as soon as the form is submitted, not later in your data. And your entries contain only identifiers in the correct form. That is a reliable basis for your customer data, your invoices and your e-invoices, meaning invoices as structured files that software can read.

The check works in two stages. The first always runs, the second only if you switch it on.

On your server only Plus the lookup with PRH/YTJ
Seven digits and check digit ✓ ✓
The identifier has been issued – ✓
What the check on your server catches and what the lookup with PRH/YTJ adds.

What the field does for you

  • You find the field Y-tunnus in the form editor in the field group e-Invoicing Fields and add it to your form like any other field.
  • It checks every identifier on your server. It must consist of seven digits and a check digit, and the check digit must match the other digits.
  • Your customer can enter the identifier with or without a hyphen, just as it is written in Finland.
  • If you want, it also confirms the identifier with PRH/YTJ. You then know the identifier has really been issued and does not just look right. You do not need a key for this. Alternatively, the lookup runs through your invoicePress account.
  • Developers use the same check as a field type on the settings pages of their own plugins. It is available outside a form, too, and nobody has to rebuild the rules.

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 PRH/YTJ.
  • It does not make your form depend on PRH/YTJ. If PRH/YTJ is unreachable at the moment, your customer can still submit the form.

How it works

From entry to saved record

1 · Entry
your customer types the identifier
2 · Check on your server
seven digits, check digit
3 · Optional: PRH/YTJ
Has the identifier been issued?
4 · Saved
with a checked identifier
How the field checks an entry on submission: first on your server, then, if you want, with PRH/YTJ, and after that the entry is saved.

There is no demo to try on this page yet. The manual shows you step by step how to set up the field.


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
Register check Nothing else, because PRH/YTJ does not require a key. Optionally, 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.

The manual walks you through the installation and the first steps. It explains every setting and also covers special cases. It applies to version 1.0.1 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. Just tell us which identifier field you need.

Request the plugin