B2BH2H

Аннулирование чеков в ФНС

Песочница
POST https://sandbox.alfabank.ru/api/semp/v1/payouts/registries/cancel-receipts
Пром
POST https://baas.alfabank.ru/api/semp/v1/payouts/registries/cancel-receipts
Scope

as-receipt, as-receipt-and-payout

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

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

application/json

Content-Type
stringrequired

application/json

BODY
Атрибут
Описание
externalId
stringrequired

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

array of objectrequired

Список аннулируемых чеков. Не более 10 самозанятых в запросе

vatin
stringrequired

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

array of objectrequired

Реквизиты аннулируемых чеков. Не более 1 чека для 1 самозанятого

receiptId
stringrequired

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

cancelReasonCode
stringrequired

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

array of objectrequired

Электронная подпись УЛ Клиента

base64Encoded
stringrequired

Значение электронной подписи, закодированное в Base64

signatureType
stringrequired

Тип электронной подписи. Возможные значения: RSA - RSA; KEP - КЭП

poaNumber
stringoptional

Номер машиночитаемой доверенности

Пример запроса
1curl -X POST https://baas.alfabank.ru/api/semp/v1/payouts/registries/cancel-receipts \
2  -H 'Accept: application/json' \
3  -H 'Authorization: Bearer {access-token}' \
4  -H 'Content-Type: application/json'
5  -d '{
6  "externalId": "f8c1ffe6-696b-4e35-994f-904a9187806d",
7  "cancelReceipt": [
8    {
9      "vatin": "585414307054",
10      "receipt": [
11        {
12          "receiptId": "26o3rf60af",
13          "cancelReasonCode": "REGISTRATION_MISTAKE"
14        }
15      ]
16    }
17  ],
18  "digestSignatures": [
19        {
20          "base64Encoded": "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",
21          "signatureType": "RSA",
22          "poaNumber": "DOVER_CBR_7702235133_20211102_1"
23        }
24    ]
25  }'

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

Пример ответа 200 (ОК)
1{
2  "requestId": "9cf7ccbf-c72a-4cff-8e1a-9e4b4dd486d2",
3  "externalId": "f8c1ffe6-696b-4e35-994f-904a9187806d"
4}
requestId
stringoptional

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

externalId
stringoptional

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

Пример ответа 200 (ОК)
1{
2  "requestId": "9cf7ccbf-c72a-4cff-8e1a-9e4b4dd486d2",
3  "externalId": "f8c1ffe6-696b-4e35-994f-904a9187806d"
4}
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}
Нет тела ответа

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