B2BH2H

Получение статуса обработки выплат, загруженных в систему

Песочница
GET https://sandbox.alfabank.ru/api/semp/v1/payouts/registries/{requestId}
Пром
GET https://baas.alfabank.ru/api/semp/v1/payouts/registries/{requestId}
Scope

as-receipt-and-payout, as-receipt, as-payout-with-check-status, as-payout

Параметры запроса

HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

Content-Type
stringoptional

application/json

PATH
Атрибут
Описание
requestId
stringrequired

Уникальный идентификатор запроса

QUERY
Атрибут
Описание
limit
integeroptional

Количество объектов на одной странице

offset
integeroptional

Количество объектов в списке, которые необходимо пропустить

Пример запроса 
1curl -X GET https://baas.alfabank.ru/api/semp/v1/payouts/registries/4e817e78-5876-4608-a873-bcc141454045?limit=1000&offset=0 \
2  -H 'Accept: application/json' \
3  -H 'Authorization: Bearer {access-token}' \
4  -H 'Content-Type: application/json'

Параметры ответа

Пример ответа 200 (ОК) 
1{
2  "pagination": {
3    "limit": 1000,
4    "offset": 0,
5    "totalCount": 10000
6  },
7  "requestId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
8  "externalId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
9  "createdDate": "2023-03-28T08:46:23.462Z",
10  "listStatus": "NEW",
11  "error": {
12    "code": "Код ошибки",
13    "message": "Описание ошибки"
14  },
15  "statementList": [
16    {
17      "payoutId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
18      "selfemployed": {
19        "vatin": "112233445566",
20        "surname": "Иванов",
21        "name": "Иван",
22        "patronymic": "Иванoвич"
23      },
24      "payoutRequisite": {
25        "payoutType": "ACCOUNT",
26        "fee": "1.50",
27        "byAccount": {
28          "accountNumber": "40817810306050000000",
29          "bic": "044525593",
30          "purpose": "Курьерские услуги за период с 1.12.2020-20.12.2020",
31          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
32        },
33        "byPan": {
34          "pan": "wS7fElYo8VWeJ8KelaJ0XA==",
35          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
36        },
37        "byPhone": {
38          "phone": "79998887766",
39          "bankId": "100000000001",
40          "clientId": "E6ec9146-A851-3b0f-FF5C-D9137EEDacc2",
41          "checkFIO": true,
42          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
43        },
44        "payoutTotalAmount": "10.00"
45      },
46      "receiptRequisite": {
47        "customerVatin": "5566778899",
48        "customerName": "ООО Петуния",
49        "incomeType": "FROM_LEGAL_ENTITY",
50        "operateDate": "2023-03-28T08:46:23.463Z",
51        "requestDate": "2023-03-28T08:46:23.463Z",
52        "services": [
53          {
54            "amount": "10.00",
55            "name": "Курьерские услуги за период с 1.12.2020-20.12.2020",
56            "quantity": 1
57          }
58        ],
59        "receiptTotalAmount": "10.00"
60      },
61      "receiptLink": {
62        "receiptId": "200wr5cn4s",
63        "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/252530829203/200wr5cn4s/print"
64      },
65      "receiptStatus": {
66        "status": "READY",
67        "updatedDate": "2023-03-28T08:46:23.463Z"
68      },
69      "payoutStatus": {
70        "status": "READY",
71        "updatedDate": "2023-03-28T08:46:23.463Z"
72      },
73      "errorRecord": [
74        {
75          "field": "Наименование поля в котором возникла ошибка",
76          "message": "Описание ошибки"
77        }
78      ]
79    }
80  ]
81}
objectoptional

Данные пагинации

limit
integeroptional

Количество записей на одной странице

offset
integeroptional

Количество записей в списке, которые были пропущены

totalCount
integeroptional

Общее количество записей

requestId
stringoptional

Уникальный идентификатор запроса

externalId
stringoptional

Внешний идентификатор запроса, переданный Клиентом

createdDate
stringoptional

Дата и время создания запроса в системе

listStatus
stringoptional

Статус исполнения загруженного списка выплат. Принимает возможные значения:

  • •
    Промежуточные статусы: PREPARED - реестр получен и сохранён, но ещё не взят в обработку; TOTAL_AMOUNT_CALCULATED - общая сумма средств по реестру подсчитана; IN_PROGRESS - в обработке; WAITING - ожидает поступления средств; BALANCE_CHECKED - на счёте достаточно средств для выплат; SIGNATURE_CHECKED - подпись проверена; WAITING_FOR_ACCEPT - реестр ожидает подтверждения; ACCEPTED - реестр подтверждён; CLIENT_ACCOUNT_CHECKED - счёт Клиента проверен в админ-модуле; CLIENT_ACCOUNT_EQ_CHECKED - счёт Клиента прошёл проверку в Банке; PAYOUT_TIME_CHECKED - проверка времени загрузки реестра выполнена; MANUAL_ACCEPTANCE - содержимое реестра уже есть в системе. Необходимо подтвердить или отклонить обработку реестра; MANUAL_ACCEPTED - обработка реестра-дубля подтверждена.
  • •
    Финальные статусы: NEW - принят для последующей обработки; FAILED_SIGNATURE - подпись не прошла проверку; OUT_OF_DATE - реестр отправлен после окончания операционного дня, необходима повторная отправка в операционный день; SUCCESS - реестр успешно обработан; UNCONFIRMED - реестр не был подтверждён; FAILED_COMPLIANCE - комплаенс-проверка не пройдена; FAILED_ACCOUNT_CHECK - счёт Клиента не прошёл проверку в админ-модуле; FAILED_ACCOUNT_EQ_CHECK - счёт Клиента не прошёл проверку в Банке; TECHNICAL_ERROR - непредвиденная ошибка; FAILED_BALANCE - недостаточно средств на счёте для выполнения выплат; ERROR - ошибка при обработке
objectoptional

Ошибки обработки загруженного списка

code
stringoptional

Код ошибки

message
stringoptional

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

array of objectoptional

Список чеков и выплат в системе

payoutId
stringoptional

Внешний идентификатор выплаты, переданный Клиентом

objectoptional

Персональные данные самозанятого

vatin
stringoptional

ИНН самозанятого

surname
stringoptional

Фамилия

name
stringoptional

Имя

patronymic
stringoptional

Отчество

objectoptional

Платёжные реквизиты получателя

payoutType
stringoptional

Тип выплаты. Принимает возможные значения:

  • •
    ACCOUNT - выплата по реквизитам счёта получателя;
  • •
    CARD - выплата на банковскую карту получателя;
  • •
    PHONE - выплата через СБП по номеру телефона
fee
stringoptional

Размер комиссии

objectoptional

Реквизиты для проведения выплаты на счёт получателя

accountNumber
stringoptional

Номер счёта получателя

bic
stringoptional

БИК банка получателя

purpose
stringoptional

Назначение платежа

comment
stringoptional

Комментарий к платежу

objectoptional

Реквизиты для проведения выплаты на карту получателя

pan
stringoptional

Номер карты получателя в зашифрованном виде

comment
stringoptional

Комментарий к платежу

objectoptional

Реквизиты для проведения выплаты по номеру телефона получателя

phone
stringoptional

Номер телефона

bankId
stringoptional

Идентификатор банка получателя

clientId
stringoptional

Идентификатор клиента в системе B2CPay

checkFIO
stringoptional

Флаг проверки совпадения ФИО получателя. Принимает возможные значения:

  • •
    true - выполнять, если совпадения по ФИО нет, не проводить платёж, иначе - выполнять проверку, при несовпадении ФИО проводить платёж
comment
stringoptional

Комментарий к платежу

payoutTotalAmount
stringoptional

Сумма выплаты

objectoptional

Реквизиты чека

customerVatin
stringoptional

ИНН покупателя

customerName
stringoptional

Наименование компании покупателя

incomeType
stringoptional

Тип дохода. Принимает возможные значения:

  • •
    FROM_INDIVIDUAL - доход от физического лица;
  • •
    FROM_LEGAL_ENTITY - доход от юридического лица или ИП;
  • •
    FROM_FOREIGN_AGENCY - доход от иностранной организации
operateDate
stringoptional

Дата расчёта с самозанятым, которая будет указана в чеке

requestDate
stringoptional

Дата запроса на формирование чека

array of objectoptional

Список услуг

amount
stringoptional

Цена услуги

name
stringoptional

Наименование услуги для регистрации дохода

quantity
integeroptional

Количество услуг. Согласно текущей спецификации ФНС всегда должно быть равно 1

receiptTotalAmount
stringoptional

Сумма чека

objectoptional

Референс чека

receiptId
stringoptional

Идентификатор чека в ФНС

link
stringoptional

Ссылка на чек с сайта ФНС

objectoptional

Статус чека

status
stringoptional

Статус чека в системе. Принимает возможные значения:

  • •
    NEW - принят для последующей обработки;
  • •
    READY - успешно зарегистрирован;
  • •
    FAILED - ошибка в процессе регистрации или сторнирования;
  • •
    IN_PROGRESS - в процессе регистрации;
  • •
    CANCELED_BY_CLIENT - аннулирован Клиентом;
  • •
    CANCELED_AUTOMATICALLY - аннулирован автоматически системой;
  • •
    FAILED_CANCEL - ошибка в процессе аннулирования;
  • •
    CANCELED_IN_PROGRESS - в процессе аннулирования;
  • •
    CANCEL_REQUESTED - запрос на аннулирование чека отправлен в ФНС;
  • •
    CANCEL_INCOME_REQUESTED_AUTOMATICALLY - отправлен запрос в ФНС на аннулирование чека;
  • •
    CHECK_REFUND - проконтролируйте возврат суммы сторнированного дохода на счёт;
  • •
    PARTNER_INFO - чек был передан клиентом;
  • •
    ALREADY_CANCELED - чек уже был отменён
updatedDate
stringoptional

Дата и время обновления статуса чека в системе

objectoptional

Статус выплаты

status
stringoptional

Статус выплаты в системе. Принимает возможные значения:

  • •
    NEW - принята для последующей обработки;
  • •
    READY - успешно исполнена;
  • •
    FAILED - ошибка в процессе исполнения;
  • •
    IN_PROGRESS - в процессе исполнения;
  • •
    WAITING - ожидает поступления средств;
  • •
    BIND_CHECKED - проверка привязки самозанятого к компании успешна;
  • •
    SELFEMPLOYED_CHECKED - проверка самозанятого успешна;
  • •
    BALANCE_CHECKED - баланса достаточно;
  • •
    SELFEMPLOYED_TAXPAYER_CHECK - статус самозанятого проверяется в ФНС;
  • •
    PAYMENT_IN_PROGRESS - выплата в обработке;
  • •
    INCOME_REGISTRATION_REQUESTED - отправлен запрос в ФНС на регистрацию чека;
  • •
    TECHNICAL_ERROR - техническая ошибка;
  • •
    FAILED_SELFEMPLOYED_CHECK - самозанятый не имеет статус;
  • •
    READY- успешно исполнена;
  • •
    FAILED_SELFEMPLOYED_TAXPAYER_CHECK - самозанятый не прошёл проверку статуса в ФНС;
  • •
    FAILED_BIND_CHECK - самозанятый не привязан к компании;
  • •
    FAILED_EQ_ACCOUNT_PAY - внутренняя ошибка выплаты в Банке;
  • •
    REGISTRATION_RESTRICTIONS_IN_PROGRESS - статус самозанятого в процессе проверки в ФНС;
  • •
    FULL_NAME_CHECKED - ФИО проверено;
  • •
    FAILED_FULL_NAME_CHECK - проверка ФИО неуспешна;
  • •
    PAYMENT_DEFERRED - проведение выплаты отложена;
  • •
    AWAIT_EXTERNAL - внешний платёж ожидает исполнения;
  • •
    COMPLIANCE_CHECKED - комплаенс проверка пройдена;
  • •
    FAILED_COMPLIANCE - комплаенс проверка не была пройдена;
  • •
    FAILED_SIGNATURE - подпись не прошла проверку;
  • •
    SIGNATURE_CHECKED - подпись проверена;
  • •
    AWAIT_MANUAL_ACCEPTANCE - выплата ожидает подтверждения реестра-дубля
updatedDate
stringoptional

Дата и время обновления статуса выплаты в системе

objectoptional

Ошибки обработки записей списка

field
stringoptional

Наименование поля, в котором возникла ошибка

message
stringoptional

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

Пример ответа 200 (ОК) 
1{
2  "pagination": {
3    "limit": 1000,
4    "offset": 0,
5    "totalCount": 10000
6  },
7  "requestId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
8  "externalId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
9  "createdDate": "2023-03-28T08:46:23.462Z",
10  "listStatus": "NEW",
11  "error": {
12    "code": "Код ошибки",
13    "message": "Описание ошибки"
14  },
15  "statementList": [
16    {
17      "payoutId": "e82331bd-28ac-481b-b7c3-e03673abc20b",
18      "selfemployed": {
19        "vatin": "112233445566",
20        "surname": "Иванов",
21        "name": "Иван",
22        "patronymic": "Иванoвич"
23      },
24      "payoutRequisite": {
25        "payoutType": "ACCOUNT",
26        "fee": "1.50",
27        "byAccount": {
28          "accountNumber": "40817810306050000000",
29          "bic": "044525593",
30          "purpose": "Курьерские услуги за период с 1.12.2020-20.12.2020",
31          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
32        },
33        "byPan": {
34          "pan": "wS7fElYo8VWeJ8KelaJ0XA==",
35          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
36        },
37        "byPhone": {
38          "phone": "79998887766",
39          "bankId": "100000000001",
40          "clientId": "E6ec9146-A851-3b0f-FF5C-D9137EEDacc2",
41          "checkFIO": true,
42          "comment": "Курьерские услуги за период с 1.12.2020-20.12.2020"
43        },
44        "payoutTotalAmount": "10.00"
45      },
46      "receiptRequisite": {
47        "customerVatin": "5566778899",
48        "customerName": "ООО Петуния",
49        "incomeType": "FROM_LEGAL_ENTITY",
50        "operateDate": "2023-03-28T08:46:23.463Z",
51        "requestDate": "2023-03-28T08:46:23.463Z",
52        "services": [
53          {
54            "amount": "10.00",
55            "name": "Курьерские услуги за период с 1.12.2020-20.12.2020",
56            "quantity": 1
57          }
58        ],
59        "receiptTotalAmount": "10.00"
60      },
61      "receiptLink": {
62        "receiptId": "200wr5cn4s",
63        "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/252530829203/200wr5cn4s/print"
64      },
65      "receiptStatus": {
66        "status": "READY",
67        "updatedDate": "2023-03-28T08:46:23.463Z"
68      },
69      "payoutStatus": {
70        "status": "READY",
71        "updatedDate": "2023-03-28T08:46:23.463Z"
72      },
73      "errorRecord": [
74        {
75          "field": "Наименование поля в котором возникла ошибка",
76          "message": "Описание ошибки"
77        }
78      ]
79    }
80  ]
81}
Нет тела ответа
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    invalid_request - неверные входные параметры запроса
error_description
stringoptional

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

Пример ошибки 400 (Bad Request) 
1{
2  "error": "invalid_request",
3  "error_description": "Authorization header is not present in request headers"
4}
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    invalid_token - предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
error_description
stringoptional

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

Пример ошибки 401 (Unauthorized) 
1{
2  "error": "invalid_token",
3  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    insufficient_scope - при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметра prompt=consent;
  • •
    access_denied - доступ к счёту запрещён
error_description
stringoptional

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

Пример ошибки 403 (Forbidden) 
1{
2  "error": "insufficient_scope",
3  "error_description": "The request requires higher privileges than provided by the access token"
4}
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    unknown_endpoint - эндпоинт не найден или неактивен
error_description
stringoptional

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

Пример ошибки 404 (Not Found) 
1{
2  "error": "unknown_endpoint",
3  "error_description": "Endpoint is not found or not active"
4}
Нет тела ответа
error
stringrequired

Код ошибки. Принимает возможные значения:

  • •
    internal_error - внутренняя ошибка сервиса при выполнении обработки запроса
error_description
stringoptional

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

Пример ошибки 500 (Internal Server Error) 
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
Нет тела ответа

Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.

Проведение выплат самозанятым, включая незарегистрированных в системе, без формирования чекаПодтверждение или отклонение отправки реестра-дубля