Требования к 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»

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

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

Новостройка.

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

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

Завершение строительства - Квартал

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

  • «1»
  • «2»
  • «3»
  • «4»
built-year  

Завершение строительства - Год

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

  • «Сдан»
  • «2017»
  • «2018»
  • ...
  • «2025»
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»

Пример корректного 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>
		<new-flat>1</new-flat>
		<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>
		<is-complete>0</is-complete>
		<intro_desc>Квартира тут</intro_desc>
		<description>Квартира в леннинском районе</description>
		<video>https://www.youtube.com/</video>
		<built-year>2018</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</exchange>
			<url>https://nsk-home.ru/images/ads/1.jpeg</deposit>
			<default>0</haggle>
		</image>
		<image>
			<type>plan</exchange>
			<url>https://nsk-home.ru/images/ads/2.png</deposit>
			<default>1</haggle>
		</image>
		<image>
			<type>photo</exchange>
			<url>https://nsk-home.ru/images/ads/3.jpg</deposit>
			<default>0</haggle>
		</image>
	</offer>
</realty-feed>
	 
			

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

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