Файл выгрузки представляет собой документ в формате XML с корневым элементом document.
Объявления размещаются в дочерних элементах object.
Каждый из объектов недвижимости описывается вложенными в object элементами.
Пример<?xml version="1.0" encoding="UTF-8"?>
<document>
<object> ... </object>
<object> ... </object>
<object> ... </object>
<object>
<operation-type>Продам</operation-type>
<object-type>Квартира на вторичном рынке</object-type>
<link>609303</link>
<address>
<state>Нижний Новгород</state>
<region>Нижегородский район</region>
<street>Пожарная улица</street>
<house-number>1606</house-number>
</address>
<description>Какая-то квартира</description>
<price>2700000</price>
<contact>
<phone>+7-(900)-123-45-67</phone>
<name>Светлана</name>
</contact>
<image>https://example.com/photo/65862294.jpg</image>
<image plan="1">https://example.com/plan.jpg</image>
<extended-area>
<total>36.5</total>
<houseroom>25</houseroom>
<kitchen>5</kitchen>
</extended-area>
<flats-type>типовое</flats-type>
<walls-type>кирпич</walls-type>
<floor>1</floor>
<floors-number>3</floors-number>
<rooms-number>2</rooms-number>
<toilet>совмещённый</toilet>
<height>2.29</height>
<renovation>типовой</renovation>
</object>
</document>
Операция. Допустимые значения: «Продам», «Сдам».
Объект. Возможные значения:
Значения operation-type (операция) | Значение object-type |
---|---|
Продам | |
Сдам |
Уникальный идентификатор объекта в системе агентства. Тип: строка.
При обращении с вопросами о загрузке конкретных объявлений необходимо указать либо его, либо идентификатор gipernn,
поэтому желательно не использовать труднопроизносимые идентификаторы.
Пример<locality>деревня Козловка, Ройкинский сельсовет</locality>
Пример<street>Гагарина проспект</street>
Пример<address>
<state>Нижний Новгород</state>
<region>Нижегородский район</region>
<street>Пожарная улица</street>
<house-number>1606</house-number>
</address>
Подробное описание объекта. Тип: строка.
Телефон агента или продавца. Разделителем в номере телефона является «-». Пример: 8-930-779-45-34
Пример<contact>
<phone>+7-(900)-123-45-67</phone>
<name>Светлана</name>
<seller_id>123</seller_id>
</contact>
Пример передачи фотографии и планировки<image>http://example.com/img1.jpg</image>
<image plan="1">http://example.com/plan.jpg</image>
Пример — подключить опции «премиум» и «выделение цветом»<paid>
<service>выделение цветом</service>
<service>премиум</service>
</paid>
Пример — отключить все опции<paid></paid>
Площадь общая, м².
Тип: число с плавающей точкой.
Пример назначений из двух групп<target>офис</target>
<target>колхоз</target>
Количество этажей в здании. Тип: целое число.
Площадь общая, м². Тип: число с плавающей точкой.
Пример назначений из двух групп<target>офис</target>
<target>пищевое</target>
Этаж, на котором расположен объект. Тип: строка.
Количество этажей в здании. Тип: целое число.
Высота потолков в метрах. Тип: число с плавающей точкой.
Год постройки дома. Тип: целое число.
Общая площадь зданий, м². Тип: число с плавающей точкой.
Площадь земельного участка, га. Тип: число с плавающей точкой.
Пример назначений из двух групп<target>офисный</target>
<target>детский центр</target>
Количество зданий. Тип: строка.
Пример<communication>газ</communication>
<communication>вода</communication>
Количество комнат. Возможные значения: «студия», число от 1 до 15.
Пример<extended-area>
<total>30</total>
<houseroom>20</houseroom>
<kitchen>7</kitchen>
</extended-area>
Обязателен для всех объектов кроме «Квартира на сутки».
Год постройки дома. Тип: целое число.
Обязателен для всех объектов кроме «Квартира на сутки».
Высота потолков. Тип: число с плавающей точкой.
Количество балконов. Тип: целое число.
Количество лоджий. Тип: целое число.
Пример<comfort>мебель</comfort>
<comfort>интернет</comfort>
Пример<lift>грузовой</lift>
<lift>пассажирский</lift>
Пример цены за квартиру<price per-unit="0">1000000</price>
Пример цены за метр<price>50000</price>
Пример цены за метр<price per-unit="1">50000</price>
Пример<extended-area>
<total>30</total>
<houseroom>20</houseroom>
<kitchen>7</kitchen>
</extended-area>
Количество комнат. Возможные значения: «студия», число от 1 до 15.
Высота потолков. Тип: число с плавающей точкой.
Количество балконов. Тип: целое число.
Количество лоджий. Тип: целое число.
Пример<lift>грузовой</lift>
<lift>пассажирский</lift>
Пример<extended-area>
<total>30</total>
<houseroom>20</houseroom>
<kitchen>7</kitchen>
</extended-area>
Площадь земли в сотках. Тип: число с плавающей точкой.
Количество этажей. Тип: целое число.
Пример<communication>газ</communication>
<communication>вода</communication>
Площадь дома в квадратных метрах. Тип: число с плавающей точкой.
Площадь земли в сотках. Тип: число с плавающей точкой.
Пример<communication>газ</communication>
<communication>вода</communication>
Общая площадь в квадратных метрах. Тип: число с плавающей точкой.
Площадь участка в сотках. Тип: число с плавающей точкой.
Пример<communication>газ</communication>
<communication>вода</communication>
Площадь участка, га. Тип: число с плавающей точкой.
Объект продажи. Тип: строка.
Срок окупаемости, единица измерения указывается в period. Тип: целое число.
Пример<target>офисная</target>
<target>торговая</target>
Пример<floor-height>
<from>2</from>
<to>3.1</to>
</floor-height>
Минимум, рублей в месяц. Тип: целое число.
Максимум, рублей в месяц. Тип: целое число.
Пример<rates>
<from>200</from>
<to>1000</to>
</rates>
Добавлена возможность распределять объявления по кабинетам агентов
Добавлена возможность передачи видеоролика
Добавлена возможность передачи планировок помещений, участков и т.п.
Исправлено правило передачи цены для квартир в новостройках.
Для квартир в квартир в новостройках можно передать высоту потолков в параметре «height».
Элемент «Ближайший населённый пункт» («nearest-town») объявлен устаревшим. Вместо него следует использовать стандартный «населённый пункт».
В продаже квартир в новостройках, продаже и аренде помещений вместо цены за объект можно передавать цену за метр.
Арендный бизнес выделен из готового бизнеса.
Замена <special>1</special><paid><service>премиум</service></paid>