Какие задачи решает MU-плагин YooKassa Certificates Override
При работе с WooCommerce и YooKassa часто возникает проблема с электронными чеками, особенно если на сайте продаются подарочные сертификаты или цифровые продукты. Стандартная логика WooCommerce и платёжных плагинов не всегда корректно определяет тип товара, из-за чего в чек может попадать неверный предмет расчёта, ставка НДС или способ оплаты.
MU-плагин YooKassa Certificates Override решает сразу несколько критически важных задач.
1. Корректное формирование чека для сертификатов
Плагин автоматически находит товары, относящиеся к категории certificates, и изменяет данные чека до его отправки в YooKassa:
предмет расчёта → услуга
способ расчёта → аванс
ставка НДС → без НДС
Это соответствует требованиям законодательства для подарочных сертификатов и цифровых прав и исключает ошибки со стороны ОФД и налоговой.
2. Работа с любыми типами товаров
Плагин одинаково корректно работает:
с обычными товарами
с вариативными товарами
с виртуальными и цифровыми продуктами
с сертификатами, созданными через PW Gift Card
Он не зависит от названия товара, описания в чеке или структуры корзины — анализ идёт по реальному заказу WooCommerce.
3. Гарантированная модификация чека до отправки
Ключевая особенность плагина — он подключается к правильному системному хуку YooKassa, когда чек ещё не отправлен и не подписан.
Это означает, что:
чек не «перезаписывается» постфактум
в YooKassa и ОФД уходит уже корректная версия
нет расхождений между заказом и фискальными данными
4. Защита от ошибок и предупреждений PHP
Плагин устраняет типичные проблемы, которые возникают при формировании чека:
ошибки вида preg_split(null)
некорректные или пустые поля description
предупреждения, влияющие на стабильность оплаты
Это повышает надёжность платёжного процесса и снижает количество ошибок в логах сервера.
5. Запрет смешанных корзин
Если пользователь пытается оплатить сертификат и обычный товар в одном заказе, плагин:
показывает понятное сообщение об ошибке
блокирует переход к оплате
предотвращает формирование некорректного чека
Таким образом исключаются спорные ситуации с фискализацией и возвратами.
6. MU-плагин: всегда активен и не отключается
Плагин установлен как MU-плагин (Must-Use), что даёт важные преимущества:
он загружается всегда
не зависит от темы
не может быть случайно отключён в админке
стабильно работает при обновлениях WordPress и WooCommerce
Итог
MU-плагин YooKassa Certificates Override нужен в тех случаях, когда:
на сайте продаются сертификаты или цифровые продукты
используется WooCommerce + YooKassa
важно корректное формирование электронных чеков
требуется соответствие требованиям ОФД и налогового законодательства
Это небольшое, но критически важное техническое решение, которое закрывает сразу несколько проблем и делает процесс оплаты надёжным и юридически корректным.
