POST /subjects

Метод позволяет создать субъекта. Субъектом может выступать физическое или юридическое лицо.

Заголовки

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

Content-Type

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

  • application/json

Тело запроса

Название Тип Формат Обязательность Описание
externalId string ^\w{1,256}$ false Клиентский идентификатор субъекта. Заполняется клиентом. Система контролирует уникальность идентификатора.
person object Person false Описание данных физического лица
organization object Organization false Описание данных юридического лица

В описании запроса должен содержаться только один из параметров person или organization.

Примеры

  1. Создание физического лица
  POST /realty/entity/v1/subjects
  Content-Type: application/json
  Authorization: ReestroAuth auth.sid=717726209B543848879C33F2BDDAB9F8561EFAC465A5DC439193062C700FAFDA&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
{
  "person":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Город",
    "snils": "000-000-000 55",
    "inn": "675434958215",
    "email": "imya@yandex.ru",
    "phone": "79699999999",
    "gender": "Female",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "Орган власти"
      }
    },
    "address":
    {
      "structuralAddress":
      {
        "region": "54",
        "city":
        {
          "name": "Новосибирск",
          "abbreviation": "г"
        },
        "street":
        {
          "name": "Челюскинцев",
          "abbreviation": "ул"
        },
        "house":
        {
          "name": "14",
          "abbreviation": "д"
        }
      }
    }
  }
}
  1. Создание юридического лица
  POST /realty/entity/v1/subjects
  Content-Type: application/json
  Authorization: ReestroAuth auth.sid=717726209B543848879C33F2BDDAB9F8561EFAC465A5DC439193062C700FAFDA&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
{
  "organization":
  {
    "name": "ООО Рога и Копыта",
    "kpp": "741501001",
    "regDate": "2018-09-04",
    "address": {
      "structuralAddress": {
        "region": "54",
        "city": {
          "name": "Новосибирск",
          "abbreviation": "г"
        },
        "street": {
          "name": "Челюскинцев",
          "abbreviation": "ул"
        },
        "house": {
          "name": "14",
          "abbreviation": "д"
        }
      }
    },
    "nativeOrgParams": {
      "ogrn": "1047409501446",
      "inn": "7420008319"
    }
  }
}

Ответы

201

Субъект успешно создан. В теле ответа содержится описание субъекта Subject.

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

  HTTP 201
  Content-Type: application/json
{
  "subjectId": "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
  "person":
  {
    "name": "Анастасия",
    "surname": "Тарасова",
    "patronymic": "Константиновна",
    "dateBirth": "2018-01-01",
    "birthPlace": "Город",
    "snils": "000-000-000 55",
    "inn": "675434958215",
    "email": "imya@yandex.ru",
    "phone": "79699999999",
    "gender": "Female",
    "identityDocument":
    {
      "documentType": "008001001000",
      "number": "123456",
      "series": "1111",
      "issueDate": "2018-12-12",
      "issuer":
      {
        "issuerCode": "123-123",
        "issuerName": "Орган власти"
      }
    },
    "citizenship": "848000000643",
    "address":
    {
      "structuralAddress":
      {
        "region": "54",
        "city":
        {
          "name": "Новосибирск",
          "abbreviation": "г"
        },
        "street":
        {
          "name": "Челюскинцев",
          "abbreviation": "ул"
        },
        "house":
        {
          "name": "14",
          "abbreviation": "д"
        }
      }
    }
  }
}

400

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

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

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

  HTTP 400
  Content-Type Application/json
  {
      "code": "validation",
      "message": "Failed to validate request",
      "target": "api",
      "errors":
      [
        {
          "code": "WrongSubjectType",
          "message": "person or organization required",
          "target": "EntityApi"
        }
      ]
  }

401

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

403

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

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода