Уведомление

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

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

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

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

Сервис позволяет проверить, был ли человек плательщиком налога на профессиональный доход (НПД) на выбранную дату. Проверка по ИНН помогает уточнить статус самозанятого при работе с физическим лицом, в том числе за прошедший период.

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

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

Параметр	Название	Тип	Обязательное	Пример
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: error.
Если запрос принят, приходит промежуточное сообщение со status: waiting. Оно подтверждает принятие заявки, но не содержит результата проверки.
После проверки приходит итоговое сообщение со status: success или status: error.

Поле	Когда присутствует	Что означает
`id`	Всегда	Идентификатор заявки; совпадает с `ticket`.
`status`	Всегда	`waiting` — заявка принята в обработку; `success` — проверка завершена; `error` — обработка завершилась ошибкой.
`result.message`	При `waiting`	Сообщение о принятии заявки. Результата проверки в нём нет.
`result.status`	При `success`	Служебный тип ответа — `result`. Это не статус НПД.
`result.result.is_self_employed`	При `success`	Результат проверки: `true` — статус НПД подтверждён, `false` — не подтверждён. Оба значения означают успешную проверку.
`message`	При `error`	Причина ошибки. Маркеры ошибок сервиса и действия клиента приведены ниже.

Важно

Итоговый ответ может прийти повторно. Сообщения с одинаковым id и итоговым статусом обрабатывайте как один результат. Сообщение waiting не является итоговым ответом.

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

Маркер ошибки может находиться внутри более длинного 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.

Примеры

В примере запроса показано содержимое request.payload для HTTP-шлюза. В примерах ответов показаны поля, относящиеся к проверке НПД; общие поля конверта опущены.

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

{
  "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 цифр"
}