Перейти к содержанию

Проверка сведений о мобилизации

Представление сведений о физическом лице, призванном по частичной мобилизации, по данным об ФЛ.

Метод используется для запроса сведений о физическом лице, призванном по частичной мобилизации, для решения вопросов об оказании им мер поддержки.

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

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

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

Запрос на проверку

Метод: POST

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

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

Название
 Тип данных Обязательно Описание
id_request string (до 36 символов) Нет Сквозной идентификатор запроса
last_name string (не более 60 символов) Да Фамилия
first_name string (не более 60 символов) Да Имя
middle_name string (не более 60 символов) Да, при наличии Отчество
birth_date string (форматYYYY-MM-DD) Да Дата рождения
inn string (формат ([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}) Нет ИНН ФЛ
snils string (11 цифр) Нет СНИЛС
doc_type_id string enum Нет Код вида документа, удостоверяющего личность
doc_num string (1-25 символов) Да, если указанdoc_type_id Серия и номер документа
issue_date string (форматYYYY-MM-DD) Да, если указанdoc_type_id Дата выдачи документа
issuer_name string (не более 255 символов) Нет, если указанdoc_type_id Наименование органа, выдавшего документ
issuer_code string (7 символов) Нет, если указанdoc_type_id Код подразделения органа, выдавшего документ

Допустимые значения doc_type_id и соответствующий ему формат doc_num можно посмотреть здесь.

{
  "id_request": "4dd077c2-48b2-446a-95a5-eb91b0e0aa56",
  "last_name": "Иванов",
  "first_name": "Иван",
  "middle_name": "Иванович",
  "birth_date": "2000-01-01",
  "doc_type_id": "21",
  "doc_num": "1234 567890",
  "issue_date": "2018-09-10"
}

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

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

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

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

{
  "request_id": "1fa6b007-45d6-4926-9fbd-5c1651244f96"
}

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

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

Метод: GET

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

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

Название Тип данных Обязательно Описание
request_id string Да Идентификатор запроса 
GET /v1/smev3/fns/svedflmob/1fa6b007-45d6-4926-9fbd-5c1651244f96

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

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

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

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

{
  "state": "in_progress"
}

{
  "state": "finished",
  "result":
  {
    "status": "not_found"
  }
}

{
  "state": "finished",
  "result":
  {
    "status": "found",
    "inn": "061537040128",
    "mob_start": "2022-09-21",
    "fns":
    [
      {"type": "npd_taxpayer", "start": "2022-09-01"}
    ],
    "id_request": "4dd077c2-48b2-446a-95a5-eb91b0e0aa56",
    "actual_at": "2022-10-21"
  }
}
  • state — статус запроса
    • in_progress — в обработке
    • finished — завершён
  • result — результат обработки (в случае state finished)
    • status — результат проверки
      • not_found — ФЛ не был призван по частичной мобилизации
      • found — ФЛ был призван по частичной мобилизации
    • inn — ИНН физлица
    • mob_start — дата призыва (формат YYYY-MM-DD)
    • mob_end — дата окончания призыва (формат YYYY-MM-DD)
    • actual_at — дата актуальности сведений
    • id_request — сквозной идентификатор запроса
    • fns — данные из ФНС (список из fns_item, см. ниже)

fns_item имеет следующий формат:

  • type — тип, может принимать следующие значения:
    • advocate — состоит на учёте в налоговом органе в качестве адвоката
    • notary — состоит на учёте в налоговом органе в качестве нотариуса
    • mediator — состоит на учёте в налоговом органе в качестве медиатора
    • bankruptcy_trustee — состоит на учёте в налоговом органе в качестве арбитражного управляющего
    • appraiser — состоит на учёте в налоговом органе в качестве оценщика
    • patent_attorney — состоит на учёте в налоговом органе в качестве патентного поверенного
    • npd_taxpayer — состоит на учёте в налоговом органе в качестве налогоплательщика НПД
    • ip — осуществляет деятельность в качестве ИП
    • chief_founder — является руководителем или учредителем юрлица
  • start — дата постановки на учёт (формат YYYY-MM-DD) (для всех type, кроме ip и chief_founder)
  • end — дата снятия с учёта (формат YYYY-MM-DD) (для всех type, кроме ip и chief_founder)
  • ogrn — ОГРН ИП/юрлица (только для type ip и chief_founder)
  • reg_date — дата регистрации ИП/юрлица (только для type ip и chief_founder)
  • reg_end — дата прекращения деятельности в качестве ИП или юрлица (только для type ip и chief_founder)
  • msp_include_date — дата включения юрлица/ИП в реестр МСП (только для type ip и chief_founder)
  • msp_exclude_date — дата исключения юрлица/ИП в реестр МСП (только для type ip и chief_founder)
  • name — полное наименование юрлица (только для type chief_founder)
  • inn — ИНН юрлица (только для type chief_founder)
  • participation_start — дата начала участия ФЛ в ЮЛ (только для type chief_founder)
  • participation_end — дата окончания участия ФЛ в ЮЛ (только для type chief_founder)
  • participation_status — статус участия (принимает одно из значений в диапазоне 1-4) (только для type chief_founder)