POST /subjects

Метод позволяет создать дольщика. Дольщиком могут выступать как физические, так и юридические лица.

Заголовки

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

Тело запроса

Название Тип Формат Обязательность Описание
externalId string ^\w{1,100}$ false Внешний идентификатор дольщика
person object Person false Информация о ФЛ
organization object Organization false Информация о ЮЛ
notification object Notification false Контактные данные дольщика
contracts array DocumentInfo true Информация о документах

В описании запроса должен быть заполнен один из параметров person или organization. Наличие одного из параметров определяет тип дольщика:

  • если указан параметр person, то дольщик является физическим лицом;
  • если указан параметр organization, то дольщик является юридическим лицом.

Параметр notification обязателен, если дольщик - физическое лицо person и является совершеннолетним.

Пример

Создание физического лица c указанием паспортных данных и информации о ДДУ

  POST /realty/web/inspection-api/v1/subjects
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
  Content-Type: application/json
{ "contracts": [
    {
      "documentType": "558401010201",
      "number": "ДДУ№332-001",
      "issueDate": "2021-01-01",
      "placeOfIssue": "Г.Екатеринбург"
    },
    {
      "documentType": "558401010201",
      "number": "ДДУ№332-002",
      "series": "null",
      "issueDate": "2023-02-01",
      "endingDate": "2024-02-01"
    }
  ],
  "externalId": "super_ID_fromCRM001",
  "person": {
    "name": "Иван",
    "surname": "Иванов",
    "patronymic": "Иванович",
    "dateBirth": "1991-01-01",
    "birthPlace": "Г.Екатеринбург",
    "snils": "39227090793",
    "inn": "473526538106",
    "address": "Г.Екатеринбург, улица Малопрудная д,5",
    "identityDocument": {
      "documentType": "008001001000",
      "number": "865999",
      "series": "5711",
      "issueDate": "2000-01-01",
      "issuer": {
        "issuerName": "УФМС России",
        "issuerCode": "590-007"
      },
      "placeOfIssue": "Г.Екатеринбург"
    }
 }
}   

Ответы

201

Тело ответа

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

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

  HTTP 201
  Content-Type: application/json
{
    "id": "6506cdb61dc70a5286708d44",
    "externalId": null,
    "person": {
        "name": "Иван",
        "surname": "Иванов",
        "patronymic": "Иванович",
        "dateBirth": "1991-01-01",
        "birthPlace": "Г.Екатеринбург",
        "snils": null,
        "inn": null,
        "address": "Г.Екатеринбург, улица Малопрудная д,5",
        "identityDocument": {
            "documentType": "008001001000",
            "number": "865999",
            "series": "5711",
            "issueDate": "2000-01-01",
            "endingDate": null,
            "issuer": {
                "issuerCode": "590-007",
                "issuerName": "УФМС России"
            },
            "placeOfIssue": null
        }
    },
    "organization": null,
    "notification": null,
    "contracts": [
        {
            "documentType": "558401010201",
            "number": "ДДУ№332-001",
            "series": null,
            "issueDate": "2021-01-01",
            "endingDate": null,
            "issuer": null,
            "placeOfIssue": null
        },
        {
            "documentType": "558401010201",
            "number": "ДДУ№332-002",
            "series": null,
            "issueDate": "2023-02-01",
            "endingDate": null,
            "issuer": null,
            "placeOfIssue": null
        }
    ]
}

400

Ошибки валидации запроса.

401

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

403

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

415

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