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 — один архив с этой страницы. Без ключа он работает как бесплатная версия.