Технические требования к XML фиду формата v2.0

Общие технические требования к наполнению фида:

URL фида должен быть постоянным и доступным по протоколу HTTP.
Ни текст объявлений, ни описание характеристик объекта не должны содержать HTML-код.
Если для объявления есть несколько значений одного параметра (например, несколько метро, фото), то нужно передавать несколько одинаковых тегов.
Стандарт XML не допускает наличие символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 — табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.

Символ в тексте
Код для XML-файла

"
"

&
&

>
>

<
<

'
'

Символ в тексте	Код для XML-файла
"	"
&	&
>	>
<	<
'	'

Описание структуры XML-файла для разных типов объектов недвижимости

Жирным выделены обязательные к заполнению элементы и атрибуты. Если хотя бы один из обязательных элементов будет отсутствовать, объявление не будет импортировано.

Элемент	Назначение	Описание	Допустимые значения
adverts		корневой элемент, содержащий информацию обо всех объектах
generation-date		дата создания фида Пример	даты и время следует указывать согласно стандарту ISO 8601
adv		элемент, содержащий информацию об отдельном объекте
id	идентификатор	любой численно символьный код уникальный для каждого объявления, для одного и того же объекта значение данного элемента не должно изменяться. Пример
active_to	дата активности	дата до которой будет активно (показываться) объявление если дата активности не передана, то объявлению будет автоматически присваиваться дата активности равная дате загрузки фида + 1 неделя. Пример	даты и время следует указывать согласно стандарту ISO 8601
type	тип объекта	Пример	«новостройка», «квартира» (для вторичного жилья)
type	тип объекта	значение «другое» позволяет указать свой тип в теге custom_type Пример	«офис», «помещение свободного назначения», «производственное помещение», «склад, «торговое помещение», «банковское помещение», «бизнес-центр», «кафе. бары. рестораны.», «особняк», «другое»
custom_type	другой тип	если не один из перечисленных типов в теге type не подходит можно указать свой Пример	название другого типа коммерческой недвижимости
type	тип объекта	Пример	«земельный участок»
type	тип объекта	Пример	«коттедж», «дом», «дача», «таунхаус»
type	тип объекта	Пример	«гараж», «гараж в ГСК», «гараж отдельно стоящий», «машиноместо закрытый паркинг», «машиноместо открытый паркинг»
operation	тип операции	Пример	«продажа» — «sale» «аренда» — «arenda» «аренда на день» — «arenda_day» «аренда на праздники» — «arenda_new_year»
min_time_type	минимальный срок аренды единица измерения	только для аренды Пример	«час», «день», «месяц», «год»
min_time_val	минимальный срок аренды значение	только для аренды Пример	целое положительное число
region	регион	Пример	при указании адреса мы рекомендуем использовать КЛАДР (Классификатор адресов России)
ray	район региона	Пример
city	город	Пример
village	населенный пункт	Пример
street	название улицы	Пример
street_socr	топоним улицы	Пример
house	дом	Пример
korp	корпус	Пример
str	строение	Пример
vld	владение	Пример
cadastral	Кадастровый номер земельного участка	Пример
jk	жилой комплекс	Пример	Обязательное поле для новостроек список возможных названий жилых комплексов и корпусов по регионам
jk_korp	корпус / очередь жилого комплекса	Пример
maps	на карте	географические координаты объекта на карте Пример	широта,долгота
text	текстовое описание объекта	Пример
cost	цена/стоимость	продажа объекта — цена всего объекта долгосрочная аренда объекта — стоимость аренды за месяц аренда объекта на Новый год, праздники — стоимость аренды за сутки посуточная аренда объекта — стоимость аренды за сутки почасовая аренда объекта — стоимость аренды за час Пример	положительное число
curr	валюта	Пример	«руб.», «RUR», «USD», «EUR»
rooms_count	количество комнат	Общее количество комнат в квартире Пример	целое положительное число
rooms_to	количество комнат к продаже/аренде	Заполняется только в случае, если продается/сдается не вся квартира целиком Пример	целое положительное число
rooms_type	тип комнат	Пример	«изолированные», «смежно-изолированные», «смежные»
studio	студия	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
apartments	апартаменты	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
square	общая площадь дома/квартиры/коммерческого помещения в кв. метрах	Пример	положительное число
living_square	жилая площадь в кв. метрах	Пример	положительное число
kitchen_square	площадь кухни в кв. метрах	Пример	положительное число
land_square	площадь участка в сотках	Пример	положительное число
sum_floor	общее количество этажей в доме	Пример	целое положительное число
floor	этаж	Пример	целое положительное число«-1» — «полуподвал», «-2» — «подвал», целое положительное число
balkon	балкон\лоджия	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
wc	санузел	Пример	«раздельный», «совмещенный», «2 и более»
lift_count	лифтов	Пример	целое положительное число
home_series	cерия дома	Пример	список допустимых названий серий домов
built_year	год постройки	Пример	целое положительное число
internet	наличие интернета	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
mortgage	ипотека	только для продажи Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
furniture	наличие мебели	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
fridge	наличие холодильника	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
washingmachine	наличие стиральной машины	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
phone	наличие телефона	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
condition	наличие кондиционера	только для аренды Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
heating	отопление	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
sewage	канализация	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
security	наличие охраны	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
facing	отделка/ремонт	Пример	«без ремонта», «требует ремонта», «с ремонтом», «муниципальный ремонт», «евроремонт», «дизайнерский ремонт»
separate_enter	отдельный вход	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
first_line	первая линия	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
repair_pit	ремонтная яма	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
electricity	электроснабжение	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
gas	подключение к газовым сетям	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
open_plan	cвободная планировка	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»
class	класс объекта	Пример	«A», «B», «C», «D», «E», «F»
land_usage	вид разрешенного использования земли	Пример	«для ведения сельского хозяйства», «для дачного строительства», «для жилищного строительства», «для индивидуального жилищного строительства (для ИЖС)», «для организации крестьянско-фермерского хозяйства»
contact_realty	название агентства/компании продавца	Пример
contact_phone	контактный телефон	Пример	возможна передача нескольких телефонных номеров разделенных запятыми
contact_name	контактное лицо	Пример
contact_email	контактный email	Пример
photo	фотографии объекта	может быть несколько тегов Пример	Фотографии объекта в форматах jpg, png. Для объявлений обязательно наличие не менее 3 фото, на фото должен быть изображён объект недвижимости, который является предметом сделки купли/продажи/аренды
url	ссылка на страницу объекта	Пример
url_video	ссылка на видео ролик объекта	Пример
premium	премиум размещение объявления	Пример	«да»/«нет», «true»/«false», «1»/«0», «+»/«-»

Валидатор XML-фидов поможет вам проверить экспортные XML-файлы на соответствие их структуры. Настоятельно рекомендуем после создания экспортного файла или внесения в него изменений обязательно проводить его проверку на валидность.

Пример XML-файла

<?xml version="1.0" encoding="windows-1251"?> <adverts> <generation-date>2015-07-14T03:30:22+03:00</generation-date> <adv> <id>1027</id> <active_to>2016-07-14T09:33:34+03:00</active_to> <type>дом</type> <operation>продажа</operation> <region>Нижегородская область</region> <ray>Сергачский район</ray> <village>село Толба</village> <maps>55.619081,45.300046</maps> <text><![CDATA[Дополнительная информация. Продается жилой дом 41кв.м. В доме : водопровод, паровое отопление. К дому пристроена большая терраса. На участке баня, кладовая. Плодово-ягодный сад. Отличное место как для постоянного проживания, так и для отдыха.]]></text> <cost>650000</cost> <curr>RUR</curr> <rooms_count>2</rooms_count> <square>82</square> <living_square>20</living_square> <kitchen_square>6</kitchen_square> <land_square>35</land_square> <sum_floor>1</sum_floor> <heating>1</heating> <electricity>1</electricity> <contact_realty>Агентство Недвижимости</contact_realty> <contact_phone>+7(495)1234567</contact_phone> <contact_name>Евгения</contact_name> <contact_email>yourmail@site.ru</contact_email> <photo>http://img.site.ru/I/I_vwscrb7uqx.jpg</photo> <photo>http://img.site.ru/I/I_5pa5xizkj8.jpg</photo> <url>http://site.ru/object/1027</url> <premium>0</premium> </adv> <adv> <id>1028</id> <active_to>2016-07-14T09:33:34+03:00</active_to> <type>дом</type> <operation>продажа</operation> <region>Нижегородская область</region> <ray>Богородский район</ray> <village>деревня Кусаковка</village> <maps>56.191278,43.908025</maps> <text><![CDATA[Дополнительная информация. Все коммуникации в доме. Требуется внутренняя отделка. На первом этаже: кабинет, зал, кухня, с/узел. На втором этаже: 2 спальни, детская.]]></text> <cost>5300000</cost> <curr>RUR</curr> <rooms_count>5</rooms_count> <square>356</square> <living_square>130</living_square> <kitchen_square>10</kitchen_square> <land_square>1</land_square> <sum_floor>2</sum_floor> <heating>1</heating> <sewage>1</sewage> <electricity>1</electricity> <gas>1</gas> <contact_realty>Агентство Недвижимости</contact_realty> <contact_phone>+7(495)1234567</contact_phone> <contact_name>Евгения</contact_name> <contact_email>yourmail@site.ru</contact_email> <photo>http://img.site.ru/I/I_cz9garjao9.jpg</photo> <url>http://site.ru/object/1028</url> <premium>0</premium> </adv> <adv> <id>10656</id> <active_to>2016-07-14T09:33:34+03:00</active_to> <type>квартира</type> <operation>продажа</operation> <region>Нижегородская область</region> <city>Нижний Новгород</city> <street>Днепропетровская улица</street> <house>12</house> <maps>56.28992,43.910711</maps> <text><![CDATA[ул. Днепропетровская,12-Ленинский район -ст.метро"Заречная" 2-х комнатная квартира "улучшенной планировки" на 2-этаже,10-ти этажного панельного дома.1995 год постройки. Общая площадь 52 кв.метров,жилая 31кв. метров, кухня 9 кв.метров. прихожая 8 кв.метров. Комнаты изолированные, санузел раздельно. Лоджия застекленная. Квартира не угловая, теплая-светлая. Состояние квартиры хорошее. Установлены счетчики на газ и воду. Рядом магазины. торговый центр"Муравей". До проспекта Ленина и метро "Заречная" 10 мин. ходьбы.]]></text> <cost>3200000</cost> <curr>RUR</curr> <rooms_count>2</rooms_count> <rooms_type>изолированные</rooms_type> <square>52</square> <living_square>32</living_square> <kitchen_square>9</kitchen_square> <sum_floor>10</sum_floor> <floor>2</floor> <balkon>да</balkon> <wc>раздельный</wc> <lift_count>1</lift_count> <built_year>1995</built_year> <internet>1</internet> <furniture>0</furniture> <phone>0</phone> <condition>0</condition> <facing>с ремонтом</facing> <open_plan>0</open_plan> <contact_phone>+7(495)1234567</contact_phone> <contact_name>Сергей</contact_name> <contact_email>yourmail@site.ru</contact_email> <photo>http://img.site.ru/7/7kn4dRsidE.jpg</photo> <photo>http://img.site.ru/t/tuZFrkP4rB.jpg</photo> <url>http://site.ru/object/10656</url> <premium>0</premium> </adv> </adverts>

Спецпредложения

5-комн. квартира 2,8 млн.p