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

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

Можно задать расписание включения «Поднятия» добавив элемент schedule. Тогда получится выбрать несколько start-time для одного объявления. И даже несколько в один день.

Возможные значения:
  • everyday – каждый день;
  • onlyweekdays — только в будние;
  • onlyweekends — только в выходные.

Пример:

В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы.

<vas start-time="2020-07-17T12:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T15:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T18:00:00+03:00" schedule="onlyweekends">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

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

Элемент указывается только для загородной недвижимости.
Элемент Обязательный элемент Описание
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>

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

Можно задать расписание включения «Поднятия» добавив элемент schedule. Тогда получится выбрать несколько start-time для одного объявления. И даже несколько в один день.

Возможные значения:
  • everyday – каждый день;
  • onlyweekdays — только в будние;
  • onlyweekends — только в выходные.

Пример:

В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы.

<vas start-time="2020-07-17T12:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T15:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T18:00:00+03:00" schedule="onlyweekends">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

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

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

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

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

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

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

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

    или

  • locality-name (название населенного пункта).
Пример использования тегов <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>
Примечание. Допускается передача всего адреса тегом <address> и координатами: 

          <location>
          <address>Москва, Садовническая улица, 82с2</address>
          <latitude>55.735525</latitude>
          <longitude>37.642474</longitude>
          </location>

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

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

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

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

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

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

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

Должен начинаться с «+7», номера с «8-800» не подходят.

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

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

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

Номер телефона для подключения функционала чатов.

Должен начинаться с «+79», номера с «880» не подходят.
Пример: 
<whatsapp-phone>+79ХХХХХХХХХ</whatsapp-phone>
Примечание. На указанном номере телефона обязательно должен быть установлен WhatsApp.
category

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

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

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

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

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

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

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
partner

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

Элемент указывается только для досок объявлений.
Элемент Обязательный элемент Описание
sales-agent

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

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

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

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

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

Должен начинаться с «+7», номера с «8-800» не подходят.

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

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

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

Номер телефона для подключения функционала чатов.

Должен начинаться с «+79», номера с «880» не подходят.
Пример: 
<whatsapp-phone>+79ХХХХХХХХХ</whatsapp-phone>
Примечание. На указанном номере телефона обязательно должен быть установлен WhatsApp.
category

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

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

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

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

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

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

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
partner

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

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

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

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

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
  <taxation-form/>
</price>
Примечание. Не добавляйте в <price> ничего , кроме перечисленных выше элементов. Иначе ваше объявление сломается.
value

Цена.

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

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

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

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

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

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

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

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

  • «день»/«day»
  • «месяц»/«month».
unit

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

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

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

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

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

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

Предоплата.

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

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

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

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

Максимальное значение — 600.

rent-pledge Залог.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-».

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

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

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

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

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

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
  <taxation-form/>
</price>
Примечание. Не добавляйте в <price> ничего , кроме перечисленных выше элементов. Иначе ваше объявление сломается.
value

Цена.

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

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

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

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

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

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

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

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

  • «день»/«day»
  • «месяц»/«month».
unit

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

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

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

  • «кв. м»/«sq. m»
  • «сотка»
  • «гектар»/«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»
  • «+»/«-».
Элемент Обязательный элемент Описание
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»
  • «сотка»
  • «гектар»/«hectare».
image

Фотография.

Обязательный элемент. Добавьте не менее 2 фото.

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

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
is-image-order-change-allowed «Умные фотографии».

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-».
renovation

Ремонт.

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

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

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

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

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

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

Описание в свободной форме. Ограничение – 10 000 знаков.
video-review Видео объекта с YouTube и возможность онлайн-показа.

<youtube-video-review-url> — прямая ссылка на видео с вашим объектом с YouTube, без сокращений и счётчиков переходов.

Примечание. Cсылка должна быть без параметра таймкода, например &t=2s.

<online-show> — если вы готовы показать недвижимость по видео-звонку, например в WhatsApp, Skype, Viber или FaceTime, добавьте этот тег со значением 1.

Пример: 

<video-review>   
  <youtube-video-review-url>http://youtu.be/iwGFalTRHDA</youtube-video-review-url>
  <online-show>1</online-show>
</video-review>
Элемент Обязательный элемент Описание
area

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

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

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

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

Площадь.

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

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

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

Возможные значения:
  • «кв. м»/«sq. m»
  • «сотка»
  • «гектар»/«hectare».
image

Фотография.

Обязательный элемент. Добавьте не менее 2 фото.

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

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
is-image-order-change-allowed «Умные фотографии».

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-».
renovation

Ремонт.

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

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

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

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

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

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

Описание в свободной форме. Ограничение – 10 000 знаков.
video-review Видео объекта с YouTube и возможность онлайн-показа.

<youtube-video-review-url> — прямая ссылка на видео с вашим объектом с YouTube, без сокращений и счётчиков переходов.

Примечание. Cсылка должна быть без параметра таймкода, например &t=2s.

<online-show> — если вы готовы показать недвижимость по видео-звонку, например в WhatsApp, Skype, Viber или FaceTime, добавьте этот тег со значением 1.

Пример: 

<video-review>   
  <youtube-video-review-url>http://youtu.be/iwGFalTRHDA</youtube-video-review-url>
  <online-show>1</online-show>
</video-review>
Пример передачи данных о площадях объекта недвижимости 
<area>
    <value>56</value>
    <unit>кв. м</unit>
</area>

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

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

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

Этаж.

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

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

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

  • «common» (общий)
  • «separate» (отдельный).
open-plan

Свободная планировка.

Строго ограниченные значения:
  • «да»
  • «true»
  • «1»
  • «+».
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

Вид из окон.

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

  • «во двор»
  • «на улицу»
  • «во двор и на улицу».
Элемент Обязательный элемент Описание
rooms

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

Этаж.

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

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

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

  • «common» (общий)
  • «separate» (отдельный).
open-plan

Свободная планировка.

Строго ограниченные значения:
  • «да»
  • «true»
  • «1»
  • «+».
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»
  • «+»/«-».
yandex-building-id

Идентификатор жилого комплекса в базе Яндекса.

Указывайте только есть ваш объект находится в новостройке.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в третьем столбце списка yandex-building-id.

Будет виден в URL карточки вашего ЖК.
yandex-house-id Идентификатор корпуса жилого комплекса в базе Яндекса.

Указывайте только есть ваш объект находится в новостройке.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в седьмом столбце списка yandex-building-id.
Элемент Описание
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»
  • «+»/«-».
yandex-building-id

Идентификатор жилого комплекса в базе Яндекса.

Указывайте только есть ваш объект находится в новостройке.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в третьем столбце списка yandex-building-id.

Будет виден в URL карточки вашего ЖК.
yandex-house-id Идентификатор корпуса жилого комплекса в базе Яндекса.

Указывайте только есть ваш объект находится в новостройке.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в седьмом столбце списка yandex-building-id.

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

Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент Описание
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

Комментарий про температурный режим на складе.
Элемент Описание
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>