Создание реестра выплат
Для оплаты услуг исполнителей необходимо создать реестр и отправить его на оплату.
В запросе передается: основание выплаты (comment) и массив "payouts" с объектом, содержащим информацию о реестре.
Информация о реестре
При создании реестра на выплату, нужно указать сумму выплаты в копейках (sum) - обязательно только для добавления/редактирования, список объектов выплат, идентификатор самозанятого в системе (idIndividual).
State - статус: 0 - добавить (используется по умолчанию); 1 - обновить; 2 - удалить
Запрос
Метод: PUT https://business.selfwork.ru/selfemployed/business/v1/payouts/add
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Request Body
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| comment | string | Нет | Основание создания реестра |
| needDoc | boolean | Нет | Автоматическая генерация документов |
| individualType | int32 | Нет | Тип исполнителя: 0 - Самозанятый; 1 - Физ.лицо |
| payouts | array[payouts] | Да | Массив объектов выплат |
payouts:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| idIndividual | int32 | Да | Идентификатор самозанятого в системе |
| idContract | int32 | Нет | Договор заключенный с самозанятым, которому предназначена выплата (опционально) |
| comment | string | Нет | Основание выплаты (обязательно только для добавления/редактирования) |
| partnerCommission | int64 | Нет | Сумма аренды в копейках |
| requisiteType | int32 | Нет | Типы: 0 - использовать реквизиты карты; 1 - использовать реквизиты номера счета |
| state | int32 | Нет | Статус: 0 - добавить (по умолчанию); 1 - обновить; 2 - удалить |
| sum | int64 | Нет | Сумма выплаты в копейках (обязательно только для добавления/редактирования) |
| taxRate | int32 | Нет | Ставка НДФЛ (для физ. лиц). Возможные значения - 13, 15, 18, 20, 22, 30 |
Пример
- cURL
curl -X PUT "https://business.selfwork.ru/selfemployed/business/v1/payouts/add" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json" \
-d '{
"comment": "Реестр выплат за июль 2025",
"needDoc": true,
"individualType": 1
"payouts": [
{
"idIndividual": 12345,
"sum": 5000000,
"comment": "Оплата за веб-разработку",
"requisiteType": 0,
"idContract": 111
"state": 0,
"taxRate": 18
},
{
"idIndividual": 67890,
"idContract": 67890,
"sum": 3000000,
"partnerCommission": 10000,
"comment": "Оплата за дизайн услуги",
"requisiteType": 1
"state": 1,
"taxRate": 13
}
]
}'
Ответы
- 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"
}
Дальнейшие действия
Ответ от сервера приходит в JSON формате. Метод возвращает "id" реестра, который необходимо отправить на проверку. Данный "id" используется для работы с выплатами, например, для получения информации по реестру. Также в ответе будет присутствовать state исходя из значения данного ключа, можно понять в каком статусе находится реестр.
Справочник статусов (state)
| Статус | Описание |
|---|---|
| 0 | Успешно создан |
| 1 | Самозанятый не найден |
| 2 | Самозанятый зарегистрирован под другим агентом |
| 3 | Неверный статус самозанятого |
| 4 | Не найдена банковская карта самозанятого |
| 5 | Неверная сумма |
| 6 | Превышены лимиты |
В случае, если по самозанятому вернулся ошибочный статус, то данный самозанятый не будет добавлен в реестр. Если реестр состоит из одного самозанятого, то в таком случае, реестр не будет создан.