Технические требования к фиду

Внимание! Размер фида должен быть не более 20Mb!

Язык описания объектов недвижимости
Фид с объявлениями для Best-House.org должен быть составлен на языке стандарта XML (Extensible Markup Language).

Кодировка
Файл фида должен быть создан в кодировке UTF-8.

Заголовок документа
XML-документ должен начинаться (с нулевого символа первой строки) со стандартного XML-заголовка.

<?xml version="1.0" encoding="utf-8"?>

Документ должен содержать корневой элемент realty-feed.

<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
    <generation-date>
2010-10-05T16:36:00+04:00 </generation-date>
        ...
</realty-feed>

Элемент realty-feed должен содержать следующие элементы:

xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06" — способ указать namespace в XML ( http://en.wikipedia.org/wiki/XML_Namespace)
generation-date — содержит информацию о дате и времени создания данного файла

Формат даты

Формат даты: YYYY-MM-DDTHH:mm:ss+04:00.
Стандартный формат ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601)

Дата и время создания файла на стороне сервера.

YYYY — год
MM — месяц
DD — день
HH — час
mm — минута
ss — секунда
+ 04:00 — указание часового пояса (в данном случае — для Москвы).

Пользователь обязан следить за изменением формата даты при переводе часов.

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

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

Примечание. Элементы, отмеченные знаком «*», являются обязательными. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
 

Элементы

Описание

type* Тип сделки: продажа или аренда
property-type*

Тип недвижимости:  жилая или коммерческая

category*

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

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

Жилая недвижимость:
1 - комнатная квартира, 2 - комнатная квартира, 3 - комнатная квартира, 4 - комнатная квартира, Дача, Коттедж, Двухуровневые апартаменты, Гостиница 1 - комната, Гостиница 2 - комнаты, Гостиница 3 - комнаты, Гостиница многокомнатная, Дом, Участок, Многокомнатная квартира, Пентхауз, Комнаты, Трехуровневые апартаменты, Таунхаус, Вилла

Коммерческая недвижимость:
Актовый зал, Автосалон, Банк, Парикмахерская, Салон красоты, Здание, Бизнес центр, Кафе, Автомойка, Коммерческие и офисные помещения, Концертный зал, Гараж, Ангар, Гостиница, Нежилое помещение, Офис, Парковка, Автостоянка, Павильон, Аптека, Производственное помещение, Имущественный комплекс, База отдыха, Автозаправка, Ресторан, Станция техобслуживания, Торговая площадь, Магазин, Спортивный комплекс, Земельный участок, Склад, Нефтебаза, Торговый центр, Мастерская

location*

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

<location>     
      <country>
      <region>
      <locality-name>
      <address>
 </location>
country*

Страна, в которой расположен объект

region*

Название области в стране

locality-name*

Название города или населенного пункта

address*

Улица и номер дома

latitude

Географическая широта

longitude

Географическая долгота

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

Элементы

Описание

sales-agent

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

<sales-agent>
    <name>
    <phone>
</sales-agent>
name Имя продавца, арендодателя или агента
phone Контактный номер телефона (указывается в международном формате). Если номеров несколько, каждый из них необходимо передавать в отдельном элементе phone.
Если имени или телефона в фиде не будет, то будут подставлены контакты из вашего профиля.

Информация об условиях сделки
Элементы, отмеченные знаком «*», являются обязательными.
 

Элементы

Описание

price*

Набор элементов, описывающих стоимость объекта. Может содержать следующие вложенные элементы:

<price>
  <value>
  <currency>
</price>
value*

Цена (сумма указывается без пробелов).

Внимание! Цена должна включать в себя НДС (если он есть) и постоянные эксплуатационные расходы (для коммерческой недвижимости).

currency*

Валюта, в которой указана цена.

Поддерживаемые значения: "RUR" или "RUB" (российский рубль), "EUR" (евро), "USD" (американский доллар), "UAH" (украинская гривна)

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

Элементы

Описание

area

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

Значение и единица измерения площади передаются во вложенных тэгах:

<area>
  <value>
  <unit> 
</area>
living-space

Жилая площадь (при продаже комнаты — площадь комнаты).

<living-space>
   <value>
   <unit>
</living-space>
image*

Фотография (может быть несколько тегов).

Примечание. Обязательное поле для всех видов объявлений

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

renovation*

Ремонт.

Доступные значения: авторский ремонт, евро ремонт, хорошее состояние, требуется ремонт, капитальный ремонт, косметический ремонт

description* Дополнительная информация (описание в свободной форме)

Описание жилого помещения
Элементы, отмеченные знаком «*», являются обязательными. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
 

Элементы

Описание

rooms*

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

floor

Этаж.

phone

Наличие телефона.

Строго ограниченные значения: «да»/«нет», «true»/«false», «1»/«0», «+»/«-».

internet

Наличие интернета.

Строго ограниченные значения: «да»/«нет», «true»/«false», «1»/«0», «+»/«-».

room-furniture

Наличие мебели.

Строго ограниченные значения: «да»/«нет», «true»/«false», «1»/«0», «+»/«-».

television

Наличие телевизора.

Строго ограниченные значения: «да»/«нет», «true»/«false», «1»/«0», «+»/«-».

washing-machine

Наличие стиральной машины.

Строго ограниченные значения: «да»/«нет», « true»/«false», «1»/«0», «+»/«-».

dishwasher

Наличие посудомоечной машины.

Строго ограниченные значения: «да»/«нет», « true»/«false», «1»/«0», «+»/«-».

refrigerator

Наличие холодильника.

Строго ограниченные значения: «да»/«нет», «true»/«false», «1»/«0», «+»/«-».

built-in-tech

Встроенная техника.

Строго ограниченные значения: «да»/«нет», « true»/«false», «1»/«0», «+»/«-».

Пример фида:

<?xml version="1.0" encoding="UTF-8"?>
<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
<generation-date>2016-07-21T12:57:14+03:00</generation-date>
    <offer internal-id="123">
        <type>продажа</type>
        <property-type>жилая</property-type>
        <category>квартира</category>        
        <url>http://ссылка на объявление</url>
        <creation-date>2016-07-18T09:09:33+03:00</creation-date>
        <last-update-date>2016-07-21T12:57:14+03:00</last-update-date>
        <location>
            <country>Россия</country>            
            <region>Московская обл.</region>
            <locality-name>Москва</locality-name>
            <address>Строителей, 4</address>
        </location>
        <sales-agent>
            <name>Агент</name>
            <phone>+111-222-333</phone>
        </sales-agent>
        <price>
            <value>1688200</value>
            <currency>RUB</currency>
        </price>
        <image>http://прямая ссылка на изображение.jpg</image>
        <description>Продается однокомнатная  квартира в хорошем состоянии ....</description>
        <area>
            <value>36,7</value>
            <unit>кв.м</unit>
        </area>
        <rooms>1</rooms>
        <floor>12</floor>
        <floors-total>18</floors-total>
        <renovation>косметический ремонт</renovation>
    </offer>
    <offer internal-id="124">
        <type>аренда</type>
        <property-type>коммерческая</property-type>
        <category>офис</category>        
        <url>http://ссылка на объявление</url>
        <creation-date>2016-07-18T09:09:33+03:00</creation-date>
        <last-update-date>2016-07-21T12:57:14+03:00</last-update-date>
        <location>
            <country>Россия</country>            
            <region>Московская обл.</region>
            <locality-name>Москва</locality-name>
            <address>Монтажников, 12</address>
        </location>
        <sales-agent>
            <name>Агент</name>
            <phone>+111-222-333</phone>
        </sales-agent>
        <price>
            <value>23000</value>
            <currency>RUB</currency>
        </price>
        <image>http://прямая ссылка на изображение.jpg</image>
        <description>Сдается офис в хорошем состоянии ....</description>
        <area>
            <value>22,0</value>
            <unit>кв.м</unit>
        </area>
        <floor>1</floor>
        <floors-total>3</floors-total>
        <renovation>евро ремонт</renovation>
    </offer>
</realty-feed>