=== Chek-Barbos — чеки самозанятым ===
Contributors: avsalexandra
Tags: samozanyatye, npd, woocommerce, receipts, yookassa
Requires at least: 5.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
Requires Plugins: woocommerce
WC requires at least: 3.7
WC tested up to: 11.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Автоматическое формирование чеков в «Мой налог» (НПД) для самозанятых при оплате заказа 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. Сделайте тестовый заказ и проверьте, что чек появился в приложении «Мой налог».

== Frequently Asked Questions ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Screenshots ==

1. Страница настроек (WooCommerce → Chek-Barbos)
2. Настройки плагина часть 2
3. На странице заказа сформировать чек вручную в Мой налог

== Changelog ==

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

== Upgrade Notice ==

= 1.0.0 =
Первый выпуск.
