R24 / Вимоги до передачі даних / Вимоги до XML-фіду для комерційної нерухомості

Вимоги до XML-фіду для комерційної нерухомості

Перед подготовкой XML-фида ознакомьтесь с требованиями к передаче данных.

  1. Общая информация об объявлении
  2. Информация о продавце или арендодателе
  3. Информация об условиях сделки
  4. Информация об объекте
  5. Описание нежилого помещения
  6. Описание здания
  7. Описание особенностей складских и производственных помещений
  8. Пример корректного YRL-файла

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

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

<offer internal-id="А1245">
 ...
</offer>

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

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

Тип сделки.

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

  • «продажа»

  • «аренда».
category Да

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

Строго ограниченное значение: «коммерческая»/«commercial».
commercial-type Да

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

Элемент может повторяться несколько раз, если у объекта несколько назначений.

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

  • «auto repair» (автосервис)

  • «business» (готовый бизнес)

  • «free purpose» (помещения свободного назначения)

  • «hotel» (гостиница)

  • «land» (земли коммерческого назначения)

  • «legal address» (юридический адрес)

  • «manufacturing» (производственное помещение)

  • «office» (офисные помещения)

  • «public catering» (общепит)

  • «retail» (торговые помещения)

  • «warehouse» (склад).
commercial-building-type  

Тип здания, в котором находится объект.

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

  • «business center» (бизнес-центр)

  • «detached building» (отдельно стоящее здание)

  • «residential building» (встроенное помещение)

  • «shopping center» (торговый центр)

  • «warehouse» (складской комплекс).
purpose  

Рекомендуемое назначение объекта.

Элемент может повторяться несколько раз.

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

  • «bank» (помещение для банка)

  • «beauty shop» (салон красоты)

  • «food store» (продуктовый магазин)

  • «medical center» (медицинский центр)

  • «show room» (шоу-рум)

  • «touragency» (турагентство).
purpose-warehouse  

Назначение склада.

Элемент может повторяться несколько раз.

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

  • «alcohol» (алкогольный склад)

  • «pharmaceutical storehouse» (фармацевтический склад)

  • «vegetable storehouse» (овощехранилище).
lot-number  

Номер лота.
url  

URL страницы с объявлением.
cadastral-number  

Кадастровый номер объекта недвижимости.
creation-date Да

Дата создания объявления.

Указывается в формате YYYY-MM-DDTHH:mm:ss+00:00.

Внимание. Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления.
vas  

Дополнительная услуга по продвижению объявления.

Элемент указывается, если к объявлению должна быть применена дополнительная услуга.

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

  • «premium»

  • «raise»

  • «promotion».

Для значения «raise» (услуги «Поднятие») можно применить ежедневное автоподключение в определенное время.

Для этого внутри vas укажите атрибут start-time, дату и время в формате YYYY-MM-DDTHH:mm:ss+00:00 и значение raise.

Пример: 
<vas start-time="2018-06-04T10:00:00+03:00">raise</vas>

Должна быть указана дата первого применения услуги. Обновлять атрибут не нужно. Объявление, к которому применена услуга, будет подниматься ежедневно в указанное время.

Внимание. Услуги нельзя подключить к объявлениям без фотографий.
location Да

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

<location>
      <country/>
      <region/>
      <district/>
      <locality-name/>
      …
 </location>
country Да

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

Примечание. В настоящее время объявления принимаются только для объектов недвижимости, расположенных в России.
region  

Название субъекта РФ.

Необязательный элемент для объектов в Москве и Санкт-Петербурге.
district  

Название района субъекта РФ.
locality-name  

Название населенного пункта.
sub-locality-name  

Район населенного пункта.
address  

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

Номер дома необязательно указывать для загородной недвижимости.
apartment  

Номер квартиры.
direction  

Шоссе.

Элемент передается только для объектов в Москве и Московской области.
distance  

Расстояние по шоссе до МКАД.

Значение указывается в километрах.

Элемент передается только для объектов в Москве и Московской области.
latitude  

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

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

Ближайшая станция метро.

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

<metro>
      <name/>
      <time-on-foot/>
      <time-on-transport/>
</metro>
name  

Название станции метро.
time-on-transport  

Время до метро в минутах на транспорте.
time-on-foot  

Время до метро в минутах пешком.
railway-station  

Ближайшая железнодорожная станция.

Элемент указывается только для загородной недвижимости.

Примечание. Формат передачи данных для описания гаражей, машиномест и боксов смотрите в разделе Описание гаражей.

В зависимости от типа недвижимости обязательны разные параметры, описывающие адрес.

Для городской недвижимости обязательны следующие параметры:

Для загородной недвижимости обязательны следующие поля:

Пример использования тегов <region>, <district> и <sub-locality-name> при описании адреса

<location>
    <country>Россия</country>
    <region>Московская область</region>
    <district>Одинцовский район</district>
    <locality-name>Одинцово</locality-name>
        <sub-locality-name>Центральный</sub-locality-name>
    <address>Пушкинская ул., д. 12</address>
    <direction>Минское шоссе</direction>
</location>

Пример использования тега <metro> при описании городской недвижимости

<location>
       <country>Россия</country>
       <locality-name>Санкт-Петербург</locality-name>
       <sub-locality-name>Адмиралтейский</sub-locality-name>
       <address>Измайловский пр., 16</address>
       <metro>
          <name>Технологический институт</name>
          <time-on-foot>10</time-on-foot>
          <time-on-transport>5</time-on-transport>
       </metro>
</location>

Пример использования тегов <direction> и <distance> при описании загородной недвижимости (для Московской области)

<location>
       <country>Россия</country>
       <region>Московская область</region>
       <district>Истринский район</district>
       <locality-name>деревня Подушкино</locality-name>
       <direction>Рублево-Успенское шоссе</direction>
       <distance>10</distance>
</location>

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

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

Элемент Обязательный элемент Описание
sales-agent Да

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

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

<sales-agent>
    <name/>
    <phone/>
    <category/>
    <organization/>
    <url/>
    <photo/>
    …
</sales-agent>
name  

Имя продавца, арендодателя или агента.
phone Да

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

Номер указывается в международном формате.

Пример: 
<phone>+74951234567</phone>

Если номеров несколько, каждый из них необходимо передавать в отдельном элементе phone.

Примечание. Для агентств недвижимости обязательно должны быть указаны прямые телефоны агентов.
category Да

Тип продавца или арендодателя.

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

  • «агентство»/«agency»

  • «владелец»/«owner»

  • «застройщик»/«developer».

Примечание. Агентам следует указывать значение «агентство»/«agency».
organization  

Название организации.
url  

Сайт агентства или застройщика.
email  

Электронный адрес продавца.
photo  

Ссылка на фотографию агента или логотип компании.
partner  

Название партнера, предоставившего объявление.

Элемент указывается только для досок объявлений.

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

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

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
  <taxation-form/>
</price>

Примечание. Запрещено указывать любые другие элементы кроме перечисленных внутри <price>.
value Да

Цена.

Значение указывается без пробелов.

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

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

Цену предложения следует передавать только в той валюте, которая указана в объявлении.

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

  • «RUR» или «RUB» (российский рубль)

  • «EUR» (евро)

  • «USD» (американский доллар).
period  

Длительность аренды.

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

  • «день»/«day»

  • «месяц»/«month».
unit  

Единица площади помещения или участка.

Параметр нужно передавать, если цена указана за единицу площади.

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

  • «кв. м»/«sq. m»

  • «cотка»

  • «гектар»/«hectare».
commission  

Размер комиссии для клиента в процентах.

Указывается целое число в процентах без знака «%».
prepayment  

Предоплата.

Указывается числовое значение в процентах без знака «%».

Максимальное значение — 100.
security-payment  

Размер обеспечительного платежа в процентах.

Указывается целое число в процентах без знака «%».

Максимальное значение — 600.
rent-pledge   Залог.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».

Элемент не используется для объявлений о продаже.

Внимание. Элемент нельзя передавать внутри тега <price>.
taxation-form  

Форма налогообложения арендодателя для аренды.

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

  • «НДС» (арендодатель — плательщик НДС)

  • «УСН» (арендодатель работает по упрощенной системе налогообложения).

Пример передачи данных о цене 1 кв. м.

<price>
    <value>60000</value>
    <currency>RUB</currency>
    <unit>кв.м</unit>
</price>
<rent-pledge>false</rent-pledge>

Пример передачи данных о цене аренды объекта недвижимости сроком на 1 месяц

<price>
    <value>700</value>
    <currency>USD</currency>
    <period>месяц</period>
</price>

Дополнительная информация об аренде коммерческой недвижимости

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

Элемент Обязательный элемент Описание
deal-status Да

Тип сделки.

Обязательный элемент только для объявлений об аренде коммерческой недвижимости. При продаже элемент передавать не нужно.

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

  • «direct rent» (прямая аренда)

  • «subrent» (субаренда)

  • «sale of lease rights» (продажа права аренды).
cleaning-included  

Клининг входит в договор аренды.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
utilities-included  

Коммунальные услуги включены в стоимость в договоре.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
electricity-included  

Электроэнергия включена в стоимость в договоре.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».

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

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

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

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

Обязательный элемент для всех объявлений, кроме участков.

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

<area>
  <value/>
  <unit/>
</area>
value  

Площадь.

Указывается числовое значение.
unit  

Единица площади помещения или участка.

Элемент используется, если цена указана за единицу площади.

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

  • «кв. м»/«sq. m»

  • «cотка»

  • «гектар»/«hectare».
image Да

Фотография.

Обязательный элемент для объявлений о сдаче недвижимости в аренду.

Может быть несколько тегов.

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

Ремонт.

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

  • «дизайнерский»

  • «евро»

  • «с отделкой»

  • «требует ремонта»

  • «хороший»

  • «частичный ремонт»

  • «черновая отделка».
quality  

Состояние объекта.

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

  • «отличное»

  • «хорошее»

  • «нормальное»

  • «плохое».
description  

Дополнительная информация.

Описание в свободной форме.

Пример передачи данных о площадях объекта недвижимости

<area>
    <value>56</value>
    <unit>кв. м</unit>
</area>

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

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

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

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

Этаж.

Обязательный элемент для агентств недвижимости.
entrance-type  

Вход в помещение.

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

  • «common» (общий)

  • «separate» (отдельный).
phone-lines  

Количество телефонных линий.
adding-phone-on-request  

Возможность добавления телефонных линий.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
internet  

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
self-selection-telecom  

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
room-furniture  

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
air-conditioner  

Наличие системы кондиционирования.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
ventilation  

Наличие вентиляции.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
fire-alarm  

Наличие пожарной сигнализации.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
water-supply  

Наличие водопровода.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
sewerage-supply  

Наличие канализации.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
electricity-supply  

Наличие электроснабжения.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
electric-capacity  

Выделенная электрическая мощность.

Указывается целое число. Значение передается в кВт.
gas-supply  

Подключение к газовым сетям.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
floor-covering  

Покрытие пола.

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

  • «ковролин»

  • «ламинат»

  • «линолеум»

  • «паркет».
heating-supply  

Наличие отопления.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
window-type  

Тип окон.

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

  • «витринные»

  • «маленькие»

  • «обычные».
window-view  

Вид из окон.

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

  • «во двор»

  • «на улицу».

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

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

Элемент Описание
office-class

Класс бизнес-центра.

Возможные значения: «A», «A+», «B», «B+», «C», «C+».
ceiling-height

Высота потолков в метрах.
guarded-building

Закрытая территория.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
access-control-system

Наличие пропускной системы.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
twenty-four-seven

Возможность круглосуточного доступа сотрудников арендатора на объект аренды 7 дней в неделю.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
lift

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
parking

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
parking-places

Количество предоставляемых парковочных мест.
parking-place-price

Стоимость парковочного места.

Указывается стоимость одного места в месяц в рублях.
parking-guest

Наличие гостевых парковочных мест.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
parking-guest-places

Количество гостевых парковочных мест.
security

Наличие охраны.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
eating-facilities

Наличие предприятий общепита в здании.

Элемент передается для бизнес-центров и складских комплексов.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
is-elite

Элитная недвижимость.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».

Описание особенностей складских и производственных помещений

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

Элемент Описание
responsible-storage

Ответственное хранение.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
pallet-price

Стоимость палето-места в месяц в рублях с учетом налогов.

Указывается в случае ответственного хранения.
freight-elevator

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

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
truck-entrance

Возможность подъезда фуры.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
ramp

Наличие пандуса.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
railway

Наличие ветки железной дороги.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
office-warehouse

Наличие офиса на складе.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
open-area

Наличие открытой площадки.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
service-three-pl

Наличие 3PL (логистических) услуг.

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

  • «да»/«нет»

  • «true»/«false»

  • «1»/«0»

  • «+»/«-».
temperature-comment

Комментарий про температурный режим на складе.

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

<?xml version="1.0" encoding="UTF-8"?>
<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
     <generation-date>2010-12-11T12:00:00+04:00</generation-date>

<!--Коммерческая недвижимость-->
<offer internal-id="1">
<type>аренда</type>
<category>commercial</category>
<commercial-type>office</commercial-type>
<commercial-building-type>business center</commercial-building-type>
<creation-date>2013-11-22T12:25:20+04:00</creation-date>
<location>
  <country>Россия</country>
  <district>Санкт-Петербург</district>
  <locality-name>г. Санкт-Петербург</locality-name>
  <sub-locality-name>Центральный</sub-locality-name>
  <address>Невский пр., 35, лит. А</address>
<metro>
          <name>Гостиный двор</name>
          <time-on-foot>1</time-on-foot>
       </metro>
</location>
<sales-agent>
   <phone>+78121234567</phone>
   <category>agency</category>
   <organization>Успех</organization>
   <url>http://commer.ru/spb/</url>
   <photo>http://commer.ru/new/logo.png</photo>
</sales-agent>
<price>
    <value>276800</value>
    <currency>RUB</currency>
    <period>month</period>
    <taxation-form>НДС</taxation-form>
</price>
<commission>0</commission>
<security-payment>100</security-payment>
<utilities-included>true</utilities-included>
<electricity-included>true</electricity-included>
<deal-status>direct rent</deal-status>
<area>
  <value>138.4</value>
  <unit>кв. м</unit>
</area>
<image>http://commer.ru/image/1.jpg</image>
<renovation>с отделкой</renovation>
<quality>отличное</quality>
<description>Офисный блок состоит из 3 помещений с мансардными окнами: зал open-space 105,3 кв. м и еще 2 помещения (16.7 и 16.4 кв. м)</description>
<rooms>1</rooms>
<internet>true</internet>
<air-conditioner>true</air-conditioner>
<ventilation>true</ventilation>
<fire-alarm>true</fire-alarm>
<heating-supply>true</heating-supply>
<electricity-supply>true</electricity-supply>
<floor>4</floor>
<floors-total>6</floors-total>
<building-name>Невский 38</building-name>
<office-class>A</office-class>
<built-year>2004</built-year>
<access-control-system>true</access-control-system>
<twenty-four-seven>true</twenty-four-seven>
<lift>true</lift>
<security>true</security>
</offer>
</realty-feed>