Создание реестра выплат
Для оплаты услуг исполнителей необходимо создать реестр и отправить его на оплату.
В запросе передается: основание выплаты (comment) и массив "payouts" с обьектом, содержащим информацию о реестре.
Информация о реестре:
При создании реестра на выплату, нужно указать сумму выплаты в копейках (sum) - обязательно только для добавления/редактирования, список объектов выплат , идентификатор самозанятого в системе (idIndividual).
State - статус: 0 - добавить ( используется по умолчанию); 1 - обновить; 2 - удалить
Пример запроса:
PUT
https://business.selfwork.ru/selfemployed/business/v1/payouts/add
Headers
Name | Type | Description |
---|---|---|
X-Login* | string | Логин пользователя |
X-Password* | string | Пароль пользователя |
Request Body
Name | Type | Description |
---|---|---|
payoutRegistries* | object | |
- comment | string | Основание создания реестра |
- state | int32 | Статус: 0 - добавить (по умолчанию); 1 - обновить; 2 - удалить |
- idIndividual* | int32 | Идентификатор самозанятого в системе |
- sum | int64 | Сумма выплаты в копейках (обязательно только для добавления/редактирования) |
comment | string | Основание выплаты (обязательно только для добавления/редактирования) |
payouts* | Array | Список объектов выплат |
needDoc | boolean | Автоматическая генерация документов |
- requisiteType | int32 | Типы: 0 - использовать реквизиты карты; 1 - использовать реквизиты номера счета |
- idContract | int32 | Договор заключенный с самозанятым, которому предназначена выплата (опционально) |
Ответ - успешное выполнение метода
Ключ | Описание |
---|---|
id | Идентификатор реестра |
payouts | Список объектов выплат |
idIndividual | Идентификатор СЗ |
state | Статус реестра |
Ответ от сервера приходит в JSON формате. Метод возвращает "id" реестра, который необходимо отправить на проверку. Данный "id" используется для работы с выплатами, например, для получения информации по реестру. Так же в ответе будет присутствовать state исходя из значения данного ключа, можно понять в каком статусе находится реестр.
Справочник параметра state:
Статус | Описание |
---|---|
0 | Успешно создан |
1 | Самозанятый не найден |
2 | Самозанятый зарегистрирован под другим агентом |
3 | Неверный статус самозанятого |
4 | Не найдена банковская карта самозанятого |
5 | Неверная сумма |
6 | Превышены лимиты |
В случае, если по самозанятому вернулся ошибочный статус, то данный самозанятый не будет добавлен в реестр. Если реестр состоит из одного самозанятого, то в таком случае, реестр не будет создан.
Ответ - Системная ошибка
Ключ | Описание |
---|---|
errorCode | Код ошибки вернувшаяся с сервера |
message | Сообщение сервера описывающая ошибку |
Last updated