Добавление самозанятого в компанию c помощью API
Для осуществления выплат в сторону самозанятого, необходимо добавить исполнителя в компанию и получить его согласие на сотрудничество.
После добавления самозанятого лица, его данные необходимо подтвердить при помощи СМС кода.
Для успешного вызова метода необходимо передать X-Login и X-Password в Headers запроса и JSON-объект с информацией о новом самозанятом.
Запрос
Метод: POST https://business.selfwork.ru/selfemployed/business/v1/self-employed/add
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Request Body
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| 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" \
-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 | Сообщение сервера, описывающее ошибку |