Получение информации об операциях самозанятых
Метод API предназначен для получения информации о реестрах в зависимости от их статуса.
Для вызова метода передать X-Login и X-Password в Headers запроса.
Также, необходимо в теле запроса передать JSON объект.
Дополнительно можно указать диапазон поиска операций, используя query параметры.
Запрос
Метод: POST https://business.selfwork.ru/selfemployed/business/v1/payouts/info-by-individuals
Query Parameters
Параметр | Тип | Описание |
---|---|---|
dateStart | string | Дата начала выборки (если не указана, то берётся с самой первой записи). Пример: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
dateEnd | string | Дата окончания выборки (если не указана, то берётся текущая дата). Пример: yyyy-MM-dd'T'HH:mm:ss.SSSZ |
Headers
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
X-Login | string | Да | Логин пользователя |
X-Password | string | Да | Пароль пользователя |
Request Body
Тип | Обязательный | Описание |
---|---|---|
array[payoutsInfoRequest] | Да | Массив объектов запроса информации о выплатах |
payoutsInfoRequest
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
idIndividual | int32 | Да | Идентификатор СЗ |
state | int32 | Да | Статус операции |
Пример
- cURL
curl -X POST "https://business.selfwork.ru/selfemployed/business/v1/payouts/info-by-individuals?dateStart=2025-01-01T00:00:00.000Z&dateEnd=2025-07-09T23:59:59.999Z" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here" \
-H "Content-Type: application/json" \
-d '[
{
"idIndividual": 12345,
"state": 1
},
{
"idIndividual": 67890,
"state": 4
},
{
"idIndividual": 11111,
"state": 8
}
]'
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
[
{
"idIndividual": 15,
"payouts": [
{
"sum": 125000,
"state": 3,
"billLink": "https://himself-ktr.nalog.ru/api/v1/receipt/220807908487/0009xxpxss/print",
"taxEstimated": 15000,
"billDate": "2020-03-06 02:14:38.005599",
"sumComm": 10,
"comment": "Comment 1",
"requisite": {
"idSelfemployedReq": 1,
"card": "4612********2441",
"account": "4612********2441",
"bik": 11331655315153,
"type": "CARD;BANK_ACCOUNT"
}
}
]
}
]
Описание ответа:
Ключ | Описание |
---|---|
idIndividual | Идентификатор СЗ |
payouts | Массив операций |
sum | Сумма операции в копейках |
state | Статус операции |
billLink | Ссылка на чек |
taxEstimated | Сумма захолдированного налога в копейках |
billDate | Дата регистрации чека |
sumComm | Сумма онлайн комиссии |
comment | Комментарий к выплате |
requisite | Объект реквизитов |
idSelfemployedReq | Идентификатор реквизитов |
card | Номер карты |
account | Номер расчетного счета |
bik | БИК банка |
type | Тип реквизитов |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
Ключ | Описание |
---|---|
errorCode | Код ошибки, вернувшийся с сервера |
message | Сообщение сервера, описывающее ошибку |
Справочник статусов операции (state)
Статус | Описание |
---|---|
0 | Новая |
1 | Проверена (готово к созданию операции выплаты) |
2 | Ошибка, выплатить нельзя |
3 | В процессе выплаты |
4 | Успешно выплачена |
5 | Ошибка в процессе оплаты |
6 | Ошибка в процессе оплаты из-за превышения лимитов |
7 | Ручное проведение |
8 | Сетевая ошибка |
9 | Акт на подписании |
10 | Акт подписан |
11 | Акт отклонен |
12 | Выплата производится повторно |
13 | Недостаточный баланс |
14 | Все |