Получение результата проверки статуса самозанятого в налоговой
Метод API предназначен для получения информации о результате проверки статуса самозанятого в налоговой.
Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса, в Path указать идентификатор самозанятого, а также в query параметрах указать идентификатор запроса проверки в налоговой.
Запрос
Метод: GET https://business.selfwork.ru/selfemployed/business/v1/self-employed/check-state-result/{id}
Path Parameters
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| id | int32 | Да | Идентификатор самозанятого в системе |
Query Parameters
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| asyncRequestId | string | Да | Идентификатор запроса проверки в налоговой |
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Пример
- cURL
curl -X GET "https://business.selfwork.ru/selfemployed/business/v1/self-employed/check-state-result/12345?asyncRequestId=abc123-def456-ghi789" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json"
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
{
"taxpayerStatus": 0,
"asyncRequestId": 123456
}
Описание ответа:
| Ключ | Описание |
|---|---|
| taxpayerStatus | Статус самозанятого в налоговой |
| asyncRequestId | Идентификатор запроса проверки в налоговой |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |
Справочник статусов taxpayerStatus
| Статус | Описание |
|---|---|
| 0 | Самозанятый (состоит на учете в налоговом органе) |
| 10 | Самозанятый. Не предоставлены разрешения на выплату |
| 15 | Самозанятый, выплата дохода не запрещена, но превысит законодательный лимит и приведет к потере статуса самозанятого |
| 30 | Самозанятый. Выплата превысит внутренний лимит на месяц для лица |
| 40 | Не состоит на учете (не самозанятый) |
| 80 | Нет данных в ИФНС |