Технические требования к оформлению YRL

Сервис «Импорт объявлений»
Руководство по составлению XML-фида для импорта объявлений на портал Est
http://est.ua/
15.12.2015
Общие сведения
Портал недвижимости Est! принимает объявления в xml файлах (xml фидах), основанных на
формате YRL (Yandex Realty Language). Соответственно xml файл должен соответствовать
определенным требованиям (с учетом некоторых нюансов, исключений и дополнений,
который будут описаны ниже в данном документе):
Технические требования к фиду YRL:
https://yandex.ru/support/webmaster/realty/requirements.xml
Пример файла YRL:
https://yandex.ru/support/webmaster/realty/yrl-example.xml
Валидатор YRL фида:
https://webmaster.yandex.ua/xsdtest.xml
XML-файл допустимо предоставлять в заархивированном виде (zip, gzip).
Процедура импорта объявлений выполняется один раз в сутки в промежутке с 00:00 до
08:00, по результатам которой партнеру отсылается письмо с отчетом о возникших
ошибках.
Отличия в заполнении некоторых элементов YRL фида
Перечень элементов, которые принимают ограниченный или расширенный список
значений:
Элемент
Описание
type
Тип сделки.
Строго ограниченные значения:
«продажа»
«покупка»
«сдача»
«сдача посуточно»
«аренда»
property-type
Тип недвижимости.
Строго ограниченные значения:
«жилая»
«коммерческая»
«земельные участки»
category
Категория объекта.
Строго ограниченные значения:
«автомойка»
«автосервис»
«апартамент»
«аптека»
«база отдыха»
«баня»
«бизнес центр»
«бильярдный клуб»
«гараж»
«гостиница»
«дача»
«дом»
«заправка»
«здание»
«кафе»
«квартира»
«клиника»
«комната»
«магазин»
«мед. кабинет»
«нефтебаза»
«ночной клуб»
«общепит»
«отель»
«офис»
«пансионат»
«парикмахерская»
«паркинг»
«парковка»
«паркоместо»
«помещение свободного назначения»
«производство и промышленность»
«ресторан»
«салон красоты»
«санаторий»
«сауна»
«склад»
«спортзал»
«стоянка»
«СТО»
«таунхаус»
«торговый центр»
«участок для объектов отдыха и здоровья»
«участок для сельского хозяйства»
«участок для строительства жилья»
«участок для строительства коммерческих объектов»
«фитнес клуб»
«хостел»
«шиномонтаж»
description
Дополнительная информация (описание в свободной форме, оставленное
подателем объявления).
В отличие от базового YRL, допускается передача в HTML формате.
currency
Валюта.
Строго ограниченные значения:
«UAH»
«USD»
«EUR»
«RUB»
renovation
quality
Ремонт и/или состояние объекта.
Строго ограниченные значения:
«дизайнерский ремонт»
«евроремонт»
«косметический ремонт»
«капитальный ремонт»
«после реконструкции»
«жилое/советское»
«требуется косметический ремонт»
«неоконченный ремонт»
«под чистовую отделку»
«требуется капитальный ремонт»
«незавершённое строительство»
«без ремонта»
Информация о продавце или арендодателе
Информация о продавце или арендодателе (элемент <sales-agent>) является обязательной,
но ее содержание при импорте игнорируется. Т.к. объявления после импорта на портал Est
привязываются к определенному пользователю, то и контактные данные получают из
профиля этого пользователя.
Дополнительные данные
Объявления на портале Est, могут содержать дополнительные данные, не предусмотренные
форматом YRL. Такие данные необходимо передавать с помощью особых элементов
<custom-param>. Они не входят в стандарт YRL, но тем не менее проходят валидацию XSD
от Яндекса (https://webmaster.yandex.ua/xsdtest.xml).
Формат:
<custom-param>
<name>название параметра</name>
<value>значения параметра</value>
</custom-param>
Правила заполнения элемента location
При заполнении элемента location нужно избегать обозначения типов населенных пунктов,
напр.: «г. Киев», «с. Петриковка». Указывайте только сами названия населенных пунктов,
например: «Киев»
Пример тега location заполненного верно:
<location>
<country>Украина</country>
<region>Львовская</region>
<locality-name>Новояворовск</locality-name>
<address>ул. А. Кузьменко, 96 / 90</address>
</location>
Пример тега location заполненного неверно:
<location>
<country>Украина</country>
<region>Львовская область</region>
<locality-name>город Новояворовск</locality-name>
<address>ул. А. Кузьменко, 96 / 90</address>
</location>
Обратите внимание:
для районных и областных центров (как-то: Днепропетровск, Кривой Рог, Киев, Белая
Церковь, Харьков, Чугуев) указание тэга <district> недопустимо, но допустимо указывать
районы нас. пункта в тэге <sub-locality-name>. Соответственно, для мелких населенных
пунктов (напр., Кирилловка, Партенит, и др. села и пгт.) не нужно указывать <sub-localityname>, но допустимо указать <district>. Ни в коем случае нельзя допускать указания тэгов
<district> и <sub-locality-name> в пределах одного объявления — эти тэги взаимоисключают
друг друга.
На данный момент, можно передавать такие дополнительные данные.
Параметр
Описание
est-login
Привязка объявления к пользователю (указывается логин
пользователя на портале Est)
est-hot
Признак горячего объявления (платная услуга).
Ориентировочная стоимость — 2.5 грн в сутки.
Актуальную стоимость уточняйте в отделе продаж
(http://admins.est.ua/)
est-headline
Заголовок рекламного текста
est-near-residence
Что находится рядом.
Строго ограниченные значения (если несколько, то
указываются через запятую):
«детсад»
«школа»
«супермаркет»
«остановки»
«развлекательные заведения»
«спортивно-оздоровительный центр»
«спорткомплекс»
«гостиница»
«парк»
«речка/озеро»
«море»
«лес»
est-type-of-flat
Тип квартиры.
Строго ограниченные значения:
«отдельная»
«коммунальная»
«малосемейка»
«двухуровневая»
«студия»
«общежитие»
est-amount-of-bathrooms
Количество санузлов (дома, таунхаусы и т.п.)
est-agent-contract-type
Форма поручения.
Строго ограниченные значения:
«устные договоренности»
«устный эксклюзивный договор»
«письменный договор»
«письменный эксклюзивный договор»
«письменный эксклюзивный договор (СПП)»
est-fees-payer
Кто платит комиссию.
Строго ограниченные значения:
«продавец»
«покупатель»
«арендатор»
«арендодатель»
est-agent-contract-from
Срок действия договора (от).
Формат: DD.MM.YYYY (день.месяц.год)
Например, 02.02.2015
est-agent-contract-till
Срок действия договора (до).
Формат: DD.MM.YYYY (день.месяц.год)
Например, 31.12.2015
est-agent-contract-awards
Вознаграждение партнеру.
Например:
5%
1000 USD
10000 UAH
Пример, заполнения дополнительных данных:
...
<parking>да</parking>
<custom-param>
<name>est-hot</name>
<value>нет</value>
</custom-param>
<custom-param>
<name>est-headline</name>
<value>Роскошный вид на ялтинскую бухту с террасы Вашего Светлого
коттеджа. Сосновый бор.</value>
</custom-param>
<custom-param>
<name>est-near-residence</name>
<value>детсад, школа, супермаркет, остановки, лес</value>
</custom-param>
<custom-param>
<name>est-amount-of-bathrooms</name>
<value>4</value>
</custom-param>
<custom-param>
<name>est-agent-contract-type</name>
<value>письменный эксклюзивный договор (СПП)</value>
</custom-param>
<custom-param>
<name>est-agent-contract-from</name>
<value>18.08.2015</value>
</custom-param>
<custom-param>
<name>est-agent-contract-till</name>
<value>31.12.2015</value>
</custom-param>
<custom-param>
<name>est-agent-contract-awards</name>
<value>2.5 %</value>
</custom-param>
<creation-date>2015-09-01T14:45:45+03:00</creation-date>
...
Достоверность объявлений
На импортированные объявлений распространяются те же правила, что и на объявления,
добавляемые вручную. Это в том числе касается и требований для получения звезд
достоверности. Подробнее о статусе и достоверности — http://est.ua/services/credibility/.
Вниманию текущих и потенциальных импорт-партнеров!
При импорте объявлений есть возможным загружать объявления не только на Личный сайт Вашего
агентства, но и распределять объявления между сотрудниками (филиалами) данного АН. Для этого,
добавляйте в описание Ваших объектов тег: <estausername>Логин на сайте EST.ua</estausername>
Например, добавляйте тег: <estausername>ivan</estausername> для каждого объявления.
Если у вас возникли дополнительные вопросы, предложения или пожелания обращайтесь, пожалуйста, к менеджеру портала http://Est.ua/
Андрей Терещенко
Руководитель отдела продаж
http://admins.est.ua/
тел.: +380 67 319-00-33
тел.: +380 99 548-00-33
тел.: +380 93 723-00-33
email: [email protected]
skype: andrew.tereshchenko