Передача данных о коммерческой недвижимости

Фид с объявлениями для Яндекс.Недвижимости составляется на языке YRL (Yandex Realty Language), разработанном в Яндексе.

YRL основан на стандарте XML (Extensible Markup Language). Как и XML, YRL не позволяет использовать первые 32 ASCII-символа в текстовых полях (исключения — табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы:

Символ, который нужно заменить Код для YRL-файла
" "
& &
> >
< &lt;
' &apos;
Кодировка

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

Заголовок документа

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

<?xml version="1.0" encoding="utf-8"?>
Корневой элемент

Корневой элемент YRL-фида (realty-feed) должен содержать элемент generation-date с датой создания фида и элементы offer, в каждом из которых должна находиться информация из одного объявления. Чтобы указать пространство имен в XML, используйте атрибут xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06".

<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">   <generation-date>2010-10-05T16:36:00+04:00</generation-date>   
 <offer>     
  ...   
 </offer>   
 ... 
</realty-feed>
Формат даты

Все даты и время следует указывать согласно стандарту ISO 8601. В общем случае — в формате YYYY-MM-DDTHH:mm:ss+00:00, где:

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

Ниже описаны все возможные элементы фида, сгруппированные по их назначению в языке YRL.

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

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

У элемента offer есть обязательный атрибут 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>

Номер лота

<cadastral-number>

Кадастровый номер объекта недвижимости

<url>

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

Обязательный элемент для досок объявлений

<creation-date>

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

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

<last-update-date>

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

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

<expire-date>

Дата и время, до которых объявление актуально.

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

<payed-adv>

Признак оплаченного объявления.

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<manually-added>

Признак объявления, добавленного вручную.

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<vas>

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

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

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

  • «premium»
  • «raise»
  • «promotion»
<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>

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

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

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

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

  • district (обязателен для городов, находящихся в областях субъектов РФ);
  • locality-name (название населенного пункта);
  • address (улица или улица и дом).

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

  • district (район субъекта РФ)

    или

    locality-name (название населенного пункта)

    или

    direction (шоссе — для объектов в Московской области)

    или

    railway-station (ближайшая железнодорожная станция).

Пример использования тегов <region>, <district> и <sub-locality-name> при описании адреса
<location>
    <country>Россия</country>
    <region>Московская область</region>
    <district>Одинцовский район</district>
    <locality-name>Одинцово</locality-name>
        <sub-locality-name>Центральный</sub-locality-name>
        <non-admin-sub-locality>Центр</non-admin-sub-locality>
    <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.

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

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

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

  • «агентство»/«agency»
  • «владелец»/«owner»
  • «застройщик»/«developer»
<organization>

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

<agency-id>

Внутренний ID агентства в базе партнера.

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

<url>

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

<email>

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

<photo>

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

<partner>

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

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

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

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

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
</price>
<value>

Цена.

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

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

<currency>

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

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

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

  • «RUR» или «RUB» (российский рубль)
  • «EUR» (евро)
  • «USD» (американский доллар)
<unit>

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

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

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

  • «кв. м»/«sq. m»
  • «cотка»
  • «гектар»/«hectare»
<commission>

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

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

<security-payment>

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

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

Пример передачи данных о цене 1 кв. м.
<price>
    <value>60000</value>
    <currency>RUB</currency>
    <unit>кв.м</unit>
</price>
Пример передачи данных о цене аренды объекта недвижимости сроком на 1 месяц
<price>
    <value>700</value>
    <currency>USD</currency>
    <period>месяц</period>
</price>

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

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

Тип сделки.

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

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

  • «direct rent» (прямая аренда)
  • «subrent» (субаренда)
  • «sale of lease rights» (продажа права аренды)
<period>

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

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

  • «день»/«day»
  • «месяц»/«month»
<cleaning-included>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<utilities-included>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<electricity-included>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<taxation-form>

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

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

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

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

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

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

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

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

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

Площадь.

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

<unit>

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

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

Возможные значения: «кв. м»/«sq. m»

<image>

Фотография.

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

Может быть несколько тегов. Фотографии планировок следует передавать первым тегом image.

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

<renovation>

Ремонт.

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

  • «дизайнерский»
  • «евро»
  • «с отделкой»
  • «требует ремонта»
  • «хороший»
  • «частичный ремонт»
  • «черновая отделка»
<quality>

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

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

  • «отличное»
  • «хорошее»
  • «нормальное»
  • «плохое»
<description>

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

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

Пример передачи данных о площадях объекта недвижимости
<area>
    <value>56</value>
    <unit>кв. м</unit>
</area>
<living-space>
    <value>36</value>
    <unit>кв. м</unit>
</living-space>
<room-space>
    <value>20</value>   
    <unit>кв. м</unit> 
</room-space>
<room-space>
    <value>16</value>   
    <unit>кв. м</unit> 
</room-space>
<kitchen-space>
    <value>8</value>
    <unit>кв. м</unit>
</kitchen-space>
Пример передачи данных о площади участка
<lot-area>
    <value>15</value>
    <unit>сот</unit>
</lot-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>
<url>http://commer.ru/spb/1</url>
<creation-date>2013-11-22T12:25:20+04:00</creation-date>
<last-update-date>2016-03-23T11:38:29+04:00</last-update-date>
<location>
  <country>Россия</country>
  <district>Санкт-Петербург</district>
  <locality-name>г. Санкт-Петербург</locality-name>
  <sub-locality-name>Центральный</sub-locality-name>
  <address>Невский пр., 35, лит. А</address>
</location>
<sales-agent>
   <phone>+78121234567</phone>
   <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>