Требования к XML-фиду для жилой недвижимости

Общая информация об объявлении

У элемента offer есть обязательный атрибут internal-id, который должен быть уникальным для каждого объявления. Этот атрибут можно заполнять, например, идентификатором объявления в вашей базе данных.

<offer internal-id="1245">
 ...
</offer>
Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
 
Элемент Обязательный элемент Описание
type

Тип сделки.

Строго ограниченные значения:

  • «Продажа»
property-type

Тип недвижимости.

Строго ограниченные значения:

  • «Жилая»
category

Категория объекта.

Строго ограниченные значения:

  • «Квартира»
  • «Квартира в новостройке»
locality-name

Город.

Строго ограниченные значения:

  • «Новосибирск»
  • «Бердск»
sub-locality-name  

Район.

Текстовый параметр

street

Улица.

Текстовый параметр

house-number

Номер дома.

Текстовый параметр

latitude  

Геокоординаты - Широта.

Текстовый параметр

longitude  

Геокоординаты - Долгота.

Текстовый параметр

cadastral-number  

Кадастровый номер.

Текстовый параметр

Информация о продавце или арендодателе

Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
 
Элемент Обязательный элемент Описание
phone

Номер телефона.

Текстовый параметр

10 цифр без кода страны. Пример: 9139838883

agent-name  

Имя субагента.

Текстовый параметр

Информация о субагенте. Данная информация позволяет привязывать объявление к вашему субагенту и регистрировать новых

agent-name  

Email субагента.

Текстовый параметр

website  

Ссылка на вебсайт.

Текстовый параметр

Информация об условиях сделки

 
Элемент Обязательный элемент Описание
price

Цена.

Положительное число

buymode  

Способы покупки.

Во вложенных тегах указывается подробная информация.

<buymode>
  <mortgage/>
  <deferred/>
  <haggle/>
  <exchange/>
  <net-sale/>
  <deposit/>
  <in-pawn/>
</buymode>
mortgage  

Ипотека.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
deferred  

Рассрочка.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
haggle  

Торг.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
exchange  

Обмен.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
net-sale  

Чистая продажа.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
deposit  

Внесен задаток.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
in-pawn  

Находится в залоге.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»

Информация об объекте

 
Элемент Обязательный элемент Описание
area

Общая площадь.

Положительное число

living-space  

Жилая площадь.

Положительное число

kitchen-space  

Площадь кухни.

Положительное число

ownership-type  

Форма собственности

Возможные значения:

  • «Частная»
  • «Договор долевого участия»
  • «Государственная»
  • «Инвестиционная»
  • «Кооперативная»
  • «Не оформлена»
remont-type  

Ремонт

Возможные значения:

  • «Без ремонта»
  • «Требует ремонта»
  • «Частичный ремонт»
  • «Черновая отделка»
  • «С отделкой»
  • «Хороший»
  • «Дизайнерский»
  • «Евро»
intro_desc  

Краткое описание

Текстовый параметр без html-тегов

description

Подробное описание

Текстовый параметр допустимы html-теги

image  

Фотография.

Может быть несколько тегов.
Не следует передавать изображения, не имеющие прямого отношения к объекту (например, логотипы или фотографии сотрудников).

Во вложенных тегах указывается подробная информация.

<image>
  <type/>
  <url/>
  <default/>
</image>
type

Тип фотографии

Возможные значения:

  • «plan» - планировка квартиры
  • «plan_floor» - планировка этажа
  • «photo» - фотография квартиры
url

Ссылка на фотографию.

Текстовый параметр

default  

Является ли фото по-умолчанию.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
video  

Ссылка на видео на YouTube.

Текстовый параметр

Пример: https://www.youtube.com/watch?v=jjo8BXVPXcQ

Описание жилого помещения

 
Элемент Обязательный элемент Описание
rooms

Общее количество комнат в квартире.

При свободной планировке количество комнат указывается согласно паспорту объекта.
Строго ограниченные значения:

  • «студия»
  • «1»
  • «2»
  • «3»
  • «4»
  • «5+»
bathrooms-separate  

Количество раздельный санузлов.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
bathrooms-combined  

Количество совмещенных санузлов.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
loggia-count  

Количество лоджий.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
balcony-count  

Количество балконов.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
windows-look  

Вид из окон.

Строго ограниченные значения:

  • «во двор»
  • «на улицу»
floor  

Этаж.

Положительное целое число

is-apartments  

Апартаменты

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
is-penthouse  

Пентхаус

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
kitchen-stove  

Кухонная плита.

Строго ограниченные значения:

  • «Электрическая»
  • «Газовая»
has-fridge  

Есть холодильник.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
has-furniture  

Есть мебель.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
has-conditioner  

Есть кондиционер.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
has-internet  

Есть интернет.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
has-tv  

Есть телевизор.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»

Описание здания

 
Элемент Обязательный элемент Описание
built-year  

Год постройки.

Положительное целое число

floors-total  

Общее количество этажей в доме.

Положительное целое число

building-type  

Материал стен

Возможные значения:

  • «Кирпичный»
  • «Монолитный»
  • «Панельный»
  • «Блочный»
  • «Деревянный»
  • «Монолитно-кирпичный»
  • «Сталинский»
ceiling-height   Высота потолков в метрах.
elevators-passenger  

Количество пассажирских лифтов.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
elevators-freight  

Количество грузовых лифтов.

Строго ограниченные значения:

  • «нет»
  • «1»
  • «2»
  • «3»
  • «4»
garbage  

Мусоропровод.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
entrances-cnt  

Количество подъездом.

Положительное целое число

flat-total  

Количество квартир в дома.

Положительное целое число

flat-per-floor  

Количество квартир на этаже.

Положительное целое число

parking  

Виды парковки.

Во вложенных тегах указывается подробная информация.

<parking>
  <ground/>
  <multilevel/>
  <underground/>
  <on-roof/>
</parking>
ground  

Наличие наземной парковки.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
multilevel  

Наличие многоуровневой парковки.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
underground  

Наличие подземной парковки.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
on-roof  

Наличие парковки на крыше.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
security  

Есть охрана.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
concierge  

Есть консьерж.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
cap-remont  

Планируется капитальный ремонт дома.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»
dismantling  

Планируется снос дома.

Строго ограниченные значения:

  • «да»/«нет»
  • «yes»/«no»
  • «true»/«false»
  • «1»/«0»

Пример корректного XML-файла



<?xml version="1.0" encoding="UTF-8"?> 
<realty-feed >
	<generation-date>2017-08-01T12:20:00+07:00</generation-date>
		<offer internal-id="1245"><locality-name>Новосибирск</locality-name>
		<sub-locality-name>Ленинский район</sub-locality-name>
		<street>Горская</street>
		<house-number>21</house-number>
		<latitude>54.996712</latitude>
		<longitude>82.898017</longitude>
		<type>Продажа</type>
		<property-type>Жилая</property-type>
		<category>Квартира</category>
		<rooms>1</rooms>
		<area>49.43</area>
		<living-space>26.43</living-space>
		<kitchen-space>18</kitchen-space>
		<loggia-count>1</loggia-count>
		<balcony-count>0</balcony-count>
		<price>3400000</price>
		<floor>14</floor>
		<floors-total>23</floors-total>
		<is-apartments>1</is-apartments>
		<is-penthouse>1</is-penthouse>
		<windows-look>На улицу</windows-look>
		<bathrooms-separate>0</bathrooms-separate>
		<bathrooms-combined>1</bathrooms-combined>
		<ownership-type></ownership-type>
		<remont-type>Косметический</remont-type>
		<ceiling-height>2750</ceiling-height>
		<kitchen-stove>Электрическая</kitchen-stove>
		<has-fridge>1</has-fridge>
		<has-furniture>1</has-furniture>
		<has-conditioner>1</has-conditioner>
		<has-internet>1</has-internet>
		<has-tv>1</has-tv>
		<entrances-cnt>2</entrances-cnt>
		<flat-total>185</flat-total>
		<flat-per-floor>6</flat-per-floor>
		<security>1</security>
		<concierge>0</concierge>
		<cap_remont>0</cap_remont>
		<dismantling>0</dismantling>
		<intro_desc>Квартира тут</intro_desc>
		<description>Квартира в леннинском районе</description>
		<video>https://www.youtube.com/</video>
		<built-year>1996</built-year>
		<building-type>Монолитно-кирпичный</building-type>
		<elevators-passenger>2</elevators-passenger>
		<elevators-freight>1</elevators-freight>
		<garbage>0</garbage>
		<cadastral-number>54:35:101326:44</cadastral-number>		
		<parking>
			<ground>Да</ground>
			<multilevel>Нет</multilevel>
			<underground>Есть</underground>
			<on-roof>Нет</on-roof>
		</parking>
		<buymode>
			<net-sale>Да</net-sale>
			<exchange>Да</exchange>
			<in-pawn>Нет</in-pawn>
			<deposit>Нет</deposit>
			<haggle>Есть</haggle>
			<mortgage>Да</mortgage>
			<deferred>Да</deferred>
		</buymode>
		<agent-name>Ольга Николаевна</agent-name>
		<agent-email>Этот адрес электронной почты защищен от спам-ботов. У вас должен быть включен JavaScript для просмотра.</agent-email>
		<phone>9133978883</phone>
		<website>an-agence.com</website>
		<image>
			<type>plan_floor</type>
			<url>https://nsk-home.ru/images/ads/1.jpeg</url>
			<default>0</default>
		</image>
		<image>
			<type>plan</type>
			<url>https://nsk-home.ru/images/ads/2.png</url>
			<default>1</default>
		</image>
		<image>
			<type>photo</type>
			<url>https://nsk-home.ru/images/ads/3.jpg</url>
			<default>0</default>
		</image>
	</offer>
</realty-feed>
	 
			
Поделитесь с друзьями

Служба помощи

Если у Вас возникли трудности, просто свяжитесь с нами:
8 (913) 397-88-83