Запрос НА направление документов участником ИО в системе «вычеты»

Инициатор вызова: участник ИО.

Процедура вызывается для направления документов по применению инвестиционных и имущественных налоговых вычетов физическим лицом в упрощенном порядке.

URL: /taxbenefits/v1/application/{documentType}

Method: POST

Query-parameters (PostTaxBenefitRequest)

Содержание	Тип	Обязательность	Описание
documentType	String	Обязательно	Код документа 001 – запрос об имеющихся в налоговых органах сведениях, необходимых для предоставления инвестиционного налогового вычета, предусмотренного пп. 3 п.1 ст. 219.1 НК РФ 002 – сообщение о совершенных физическим лицом сделках, необходимые для предоставления инвестиционного налогового вычета, предусмотренного пп. 2 п.1 ст. 219.1 НК РФ 003 – сообщение о совершенных физическим лицом сделках, необходимые для предоставления имущественного налогового вычета, предусмотренного пп. 3 и 4 п.1 ст. 220 НК РФ

Тело запрос (PostTaxBenefitRequest)

Содержание	Тип	Обязательность	Описание
contentBase64	String, Base64	Обязательно	XML с заявлением на налоговый или имущественный вычет закодированное в Base64
contentSignatureBase64	String, Base64	Обязательно	Отсоединенная подпись документа, закодированная в Base64

Ответ (PostTaxBenefitResponse)

Содержание	Тип	Обязательность	Описание
requestId	String	Обязательно	Идентификатор сообщения. Совпадает с X-Request_Id указанным при создании запроса со стороны участника ИО или назначается системой автоматически, если X-Request_Id не был указан
acknowledgeTime	String	Не обязательно	Дата получения документа
status	String	Обязательно	Статус обработки запроса. Возможные значения: OK – запрос взят в обработку ERROR – ошибка при регистрации
error	Struct	Не обязательно	Содержит информацию о возникших ошибках при обработке запроса
· code	String	Обязательно	Код ошибки
· message	String	Обязательно	Описание ошибки
· additionalInfo	Struct, String	Не обязательно	Набор дополнительных атрибутов ошибки. Может быть использован для составления более детального запроса в службу технической поддержки. Пример: "additionalInfo": { "tpFio": "Иванов Иван Иванович", "tpInn": "5212345678" }

Бизнес-логика

Запрос направляется в компонент системы «Вычеты» с использованием технологии синхронного взаимодействия. Логика формирования запроса аналогична запросу 2.1. Регистрация участника ИО в системе «Вычеты».

На входе проводится контроль запроса согласно разделу 1.2. Проверка токена участника ИО. Для проверки корректности и возможности обработки данного запроса проводятся следующие проверки:

1. Проверка отправителя запроса. В БД должна содержаться информация об участнике ИО. Если запись о нем не найдена (ранее не был получен корректный запрос на регистрацию /taxbenefits/v1/registration, тогда направляется сообщение с ошибкой. Пример такого сообщения:

{

"requestId": "4ad76228-517f-4496-aa6c-eef36d3de35a",

"acknowledgeTime": null,

"status": "ERROR",

"error": {

"code": "partner.not.found",

"message": "Участник ИО не найден"

"additionalInfo": {}

}

}

В логи записывается информация о статусе запроса с данным X-Request-Id, статусом ERROR и информацией об ошибке. При повторном направлении данным участником ИО запроса с таким идентификатором будет направлен аналогичный ответ.

Также проводится проверка подтверждения переданных данных участником ИО при регистрации. Если регистрация не подтверждена, то участнику ИО направляется ответ формата:

{

"requestId": "4ad76228-517f-4496-aa6c-eef36d3de35a",

"acknowledgeTime": null,

"status": "ERROR",

"error": {

"code": "partner.not.registered",

"message": "Участник ИО не зарегистрирован"

"additionalInfo": {}

}

}

2. Форматно-логический контроль документа, переданный как атрибут contentBase64, на соответствие утвержденной xsd-схеме в зависимости от типа элемента documentType.

Если проверка не пройдена. Пример сообщения с ошибкой:

{

"requestId": "4ad76228-517f-4496-aa6c-eef36d3de35a",

"acknowledgeTime": null,

"status": "ERROR",

"error": {

"code": "application.xsd.failed",

"message": "Запрос 9999:5dc66951e2883063a64bd5b3fafc915d. Заявление не прошло валидацию по xsd схеме: cvc-pattern-valid: Value '1111111111555555' is not facet-valid with respect to pattern '([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}' for type 'ИННЮЛТип'.",

"additionalInfo": {

"XSD_SERIALIZE_ERROR": "cvc-pattern-valid: Value '1111111111555555' is not facet-valid with respect to pattern '([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}' for type 'ИННЮЛТип'.",

"X_REQUEST_ID": "9999:5dc66951e2883063a64bd5b3fafc915d",

       "ERROR_STEP": "FormatValidationResult"

}

}

}

3. Проверяется отсоединённая подпись, переданная как атрибут contentSignatureBase64 на соответствие переданной в сертификате публичной части ключа данного участника ИО и отсутствию изменений в документе с момента его подписания.

В случае если проверка дает отрицательный результат участнику ИО направляется сообщения следующего формата:

{

"requestId": "4ad76228-517f-4496-aa6c-eef36d3de35a",

"acknowledgeTime": null,

"status": "ERROR",

"error": {

"code": "application.xml.signature.failed",

"message": "Запрос d3d59828a8e7a73a74abc605594b5512. Xml заявление не прошло проверку подписи cryptopro",

"additionalInfo": {

"REASON": "Last unit does not have enough valid bits",

"X_REQUEST_ID": "d3d59828a8e7a73a74abc605594b5512",

"ERROR_STEP": "XmlSignatureValidationStepResult"

}

}

}

В случае положительного прохождения всех проверок документ сохраняется в системе «Вычеты». Ответ с номером заявки отправляется участнику ИО:

{

"requestId": "4ad76228-517f-4496-aa6c-eef36d3de35a",

"acknowledgeTime": "2020-09-02T23:21:02.646+03:00",

"status": "OK",

"error": null

}

В случае отрицательного прохождения проверок документ сохраняется в системе «Вычеты». Ответ с одной из ошибок, описанных выше, отправляется участнику ИО.

Описание схемы взаимодействия при направлении документов участником ИО в системе «Вычеты» представлено на рисунке 2.

Рисунок 2 – Схема взаимодействия при направлении документов участником ИО в системе «Вычеты»