Перейти к основному содержимому

Получение информации об операциях самозанятых

Метод API предназначен для получения информации о реестрах в зависимости от их статуса.

Для вызова метода передать X-Login и X-Password в Headers запроса.

Также, необходимо в теле запроса передать JSON объект.

Дополнительно можно указать диапазон поиска операций, используя query параметры.

Запрос

Метод: POST https://business.selfwork.ru/selfemployed/business/v1/payouts/info-by-individuals

Query Parameters

ПараметрТипОписание
dateStartstringДата начала выборки (если не указана, то берётся с самой первой записи). Пример: yyyy-MM-dd'T'HH:mm:ss.SSSZ
dateEndstringДата окончания выборки (если не указана, то берётся текущая дата). Пример: yyyy-MM-dd'T'HH:mm:ss.SSSZ

Headers

ПараметрТипОбязательныйОписание
X-LoginstringДаЛогин пользователя
X-PasswordstringДаПароль пользователя

Request Body

ТипОбязательныйОписание
array[payoutsInfoRequest]ДаМассив объектов запроса информации о выплатах

payoutsInfoRequest

ПараметрТипОбязательныйОписание
idIndividualint32ДаИдентификатор СЗ
stateint32ДаСтатус операции

Пример

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
}
]'

Ответы

Запрос выполнен успешно

[
{
"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Тип реквизитов

Справочник статусов операции (state)

СтатусОписание
0Новая
1Проверена (готово к созданию операции выплаты)
2Ошибка, выплатить нельзя
3В процессе выплаты
4Успешно выплачена
5Ошибка в процессе оплаты
6Ошибка в процессе оплаты из-за превышения лимитов
7Ручное проведение
8Сетевая ошибка
9Акт на подписании
10Акт подписан
11Акт отклонен
12Выплата производится повторно
13Недостаточный баланс
14Все