Обновление реестра
Метод API предназначен для редактирования существующего реестра.
Для вызова метода необходимо передать X-Login и X-Password в Headers запроса.
Также необходимо в теле запроса используя объект внести необходимые изменения в реестр.
Запрос
Метод: POST https://business.selfwork.ru/selfemployed/business/v1/payouts/update
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Request Body
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| id | int32 | Да | Уникальный идентификатор реестра |
| needDoc | boolean | Да | Автоматическая генерация документов |
| individualType | int32 | Нет | Тип исполнителя: 0 - Самозанятый; 1 - Физ.лицо |
| payouts | array[object] | Да | Массив выплат по СЗ |
payouts
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| state | int32 | Нет | Статус: 0 - добавить (по умолчанию); 1 - обновить; 2 - удалить |
| idIndividual | int32 | Да | Идентификатор СЗ |
| sum | int32 | Нет | Сумма выплаты в копейках (обязательно только для добавления/редактирования) |
| comment | string | Нет | Основание выплаты (обязательно только для добавления/редактирования) |
| idContract | int32 | Нет | Договор заключенный с самозанятым, которому предназначена выплата (опционально) |
| requisiteType | int32 | Нет | Типы: 0 - использовать реквизиты карты; 1 - использовать реквизиты номера счета |
| partnerCommission | int32 | Нет | Сумма аренды в копейках |
| taxRate | int32 | Нет | Ставка НДФЛ (для физ. лиц) |
Пример
- cURL
curl -X POST "https://business.selfwork.ru/selfemployed/business/v1/payouts/update" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json" \
-d '{
"id": 12345,
"needDoc": true,
"individualType": 0,
"payouts": [
{
"state": 0,
"idIndividual": 67890,
"sum": 5000000,
"comment": "Оплата за веб-разработку",
"partnerCommission": 25000,
"idContract": 111,
"requisiteType": 0
},
{
"state": 1,
"idIndividual": 67891,
"sum": 3000000,
"comment": "Оплата за дизайн",
"requisiteType": 1
}
]
}'
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
{
"id": 213,
"payouts": [
{
"idIndividual": 15,
"state": 0
}
]
}
Описание ответа:
| Ключ | Описание |
|---|---|
| id | Идентификатор реестра |
| payouts | Список результатов создания выплат по реестру |
| - idIndividual | Идентификатор СЗ |
| - state | Статус |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Справочник статусов (state)
| Статус | Описание |
|---|---|
| 0 | Успешно создана |
| 1 | Самозанятый не найден |
| 2 | Самозанятый зарегистрирован под другим агентом |
| 3 | Неверный статус самозанятого |
| 4 | Не найдена банковская карта самозанятого |
| 5 | Неверная сумма |
| 6 | Превышены лимиты |
| 7 | Договор не связан с агентом |
| 8 | Удержание аренды не доступно |
| 9 | Не указана ставка НДФЛ |
| 10 | Истек срок действия договора |
| 11 | Переданный договор не связан с самозанятым |