
NZBN Lookup для WooCommerce — перевірка бізнес-номера NZBN (Нова Зеландія)
Перевірка NZBN новозеландського бізнесу на касі WooCommerce: назва й статус із реєстру MBIE, дані в замовленні; у Pro — пошук за назвою, автозаповнення адреси, роль B2B, відмова закритим бізнесам.
- Сумісність
- WordPress 6.4+ · WooCommerce 8.6+ · PHP 7.4+ · HPOS · мова інтерфейсу: English
- Ліцензія
- сайт + тестова копія, річна
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 12.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує покупець
На касі зʼявляється поле NZBN (назву можна змінити). Коли покупець виходить із поля, під ним показується назва бізнесу й статус («Example Trading Limited — Registered») або повідомлення, що такого номера в реєстрі нема.
Що отримує адмін
WooCommerce → NZBN: вставте ключ підписки, оберіть Production (живий реєстр) чи Sandbox (тестові дані MBIE, лише з ключем Sandbox), натисніть «Check connection», вкажіть, чи номер обовʼязковий.
Що додає Pro
Пошук за назвою. Покупець вводить назву бізнесу, обирає його зі списку, і NZBN підставляється сам.

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
WordPress 6.4+, WooCommerce 8.6+, PHP 7.4+.
Потрібен власний ключ підписки NZBN API з api.business.govt.nz (Production або Sandbox).
Сумісно з HPOS, класичною й блоковою касою. Мова інтерфейсу: English.
Історія версій
Перший випуск: поле NZBN на звичайній і блоковій касі та в обліковому записі, перевірка контрольної цифри, перевірка в реєстрі NZBN (Production чи Sandbox), назва бізнесу в замовленні…
Разом з NZBN Lookup купують


Mainfreight Shipping для WooCommerce — тарифи й відстеження Mainfreight (Нова Зеландія)

Кинуті кошики для WooCommerce

Набори товарів і подарунок від суми для WooCommerce
Повний опис модуля
NZBN Lookup для WooCommerce додає на касу й у «Мій обліковий запис» поле NZBN і звіряє введений номер із реєстром New Zealand Business Number через безкоштовний NZBN API Міністерства бізнесу, інновацій і зайнятості Нової Зеландії (MBIE). NZBN має 13 цифр, остання — контрольна: помилку в номері видно одразу, ще до запиту в реєстр. Магазин бачить назву й статус бізнесу, а замовлення зберігає ці дані. Для роботи потрібен власний ключ підписки з api.business.govt.nz.
Що потрібно від вас. Кожен магазин використовує свій ключ NZBN API: зареєструйтесь на api.business.govt.nz, підпишіться на NZBN API (за даними порталу, без плати) і дочекайтесь схвалення підписки командою API MBIE: вона схвалює підписки вручну й може спитати, для чого вам доступ. Ключ вставляється в налаштуваннях плагіна. Перевірка підтверджує, що бізнес із таким номером є в реєстрі і який у нього статус; номер GST вона не перевіряє.
Що отримує покупець
На касі зʼявляється поле NZBN (назву можна змінити). Коли покупець виходить із поля, під ним показується назва бізнесу й статус («Example Trading Limited — Registered») або повідомлення, що такого номера в реєстрі нема. Помилка в контрольній цифрі чи довжині ловиться без жодного запиту до реєстру. Якщо поле «Компанія» порожнє, назва з реєстру підставляється туди. Приватні покупці можуть пропустити поле: воно необовʼязкове, а обовʼязковим його варто робити лише для оптового магазину.
У «Мій обліковий запис» → «Деталі облікового запису» є те саме поле. Номер, який покупець ввів на касі чи тут, зберігається на клієнті, а наступна каса починається з нього. Поле на блоковій касі й у «Деталях облікового запису» — одне й те саме значення.
Номер із неправильним форматом зупиняє замовлення зрозумілим повідомленням. Номер, якого реєстр не знає, за замовчуванням не зупиняє замовлення: у ньому лише нотатка. Опція «Відхиляти невідомі номери» вимкнена за замовчуванням, і її можна ввімкнути в налаштуваннях. Якщо реєстр тимчасово недоступний, замовлення проходить, а в нотатці сказано, що номер не перевірено, тож державний сервіс не блокує продажі.
Що отримує адмін
WooCommerce → NZBN: вставте ключ підписки, оберіть Production (живий реєстр) чи Sandbox (тестові дані MBIE, лише з ключем Sandbox), натисніть «Check connection», вкажіть, чи номер обовʼязковий. Ключ зберігається зашифрованим і ніколи не потрапляє в браузер. Кнопка «Look up» дозволяє перевірити будь-який номер просто в налаштуваннях. Відповіді реєстру кешуються на 6 годин, а запити йдуть з вашого сервера, а не з браузера покупця.
У замовленні зʼявляється блок: номер, назва, статус, тип, адреса, дата реєстрації та номер у реєстрі. Те саме записується в нотатку замовлення. У Pro в блоці є кнопка «Check again», а також номер GST, який бізнес опублікував у реєстрі.
Що додає Pro
Пошук за назвою. Покупець вводить назву бізнесу, обирає його зі списку, і NZBN підставляється сам.
Автозаповнення адреси. Назва бізнесу й адреса з реєстру (рахунок, поштова чи зареєстрована) підставляються в порожні поля виставлення рахунку, коли покупець вводить номер. Працює на звичайній і блоковій касі. Область (region) реєстр не віддає, тож це поле покупець заповнює сам.
Закриті бізнеси. Бізнес, який реєстр показує як знятий з реєстру, закритий, у ліквідації, під зовнішнім управлінням чи адмініструванням, не може оформити замовлення; покупець бачить причину.
Реєстр недоступний. За бажанням замовлення відхиляється, коли реєстр недосяжний (за замовчуванням воно проходить із нотаткою).
Номер GST у замовленні. Номер GST, який бізнес опублікував у реєстрі, зберігається разом із замовленням. Плагін не перевіряє, чи діє реєстрація GST, і лише показує те, що є в реєстрі.
Роль клієнта B2B. Клієнт із підтвердженим бізнесом, що працює, отримує роль, яку ви обрали (ту, з якою працює ваш плагін оптових цін); коли бізнес закривається, роль знімається. Керівників магазину й адміністраторів плагін не чіпає, а роль знімає лише в тих, кому видав сам.
Регулярна перевірка клієнтів. Збережені на облікових записах номери перевіряються знову кожні кілька днів, пачками по 25 щогодини (незмінений запис майже нічого не коштує реєстру: використовується ETag). Зміни назви чи статусу потрапляють у журнал і на пошту магазину. Кнопка «Check all customers now» запускає ту саму перевірку для всіх клієнтів пачками.
Check again і перевірка перед відвантаженням. Кнопка в замовленні знову питає реєстр і записує зміни в нотатки; за бажанням реєстр опитується ще раз, коли замовлення переходить у «В обробці», і якщо бізнес більше не працює, замовлення ставиться на утримання.
Оновлення з catcode.com.ua.
Як це працює, крок за кроком
- Встановіть плагін і активуйте його (WooCommerce має бути активним).
- На api.business.govt.nz підпишіться на NZBN API й отримайте ключ після схвалення підписки.
- У WooCommerce → NZBN вставте ключ, оберіть Production, натисніть «Check connection» і збережіть.
- Оберіть, чи номер обовʼязковий, і що робити з номерами, яких реєстр не знає.
- Відкрийте касу: поле NZBN уже там.
- У Pro увімкніть пошук за назвою, автозаповнення адреси, відмову закритим бізнесам, роль B2B та регулярну перевірку клієнтів.
Що під капотом
- Дані реєстру New Zealand Business Number, який веде MBIE (уряд Нової Зеландії): запит за NZBN через NZBN API, Production або Sandbox.
- Запити йдуть з вашого сервера; на реєстр передається NZBN (у Pro при пошуку — введений текст назви), дані покупця — ні. Ключ підписки передається в заголовку Ocp-Apim-Subscription-Key.
- Відповіді кешуються на 6 годин, тож каса не навантажує реєстр і не витрачає квоту вашої підписки.
- Ключ NZBN API шифрується в базі й не виводиться в браузер.
- Блок на блоковій касі й поле на звичайній касі, «Деталі облікового запису» і замовлення працюють з одним і тим самим збереженим значенням.
Як встановити
- Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
- WooCommerce → NZBN: вставте ключ підписки, оберіть Production чи Sandbox, натисніть «Check connection», збережіть.
- Відкрийте касу: поле NZBN зʼявилось.
- Для Pro: вставте ліцензійний ключ або запустіть пробний період у розділі «Licence» на тій самій сторінці.
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний плагін NZBN чи MBIE?
Ні, це незалежна інтеграція від CatCode. Дані реєстру належать MBIE (Ministry of Business, Innovation and Employment, уряд Нової Зеландії); модуль не афілійований із ними й не схвалений ними.
Потрібен ключ чи акаунт?
Так. Підписка на NZBN API на api.business.govt.nz безкоштовна, але ключ належить вам, а не нам. Підписку схвалює команда API MBIE вручну й може спитати, для чого вона потрібна.
Що робить опція «Відхиляти невідомі номери»?
Вона вимкнена за замовчуванням. Тоді номер, якого реєстр не знає, не зупиняє замовлення: у ньому лише нотатка. Увімкніть її, якщо хочете відхиляти такі номери.
Чи перевіряє плагін номер GST?
Ні. Він перевіряє, що бізнес із таким NZBN є в реєстрі і який у нього статус. У Pro зберігається номер GST, який бізнес сам опублікував у реєстрі.
Чи можуть приватні покупці оформити замовлення?
Так. Залиште «Required» вимкненим, і поле стане необовʼязковим.
Що, якщо реєстр недоступний?
Замовлення проходить, а в нотатці сказано, що номер не перевірено. У Pro можна обрати протилежну поведінку й відхиляти замовлення.
Чому реальний номер «не знайдено» в Sandbox?
Sandbox MBIE містить тестові записи й старі дані Companies Register, а не живий реєстр. Для реальних номерів перемкніть на Production з ключем Production.
Що буде після пробного періоду?
Pro вимкнеться, безкоштовна частина продовжить працювати: поле, перевірка в реєстрі, дані в замовленні, поле в обліковому записі.
На скільки сайтів ключ?
Один ліцензійний ключ Pro працює на два сайти: магазин і тестову копію.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















