Chek-Barbos — чеки самозанятым

By Alexandra

0+ active installationsVersion 1.0.0

Автоматическое формирование чеков в «Мой налог» (НПД) для самозанятых при оплате заказа WooCommerce через Юкассу, Робокассу и другие способы.

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

  1. Убедитесь, что установлены и активны WooCommerce и нужный вам платёжный шлюз (например, «ЮKassa для WooCommerce» или «Robokassa payment gateway for Woocommerce»).
  2. Загрузите папку плагина в /wp-content/plugins/ (или установите zip через «Плагины → Добавить новый → Загрузить плагин»).
  3. Активируйте «Chek-Barbos — чеки самозанятым» в списке плагинов.
  4. Откройте WooCommerce → Chek-Barbos и войдите одним из двух способов: по номеру телефона и коду из SMS (рекомендуется — так же, как вход в само приложение «Мой налог»), либо по ИНН и паролю от «Личного кабинета налогоплательщика» (lkfl2.nalog.ru), если он у вас есть.
  5. Включите автоматическое создание чеков и выберите способы оплаты, к которым оно применяется.
  6. Нажмите «Проверить подключение», чтобы убедиться, что авторизация работает.
  7. Сделайте тестовый заказ и проверьте, что чек появился в приложении «Мой налог».

FAQ

Почему плагин называется Чек-барбос?

Нужно было уникальное название плагина и я люблю собак =) Люди, заводите собак, будьте счастливы!

Это официальный плагин ФНС или ЮKassa?

Нет. Это неофициальный сторонний плагин. Он авторизуется под вашей собственной учётной записью «Мой налог» и использует тот же веб-интерфейс, что и официальный кабинет lknpd.nalog.ru.

Отправляет ли плагин чек или уведомление покупателю?

Нет. Чек создаётся только в вашей учётной записи «Мой налог» — покупателю ничего не отправляется.

Что будет при обновлении плагина платёжного шлюза?

Ничего — плагин не изменяет файлы шлюза и работает независимо через стандартное событие WooCommerce woocommerce_payment_complete.

Нужен ли официальный договор с ФНС, чтобы этим пользоваться?

Нет — ФНС не предоставляет открытый партнёрский API для самозанятых-физлиц. Плагин использует тот же веб-интерфейс, что и официальный кабинет lknpd.nalog.ru, с авторизацией под вашей учётной записью.

Что делать, если чек не сформировался?

Причина записывается в примечание к заказу. В карточке заказа есть кнопка «Сформировать чек» / «Сформировать заново» для ручного повтора, и (по желанию) уведомление на почту.

Что происходит с данными плагина при его удалении?

По умолчанию — ничего: настройки и метаполя чеков остаются в базе (на случай, если плагин удалён временно). Если на странице настроек включить флажок «Удалять все данные плагина при удалении», то при удалении плагина через «Плагины → Удалить» безвозвратно удаляются ИНН, пароль, токены авторизации и метаполя чеков во всех заказах.

Screenshots

Changelog

1.0.0

  • Первый выпуск: автоматическое создание чека в «Мой налог» при оплате, аннулирование при возврате, ручное создание из карточки заказа.