Чорний листопад: −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 грн / рік

Що є в 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 грн Детальніше →

Повний опис модуля

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. Розкажіть про задачу — підготуємо оцінку.

Замовити кастомний модуль