API для отправки чека самозанятому в «Мой налог»

При разработке интернет-магазина для самозанятого важно автоматизировать передачу чеков в налоговую. Без этого предприниматель рискует получить штраф за нарушение порядка расчётов. Разберём, как подключить API для формирования чека и отправки его в приложение «Мой налог».

Как работает передача чеков для самозанятых?

Самозанятые обязаны выдавать чеды каждому покупателю. Чек формируется через приложение «Мой налог» или через партнёрский API. Владельцы онлайн-магазинов могут интегрировать свой сайт с налоговой напрямую - для этого используется API платёжных агрегаторов или специализированных сервисов (например, «Чекмастер», «Астрал.Чек» или «ПСБ-Бизнес»).

Какие существуют способы интеграции?

1. Через сервис-посредник (Сервис приёма платежей)

Самый популярный вариант - заказать приём платежей у партнёра ФНС. Платёжный шлюз (например, ЮKassa, CloudPayments, Тинькофф Касса) сам формирует чек и отправляет его в «Мой налог» после успешной оплаты. Вам нужно лишь передать данные покупателя: ИНН, сумму, наименование товара.

2. Через API банка или платёжного сервиса

Если вы используете собственный процессинг, можно подключить API напрямую. Например, Сбербанк Бизнес Онлайн или Точка Банк предоставляют методы для создания чека. Запрос содержит обязательные поля: ИНН самозанятого, сумма, тип расчёта (полный/аванс). Ответ приходит в формате JSON с номером чека и статусом.

3. Через официальный API ФНС (сложный путь)

ФНС публикует API для самозанятых, но он предназначен в первую очередь для мобильного приложения «Мой налог». Для интернет-магазина этот способ неудобен - требуется сертификат электронной подписи и ручное подписание каждого чека. Рекомендуем использовать готовые интеграции.

Пошаговая инструкция: как настроить отправку чека

• Шаг 1. Выберите платёжный сервис, который поддерживает самозанятых (ЮKassa, CloudPayments, PayMaster).
• Шаг 2. Зарегистрируйтесь в сервисе и получите API-ключ (токен).
• Шаг 3. В коде сайта после успешной оплаты вызовите метод создания чека: передайте ИНН самозанятого, сумму, название товара и признак способа расчёта.
• Шаг 4. Обработайте ответ - если статус «success», чек отправлен в ФНС. При ошибке повторите запрос или покажите пользователю сообщение.

Пример запроса к API (на языке PHP)

$data = [
  'inn' => '123456789012',
  'amount' => 1500.00,
  'description' => 'Кофеварка Bork 500',
  'type' => 'full_payment'
];
$ch = curl_init('https://api.partner.ru/v1/check');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
$response = curl_exec($ch);
curl_close($ch);

Частые ошибки и как их избежать

• Ошибка 400 - некорректные данные. Проверьте ИНН (10 цифр для юрлица, 12 для физлица) и сумму (не более 2 знаков после запятой).
• Ошибка 409 - чек уже существует. Не отправляйте повторно один и тот же заказ - используйте уникальный ID заказа.
• Отсутствие интернета. Если сервис недоступен, сохраните запрос в очередь и повторите отправку через минуту.

Требования к чеку для самозанятого

Чек должен содержать: дату и время, наименование товара/услуги, сумму, ИНН продавца, тип расчёта (полный/аванс). Дополнительно можно указать номер заказа и адрес сайта. Обязательно сохраняйте электронную версию чека в личном кабинете сервиса - она заменяет бумажный вариант.

Заключение

Интеграция API для отправки чеков самозанятому - обязательный этап для интернет-магазина. Выбирайте надёжный платёжный сервис с поддержкой самозанятых, тестируйте отправку в тестовом режиме и следите за обновлениями ФНС. Это защитит вас от штрафов и упростит учёт доходов.