Partita IVA Lookup для WooCommerce — пошук компанії за P.IVA через Openapi

Partita IVA Lookup with Openapi for WooCommerce додає на чекаут WooCommerce (класичний і блоковий) поле Partita IVA і кнопку «Find company». Покупець вводить номер італійської компанії, модуль питає Company API сервісу Openapi і підставляє в платіжні дані назву та юридичну адресу. Для магазинів, що продають італійським компаніям: B2B, опт, рахунки з Partita IVA покупця. Запити йдуть через ваш власний акаунт Openapi.

Що робить безкоштовна версія

Номер спершу проходить перевірку контрольної цифри прямо в магазині, тож описку видно до будь-якого запиту. Коли покупець виходить з поля або натискає «Find company», модуль знаходить компанію через метод IT-start і показує під полем рядок на зразок «OPENAPI S.P.A. — Active». Назва компанії, вулиця, CAP, місто і провінція вписуються в платіжну адресу, на класичній і блоковій касі. Поле Partita IVA можна додати від плагіна, взяти поля CatCode FatturaPA або назвати поле іншого плагіна (останнє лише на класичній касі). Знайдена компанія кешується (24 години за замовчуванням, від 1 до 720), тож повторний запит не коштує вам нових кредитів. Усе, що знайдено, лишається в замовленні: копія даних, нотатка і блок на сторінці замовлення. Якщо Openapi не відповідає або номера немає в реєстрі, замовлення проходить, а в нотатці записано причину; відмовляти для невідомих номерів можна окремою галочкою. Окремі кнопки в налаштуваннях: перевірка з’єднання і «Try it» для будь-якого номера. Токен зберігається зашифрованим, є перемикач на тестове середовище Openapi.

Що додає Pro

PEC і код одержувача SDI підставляються у власні поля, поля CatCode FatturaPA або поля, які ви назвете; якщо в основній відповіді коду немає, модуль питає метод IT-sdicode. Для компаній, закритих у реєстрі (CESSATA) або позначених податковою як закриті (IT-closed), можна обрати: відмовити в замовленні, лише попередити або нічого не робити. Позначки на замовленні: державна установа (PA, IT-pa) і компанія зі split payment (IT-splitpayment). Покупці з інших країн: Франція, Німеччина, Іспанія, Португалія, Велика Британія, Бельгія, Австрія, Швейцарія і Польща шукаються їхніми методами «-start», решта країн ЄС через EU-vies (чинний номер ПДВ і назва). Кнопка «Look up again» на сторінці замовлення повторює запит. Ліміт запитів на добу, журнал запитів по місяцях і методах, а також галочка «відмовити, коли номер не можна перевірити».

Що варто знати заздалегідь

• Модуль працює через ваш акаунт Openapi (openapi.com): токен створюється в консолі Openapi з доступом до методів Company API, які ви використовуєте.
• Запити в бойовому середовищі Openapi тарифікує з кредиту вашого акаунта. Кнопка перевірки з’єднання теж надсилає один тарифікований запит IT-start.
• Тестове середовище Openapi відповідає лише для компаній зі свого списку прикладів, тож для живих номерів потрібен бойовий токен.
• Щоб запити з каси не вичерпували кредит, з однієї адреси дозволено 20 пошуків за 10 хвилин. Ліміт запитів на добу є в Pro.
• Закритою компанія вважається, коли реєстр показує CESSATA або податкова позначила її закритою. Статуси INATTIVA і SOSPESA лише підсвічують рядок стану.
• Код SDI модуль приймає з 7 символів. Поля іншого плагіна читаються лише на класичній касі.
• Закешована відповідь зберігає статус тією мовою, якою її отримали, і покупець іншою мовою бачить її до кінця терміну кешу.
• Це незалежна інтеграція: модуль не є офіційним продуктом Openapi, а торгова марка Openapi належить її власнику.
• Інтерфейс модуля і тексти для покупця англійською та італійською.

Як це працює, крок за кроком

1. Створіть акаунт на openapi.com, поповніть кредит і в консолі створіть токен з доступом до Company API.
2. WooCommerce → Partita IVA Lookup: вставте токен, натисніть «Check connection» і збережіть.
3. Оберіть, де брати поле Partita IVA: власне поле плагіна, поля CatCode FatturaPA чи поле іншого плагіна.
4. Відкрийте чекаут, введіть Partita IVA і натисніть «Find company»: назва компанії та адреса заповняться самі.

Під капотом

• Токени зберігаються зашифрованими і не виводяться назад на сторінку.
• Для всієї каси кожен метод Openapi викликається один раз: відповідь переходить від пошуку до перевірки і до збереження замовлення.
• Запити з каси захищені одноразовим ключем і лімітом на адресу.
• Замовлення проходить і тоді, коли Openapi недоступний: причина записується в нотатку. У Pro можна обрати протилежне.
• Сумісно з HPOS, класичною і блоковою касою; мови: English, italiano.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → Partita IVA Lookup: вставте токен Openapi і натисніть «Check connection».
3. Оберіть поле Partita IVA і збережіть налаштування.
4. Введіть номер на чекауті, щоб побачити результат.

Модуля ще немає на wordpress.org: безкоштовна версія і Pro — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.