EU VAT Check для WooCommerce — перевірка ПДВ-номерів у VIES і reverse charge

EU VAT Check для WooCommerce — поле ПДВ-номера (VAT ID, USt-IdNr.) на чекауті з перевіркою в офіційному сервісі VIES Єврокомісії. Якщо B2B-покупець з іншої країни ЄС вводить валідний номер, плагін знімає ПДВ за схемою reverse charge, а відповідь VIES разом з consultation number зберігає в замовленні як доказ перевірки. Плагін задуманий як наступник EU VAT Assistant, розвиток якого припинено: номери клієнтів і старі замовлення підхоплюються самі.

Чесно про межі. Плагін вирішує, чи знімати ПДВ, за загальною B2B-схемою ЄС: номер валідний, країна номера збігається з країною платника, це не продаж усередині країни магазину і не доставка в країну магазину. Трикутні угоди, послуги з іншим місцем постачання, особливі території й IOSS він не розбирає — рішення й звітність лишаються за магазином і податковим консультантом, це не податкова порада. Повний прогін чекаутів ішов на офіційному тестовому сервісі Єврокомісії; реальні номери клієнтів у живому VIES перевірте на своєму магазині в тріалі.

Як це виглядає для покупця

• Поле «EU VAT number» в адресі на блоковому чекауті, під платіжною адресою на класичному і в «Мій акаунт».
• Відповідь одразу: зелене повідомлення й ПДВ зникає з підсумку, червоне — номер недійсний, жовте — VIES зараз не відповідає. Прибрав номер — ПДВ повертається.
• Класичний чекаут ховає поле для країн поза ЄС і показує його для Північної Ірландії (префікс XI за поштовим кодом BT).
• Текст reverse charge — на сторінці подяки й у листах WooCommerce, а з PDF Invoices & Packing Slips — і на PDF-рахунку.

Що отримує адмін

• Бокс у замовленні (HPOS і класичне сховище): номер, статус, назва й адреса з VIES, consultation number, час перевірки, кнопка «Check in VIES now» з нотаткою про результат. Податки кнопка сама не перераховує.
• Колонка «EU VAT» у списку замовлень, поле в платіжних даних замовлення і в профілі користувача.
• Журнал перевірок: кожна відповідь VIES з датою, номером, замовленням і джерелом, з фільтрами.
• Політики: невалідний номер — зупинити замовлення або нарахувати ПДВ; VIES не відповідає — нарахувати ПДВ або прийняти й перевіряти щогодини ще 3 доби.
• Перенесення з EU VAT Assistant: номери клієнтів копіюються кнопкою і при вході клієнта, старі замовлення читаються боксом і звітами; для самого EU VAT Assistant — підказка його вимкнути.

Pro: докази локації, OSS, ставки ПДВ

• Докази локації покупця: країна платника, доставки, IP (геолокація WooCommerce, без зовнішнього сервісу) і номера — у замовленні видно, скільки з них збігаються.
• OSS-звіт за квартал по країнах і ставках для продажів споживачам в інших країнах ЄС і EC Sales List по номерах клієнтів з reverse charge — з поверненнями й CSV. Це робочі цифри для підготовки декларації, а не подача.
• Стандартні ставки ПДВ 27 країн з бази TEDB Єврокомісії: порівняння з таблицею податків WooCommerce, запис кнопкою після перегляду, щотижнева перевірка змін.
• Звірка назви компанії з даними VIES і планова повторна перевірка збережених номерів клієнтів.

Разом з іншими модулями для Німеччини та ЄС

• E-Invoice EN 16931 для WooCommerce бере перевірений номер з EU VAT Check у рахунок ZUGFeRD / XRechnung і ставить категорії reverse charge K / AE. На чекауті лишається одне поле номера — друге поле E-Invoice вимикається само.
• DATEV Export для WooCommerce (Pro) може брати перевірений номер клієнта з EU VAT Check у поле ЄС-номера проводки для продажів з reverse charge — так налаштовано й перевірено в спільному прогоні.
• Unit Price Grundpreis для WooCommerce — ціна за 1 кг / 1 л на вітрині для магазинів з Німеччини.

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

1. Увімкніть поле, вкажіть власний ПДВ-номер магазину (для consultation number) і натисніть «Test the connection».
2. Оберіть політики для невалідного номера і недоступного VIES.
3. Покупець з іншої країни ЄС вводить номер на чекауті — плагін перевіряє формат, потім питає VIES.
4. Номер валідний і країна збігається — ПДВ знімається, покупець бачить зелене повідомлення.
5. Замовлення зберігає номер, відповідь VIES і consultation number; у журналі — рядок перевірки.
6. З Pro — наприкінці кварталу OSS-звіт і EC Sales List у CSV.

Що під капотом

• Офіційний VIES REST API Єврокомісії (check-vat-number, check-vat-test-service, check-status) — без парсингу й без сторонніх посередників.
• Спершу локальна перевірка структури номера за таблицею VIES, щоб не витрачати запит на очевидну помилку; потім кеш відповідей і один повтор при MS_MAX_CONCURRENT_REQ / GLOBAL_MAX_CONCURRENT_REQ.
• Захист від перебору: не більше 15 різних номерів на годину з однієї IP.
• Reverse charge через штатний механізм WooCommerce (звільнення покупця від ПДВ), тому суми, податки й звіти WooCommerce лишаються узгодженими.
• Видалення плагіна прибирає налаштування, кеш відповідей VIES і крони; журнал перевірок і мета замовлень лишаються як податкові докази (журнал видаляється лише з константою CCEUVAT_DELETE_DATA).

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть catcode-eu-vat-check-for-woocommerce-1.0.0.zip і активуйте. Якщо стоїть EU VAT Assistant чи інший плагін ПДВ-номерів — вимкніть його.
2. WooCommerce → EU VAT Check → Settings: поле, власний ПДВ-номер, політики; «Test the connection».
3. Для переходу з EU VAT Assistant — кнопка перенесення номерів клієнтів.
4. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал у вкладці Licence.