Добавление нескольких самозанятых в компанию
Метод API предназначен для добавления нескольких самозанятых в компанию.
Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса и JSON-объект с массивом, содержащим информацию о самозанятых.
Запрос
Метод: POST https://business.selfwork.ru/selfemployed/business/v1/self-employed/add-list
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Request Body
| Тип | Обязательный | Описание |
|---|---|---|
| array[individual] | Да | Массив объектов с данными самозанятых |
individual
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| firstName | string | Да | Имя |
| lastName | string | Да | Фамилия |
| middleName | string | Нет | Отчество |
| birthDate | string | Нет | Дата рождения в формате: yyyy-MM-dd |
| gender | string | Нет | Пол в формате: M, F |
| inn | string | Да | ИНН - строго 10 или 12 цифр |
| phone | string | Да | Номер телефона в формате +7ХХХХХХХХХХ |
| actionName | string | Нет | Вид деятельности |
| comment | string | Нет | Произвольная информация |
| autoPayTax | boolean | Нет | Автоматическая выплата налогов |
Пример
- cURL
curl -X POST "https://business.selfwork.ru/selfemployed/business/v1/self-employed/add-list" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json" \
-d '[
{
"firstName": "Анна",
"lastName": "Сидорова",
"middleName": "Владимировна",
"birthDate": "1990-05-15",
"gender": "F",
"inn": "123456789012",
"phone": "+79001234567",
"actionName": "Веб-разработка",
"comment": "Специализация: React, Node.js",
"autoPayTax": true
}
]'
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
[
{
"id": 10,
"inn": 1234567890,
"errorCode": 0
}
]
Описание ответа:
| Ключ | Описание |
|---|---|
| id | Идентификатор в базе данных |
| inn | ИНН |
| errorCode | Статус добавления СЗ в систему: 0 - успех; 1 - уже существует; 2 - банковские карты не поддерживаются; 3 - некорректный ИНН |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |