`POST /representatives`

Метод позволяет создать представительство между двумя сущностями.

Заголовки

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

Тело запроса

Название	Тип	Формат	Обязательность	Описание
principalId	string	`Guid`	`true`	Идентификатор представляемого. Может быть юридическое или физическое лицо.
agentId	string	`Guid`	`true`	Идентификатор представителя. Может быть только физическое лицо.
attorney	object	documentInfo	`true`	Правоудостоверяющий документ

documentInfo

Объект содержит описание документов.

Название	Тип	Формат	Обязательность	Описание
documentType	string	DocumentType	`true`	Тип документа
number	string	`^[\w]{1,45}$`	`false`	Номер документа
series	string	`^[\w]{1,45}$`	`false`	Серия документа
issueDate	string	`YYYY-MM-DD`	`false`	Дата выдачи документа
endingDate	string	`YYYY-MM-DD`	`false`	Дата окончания действия документа
issuer	string	Issuer	`false`	Издатель
placeOfIssue	string	`^[\w]{1,1000}$`	`false`	Место выдачи

Обязательность заполнения полей объекта documentInfo зависит от типа документа, указанного в documentType. Подробное описание обязательных реквизитов для всех типов документов указано в справочнике DocumentType.

Issuer

Объект содержит описание организации, выдавшей документ, или автора документа.

Название	Тип	Формат	Обязательность	Описание
issuerCode	string	`^[\w]{1,20}$`	`false`	Код подразделения
issuerName	string	`^[\w]{1,255}$`	`true`	Наименование организации

Пример

Создание представителя с указанием документа подтверждающее право на представительство

  POST /realty/web/inspection-api/v1/representatives
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
  Content-Type: application/json

{
  "agentId": "6506cdb61dc70a5286708d44",
  "attorney": {
    "documentType": "558301020000",
    "number": "123456",
    "series": "654321",
    "issueDate": "2023-01-01",
    "endingDate": "2024-01-01"
  },
  "principalId": "6440fc423ae7bf7a8d65c576"
}

Ответы

201

Тело ответа

Представитель успешно создан. В теле ответа содержится описание представителя representative.

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

  HTTP 201
  Content-Type: application/json

{
    "id": "650700ac1dc70a5286708d57",
    "principal": {
        "id": "6440fc423ae7bf7a8d65c576",
        "externalId": null,
        "person": {
            "name": "Анжела",
            "surname": "Дите",
            "patronymic": null,
            "dateBirth": "2023-04-01",
            "birthPlace": "Новосибирск",
            "snils": null,
            "inn": null,
            "address": "Новосибирск",
            "identityDocument": {
                "documentType": "008001011000",
                "number": "123",
                "series": "II-А",
                "issueDate": "2023-04-03",
                "endingDate": null,
                "issuer": {
                    "issuerCode": null,
                    "issuerName": "УВД"
                },
                "placeOfIssue": null
            }
        },
        "organization": null,
        "notification": null,
        "contracts": [
            {
                "documentType": "558401010201",
                "number": "Д-001",
                "series": null,
                "issueDate": "2023-04-03",
                "endingDate": null,
                "issuer": null,
                "placeOfIssue": null
            }
        ]
    },
    "agent": {
        "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": []
    },
    "attorney": {
        "documentType": "558301020000",
        "number": "123456",
        "series": null,
        "issueDate": "2023-01-01",
        "endingDate": "2024-01-01",
        "issuer": null,
        "placeOfIssue": null
    }
}

400

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

401

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

403

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

415

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