`POST /subjects/requisites`

Метод позволяет получить реквизиты субъекта (организации или физического лица) на основании его персональных данных. Можно получить следующие реквизиты:

ИНН физического лица

Заголовки

Название	Описание
Authorization	Заголовок авторизации
ContentType	Тип контента

Content-Type

Допустимые значения Content-Type:

application/json

Тело запроса

Название	Тип	Формат	Обязательность	Описание
requisiteType	object	RequisiteType	`true`	Реквизит, который необходимо получить
inn	object	Inn	`false`	Данные необходимые для получения ИНН

RequisiteType

Название	Описание
inn	ИНН физического лица. Если он указан в `requisiteType`, то в теле запроса обязательно должен быть указан объект inn

Пример

  POST /entity/v1/subjects/requisites
  Content-Type: Application/json
  Authorization: ReestroAuth apiKey=235dc85c-f7f9-4dc0-8bbf-dad9e0185afd&portal.orgid=1748b89b-7d34-4d47-b479-b06b40ab1a30

{
  "requisiteType": "inn",
  "inn":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Город",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "Орган власти"
      }
    }
  }
}

Ответы

200

Реквизит успешно получен. В теле ответа содержится:

Тело ответа

Название	Тип	Формат	Обязательность	Описание
requisiteType	object	RequisiteType	`true`	Полученный реквизит
inn	object	Inn	`false`	Описание ИНН, если удалось его получить

  HTTP 200
  Content-Type: Application/json

{
  "requisiteType": "inn",
  "inn":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Где то",
    "inn": "140702214133",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "кем-то"
      }
    }
  }
}

400

Ошибки валидации запроса. В теле ответа содержится описание ошибки Error. Для данного метода возможны следующие ошибки:

Код ошибки	Описание
AbsenceOfRequiredField	Не указано одно из обязательных полей
WrongFieldValue	Значение поля не соответствует требуемому формату. Поле, формат которого не соответствует, указано в описании ошибки в `message`

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

    HTTP 400
    Content-Type Application/json

    {
      "code": "validation",
      "message": "Failed to validate input request",
      "target": "api",
      "errors":
      [
        {
          "code": "AbsenceOfRequiredField",
          "message": "dateBirth is required",
          "target": "EntityApi"
        }
      ]
    }

401

Ошибка авторизации: пользователь не авторизован

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации

404

По указанным данным не удалось найти искомый реквизит