B2BH2H

Получение информации по зарегистрированным доходам с разбивкой по чекам

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

as-accrual-and-debt

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

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

application/json

Content-Type
stringoptional

application/json

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

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

Пример запроса 
1curl -X GET https://baas.alfabank.ru/api/semp/v1/selfemployed/income/83ca6d9b-4c72-4044-bcee-789b36c1943f \
2  -H 'Accept: application/json' \
3  -H 'Authorization: Bearer {access-token}' \
4  -H 'Content-Type: application/json'

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

Пример ответа 200 (OK) 
1{
2    "status": "SUCCESS",
3    "receipts": [
4        {
5            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2gss1c931r/print",
6            "totalAmount": 2,
7            "receiptId": "2gss1c931r",
8            "incomeType": "FROM_LEGAL_ENTITY",
9            "requestDate": "2023-09-26T09:34:24Z",
10            "operationDate": "2023-06-30T20:41:20Z",
11            "taxPeriodId": "202306",
12            "taxToPay": 0.12,
13            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
14            "cancelationTime": "2024-05-07T11:56:46.482Z",
15            "services": [
16                {
17                    "amount": 2.00,
18                    "name": "Курьерс",
19                    "quantity": 1
20                }
21            ]
22        },
23        {
24            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2ne2j0e9jj/print",
25            "totalAmount": 2,
26            "receiptId": "2ne2j0e9jj",
27            "incomeType": "FROM_LEGAL_ENTITY",
28            "requestDate": "2023-10-06T05:34:24Z",
29            "operationDate": "2023-06-30T20:38:47Z",
30            "taxPeriodId": "202306",
31            "taxToPay": 0.12,
32            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
33            "cancelationTime": "2024-05-07T11:56:46.482Z",
34            "services": [
35                {
36                    "amount": 2.00,
37                    "name": "Курьерс",
38                    "quantity": 1
39                }
40            ]
41        }
42    ]
43}
status
stringoptional

Статус

array of objectoptional

Список полученных чеков

receiptId
stringoptional

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

totalAmount
stringoptional

Сумма чека

link
stringoptional

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

incomeType
stringoptional

Тип дохода. Принимает возможные значения: FROM_INDIVIDUAL - доход от физического лица; FROM_LEGAL_ENTITY - доход от юридического лица или ИП; FROM_FOREIGN_AGENCY - доход от иностранной организации

requestDate
stringoptional

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

operateDate
stringoptional

Дата расчёта с самозанятым

taxPeriodId
stringoptional

Налоговый период, в котором при расчёте налога будет/был учтён чек

taxToPay
stringoptional

Налог к уплате с данного чека: начисленный налог - использованный бонус

partnerCode
stringoptional

ID банка / платформы-партнёра

cancelationTime
stringoptional

Дата сторнирования

array of objectoptional

Список услуг

amount
stringoptional

Цена услуги

name
stringoptional

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

quantity
integeroptional

Количество

Пример ответа 200 (OK) 
1{
2    "status": "SUCCESS",
3    "receipts": [
4        {
5            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2gss1c931r/print",
6            "totalAmount": 2,
7            "receiptId": "2gss1c931r",
8            "incomeType": "FROM_LEGAL_ENTITY",
9            "requestDate": "2023-09-26T09:34:24Z",
10            "operationDate": "2023-06-30T20:41:20Z",
11            "taxPeriodId": "202306",
12            "taxToPay": 0.12,
13            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
14            "cancelationTime": "2024-05-07T11:56:46.482Z",
15            "services": [
16                {
17                    "amount": 2.00,
18                    "name": "Курьерс",
19                    "quantity": 1
20                }
21            ]
22        },
23        {
24            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2ne2j0e9jj/print",
25            "totalAmount": 2,
26            "receiptId": "2ne2j0e9jj",
27            "incomeType": "FROM_LEGAL_ENTITY",
28            "requestDate": "2023-10-06T05:34:24Z",
29            "operationDate": "2023-06-30T20:38:47Z",
30            "taxPeriodId": "202306",
31            "taxToPay": 0.12,
32            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
33            "cancelationTime": "2024-05-07T11:56:46.482Z",
34            "services": [
35                {
36                    "amount": 2.00,
37                    "name": "Курьерс",
38                    "quantity": 1
39                }
40            ]
41        }
42    ]
43}
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

Код ошибки. Принимает возможные значения: internal_error - внутренняя ошибка сервиса при выполнении обработки запроса

error_description
stringoptional

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

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

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

Запрос информации по зарегистрированным доходам с разбивкой по чекамЗапрос информации о состоянии Лицевого счёта самозанятого