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

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/

Screenshots

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, с авторизацией под вашей учётной записью.

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

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

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

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

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Chek-Barbos — чеки самозанятым” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

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