Требования к XML-фиду для коммерческой недвижимости

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

У элемента 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

Номер лота.

url

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

cadastral-number

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

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.

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 (название населенного пункта).

Пример использования тегов <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».
Примечание. Агентам следует указывать значение «агентство»/«agency».
organization

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

url

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

email

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

photo

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

partner

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

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

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

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

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
  <taxation-form/>
   ...
</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»
  • «+»/«-».

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

taxation-form

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

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

  • «НДС» (арендодатель — плательщик НДС)
  • «УСН» (арендодатель работает по упрощенной системе налогообложения).
Пример передачи данных о цене 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» (продажа права аренды).
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>
<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>
   <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>