Получение актуальных самозанятых
Чтобы получить список актуальных самозанятых, с подробной информацией о всех исполнителях, подключенных к платформе, необходимо использовать метод self-employed/actual.
При успешной отправке запроса, вернется массив с данными о самозанятых, которые подключены к компании-партнеру, в том числе их идентификаторы в системе.
Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса.
Запрос
Метод: GET https://business.selfwork.ru/selfemployed/business/v1/self-employed/actual
Query Parameters
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| page | int32 | Нет | Номер страницы, отсчёт с 1. Действует только вместе с pageSize |
| pageSize | int32 | Нет | Размер страницы. Без него метод вернёт весь список одним ответом |
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Пример
- cURL
curl -X GET "https://business.selfwork.ru/selfemployed/business/v1/self-employed/actual" \
-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
Запрос выполнен успешно
[
{
"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": 1,
"snils": "12345678901",
"inn": "1234567890",
"phone": "+79612345678",
"actionName": "Программист",
"comment": "string",
"autoPayTax": true
}
]
Описание ответа:
| Ключ | Описание |
|---|---|
| id | Идентификатор в базе данных |
| firstName | Имя |
| lastName | Фамилия |
| middleName | Отчество |
| birthDate | Дата рождения |
| state | Статус |
| gender | Пол |
| bankCards | Список банковских карт |
| individualType | Тип исполнителя: 0 - самозанятый; 1 - физ. лицо |
| snils | СНИЛС |
| inn | ИНН |
| phone | Номер телефона в формате +7ХХХХХХХХХХ |
| actionName | Группа исполнителей |
| 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 | Ожидает СНИЛС (для физ. лица) |