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

Метод 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

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

[
  {
    "idIndividual": 15,
    "payouts": [
      {
        "idCertificate": 1234567,
        "idContract": 1234567,
        "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": 100,
        "comment": "Comment 1",
        "partnerCommission": 100,
        "requisite": {
          "idSelfemployedReq": 1,
          "card": "4612********2441",
          "account": "4612********2441",
          "bik": 11331655315153,
          "type": "CARD;BANK_ACCOUNT"
        }
      }
    ]
  }
]

Описание ответа:

Ключ	Описание
idIndividual	Идентификатор СЗ
idCertificate	Идентификатор акта выполненных работ
idContract	Идентификатор договора
payouts	Массив операций
sum	Сумма операции в копейках
state	Статус операции
billLink	Ссылка на чек
taxEstimated	Сумма захолдированного налога в копейках
billDate	Дата регистрации чека
sumComm	Сумма онлайн комиссии
comment	Комментарий к выплате
requisite	Объект реквизитов
idSelfemployedReq	Идентификатор реквизитов
card	Номер карты
account	Номер расчетного счета
bik	БИК банка
type	Тип реквизитов
partnerCommission	Сумма аренды в копейках

401: Unauthorized

Не валидные авторизационные данные

{
  "errorCode": 1,
  "message": "Access denied"
}

500: Internal Server Error

Системная ошибка

{
  "errorCode": 100,
  "message": "Internal server error"
}

Описание ошибки:

Ключ	Описание
errorCode	Код ошибки, вернувшийся с сервера
message	Сообщение сервера, описывающее ошибку

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

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