B2B

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

Пром GET https://baas.alfabank.ru/api/semp/v1/selfemployed/income/{requestId}

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

Scope

as-accrual-and-debt

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

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

Bearer {access_token}, полученный по Authorization Code Flow

Accept
stringrequired

application/json

Content-Type
stringoptional

application/json

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

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

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

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

Пример ответа 200 (OK)
{
    "status": "SUCCESS",
    "receipts": [
        {
            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2gss1c931r/print",
            "totalAmount": 2,
            "receiptId": "2gss1c931r",
            "incomeType": "FROM_LEGAL_ENTITY",
            "requestDate": "2023-09-26T09:34:24Z",
            "operationDate": "2023-06-30T20:41:20Z",
            "taxPeriodId": "202306",
            "taxToPay": 0.12,
            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
            "services": [
                {
                    "amount": 2.00,
                    "name": "Курьерс",
                    "quantity": 1
                }
            ]
        },
        {
            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2ne2j0e9jj/print",
            "totalAmount": 2,
            "receiptId": "2ne2j0e9jj",
            "incomeType": "FROM_LEGAL_ENTITY",
            "requestDate": "2023-10-06T05:34:24Z",
            "operationDate": "2023-06-30T20:38:47Z",
            "taxPeriodId": "202306",
            "taxToPay": 0.12,
            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
            "services": [
                {
                    "amount": 2.00,
                    "name": "Курьерс",
                    "quantity": 1
                }
            ]
        }
    ]
}
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 банка/платформы-партнера

array of objectoptional

Список услуг

amount
stringoptional

Цена услуги

name
stringoptional

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

quantity
integeroptional

Количество

Пример ответа 200 (OK)
{
    "status": "SUCCESS",
    "receipts": [
        {
            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2gss1c931r/print",
            "totalAmount": 2,
            "receiptId": "2gss1c931r",
            "incomeType": "FROM_LEGAL_ENTITY",
            "requestDate": "2023-09-26T09:34:24Z",
            "operationDate": "2023-06-30T20:41:20Z",
            "taxPeriodId": "202306",
            "taxToPay": 0.12,
            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
            "services": [
                {
                    "amount": 2.00,
                    "name": "Курьерс",
                    "quantity": 1
                }
            ]
        },
        {
            "link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/936144570006/2ne2j0e9jj/print",
            "totalAmount": 2,
            "receiptId": "2ne2j0e9jj",
            "incomeType": "FROM_LEGAL_ENTITY",
            "requestDate": "2023-10-06T05:34:24Z",
            "operationDate": "2023-06-30T20:38:47Z",
            "taxPeriodId": "202306",
            "taxToPay": 0.12,
            "partnerCode": "f16408b1-5cf8-4938-b3da-f05e5b51db7d",
            "services": [
                {
                    "amount": 2.00,
                    "name": "Курьерс",
                    "quantity": 1
                }
            ]
        }
    ]
}
error
stringrequired

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

error_description
stringoptional

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

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

Код ошибки. Принимает возможные значения: invalid_token - Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам

error_description
stringoptional

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

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

Код ошибки. Принимает возможные значения: insufficient_scope - У пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied - Доступ к счету запрещен

error_description
stringoptional

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

Пример ошибки 403 (Forbidden)
{
  "error": "insufficient_scope",
  "error_description": "The request requires higher privileges than provided by the access token"
}
Нет тела ответа
error
stringrequired

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

error_description
stringoptional

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

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

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

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