Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

YTJ Business ID Lookup for WooCommerce — Y-tunnus at the checkout and company data from the PRH register (Finland)

A Y-tunnus field at the WooCommerce checkout: check digit, the ID on the order, company name and address from the open PRH register; Pro adds lookup at the checkout, VAT, bulk checks.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
Compatibility
WordPress 6.4+ · WooCommerce 9.9+ (HPOS, block checkout) · PHP 7.4+ · languages: English, suomi (in Pro)
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
Updated
14.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Business ID (Y-tunnus) field on classic and block checkout: for billing country Finland or for every country, label editable ✔ ✔
Optional, required when a company name is filled in, or always required ✔ ✔
Format and check digit while typing, no request: 1234567-8, 12345678, FI12345678, six-digit ID ✔ ✔
ID kept on the order (HPOS and legacy), in e-mails, on the thank-you page, in the personal data export and erasure ✔ ✔
"Fetch from YTJ" on the order: name, status, postal or visiting address; "Copy to billing details" ✔ ✔
"Try it" box in the settings and the choice of register address ✔ ✔
HPOS and block checkout compatible ✔ ✔
Register lookup at the checkout with company name and address filled in, answers cached for a day — ✔
Search by company name with a pick list at the checkout — ✔
Refuse orders from bankrupt, in liquidation, ceased companies and unknown IDs — ✔
VAT number FI + 8 digits on the order, copied to a meta key of your invoice plugin — ✔
VAT exemption for Finnish companies in the VAT register (shops based outside Finland) — ✔
Customer profile: ID and status, a column in the Users list — ✔
Bulk check of orders and saved customers in the background, weekly if you wish — ✔
A second look before shipping and an e-mail alert about a problem company — ✔
Company form, business line, dates and VAT register entry in the order box — ✔
Finnish interface translation — ✔
Updates from catcode.com.ua — ✔

What it looks like

The
Left: the box in the free version with the status and address from the register and the “Fetch from YTJ” and “Copy to billing details” buttons. Right: the same box in Pro, which adds the company form, business line, registration date, VAT register and the VAT number.
The Y-tunnus field at the checkout
Classic checkout: the company is picked from a list by name (Pro). Block checkout: the “Y-tunnus” field in the contact details with the message that the company was found.
Field settings and the
WooCommerce → YTJ Business ID: when to show the field, the label, required or not, the register address, and a one-click lookup of any Business ID.

Key points

What happens to the order

The order gets a “Business ID (YTJ)” box: the ID, the status of the company (active, in liquidation, bankrupt, ceased), its name, the postal or visiting address and the date of the request. “Fetch from YTJ” asks the register about that one order, and “Copy to billing details” moves the name and address into the billing details.

The field at the checkout

The field appears on classic and block checkout (through the Additional Checkout Fields API) and by default only for the billing country Finland; it can be shown for every country.

Settings

WooCommerce → YTJ Business ID. Switch the field on, show it for Finland or for every country, the label, how it is required, refusing a wrong check digit and which register address to use (postal or visiting).

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • WordPress 6.4+, WooCommerce 9.9+ (HPOS, block checkout), PHP 7.4+.
  • Access from the shop server to avoindata.prh.fi (HTTPS); no account or key is needed.
  • Interface languages: English, suomi (the Finnish translation is part of Pro).

Version history

v1.0.0 Current 14.11.2026

The Business ID (Y-tunnus) field on classic and block checkout, format and check digit verification, saving on the order, “Fetch from YTJ” and “Copy to billing details”, “Try it”, HPOS, English.

Frequently bought with YTJ Business ID Lookup

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

YTJ Business ID Lookup for WooCommerce adds a “Business ID (Y-tunnus)” field to the checkout for Finnish companies and takes the company data from the open data API of the Finnish Patent and Registration Office, PRH (the YTJ register). The ID is kept on the order and shown in e-mails and on the thank-you page; the check digit is verified while the buyer types, and the company name and address can be pulled from the register.

What you need. Nothing: no account, no key, no contract. The YTJ register is open, and PRH publishes the data under the Creative Commons Attribution 4.0 licence; the plugin shows the source in the settings and in the order box.

What happens to the order

The order gets a “Business ID (YTJ)” box: the ID, the status of the company (active, in liquidation, bankrupt, ceased), its name, the postal or visiting address and the date of the request. “Fetch from YTJ” asks the register about that one order, and “Copy to billing details” moves the name and address into the billing details. If the buyer wrote a different company name, the box warns about it. In Pro the box also shows the company form, business line, registration date, the VAT register entry and the VAT number as FI + eight digits.

The address can be the postal one (the default, as it goes onto invoices) or the visiting one; when the register has only one of them, that one is used. Companies with an address abroad get only their name. When the register does not answer, the order still goes through, and the box says the company could not be checked and can be fetched later.

The field at the checkout

The field appears on classic and block checkout (through the Additional Checkout Fields API) and by default only for the billing country Finland; it can be shown for every country. It accepts 1234567-8, 12345678, an old six-digit ID and the VAT form FI12345678, writes the ID the official way and says right away when the check digit is wrong. Nothing is sent anywhere for this. You change the label yourself.

The field can be optional (private buyers skip it), required when a company name is filled in, or always required for a business-only shop. Refusing an order for a wrong check digit is off by default: the buyer sees a hint under the field. In Pro, when the buyer has typed a complete ID the plugin asks the register, fills in the company name and address and keeps the status on the order; the buyer can also start typing a company name and pick the company from a list.

Settings

WooCommerce → YTJ Business ID. Switch the field on, show it for Finland or for every country, the label, how it is required, refusing a wrong check digit and which register address to use (postal or visiting). Below is the “Try it” box: enter any ID and see the name, status, company form and address at once. A separate “Licence” section holds the Pro key or the trial.

What Pro adds

Lookup at the checkout: as soon as the buyer has typed a complete ID, the plugin asks the register, fills in the company name and address (on classic and block checkout) and keeps the status on the order. Answers are kept for a day (a not-found for an hour), so the same ID is not asked twice. Search by name shows a list of up to eight companies.

Refusals: optionally the order does not go through when the company is bankrupt, in liquidation or ceased, or when the ID is not in the register. Both options are off by default, and when the register does not answer the order is never stopped.

VAT: the order gets the VAT number (FI and eight digits), optionally copied to an order meta key of your invoice plugin. A separate option for shops based outside Finland: no VAT is charged to companies in the Finnish VAT register (reverse charge). It is off by default, and the settings remind you to check it with your accountant.

Customer profile: the ID and status are kept in the profile of a logged-in customer and filled in at the next checkout, and the Users list has a column with the ID and the company status. Bulk actions: “Check Business ID in YTJ” in the order list and a “Check all saved customers now” button, in the background at ten requests a minute; optionally every week.

Before shipping: when an order goes to Processing, the register is asked again, and the order is put on hold if the company stopped trading. An e-mail alert comes when an order is from a company that is not trading or not in the register. There is also a Finnish translation of the interface and updates from catcode.com.ua.

Limits

  • The data is only what the open PRH register publishes, and that is what the plugin shows. When the register is not available, the company stays unchecked and the order goes through.
  • The register request at the checkout has a timeout of 6 seconds; after a failure the plugin does not ask the register again for a minute.
  • A visitor limit applies: 30 lookups by ID and 40 searches by name in 10 minutes. Buyers behind a shared IP address (an office) can reach it: then the company cannot be checked, but they can still order.
  • VAT exemption relies on the entry in the PRH VAT register, which is not the same as a VIES validation; the decision is yours and your accountant’s, which is why the option is off by default.
  • Block checkout: if the VAT decision changes at the moment of placing the order (the cache ran out or the register answered differently), the order asks once to press “Place order” again.
  • Search by name returns up to 100 full records from PRH per request while the plugin shows eight, so it is heavier than a lookup by ID.
  • Companies with an address abroad give only their name; for companies in bankruptcy no data is filled in at the checkout.

How it works, step by step

  1. Install the plugin and activate it (WooCommerce must be active).
  2. Open WooCommerce → YTJ Business ID: the field is already on; change the label, how it is required and the address if you need.
  3. Enter any ID in “Try it” and press “Look up” to see the answer of the register.
  4. At the checkout the buyer types the Y-tunnus; the check digit is verified at once.
  5. On the order press “Fetch from YTJ” and, if needed, “Copy to billing details”.
  6. In Pro: a key or the trial in the “Licence” section, then lookup at the checkout, refusals, VAT and bulk checks.

Under the hood

  • The PRH YTJ open data API v3 (avoindata.prh.fi/opendata-ytj-api/v3): requests come from your server, not from the buyer’s browser.
  • Only the company ID is sent to the register, and in Pro also the company name the buyer types for a search; the register receives no buyer data and no buyer IP address.
  • Answer cache: a day, and an hour for not-found; company names in the search list are cached for an hour per language.
  • The request timeout is 6 seconds, so placing an order is not held up for long, and there is one request a minute after a failure.
  • PRH publishes the data under the Creative Commons Attribution 4.0 licence; the source is shown in the settings and in the order box. The ID counts as personal data for privacy: it is included in the WordPress personal data export and erasure.

How to install

  1. Plugins → Add New → Upload Plugin: choose the zip and activate.
  2. WooCommerce → YTJ Business ID: look at the default settings.
  3. In “Try it” enter a company ID to see the answer of the register.
  4. For Pro: paste the licence key or start the trial in the “Licence” section on the same page.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this an official PRH plugin?

No, it is an independent plugin from CatCode. The data comes from the PRH open API, but the plugin is not affiliated with PRH and not endorsed by it.

Do I need an API key or an account?

No. The PRH open API is public and free.

What happens when the register does not answer?

The order goes through. The order box says the company could not be checked, and you can ask again later with "Fetch from YTJ".

Which address is taken from the register?

The postal one by default, because it goes onto invoices; you can switch to the visiting address. When there is only one, that one is used. Companies with an address abroad give only a name.

Does the plugin turn buyers away for a wrong check digit?

Not by default: the buyer sees a hint under the field, and the order marks the ID as wrong. You can switch on refusing such orders.

Can companies be exempted from VAT?

In Pro, for shops based outside Finland, there is an option "no VAT for Finnish companies in the VAT register". It is off by default, and whether it is enough for your invoices is for your accountant to decide: an entry in the PRH VAT register is not a VIES validation.

Does it work with HPOS and block checkout?

Yes, with HPOS order storage and the legacy one, and with block and classic checkout.

Does the plugin slow the checkout down?

Not in the free version: nothing is requested at the checkout. In Pro the register is asked when the buyer has typed a complete ID, with a 6-second timeout, and answers are cached.

What happens after the trial or when the licence ends?

Pro switches off and waiting checks are not run, which leaves a note on the order. The free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module