Сведения о задолженности по платежам, администрируемым ФНС

Вид сведений (ВС) предназначен для обеспечения передачи ФНС сведений о задолженности по платежам, администрируемым ФНС России. ВС содержит:

Сведения запроса:
- Идентификатор запроса, сформированный запрашивающей стороной
- Сведения о налогоплательщике ФЛ или ИП (ИНН, ФИО)
- Сведения о налогоплательщике организации (ИНН, КПП, полное наименование)
Сведения ответа:
- Идентификатор запроса, сформированный запрашивающей стороной
- Дата сведений
- Сведения о задолженности:
  - Сальдо ЕНС (в том числе задолженность, приостановленная, в связи с введением процедуры банкротства, задолженность по наступившим срокам графика мирового соглашения)
  - Задолженность, приостановленная к взысканию и исполнению обязанности
  - Просроченная задолженность
  - Задолженность по неналоговым платежам (в том числе задолженность, приостановленная, в связи с введением процедуры банкротства, задолженность по наступившим срокам графика мирового соглашения)
- Сведения об обработке запроса (код обработки, описание ошибки обработки)

Во всех запросах необходимо передавать следующие HTTP-заголовки:

Название	Тип	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор магазина
`X-Signature`	string	Да	Подпись запроса

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

Запрос

Метод: POST

Production: https://api.baas.kvell.group/v1/smev3/fns/svdplgplat
Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/svdplgplat

Параметры запроса (JSON)

Название	Тип данных	Обязательно	Описание
`id_request`	строка (формат `^[a-zA-Z0-9-]{32,36}$`)	Нет	Уникальный идентификатор запроса (отправляется в ФНС)
`info_date`	string (формат `YYYY-MM-DD`)	Да	Дата сведений
`individual`	dict (см. формат ниже)	Нет	Сведения об ФЛ или ИП
`legal`	dict (см. формат ниже)	Нет	Сведения о ЮЛ

В запросе обязательно указывается individual (информация в отношении ФЛ или ИП) или legal (информация в отношении ЮЛ).
Формат individual:

Название	Тип данных	Обязательно	Описание
`inn`	string	Да	ИНН ФЛ
`first_name`	string (не более 60 символов)	Да	Имя
`last_name`	string (не более 60 символов)	Да	Фамилия
`middle_name`	string (не более 60 символов)	Да, при наличии	Отчество

Формат legal:

Название	Тип данных	Обязательно	Описание
`inn`	string	Да	ИНН ЮЛ
`kpp`	string	Нет	КПП ЮЛ
`org_name`	string (не более 1000 символов)	Нет	Полное наименование ЮЛ

{
  "info_date": "2022-01-01",
  "id_request": "df48392ecc724309be85a0817c153ae9",
  "individual":
  {
    "inn": "010000000000",
    "last_name": "Иванов",
    "first_name": "Иван",
    "middle_name": "Иванович"
  }
}

Формирование подписи

Подпись X-Signature формируется конкатенацией X-Api-Key, json <тело запроса> и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{json <тело запроса>}{secret_key})

Ответ запроса

{
  "request_id": "b48c09bc-6efb-4da4-95aa-4a85ff923425"
}

request_id — идентификатор запроса, используется для получения результата.

Получение результата проверки

Метод: GET

Production: https://api.baas.kvell.group/v1/smev3/fns/svdplgplat/{request_id}
Stage: https://api.baas.stage.kvell.group/v1/smev3/fns/svdplgplat/{request_id}

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

Название	Тип данных	Обязательно	Описание
`request_id`	string	Да	Идентификатор запроса

GET /v1/smev3/fns/svdplgplat/b48c09bc-6efb-4da4-95aa-4a85ff923425

Формирование подписи

Подпись X-Signature формируется конкатенацией X-Api-Key, request_id и secret_key. Формируется sha256 от полученной строки:

sha256({x-api-key}{request_id}{secret_key})

Ответ запроса

Пример 1Пример 2Пример 3Пример 4 (HTTP 404)

{
  "state": "in_progress",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": null
}

{
  "state": "finished",
  "request_id": "befe8815-24b0-446b-925c-ea128f39667c",
  "response_id": "df65dc1c-fc66-41cd-abbd-87218127fbeb",
  "result":
  {
    "balance_ens":
    {
      "debt_sign": "1", "tax": "40", "fees": "1", "insurance": "10", "penalty": "5", "fines": "600", "percents": "0", "enp": "50"
    },
    "debt_suspended":
    {
      "debt_sign": "1", "tax": "30", "fees": "0", "insurance": "0", "penalty": "20", "fines":"450", "percents": "40", "enp": "0"
    },
    "debt_overdue":
    {
      "debt_sign": "1", "tax": "120", "fees": "0", "insurance": "0", "penalty": "0", "fines": "30", "percents": "300", "enp": "0"
    },
    "debt_non_tax":
    {
      "debt_sign": "1", "total": "50", "regular_subsoil": "100"
    }
  }
}

{
  "state": "finished",
  "request_id": "6ed9f77b-c150-4cdb-adcf-9d70d167f6ab",
  "response_id": null,
  "error": {
    "code": "internal",
    "desc": "Ошибка соединения со СМЭВ"
  }
}

{
  "error": "request not found"
}

state — статус запроса
- in_progress — в обработке
- finished — завершён
request_id — назначенный идентификатор запроса для СМЭВ3 (опционально)
response_id — идентификатор ответа в системе СМЭВ3, если был получен ответ от ИС ведомства (ФНС)
error — ошибка от внутреннего сервиса, СМЭВ или ИС ведомства (обязательно, если state = finished и result = null)
- code — код ошибки (обязательно)
- desc — описание ошибки (обязательно)
- status_code — статусный HTTP-код от СМЭВ3 (опционально)
- destname — поле запроса, содержащее ошибку от СМЭВ (опционально)
result — результат обработки (обязательно, если state = finished и error = null)
- balance_ens — сальдо ЕНС (в том числе задолженность, приостановленная в связи с введением процедуры банкротства, задолженность по наступившим срокам графика мирового соглашения):
  - debt_sign — признак задолженности: 0 — нет, 1 — есть (обязательно)
  - tax — задолженность по налогам (необязательно)
  - fees — задолженность по сборам (включая госпошлину) (необязательно)
  - insurance — задолженность по страховым взносам (необязательно)
  - penalty — задолженность по пени (необязательно)
  - fines — задолженность по штрафам (необязательно)
  - percents — задолженность по процентам (необязательно)
  - enp — задолженность по ЕНП (необязательно)
- debt_suspended — задолженность, приостановленная к взысканию и исполнению обязанности (структура аналогична balance_ens)
- debt_overdue — просроченная задолженность (структура аналогична balance_ens)
- debt_non_tax — задолженность по неналоговым платежам (в том числе задолженность, приостановленная в связи с введением процедуры банкротства, задолженность по наступившим срокам графика мирового соглашения)
  - debt_sign — признак задолженности: 0 — нет, 1 — есть (обязательно)
  - total — задолженности по неналоговым платежам всего (необязательно)
  - regular_subsoil — в том числе, задолженность по регулярным платежам за пользование недрами (необязательно)