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

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

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

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

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

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

Примечание

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

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

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

  • 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

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

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

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

Элемент

Обязательный элемент

Описание

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»
  • «+»/«-».

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

Внимание

Элемент нельзя передавать внутри тега .

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»
  • «сотка»
  • «гектар»/«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

Вид из окон.

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

  • «во двор»
  • «на улицу»
  • «во двор и на улицу».

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

Внимание

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

Элемент

Описание

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

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

Пример корректного 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>
Предыдущая
Жилая недвижимость
Следующая
Новостройки