Технические требования к XML фиду формата v2.0
Общие технические требования к наполнению фида:
URL фида должен быть постоянным и доступным по протоколу HTTP.
Ни текст объявлений, ни описание характеристик объекта не должны содержать HTML-код.
Если для объявления есть несколько значений одного параметра (например, несколько метро, фото), то нужно передавать несколько одинаковых тегов.
Стандарт XML не допускает наличие символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 — табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.
Символ в тексте
Код для 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 | тип операции |
Пример
|
|
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-файла
![2-комн. квартира 4,6 млн.p](https://img5.kvmeter.ru/upload/resize/flat/43f/256_192_2/43fc8449aeaca503df6c8e5f6ab4b1a0.jpeg)
47.6 / 25 / 5 м2 11 этаж из 17
![2-комн. квартира 9,3 млн.p](https://img4.kvmeter.ru/upload/resize/flat/7c9/256_192_2/7c9be8336a6bda507b9870ea31458571.jpeg)
50.7 / 37 / 7 м2 4 этаж из 5
![Дом 3,5 млн.p](https://img.kvmeter.ru/upload/resize/cottage/5d1/256_192_2/5d10c2b3a9f9fc8421a17a9c2e853275.jpeg)
15 соток / 90 м2
![Дом 25,0 млн.p](https://img3.kvmeter.ru/upload/resize/cottage/abe/256_192_2/abe1ace05064a001b970eca49359fa50.jpeg)
18 соток / 154 м2
![Дом 550 000 p](https://img7.kvmeter.ru/upload/resize/cottage/dbe/256_192_2/dbe9a98e034f26bb7fde680efe3ddc97.jpeg)
10 соток / 32 м2
![Дом 2,8 млн.p](https://img4.kvmeter.ru/upload/resize/cottage/109/256_192_2/10942e6e528cc5200c17f4c8ad842a94.jpeg)
8.14 соток / 95 м2
![1-комн. квартира 13,2 млн.p](https://img.kvmeter.ru/upload/resize/flat/d6d/256_192_2/d6d4521f2221ea8e9b41044d844b5d14.jpeg)
45 / 14.4 / 17.2 м2 7 этаж из 9
![3-комн. квартира 15,0 млн.p](https://img7.kvmeter.ru/upload/resize/flat/677/256_192_2/67784b803b4b7982c3fb956ab58b1d8e.jpeg)
63 / 45 / 7 м2 2 этаж из 12
![Дом 10,0 млн.p](https://img9.kvmeter.ru/upload/resize/cottage/f5d/256_192_2/f5de5653dc68eca1e63374740d6ee773.jpeg)
9 соток / 54.5 м2
![Дом 150,0 млн.p](https://img.kvmeter.ru/upload/resize/cottage/604/256_192_2/604a041481af84c72fd4cb1c2f9866da.jpeg)
12 соток / 198 м2
![Участок 5,5 млн.p](https://img7.kvmeter.ru/upload/resize/land/f9d/256_192_2/f9de5c56e911d44ab06257a2416c4a96.jpeg)
18 соток
![Участок 9,8 млн.p](https://img5.kvmeter.ru/upload/resize/land/8d3/256_192_2/8d327036fed4d631666141ddac316a20.jpeg)
7.8 соток
![Участок 23,0 млн.p](https://img5.kvmeter.ru/upload/resize/land/fb9/256_192_2/fb9c0d9fcc75ed744a1fe850eed2447b.jpeg)
6.8 соток
![Участок 2,0 млн.p](https://img1.kvmeter.ru/upload/resize/land/afb/256_192_2/afb7a7419639538d072255e3d4deb135.jpeg)
6 соток