Description
Chek-Barbos — плагин для автоматического формирования чеков в приложении «Мой налог» для самозанятых (плательщиков налога на профессиональный доход, НПД).
Неофициальный плагин. Не связан с ФНС России, НКО «ЮMoney» (ЮKassa) и ООО «Робокасса» и не одобрен ими; названия сервисов упоминаются только для описания совместимости.
Плагин «ЮKassa для WooCommerce» формирует фискальные чеки только для ИП и юридических лиц (ООО). Продавцы, зарегистрированные как самозанятые (плательщики налога на профессиональный доход, НПД), обязаны сформировать чек сами — в приложении «Мой налог» или в веб-кабинете (lknpd.nalog.ru). Встроенная функция чеков платёжного шлюза этот случай не закрывает.
Этот плагин закрывает пробел: сразу после оплаты заказа он автоматически создаёт соответствующий чек в «Мой налог» на сумму заказа. Работает с любым выбранным способом оплаты WooCommerce — ЮKassa, Робокасса, «оплата при получении», банковский перевод и т. д. Каждая позиция чека называется <Название товара> #<номер заказа>.
Это требование закона, а не просто удобство. По ч. 2 ст. 14 Федерального закона № 422-ФЗ от 27.11.2018 самозанятый обязан сформировать чек и передать его покупателю в момент расчёта, если оплата произведена наличными или с использованием электронных средств платежа — сюда относятся и платежи картой через платёжный шлюз (ЮKassa, Робокасса). Более поздний срок (до 9 числа следующего месяца, ч. 3 той же статьи) действует только для денег, поступивших напрямую на счёт по банковским реквизитам, но не для оплат картой на сайте. Поэтому при оплате картой чек нужно сформировать в тот же день — плагин делает это автоматически и сразу.
Покупателю не отправляется ни письмо, ни SMS — чек создаётся только для налогового учёта продавца.
Возможности:
- Автоматическое создание чека в «Мой налог» при оплате заказа
- Выбор способов оплаты, при которых создаётся чек (например, только ЮKassa, но не «оплата при получении»)
- Позиция чека = название товара + номер заказа
- Стоимость доставки добавляется отдельной позицией (если оплачена)
- Автоматическое аннулирование чека при возврате заказа
- Кнопка ручного создания / повторного создания чека в карточке заказа (для повтора после сетевого сбоя)
- Кнопка «Проверить подключение» на странице настроек
- Клиенту ничего не отправляется — только внутренний налоговый учёт
- Необязательное полное удаление настроек плагина и метаполей заказов при удалении плагина
- Необязательное уведомление на почту, если чек не удалось создать или аннулировать
Плагин рассчитан только на Россию (режим НПД существует только в РФ), поэтому его интерфейс на русском языке.
External services
Плагин обращается к одному внешнему сервису: «Мой налог» (НПД) Федеральной налоговой службы России, хост lknpd.nalog.ru (базовый адрес API https://lknpd.nalog.ru/api/v1). Подключение необходимо для основной функции плагина — авторизации от имени самозанятого и регистрации дохода / формирования чеков НПД. Плагин не аффилирован с ФНС.
Какие данные и когда отправляются:
- Сохранение страницы настроек никуда ничего не отправляет — ИНН, пароль и номер телефона просто сохраняются в базе данных сайта.
- Вход по телефону: по кнопке «Отправить код» номер телефона отправляется на
https://lknpd.nalog.ru/api/v1/auth/challenge/sms/start; введённый код из SMS — наhttps://lknpd.nalog.ru/api/v1/auth/challenge/sms/verify. - Вход по ИНН и паролю: учётные данные отправляются на
https://lknpd.nalog.ru/api/v1/auth/lkfl. - При оплате заказа выбранным способом оплаты (событие
woocommerce_payment_complete) плагин отправляет названия позиций заказа, суммы и номер заказа наhttps://lknpd.nalog.ru/api/v1/income; при возврате — наhttps://lknpd.nalog.ru/api/v1/cancel. Персональные данные покупателя (email, телефон, имя) не передаются. - Токен авторизации периодически обновляется через
https://lknpd.nalog.ru/api/v1/auth/token. - Кнопка «Проверить подключение» на странице настроек также обращается к этим адресам для проверки авторизации.
Это тот же интерфейс, который использует официальный веб-кабинет «Мой налог». ФНС не публикует открытый партнёрский API для самозанятых-физлиц, поэтому авторизация выполняется под вашей собственной учётной записью.
Документы сервиса:
- Условия использования / соглашение: https://lknpd.nalog.ru/auth/register/agreement
- Политика конфиденциальности приложения «Мой налог»: https://npd.nalog.ru/app/privacy/
- Политика конфиденциальности (на официальном портале): https://www.nalog.gov.ru/rn77/copyright/mobile_privacy_policy/selfemployed/
- Официальная информация о налоге на профессиональный доход: https://npd.nalog.ru/ ; нормативные документы: https://npd.nalog.ru/docs/
Installation
- Убедитесь, что установлены и активны WooCommerce и нужный вам платёжный шлюз (например, «ЮKassa для WooCommerce» или «Robokassa payment gateway for Woocommerce»).
- Загрузите папку плагина в
/wp-content/plugins/(или установите zip через «Плагины → Добавить новый → Загрузить плагин»). - Активируйте «Chek-Barbos — чеки самозанятым» в списке плагинов.
- Откройте WooCommerce → Chek-Barbos и войдите одним из двух способов: по номеру телефона и коду из SMS (рекомендуется — так же, как вход в само приложение «Мой налог»), либо по ИНН и паролю от «Личного кабинета налогоплательщика» (lkfl2.nalog.ru), если он у вас есть.
- Включите автоматическое создание чеков и выберите способы оплаты, к которым оно применяется.
- Нажмите «Проверить подключение», чтобы убедиться, что авторизация работает.
- Сделайте тестовый заказ и проверьте, что чек появился в приложении «Мой налог».
FAQ
Почему плагин называется Чек-барбос?
Нужно было уникальное название плагина и я люблю собак =) Люди, заводите собак, будьте счастливы!
Это официальный плагин ФНС или ЮKassa?
Нет. Это неофициальный сторонний плагин. Он авторизуется под вашей собственной учётной записью «Мой налог» и использует тот же веб-интерфейс, что и официальный кабинет lknpd.nalog.ru.
Отправляет ли плагин чек или уведомление покупателю?
Нет. Чек создаётся только в вашей учётной записи «Мой налог» — покупателю ничего не отправляется.
Что будет при обновлении плагина платёжного шлюза?
Ничего — плагин не изменяет файлы шлюза и работает независимо через стандартное событие WooCommerce woocommerce_payment_complete.
Нужен ли официальный договор с ФНС, чтобы этим пользоваться?
Нет — ФНС не предоставляет открытый партнёрский API для самозанятых-физлиц. Плагин использует тот же веб-интерфейс, что и официальный кабинет lknpd.nalog.ru, с авторизацией под вашей учётной записью.
Что делать, если чек не сформировался?
Причина записывается в примечание к заказу. В карточке заказа есть кнопка «Сформировать чек» / «Сформировать заново» для ручного повтора, и (по желанию) уведомление на почту.
Что происходит с данными плагина при его удалении?
По умолчанию — ничего: настройки и метаполя чеков остаются в базе (на случай, если плагин удалён временно). Если на странице настроек включить флажок «Удалять все данные плагина при удалении», то при удалении плагина через «Плагины → Удалить» безвозвратно удаляются ИНН, пароль, токены авторизации и метаполя чеков во всех заказах.
Screenshots
Changelog
1.0.0
- Первый выпуск: автоматическое создание чека в «Мой налог» при оплате, аннулирование при возврате, ручное создание из карточки заказа.



