Получение информации по всем реестрам за определённый период
Метод API возвращает информацию по всем реестрам за указанный временной диапазон.
Для вызова метода необходимо передать X-Login и X-Password в Headers запроса.
Для указания временного периода, используются query параметры: dateStart и dateEnd.
Запрос
Метод: GET https://business.selfwork.ru/selfemployed/business/v1/payouts/info-on-all
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 | Да | Пароль пользователя |
Пример
- cURL
curl -X GET "https://business.selfwork.ru/selfemployed/business/v1/payouts/info-on-all?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"
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
[
{
"id": 20,
"state": 0,
"comment": "Comment",
"individualPayouts": [
{
"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"
}
}
]
}
],
"autoGenerateDocs": true
}
]
Описание ответа:
| Ключ | Тип | Описание |
|---|---|---|
| id | int32 | Идентификатор реестра |
| state | int32 | Статус реестра |
| comment | string | Комментарий к реестру |
| individualPayouts | array[object] | Массив операций СЗ |
| autoGenerateDocs | boolean | Автоматическая генерация документа |
individualPayouts:
| Ключ | Тип | Описание |
|---|---|---|
| idIndividual | int32 | Идентификатор СЗ |
| payouts | array[object] | Массив операций СЗ |
payouts:
| Ключ | Тип | Описание |
|---|---|---|
| sum | int32 | Сумма операции в копейках |
| state | int32 | Статус операции |
| billLink | string | Ссылка на чек |
| taxEstimated | int32 | Сумма захолдированного налога в копейках |
| billDate | string | Дата регистрации чека |
| sumComm | int32 | Сумма онлайн комиссии |
| comment | string | Комментарий к выплате |
| requisite | object | Объект реквизитов |
requisite:
| Ключ | Тип | Описание |
|---|---|---|
| idSelfemployedReq | int32 | Идентификатор реквизитов |
| card | string | Номер карты |
| account | string | Номер расчетного счета |
| bik | int64 | БИК банка |
| type | string | Тип реквизитов |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |
Справочник статусов (state)
| Статус | Описание |
|---|---|
| 0 | Новый |
| 1 | Предварительная обработка (резерв на перенос обработки в шлюзы, не финальный) |
| 2 | Проверен, нет ошибок (проверка - это будем делать в кабинете, не финальный) |
| 3 | Проверен, есть ошибки (проверка - это будем делать в кабинете, не финальный) |
| 4 | Обработан (все выплаты успешны, статус финальный, с реестром более ничего делать нельзя) |
| 5 | Обработан, есть ошибки (по некоторым выплатам реестра операции не созданы или в ошибке, статус финальный, с реестром более ничего делать нельзя) |
| 6 | Ошибка обработки (все выплаты в ошибке, операции не созданы, реестр можно редактировать) |
| 7 | Проверен, нельзя создать выплаты |
| 8 | В процессе выплаты |