YooKassa Agent Receipts for WooCommerce — это специализированный плагин-расширение (аддон) для официального модуля «ЮKassa для WooCommerce», предназначенный для автоматической передачи признака агента и реквизитов поставщика в фискальные чеки (в соответствии с требованиями 54-ФЗ).
Плагин необходим интернет-магазинам, работающим по агентской, комиссионной схеме или модели маркетплейса/витрины (продажа товаров и услуг сторонних поставщиков, бронирование, билеты и т.д.).
При отправке чеков через ЮKassa по агентской схеме каждая товарная позиция должна содержать:
- Признак агента (agent_type).
- Данные поставщика (supplier): наименование юрлица/ИП, контактный телефон и ИНН.
Плагин позволяет централизованно настроить эти реквизиты в разрезе категорий товаров WooCommerce без необходимости редактировать каждый товар вручную.
Ключевые возможности
📂 Привязка к категориям товаров: правила фискализации настраиваются для одной или нескольких категорий каталога.
🌳 Поддержка иерархии и наследования: подкатегории автоматически наследуют правила родительских категорий. Если товар входит в несколько категорий с разными правилами, приоритет отдаётся наиболее глубокой (вложенной) категории.
🔀 Поддержка вариативных товаров: для вариаций корректно определяются категории родительского товара.
🔒 Фиксация данных в заказе: правила сохраняются в метаданные заказа в момент оформления (_yar_agent_receipt_rules), что исключает расхождения, если настройки категорий изменятся в будущем.
📋 Все типы агентов по 54-ФЗ:
- Агент (agent)
- Комиссионер (commissioner)
- Поверенный (attorney)
- Платёжный агент (payment_agent)
- Платёжный субагент (payment_subagent)
- Банковский платёжный агент (banking_payment_agent)
- Банковский платёжный субагент (banking_payment_subagent)
🛒 Поддержка всех типов оформления заказа:
- Классический чекаут WooCommerce (шорткод [woocommerce_checkout]);
- Блочный чекаут (WooCommerce Checkout Block / Store API);
- Страница повторной оплаты неоплаченного заказа (Order Pay).
🛡️ Валидация и нормализация данных:
- Автоматическое приведение номеров телефонов к формату ITU-T E.164 (например, 8999... / 7999... $\rightarrow$ +7999...);
- Проверка корректности ИНН (10 цифр для юрлиц, 12 для ИП);
- Защита от неполных данных поставщика (предотвращает ошибки фискализации на стороне онлайн-кассы).