Получение списка самозанятых по id
Метод API предназначен для получения списка самозанятых по идентификатору.
Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса и JSON-объект со списком идентификаторов самозанятых.
Запрос
Метод: POST https://business.selfwork.ru/selfemployed/business/v2/self-employed/find-by-id
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Request Body
| Тип | Обязательный | Описание |
|---|---|---|
| array[int32] | Да | Список id самозанятых |
Пример
- cURL
curl -X POST "https://business.selfwork.ru/selfemployed/business/v2/self-employed/find-by-fio" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json" \
-d '[
502259,
503456,
507654,
129012,
594567,
124567,
777890,
504321,
124321,
595678,
778901,
509123,
126123,
596789,
779012,
506789,
120123,
597890,
770123,
503789
]'
-d '[
]'
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
[
{
"id": 10,
"firstName": "Виктор",
"lastName": "Иванов",
"middleName": "Викторович",
"birthDate": "1994-01-27T00:00:00.000+0000",
"state": 3,
"gender": "M",
"bankCards": ["2222********5555", "2222********6666", "2222********7777"],
"individualType": 0,
"snils": "12345678901",
"inn": "1234567890",
"phone": "+79612345678",
"groups": [{ "id": 10, "name": "Программист" }],
"comment": "string",
"autoPayTax": true
}
]
Описание ответа:
| Ключ | Описание |
|---|---|
| id | Идентификатор в базе данных |
| firstName | Имя |
| lastName | Фамилия |
| middleName | Отчество |
| birthDate | Дата рождения |
| state | Статус |
| gender | Пол |
| bankCards | Список банковских карт |
| individualType | Тип исполнителя: 0 - самозанятый; 1 - физ. лицо |
| snils | СНИЛС |
| inn | ИНН |
| phone | Номер телефона в формате +7ХХХХХХХХХХ |
| groups | Виды деятельности: массив { id, name } |
| comment | Произвольная информация |
| autoPayTax | Автоматическая выплата налогов |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |
Справочник статусов (state)
| Статус | Описание |
|---|---|
| 0 | Новый, не обработан |
| 1 | В обработке |
| 2 | Не самозанятый |
| 3 | Самозанятый, не предоставил права площадке |
| 4 | Самозанятый |
| 5 | Согласие отозвано |
| 6 | Архивный |
| 7 | Не существует |
| 8 | Блокирован |
| 9 | Ожидает СНИЛС (для физ. лица) |