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