Описание XML-формата системы
Заголовок:
<?xml version="1.0" encoding="UTF-8"?>
Примеры XML-файлов для описания различных типов недвижимости:
- Пример описания квартиры
- Пример описания коттеджа
- Пример описания участка
- Пример описания коммерческого объекта
- Пример описания новостройки
- Пример описания квартиры в новостройке
Общая структура и корневой элемент:
<root>
Структура блока offer:
Звездочками * обозначены обязательные поля.
Для полей, подразумевающих выбор одного из вариантов, регистр символов неважен.
Общая информация:
Тег | Описание | |
id * | Идентификатор объявления в базе данных партнера, предоставляющего выгрузку. Тип: целое число, только цифры, без букв. id объявлений не должен превышать 10 символов. | |
part* |
Общий тип недвижимости, к которому относится объявление. Допустимые значения:
|
|
object-type* |
Тип объекта. Допустимые значения: Для жилой недвижимости:
Для загородной недвижимости:
Для коммерческой недвижимости
|
|
description* | Описание объявления в свободной форме (не менее 50 символов) | |
url | Ссылка на объявление | |
created-at* | Дата подачи объявления в формате (YYYY-MM-DD / DD-MM-YYY / DD.MM.YYY ) | |
updated-at* | Дата последнего изменения объявления (YYYY-MM-DD / DD-MM-YYY / DD.MM.YYY ) | |
images | Набор элементов со ссылками на фотографии объекта (обязательно для всех видов недвижимости для проекта Юла). Размер одной фотографии не должен превышать 10 мб | |
image primary="1/0" | Фотография объекта. Атрибут primary определяет - будет ли данное изображение использоваться в качестве основного |
Информация об условиях сделки:
Тег | Описание | ||
bargain* | Набор элементов, описывающих условия сделки | ||
type* |
Тип сделки. Доступные значения:
Не обязательно для новостроек |
||
share | Предлагается к продаже доля от объекта (только продажа), например часть комнаты, часть загородного дома. Доступные значения:
|
||
haggle |
Торг возможен. Доступные значения:
|
||
objects-count | Количество объектов в предложении | ||
mortgage | Возможна ипотека (только продажа). Доступные значения:
|
||
prepayment | Предоплата в %. Неотрицательное целое число | ||
pledge | Залог. Доступные значения:
|
||
fee |
Комиссия арендатора (только аренда). Доступные значения:чения:
|
||
fee-value |
Размер комиссии арендатора. Доступные значения:
|
||
pets | Возможно заселение с животными (только аренда). Доступные значения:
|
||
children | Возможно заселение с детьми (только аренда). Доступные значения:
|
||
price* | Набор элементов, описывающих цену | ||
value* |
Значение цены. Положительное число с плавающей точкой Не обязательно для новостроек (при условии наличия информации о ценах (обязательно для всех видов недвижимости для проекта Юла) внутри блока housing-stock) |
||
value-max | Верхняя граница диапазона цен (если в предложении несколько объектов) | ||
unit |
Единица измерения для цены. Доступные значения:
|
||
currency | Валюта. Трехбуквенный индекс валюты, например, RUR, USD, EUR | ||
period |
Период, за который указана цена (только аренда). Доступные значения:
|
||
Только для новостроек fz214 |
Продажа по ФЗ №214. Доступные значения:
|
||
Только для новостроек sales-started |
Продажи начались. Доступные значения:
|
||
Только для новостроек maternity-capital |
Ипотека с использованием материнского капитала. Доступные значения:
|
||
Только для новостроек military-mortgage |
Военная ипотека. Доступные значения:
|
||
Только для новостроек payment-installment |
Возможна рассрочка. Доступные значения:
|
||
Только для новостроек discount |
Акции и скидки. Текст. |
Информация о застройщике (Только для Новостроек):
Тег | Описание | |
developer | Набор элементов, описывающих продавца | |
name* | Название застройщика. Строка | |
description | Описание, строка | |
E-mail застройщика | ||
url | Ссылка на сайт | |
phone | Телефон | |
address | Адрес | |
logo-url | Ссылка на логотип |
Документы, связанные с ЖК (Только для Новостроек):
Тег | Описание | ||
documents | Контейнер для множества записей document | ||
document | |||
name | Название документа | ||
url | Ссылка на документ в формате PDF | ||
... |
Информация о продавце (обязательна для всех объявлений):
Тег | Описание | |
seller | Набор элементов, описывающих продавца | |
phone* | Телефон для связи (не более одного) | |
extension | Добавочный тел. (не более одного) | |
name | Название компании или имя продавца (не более одного) | |
email* | Адрес почты для связи (не более одного) |
Дополнительный список продавцов для новостроек (если их несколько):
Тег | Описание | ||
sellers | Контейнер для записей seller | ||
seller | |||
name | Название компании | ||
phone | Телефон для связи |
Географические данные:
Детальное описание обязательных полей:
- Для всех объектов обязательными полями являются country, state, town
- Для объявлений в РФ по объектам недвижимости, обладающим адресом (т.е. не земельные участки), обязательным полем является street и информация о нумерации дома в блоке house
- Для земельных участков в РФ указание улицы и дома (street, house) необязательно
- Для объявлений на Украине, в Беларуси и Узбекистане, указание улицы и дома (street, house) необязательно (но желательно)
- Для всех объектов кроме квартир и комнат в небольших деревнях или поселках, а также для новостроек (без утвержденной адресации) обязательна улица street, но номер дома, то есть блок house можно опустить.
Тег | Описание | ||
location* | Набор элементов, описывающих географической положение объекта объявления | ||
country* | Страна | ||
state* | Регион внутри страны, в которой размещается объект. Для РФ – область. | ||
region | Район внутри региона или области, в котором размещается объект | ||
town* | Город/поселок/деревня/село | ||
town-region | Район внутри города | ||
district | Округ (только для Москвы) | ||
street* |
Улица Не обязательно для новостроек |
||
house* |
Набор элементов, описывающих номер дома Не обязательно для новостроек |
||
number | Номер дома, включая дробь | ||
building | Номер или литера строения | ||
struct | Номер корпуса | ||
subway | Набор элементов, описывающих удаленность объекта от метро (для городов с метро) | ||
name | Название станции | ||
distance | Значение удаленности | ||
distance-type |
Тип удаленности. Доступные значения: (если ничего не указано, по умолчанию ставится "минут пешком")
|
||
highway | Для объектов в Московской области. Набор элементов, описывающих ближайшее к объекту шоссе и удаленность от МКАД | ||
name | Название шоссе | ||
distance | Значение удаленности от МКАД в км. | ||
latitude | Широта (Обязательно для Новостроек и квартир в новостройках.) | ||
longitude | Долгота (Обязательно для Новостроек и квартир в новостройках.) | ||
Только для новостроек route |
Маршруты проезда к объекту. | ||
transport | На общественном транспорте. Текст. | ||
car | На машине. Текст. |
Детальная информация об объекте:
Тег | Описание | ||||
floor* | Описание этажности (обязательно для квартир) | ||||
total* | Всего этажей (обязательно для квартир для realty.mail.ru и для квартир и комнат проекта Юла) | ||||
current* | Этаж, на котором располагается объект (обязательно для квартир для realty.mail.ru и для квартир и комнат проекта Юла) | ||||
area* |
Описание площадей Не обязательно для новостроек |
||||
total* | Общая площадь объекта в м2 (обязательно для всех видов недвижимости для проекта Юла) | ||||
total-max | Верхняя граница диапазона площади (если в предложении участвует несколько объектов) | ||||
living | Жилая площадь, м2 | ||||
living-max | Верхняя граница диапазона жилой площади (если в предложении участвует несколько объектов) | ||||
kitchen | Площадь кухни, м2 | ||||
kitchen-max | Верхняя граница площади кухни (если в предложении участвует несколько объектов) | ||||
plot | Площадь участка, сот (обязательно за загородной недвижимости) | ||||
plot-max | Верхняя граница площади участка (если в предложении участвует несколько объектов) | ||||
house-info | Информация о доме | ||||
house-type |
Тип дома. Доступные значения:
|
||||
commercial-building-type |
Тип коммерческого строения. Доступные значения:
|
||||
elevator | Наличие лифта. Доступные значения:
|
||||
refuse | Наличие мусоропровода. Доступные значения:
|
||||
building-serial | Серия дома. Строка | ||||
concierge | Наличие консьержа. Доступные значения:
|
||||
security | Наличие охраны в доме. Доступные значения:
|
||||
garage | Наличие гаража. Доступные значения:
|
||||
parking | Наличие парковки. Доступные значения:
|
||||
hatched-area | Охраняемая площадь. Доступные значения:
|
||||
building-class |
Класс коммерческого строения. Доступные значения:
|
||||
heating-type |
Тип отопления в доме. Доступные значения:
|
||||
watercloset-type |
Тип туалета (для загородной недвижимости). Доступные значения:
|
||||
videos | Видео (список элементов video) | ||||
video | |||||
youtube-id | Youtube ID видеоролика | ||||
newbuilding* | Детальное описание новостройки или жилого комплекса (только для этих типов) | ||||
name* | Название ЖК. Обязательно для "квартир в новостройке". | ||||
date* | Дата гос. приемки дома | ||||
status* | Текущее состояние дома. Строка, описывающая положение дел на объекте. Доступные значения
|
||||
Только для новостроек new-building-class |
Класс строения. Доступные значения:
|
||||
Только для новостроек housing-stock* |
Контейнер для записей housing - множество записей
о предложениях доступного жилого фонда
(однушки/двушки) с указанием общих данных по
каждому типу
|
||||
Только для новостроек housing* |
Контейнер данных записи жилого фонда |
||||
Только для новостроек type* |
Тип объекта. Доступные значения:
|
||||
Только для новостроек area |
Нижняя граница площади для объектов данного
предложений
|
||||
Только для новостроек area-max |
Верхняя граница площади для объектов данного
предложений
|
||||
Только для новостроек price |
Нижняя граница цен для объектов данного
предложения
|
||||
Только для новостроек price-max |
Верхняя граница цен для объектов данного
предложения
|
||||
Только для новостроек count |
Число объектов, доступных в предложении |
||||
Только для новостроек layouts |
Изображения планировок (список элементов image) |
||||
Только для новостроек image |
Ссылка на изображение планировки |
||||
Только для новостроек progress-images |
Ход строительства объекта (список элементов image) |
||||
Только для новостроек image |
Ссылка на изображение хода строительства |
||||
Только для новостроек videos |
Видео новостройки (список элементов video) |
||||
Только для новостроек video |
|||||
Только для новостроек youtube-id |
Youtube ID видеоролика |
||||
Только для новостроек ... |
|||||
object-info | Описание объекта сделки | ||||
rooms | Описание комнатности | ||||
total | Всего комнат в объекте сделки (*обязательно для квартир для realty.mail.ru и для квартир и комнат проекта Юла) | ||||
operate | Комнат в предложении | ||||
to | Макс. число комнат в предложении (если в предложении участвует несколько объектов) | ||||
apartments |
Это апартаменты. Доступные значения:
|
||||
balcony | Наличие балкона. Доступные значения:
|
||||
loggia | Наличие лоджии. Доступные значения:
|
||||
ceil-height | Высота потолков в метрах. Положительное число с плавающей точкой | ||||
furniture | Наличие мебели. Доступные значения:
|
||||
refrigerator | Наличие холодильника. Доступные значения:
|
||||
washing-machine | Наличие стиральной машины. Доступные значения:
|
||||
internet | Наличие интернета. Доступные значения:
|
||||
tv | Наличие телевизора (антенна). Доступные значения:
|
||||
conditioner | Наличие кондиционера. Доступные значения:
|
||||
phone | Наличие телефона. Доступные значения:
|
||||
bathroom-type |
Тип санузла. Доступные значения:
|
||||
free-planning | Свободная планировка. Доступные значения:
|
||||
renovation |
Тип ремонта. Доступные значения:
|
||||
common-state |
Общее состояние. Доступные значения:
|
||||
flat-type |
Тип квартиры. Доступные значения:
|
||||
Только для новостроек low-floor-building |
Малоэтажная застройка. Доступные значения:
|
||||
Только для новостроек developer-decoration-info |
Детальная информация об отделке. Строка |
||||
Только для новостроек parking-type |
Тип парковки. Доступные значения:
|
||||
Только для новостроек children-ground |
Наличие детской площадки. Доступные значения:
|
||||
Только для новостроек sports-ground |
Наличие спортивной площадки. Доступные
значения:
|
||||
Только для новостроек freight-elevator |
Наличие грузового лифта. Доступные значения:
|
||||
Только для новостроек conditioning-type |
Тип кондиционирования. Доступные значения:
|
||||
plot-info | Информация об участке | ||||
electricity | Подведено электричество. Доступные значения:
|
||||
sewage | Подведен водоотвод. Доступные значения:
|
||||
water-supply | Подведено водоснабжение. Доступные значения:
|
||||
gas | Подведен газ. Доступные значения:
|
||||
plot-status* |
Статус участка. Доступные значения:
|
Только для новостроек videos |
Видео новостройки (список элементов video) |