ym88659208ym87991671
Зарегистрировать чек самозанятого | Документация для разработчиков

Зарегистрировать чек самозанятого

Обновлено 13 июля 2026

Запрос для формирования и отправки чека в налоговую (ФНС) для ранее проведенного перевода (B2C-платежа) в адрес самозанятого.

Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис SELF_EMPLOYED.

Перед отправкой чека самозанятый должен быть успешно валидирован. В запросе на регистрацию чека необходимо передать ValidationRequestId, полученный из ответа на запрос POST /v1/self-employed/payees/validation.

Регистрация чека в ФНС может занимать некоторое время, но не более суток. Метод работает по принципу идемпотентного запроса:

  • Если чек не был зарегистрирован сразу, то в ответе придет промежуточный статус PROCESSING, необходимо повторно зарегистрировать чек, отправив точно такой же запрос (с теми же данными). Повторные запросы на регистрацию чека необходимо производить не чаще чем 1 раз в минуту первые 5 минут, и далее не чаще 1 раза в 10 минут.
  • Если обработка завершена, то ответ будет содержать финальный статус SUCCESS и ссылку на зарегистрированный чек.
Рекомендации по тестированию в песочнице

Сценарии тестирования

Для тестирования сценариев используйте фиксированные значения paymentId.


1. Чтобы получить успешный ответ со статусом "receiptStatus": "PROCESSING", нужно в поле paymentId передать значение 16032026-0916-416c-9381-8c4af3c41acc.


2. Чтобы получить успешный ответ со статусом "receiptStatus": "SUCCESS" и ссылкой на чек, нужно в поле paymentId передать любое другое значение (кроме указанных в сценариях №1, 3-10).


3. Чтобы получить ошибку "Запрос на регистрацию чека самозанятого доступен только по собственной организации.", нужно в поле paymentId передать значение 16032026-0116-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "WORKFLOW_FAULT", HTTP-статус 400


4. Чтобы получить ошибку "При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже.", нужно в поле paymentId передать значение 16032026-0216-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "UNAVAILABLE_RESOURCE_EXCEPTION", HTTP-статус 500


5. Чтобы получить ошибку "Сервис временно недоступен. Повторная регистрация чека невозможна, получателю необходимо создать чек самостоятельно.", нужно в поле paymentId передать значение 16032026-0316-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "UNAVAILABLE_RESOURCE_EXCEPTION", HTTP-статус 500


6. Чтобы получить ошибку "При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже.", нужно в поле paymentId передать значение 16032026-0416-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "UNAVAILABLE_RESOURCE_EXCEPTION", HTTP-статус 500


7. Чтобы получить ошибку "Несоответствие id валидации и id платежа", нужно в поле paymentId передать значение 16032026-0516-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "WORKFLOW_FAULT", HTTP-статус 400


8. Чтобы получить ошибку "Не найден результат валидации физ. лица на самозанятость", нужно в поле paymentId передать значение 16032026-0616-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "WORKFLOW_FAULT", HTTP-статус 400


9. Чтобы получить ошибку "Превышен лимит запросов. Повторите операцию позже.", нужно в поле paymentId передать значение 16032026-0716-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "TOO_MANY_REQUESTS", HTTP-статус 429


10. Чтобы получить ошибку "У вас недостаточно прав для совершения операции. Обратитесь к руководителю организации для получения полномочий.", нужно в поле paymentId передать значение 16032026-0816-416c-9381-8c4af3c41acc.

Причина в ответе: "cause": "ACTION_ACCESS_EXCEPTION", HTTP-статус 403

Запрос

Ответы

Успешный код возврата

Loading...
Это полезный материал?
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке