Чёрный ноябрь: −35% на все модули до 30 ноября Чёрный ноябрь: −35% до 30 ноября Выбрать модуль

Связаться
WooCommerce

YTJ Business ID Lookup для WooCommerce — Y-tunnus на кассе и данные компании из реестра PRH (Финляндия)

Поле Y-tunnus на кассе WooCommerce: контрольная цифра, код в заказе, название и адрес компании из открытого реестра PRH; в Pro проверка на кассе, НДС, массовые проверки.

Скачать Free
Pro · лицензия на год Тестовые копии сайтов включены в цену. Чем больше сайтов, тем дешевле каждый
Совместимость
WordPress 6.4+ · WooCommerce 9.9+ (HPOS, блочная касса) · PHP 7.4+ · языки: English, suomi (в Pro)
Лицензия
сайт + тестовая копия, годовая
Триал
7 дней, без карты, один на сайт
Обновлено
14.11.2026
Или все 509 Pro-модулей в All Access — 3 244 грн / год ≈ 66 €

Что есть во Free,
а что даёт Pro

Бесплатная версия работает без ограничения по времени. Pro добавляет остальные функции из таблицы.

Функция Free Pro
Поле Business ID (Y-tunnus) на классической и блочной кассе: для платёжной страны Финляндия или для всех, подпись меняется ✔ ✔
Необязательное, обязательное по названию компании или всегда обязательное ✔ ✔
Формат и контрольная цифра при вводе без запросов: 1234567-8, 12345678, FI12345678, шестизначный код ✔ ✔
Код в заказе (HPOS и обычное хранилище), в письмах, на странице благодарности, в экспорте и удалении персональных данных ✔ ✔
Кнопка «Fetch from YTJ» в заказе: название, статус, почтовый или фактический адрес; «Copy to billing details» ✔ ✔
Поле «Try it» в настройках и выбор адреса из реестра ✔ ✔
Совместимость с HPOS и блочной кассой ✔ ✔
Проверка в реестре на кассе с автозаполнением названия и адреса, кеш на сутки — ✔
Поиск компании по названию со списком на кассе — ✔
Отказ заказа для банкротов, ликвидации, прекращённых и неизвестных кодов — ✔
Номер НДС FI + 8 цифр в заказе и копия в мета-ключ плагина счетов — ✔
Освобождение от НДС для финских компаний из реестра НДС (для магазинов вне Финляндии) — ✔
Профиль покупателя: код и статус, колонка в списке пользователей — ✔
Массовая проверка заказов и сохранённых клиентов в фоне, еженедельная по желанию — ✔
Повторная проверка перед отправкой и e-mail уведомление о проблемной компании — ✔
Форма компании, вид деятельности, даты и запись в реестре НДС в блоке заказа — ✔
Финский перевод интерфейса — ✔
Обновления с catcode.com.ua — ✔

Как это выглядит

Блок «Business ID (YTJ)» в заказе WooCommerce
Слева блок в бесплатной версии: статус и адрес из реестра и кнопки «Fetch from YTJ» и «Copy to billing details». Справа тот же блок в Pro: дополнительно форма компании, вид деятельности, дата регистрации, реестр НДС и номер НДС.
Поле Y-tunnus на кассе
Классическая касса: компания выбирается из списка по названию (Pro). Блочная касса: поле «Y-tunnus» в контактных данных с сообщением, что компания найдена.
Настройки поля и окно «Try it»
WooCommerce → YTJ Business ID: когда показывать поле, подпись, обязательность, адрес из реестра и проверка любого кода в один клик.

Главное о модуле

Что происходит с заказом

В заказе появляется блок «Business ID (YTJ)»: код, статус компании (действует, ликвидация, банкротство, прекратила деятельность), название, почтовый или фактический адрес и дата запроса.

Поле на кассе

Поле появляется на классической и блочной кассе (через Additional Checkout Fields API) и по умолчанию только для платёжной страны Финляндия; можно показывать его для всех стран.

Настройки

WooCommerce → YTJ Business ID. Включить поле, показывать его для Финляндии или для всех стран, подпись, режим обязательности, отказ при неправильной контрольной цифре и выбор адреса из реестра (почтовый или фактический).

Триал стартует, когда вы попросите

Свежая установка — бесплатная версия, ничего не включается само. Кнопка «Попробовать Pro 7 дней» → e-mail → ключ сразу в окне и письмом.

Один ключ — сайт и тестовая копия

Переносите сайт — отвяжите лицензию на старом домене и активируйте на новом сами. Тестовая копия (staging., dev.) работает с тем же ключом и места сайта не занимает. Для студий — ключи на 5, 25 сайтов или без ограничений.

Технические требования

  • WordPress 6.4+, WooCommerce 9.9+ (HPOS, блочная касса), PHP 7.4+.
  • Доступ сервера магазина к avoindata.prh.fi (HTTPS); аккаунта и ключа не нужно.
  • Языки интерфейса: English, suomi (финский перевод входит в Pro).

История версий

v1.0.0 Текущая 14.11.2026

Первый выпуск: поле Business ID (Y-tunnus) на классической и блочной кассе, проверка формата и контрольной цифры, сохранение в заказе, «Fetch from YTJ» и «Copy to billing details», «Try…

Вместе с YTJ Business ID Lookup покупают

All Access Нужно больше? Все модули (509) одной лицензией, новые добавляются сами. 3 244 грн≈ 66 € Подробнее →

Полное описание модуля

YTJ Business ID Lookup для WooCommerce добавляет на кассу поле «Business ID (Y-tunnus)» для финских компаний и берёт данные компании из открытого API финского Патентно-регистрационного ведомства PRH (реестр YTJ). Код сохраняется в заказе, показывается в письмах и на странице благодарности; контрольная цифра проверяется ещё при вводе, а название и адрес компании можно подтянуть из реестра.

Что нужно. Ничего: ни аккаунта, ни ключа, ни договора. Реестр YTJ открыт, а данные PRH публикует по лицензии Creative Commons Attribution 4.0; ссылку на источник плагин показывает в настройках и в блоке заказа.

Что происходит с заказом

В заказе появляется блок «Business ID (YTJ)»: код, статус компании (действует, ликвидация, банкротство, прекратила деятельность), название, почтовый или фактический адрес и дата запроса. Кнопка «Fetch from YTJ» спрашивает реестр об этом одном заказе, а «Copy to billing details» переносит название и адрес в платёжные данные. Если покупатель указал другое название компании, блок об этом предупреждает. В Pro блок показывает ещё форму компании, вид деятельности, дату регистрации, запись в реестре НДС и номер НДС в формате FI + восемь цифр.

Адрес можно брать почтовый (по умолчанию, он идёт в счета) или фактический; если в реестре есть только один, используется он. Для компаний с зарубежным адресом берётся только название. Когда реестр не отвечает, заказ всё равно проходит, а блок пишет, что компанию не удалось проверить, и её можно запросить позже.

Поле на кассе

Поле появляется на классической и блочной кассе (через Additional Checkout Fields API) и по умолчанию только для платёжной страны Финляндия; можно показывать его для всех стран. Оно принимает 1234567-8, 12345678, старый шестизначный код и форму НДС FI12345678, записывает код официальным способом и сразу говорит, если контрольная цифра не сходится. Для этого ничего никуда не отправляется. Подпись поля вы меняете сами.

Поле может быть необязательным (частные покупатели его пропускают), обязательным, когда заполнено название компании, или обязательным всегда для магазина только для бизнеса. Отказ заказа из-за неправильной контрольной цифры выключен по умолчанию: покупатель видит подсказку под полем. В Pro, когда покупатель вводит полный код, плагин спрашивает реестр, подставляет название и адрес компании и сохраняет статус в заказе; можно и начать писать название компании и выбрать её из списка.

Настройки

WooCommerce → YTJ Business ID. Включить поле, показывать его для Финляндии или для всех стран, подпись, режим обязательности, отказ при неправильной контрольной цифре и выбор адреса из реестра (почтовый или фактический). Ниже поле «Try it»: введите любой код и сразу увидите название, статус, форму компании и адрес. Отдельный раздел «Licence» — для ключа Pro или пробного периода.

Что добавляет Pro

Проверка на кассе: как только покупатель ввёл полный код, плагин спрашивает реестр, подставляет название и адрес компании (на классической и блочной кассе) и сохраняет статус в заказе. Ответы кешируются на сутки (ненайденное на час), поэтому один и тот же код не запрашивается дважды. Поиск по названию показывает список из восьми компаний.

Отказ: по желанию заказ не проходит, когда компания банкрот, в ликвидации или прекратила деятельность либо когда кода нет в реестре. Обе опции выключены по умолчанию, а когда реестр не отвечает, заказ никогда не останавливается.

НДС: в заказ пишется номер НДС (FI и восемь цифр) и, по желанию, копируется в мета-ключ вашего плагина счетов. Отдельная опция для магазинов с базовой страной не Финляндия: компаниям из реестра плательщиков НДС Финляндии НДС не начисляется (обратное начисление). По умолчанию она выключена, а в настройках стоит напоминание согласовать это с бухгалтером.

Профиль покупателя: код и статус сохраняются в профиле авторизованного клиента и подставляются на следующей кассе, а в списке пользователей есть колонка с кодом и статусом компании. Массовые действия: «Check Business ID in YTJ» в списке заказов и кнопка «Check all saved customers now», в фоне по десять запросов в минуту; по желанию раз в неделю.

Перед отправкой: когда заказ переходит в «Обрабатывается», реестр спрашивается ещё раз, и заказ откладывается, если компания прекратила деятельность. E-mail уведомление приходит, когда заказ от компании, которая не работает или не найдена в реестре. Также есть финский перевод интерфейса и обновления с catcode.com.ua.

Ограничения

  • Данные только из открытого реестра PRH: что он публикует, то плагин и показывает. Если реестр недоступен, компания остаётся непроверенной, а заказ проходит.
  • Запрос к реестру на кассе имеет таймаут 6 секунд; после сбоя плагин не спрашивает реестр ещё минуту.
  • Для посетителя действует лимит: 30 запросов по коду и 40 поисков по названию за 10 минут. Покупатели за общим IP-адресом (офис) могут его достичь: тогда компанию не удастся проверить, но заказать можно.
  • Освобождение от НДС опирается на запись в реестре плательщиков НДС PRH, а это не то же самое, что проверка в VIES; решение за вами и вашим бухгалтером, поэтому опция выключена по умолчанию.
  • Блочная касса: если решение о НДС меняется в момент оформления (истёк кеш или реестр ответил иначе), заказ один раз просит нажать «Оформить» ещё раз.
  • Поиск по названию возвращает от PRH до 100 полных записей за запрос, а плагин показывает восемь, поэтому он тяжелее поиска по коду.
  • Для компаний с зарубежным адресом берётся только название; для компаний в банкротстве данные на кассе не подставляются.

Как это работает, шаг за шагом

  1. Установите плагин и активируйте его (WooCommerce должен быть активен).
  2. Откройте WooCommerce → YTJ Business ID: поле уже включено, при необходимости измените подпись, обязательность и адрес.
  3. Введите любой код в «Try it» и нажмите «Look up», чтобы увидеть ответ реестра.
  4. На кассе покупатель вводит Y-tunnus; контрольная цифра проверяется сразу.
  5. В заказе нажмите «Fetch from YTJ» и, при необходимости, «Copy to billing details».
  6. В Pro: ключ или пробный период в разделе «Licence», дальше проверка на кассе, отказы, НДС и массовые проверки.

Что под капотом

  • PRH YTJ open data API v3 (avoindata.prh.fi/opendata-ytj-api/v3): запросы идут с вашего сервера, а не из браузера покупателя.
  • В реестр передаётся только код компании, а в Pro ещё и название, которое покупатель вводит для поиска; данных покупателя и его IP-адреса реестр не получает.
  • Кеш ответов: сутки, а для ненайденного час; названия компаний в списке поиска кешируются на час по языку.
  • Таймаут запроса 6 секунд, поэтому оформление заказа не задерживается надолго, и один запрос в минуту после сбоя.
  • Данные PRH публикует по лицензии Creative Commons Attribution 4.0; источник показывается в настройках и блоке заказа. Код относится к данным для приватности: он входит в экспорт и удаление персональных данных WordPress.

Как установить

  1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
  2. WooCommerce → YTJ Business ID: просмотрите стандартные настройки.
  3. В «Try it» введите код компании, чтобы увидеть ответ реестра.
  4. Для Pro: вставьте лицензионный ключ или запустите пробный период в разделе «Licence» на той же странице.

Вопросы
о модуле

Не нашли ответ? Напишите в Telegram — ответим в течение рабочего дня.

@catcode_support Настройка, совместимость, активация
Это официальный плагин PRH?

Нет, это независимый плагин от CatCode. Данные берутся из открытого API PRH, но плагин не аффилирован с PRH и не одобрен им.

Нужен ли ключ API или аккаунт?

Нет. Открытый API PRH публичный и бесплатный.

Что будет, когда реестр не отвечает?

Заказ проходит. В блоке заказа стоит, что компанию не удалось проверить, и её можно запросить позже кнопкой «Fetch from YTJ».

Какой адрес берётся из реестра?

По умолчанию почтовый, потому что он идёт в счета; можно переключить на фактический. Если есть только один, берётся он. Компании с зарубежным адресом дают только название.

Отклоняет ли плагин покупателей из-за неправильной контрольной цифры?

По умолчанию нет: покупатель видит подсказку под полем, а заказ помечает код как неправильный. Отказ можно включить.

Можно ли освободить компании от НДС?

В Pro для магазинов, чья базовая страна не Финляндия, есть опция «без НДС для финских компаний из реестра плательщиков НДС». Она выключена по умолчанию, а достаточно ли этого для ваших счетов, решает бухгалтер: запись в реестре НДС PRH не является проверкой VIES.

Работает ли с HPOS и блочной кассой?

Да, и с хранилищем заказов HPOS, и с обычным, и с блочной и классической кассой.

Тормозит ли плагин кассу?

В бесплатной версии нет: на кассе ничего не запрашивается. В Pro запрос к реестру идёт, когда покупатель ввёл полный код, с таймаутом 6 секунд, а ответы кешируются.

Что будет после пробного периода или конца лицензии?

Pro выключится, а отложенные проверки не выполняются, о чём остаётся заметка в заказе. Бесплатная часть продолжает работать.

Не тот вариант, что искали?

Делаем кастомные модули под WordPress, WooCommerce, OpenCart и Shopify. Расскажите о задаче — подготовим оценку.

Заказать кастомный модуль