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

Проверка физ. лиц на статус самозанятого

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

Проверяет, имеет ли физическое лицо статус самозанятого (плательщика налога на профессиональный доход), и сохраняет данные для последующей выдачи чеков.

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

Рекомендации по тестированию в песочнице

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

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


1. Чтобы получить успешный ответ с результатом проверки "payeeValidationResult": false, нужно в поле taxId передать значение, начинающееся с 987654321 (например, 987654321098).


2. Чтобы получить успешный ответ со статусом "payeeValidationStatus": "ERROR", нужно в поле taxId передать значение, начинающееся с 12345678 (например, 123456789098).


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


4. Чтобы получить ошибку "При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже.", нужно в поле taxId передать значение 500000000001.

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


5. Чтобы получить ошибку "Превышен лимит запросов. Повторите операцию позже.", нужно в поле taxId передать значение 429000000000.

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


6. Чтобы получить ошибку "При выполнении операции произошла ошибка. Мы уже работаем над ее устранением. Повторите попытку позже.", нужно в поле taxId передать значение 500000000002.

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


7. Чтобы получить ошибку "Запрос на проверку статусов самозанятых доступен только по собственной организации.", нужно в поле taxId передать значение 600000000000.

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

Запрос

Ответы

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

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