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.

Примеры

  1. Создание физического лица
  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": "д"
        }
      }
    }
  }
}
  1. Создание юридического лица
  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 указан тип контента, который не поддерживается для данного метода