Перейти к основному содержимому

Работа с объектами недвижимости

Для проведения сделки необходимо создать карточку ОН в системе М2, либо использовать уже существующий.
Для операций с ОН предоставлен ряд возможностей, описанных ниже.

Создание объектов недвижимости​

Для создания объекта недвижимости необходимо указать основные данные по ОН, такие как:

  • Тип объекта
  • Адрес ОН
  • Кадастровый номер
  • Площадь
Типы объектов недвижимости
  • Квартира REAL_ESTATE_PLACEMENT_FLAT
  • Земельный участок REAL_ESTATE_LAND
  • Здание жилое REAL_ESTATE_BUILDING_ACCOMMODATION
  • Здание нежилое REAL_ESTATE_BUILDING_NOT_ACCOMMODATION
  • Комната REAL_ESTATE_PLACEMENT_ROOM
  • Нежилое помещение (кладовки, гаражи, машиноместа и т.д.) REAL_ESTATE_PLACEMENT_NOT_ACCOMMODATION
  • Сооружение REAL_ESTATE_CONSTRUCTION
  • Объект незавершённого строительства REAL_ESTATE_UNFINISHED

Для создания объектов недвижимости используется следующий метод.
В ответ возвращается идентификатор созданного объекта недвижимости, который необходимо использовать далее для создания сделки с этим ОН.

Пример запроса
POST https://m2.ru/api/public/deal-api/v1/real-estates HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  "data": {
    "type": "REAL_ESTATE_LAND",
    "address": "Москва, Ленина 1",
    "cadastral": "00:00:0000000:1111",
    "fullArea": {
      "value": 100,
      "type": "SQUARE_METER"
    }
  }
}
Справка

Для недвижимости реализуемой по ДДУ/ДУПТ (первичный рынок) тип объекта недвижимости должен соответствовать типу Земельный участок REAL_ESTATE_LAND и включать в себя кадастровый номер земельного участка, адрес участка и общую площадь земельного участка.

Обновление объекта недвижимости​

Если после создания ОН необходимо внести изменения, можно воспользоваться следующим методом:

Пример запроса
POST https://m2.ru/api/public/deal-api/v1/real-estates/{id} HTTP/1.1
Authorization: Bearer
Content-type: application/json

{
  "data": {
    "type": "REAL_ESTATE_LAND",
    "address": "Москва, Ленина 1",
    "cadastral": "00:00:0000000:1111",
    "fullArea": {
      "value": 100,
      "type": "SQUARE_METER"
    }
  }
}

Получение информации по уже созданному объекту недвижимости​

Пример запроса
GET https://m2.ru/api/public/deal-api/v1/real-estates/{id} HTTP/1.1
Authorization: Bearer
Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json
{
  "realEstate": {
    "id": "string",
    "creationTimestamp": "2025-01-24T00:26:01.963Z",
    "updateTimestamp": "2025-01-24T00:26:01.963Z",
    "data": {
      "type": "REAL_ESTATE_LAND",
      "address": "Москва, Ленина 1",
      "cadastral": "00:00:0000000:1111",
      "fullArea": {
        "value": 100,
        "type": "SQUARE_METER"
      }
    }
  }
}