Уведомление

Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.

Если у вас есть законные основания для подключения к Виду сведения, мы можем проконсультировать по техническим и организационным моментам подключения. Связаться с нами

Проверка статуса самозанятого

Атрибут	Значение
Название	info-radar-self-employed-v2
Тип	Адаптер проверки статуса плательщика НПД
Наименование	Проверка статуса самозанятого

По ИНН физического лица сервис проверяет, был ли человек плательщиком налога на профессиональный доход (НПД) на указанную дату. В результате возвращается is_self_employed: true — статус подтверждён, false — статус не подтверждён.

Сервис является частью платформы Агредатор. Перед интеграцией ознакомьтесь с обязательными документами:

Принимаемые параметры

Параметр	Название	Тип	Обязательное	Пример
data	Данные проверки	object	+	см. ниже
data.inn	ИНН физического лица, 12 цифр	string	+	`123456789012`
data.request_date	Дата проверки, `YYYY-MM-DD`	string	+	`2026-08-21`

Ограничения на поля:

data.inn — строка из 12 цифр. ИНН юридического лица из 10 цифр не принимается.
data.request_date — существующая дата в формате YYYY-MM-DD от 2019-01-01 до сегодняшней даты включительно. Сегодняшний день определяется по московскому времени.

Важно:

Имена полей чувствительны к регистру: INN или Inn вместо inn приводят к ошибке об отсутствии data.inn. Значение null также считается отсутствующим полем.
Дополнительные поля внутри data не используются при проверке и не передаются в ФНС.

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

При обычной обработке сначала приходит промежуточное сообщение со status: waiting, затем итоговое со status: success или status: error. Если запрос отклонён до постановки в обработку, приходит только сообщение об ошибке. Итоговое сообщение может быть доставлено повторно.

Повторные итоговые сообщения сопоставляйте по id. Промежуточное сообщение waiting с тем же id не должно мешать обработке последующего итогового ответа.

Параметр	Значение	Когда приходит	Пример
id	Идентификатор заявки; совпадает с `ticket`	Всегда	`0f2a1c1e-6f4a-4f4a-9c5a-0d2b7e8f1a23`
status	Статус обработки	Всегда	`waiting`, `success`, `error`
result.message	Отметка о принятии заявки в работу	При `waiting`	`Валидация пройдена, взяли в работу`
result.status	Тип результата	При `success`	`result`
result.result.is_self_employed	Наличие статуса НПД на указанную дату	При `success`	`true` или `false`
message	Текст ошибки	При `error`	`<7c31a299> Не удалось выполнить проверку статуса НПД. Повторите запрос позднее`

При waiting поле result.message не содержит результат проверки. При success используйте result.result.is_self_employed: значение false означает успешную проверку с отрицательным результатом. При error причина находится в message, а блока result нет.

Ошибки и действия при их получении

Маркер ошибки может находиться внутри более длинного message. В одном сообщении могут присутствовать маркеры ошибок обоих входных полей.

Маркер	Текст ошибки	Действие клиента
`<7c31a204>`	Отсутствует обязательный параметр data.inn	Передать `data.inn` в новом запросе.
`<7c31a205>`	Отсутствует обязательный параметр data.request_date	Передать `data.request_date` в новом запросе.
`<7c31a201>`	Поле data.inn должно содержать корректный ИНН физического лица из 12 цифр	Исправить ИНН и создать новый запрос.
`<7c31a202>`	Поле data.request_date должно содержать корректную дату в формате YYYY-MM-DD в диапазоне от 2019-01-01 до текущей даты	Исправить дату и создать новый запрос.
`<7c31a203>`	Некорректные данные для проверки. Проверьте ИНН и дату	Проверить ИНН и дату, затем создать новый запрос.
`<7c31a299>`	Не удалось выполнить проверку статуса НПД. Повторите запрос позднее	Создать новый запрос позднее.

Повторная отправка заявки с прежним ticket не запускает проверку заново. Новая заявка должна получить новый ticket.

Примеры

Пример запроса

{
  "data": {
    "inn": "123456789012",
    "request_date": "2026-08-21"
  }
}

Пример промежуточного сообщения

Приходит сразу после приёма заявки.

{
  "id": "0f2a1c1e-6f4a-4f4a-9c5a-0d2b7e8f1a23",
  "status": "waiting",
  "result": {
    "message": "Валидация пройдена, взяли в работу"
  }
}

Пример ответа: статус подтверждён

{
  "id": "0f2a1c1e-6f4a-4f4a-9c5a-0d2b7e8f1a23",
  "status": "success",
  "result": {
    "status": "result",
    "result": { "is_self_employed": true }
  }
}

Пример ответа: статуса нет

Проверка выполнена успешно, статуса НПД на указанную дату не было. Это не ошибка.

{
  "id": "0f2a1c1e-6f4a-4f4a-9c5a-0d2b7e8f1a23",
  "status": "success",
  "result": {
    "status": "result",
    "result": { "is_self_employed": false }
  }
}

Пример ответа с ошибкой

{
  "id": "0f2a1c1e-6f4a-4f4a-9c5a-0d2b7e8f1a23",
  "status": "error",
  "message": "<7c31a201> Поле data.inn должно содержать корректный ИНН физического лица из 12 цифр"
}