`POST /subjects`

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

Заголовки

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

Content-Type

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

application/json

Тело запроса

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

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

Примеры

Создание физического лица

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

{
  "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": "д"
        }
      }
    }
  }
}

Создание юридического лица

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

{
  "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 указан тип контента, который не поддерживается для данного метода