Технические требования

Общие требования к XML-фидам

Фид должен быть составлен в стандарте XML в кодировке UTF-8.
Фид должен обновляться не реже, чем раз в 3 часа. (Обязательно обновление даты\времени в элементе <generation-date>).
В случае когда параметр <generation-date> остается неизмененным - обработка фида проведена НЕ будет.
"id" объекта или агента должен быть уникален в пределах своего типа, должен быть числом, не может начинаться с "0" и не может превышать число 2 000 000 000.
Фид должен содержать как минимум одного агента. Блок offer c id агента должен быть описан в фиде до описания объектов данного агента. В остальном порядок следования offer-блоков не важен.
При обработке фида новые id добавляются, имеющиеся обновляются (если есть изменения), объекты которые были в предыдущем фиде и не упоминаются в пришедшем снимаются с показа.
обязательные поля выделены жирным
В полях для которых в качестве допустимых значений указана ссылка на справочник должен быть указан ID, не текстовое значение.

Описание объектов.

Общая структура описания объекта.

Каждый объект в отдельном offer


<offer type="" id="" >
	<!-- type - тип объекта. Одно из значений списка.
	flat - продажа готовых квартир на вторичном рынке.
	room - продажа отдельных комнат на вторичном рынке.
	new-flat - продажа квартир в новостройках.
	country - продажа земельных участков (под некоммерческие цели) и домов с 	земельными участками.
	rent - сдача жилой недвижимости в аренду.
	commerce - продажа или сдача в аренду объектов коммерческой недвижимости
	id - идентификатор объекта, уникальный в пределах своего типа.
	-->
<creation-date>
	<!--  Дата создания объявления -->
</creation-date>
<last-update-date>
	<!--  Дата последней редакции -->
</last-update-date>
<location>
	<!-- Местоположение -->
	
	<!-- Адрес должен быть указан по возможности полно! Улицу можно не указывать только в том случае, если в нашем списке улиц нет значений. Там где есть метро, оно обязательно должно быть указано! Не указание улицы (где они есть) или номера дома влечет наложение штрафа при пост-модерации!  -->
	
	<!-- для new-flat не нужно, будут использованы данные из нашей базы-->
	<!-- для Бизнес Центров не нужно, будут использованы данные из нашей базы-->
</location>
<sales-agent>
	<agent-id>XXXX</agent-id>
</sales-agent>
<images>
	<image>
	   <url>http://www.site.ru/20079t.jpg</url>
	   <sort>1</sort>
	   <comment>вид из окна</comment>
	</image>
	<!-- может быть несколько -->
</images>
<videos>
	<video>
	   <url>https://youtu.be/Aos0n1234</url>
	</video>
	<!-- может быть только одно видео и только с youtube.com -->
</videos>
<!--Поля описание объекта и условий сделки в соответствии с типом объекта.-->
<promotions>
    <promotion>XXX</promotion>
    <promotion>XXX</promotion>
<!--Поля задающие способ продвижения объявления на emls.ru-->
</promotions>
</offer>
		
		


Адрес должен быть указан по возможности полно! Улицу можно не указывать только в том случае, если в нашем списке улиц нет значений. Там где есть метро, оно обязательно должно быть указано! Не указание улицы (где они есть) или номера дома влечет наложение штрафа при пост-модерации!

Способы продвижения объявлений

Метка о продвижении объявления размещается на необходимое количество суток с последующим вычетом 4 часов.
Например, при продвижении объявления на 3 дня метка на объекте размещается на (24*3)-4= 68 часов.
Важно: если метка размещается на большее время, то объект будет продвинут на следующие сутки.


<promotions>
    <promotion>XXX</promotion>
    <promotion>XXX</promotion>
</promotions>

где <promotion>XXX</promotion> - одно или несколько из:
<promotion>emls_top</promotion> - Топ-3 EMLS
<promotion>emls_up</promotion> - Поднятие EMLS
<promotion>emls_highlight</promotion> - Выделение EMLS
<promotion text="примечание в рекламу длиной 50 символов">emls_objectday</promotion> - Объект дня EMLS
<promotion>emls_map</promotion> - Выделение на карте EMLS
<promotion>cian_up</promotion> - Поднятие CIAN
<promotion>cian_highlight</promotion> - Выделение CIAN
<promotion>cian_top</promotion> - Топ-3 CIAN
<promotion>emls_cian_up</promotion> - Пакет поднятие EMLS + CIAN
<promotion>emls_cian_highlight</promotion> - Пакет выделение EMLS + CIAN
<promotion>emls_cian_top</promotion> - Пакет Топ-3 EMLS + CIAN

		


Пример:


		
		
<?xml version="1.0" encoding="UTF-8"?>
<emls-realty-feed xmlns="http://emls.ru/schemas/2015-08">
<generation-date>2015-10-02T16:41:50+03:00</generation-date>
<offer id="196398" type="agent">
    <fio>Иванов М.М.</fio>
    <phone>+79019876543</phone>
    <phone2>+79011234567</phone2>
</offer>
<offer id="100230" type="flat">
	<creation-date>2015-10-02 15:56:12</creation-date>
	<last-update-date>2015-10-02</last-update-date>
	<location>
		<region>2</region>
		<district>2</district>
		<locality>6</locality>
		<street>504</street>
		<house-number>62</house-number>
		<house-case>1</house-case>
		<station>21</station>
		<station-howget>4</station-howget>
		<latitude>60.03835700</latitude>
		<longitude>30.39681500</longitude>
	</location>
	<sales-agent>
		<agent-id>196398</agent-id>
	</sales-agent>
	<images>
		<image>
			<url>http://....jpg</url>
			<sort>1</sort>
		</image>
		<image>
			<url>http://www......jpg</url>
			<sort>2</sort>
		</image>
	</images>
	<rooms>2</rooms>
	<rooms-type>2</rooms-type>
	<all-space>48</all-space>
	<living-space>28</living-space>
	<kitchen-space>8</kitchen-space>
	<living>17+11</living>
	<corridor-space>6</corridor-space>
	<property-type>6</property-type>
	<warrants>1</warrants>
	<balcony>3</balcony>
	<window-view>5</window-view>
	<stove>5</stove>
	<quality>3</quality>
	<phone-supply>2</phone-supply>
	<bathroom>2</bathroom>
	<bath>2</bath>
	<hotwater-supply>2</hotwater-supply>
	<description>Прямая прода.... кухня 8кв.м.</description>
	<floor>2</floor>
	<floors-total>9</floors-total>
	<building-type>9</building-type>
	<built-year>1971</built-year>
	<building-input>2</building-input>
	<rubbish-chute>2</rubbish-chute>
	<lift>2</lift>
	<price>4350000</price>
	<deal-type>2</deal-type>
	<promotions>
        <promotion>XXX</promotion>
        <promotion>XXX</promotion>
	</promotions>
</offer>
</emls-realty-feed>
		
		
		

Агенты

<offer type="agent" id="...">
Элемент Описание Дополнительно
fio краткое ФИО
surname Фамилия
name Имя
second-name Отчество
phone Телефон для публикаций
phone2 Второй телефон для публикаций
email Email агента обязателен и уникален у всех агентов в фиде
dismiss Агент уволен,
Желательно присылать , для сохранения отчетов, истории работы или на случай восстановления агента.
«true»/«false», «1»/«0», «+»/«-»
</offer>

Квартиры

<offer type="flat" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
region Субъект РФ (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/region
district Регион/район (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/district/NNN, где NNN – region-id (см.пред.пункт)
locality Район/нас.пункт (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/locality/NNN, где NNN – district-id (см.пред.пункт)
street улица (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/street/NNN, где NNN – locality-id (см.пред.пункт). Обязательно для города.
house-number Номер дома
house-case Номер корпуса 1, 2, 3 (только цифры)
house-letter литера «А» «Б» «В» или «/1» ( для адресов вида дом 6/1 ) или «-34» (для адресов вида дом 32-34)
station Метро/станция http://emls.ru/api/v1.0/list/station/NNN, где NNN – district-id (см.2-й пункт). Обязательно для города.
station-howget Как добраться от метро/станции http://emls.ru/api/v1.0/list/stationhowget
latitude Широта например, 60.03835700
longitude Долгота например, 30.03835700

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
rooms кол-во комнат участвующих в сделке
share-marker продажа доли в квартире «true»/«false», «1»/«0», «+»/«-»
rooms-type планировка комнат, значение из справочника. http://emls.ru/api/v1.0/list/typerooms
all-space Общая площадь всей квартиры. м.кв.
living-space жилая площадь,
для комнат - продаваемая площадь
м.кв.
kitchen-space площадь кухни м.кв. Обязательно всем кроме студий.
living Разбивка по площадям комнат, 12+15 - изолированные
(12.25+15.5) смежные
(12.25+15.5)+14.0 смежно-изол.
corridor-space площадь коридора м.кв.
hall-space площадь прихожей м.кв.
ceiling высота потолка в метрах 3.20
property-type тип собственности, значение из справочника http://emls.ru/api/v1.0/list/typeproperty
warrants кол-во ордеров, если существенно для сделки.
tenants кол-во жильцов, если существенно для сделки.
children кол-во детей, если существенно для сделки.
balcony наличие балкона, справочник http://emls.ru/api/v1.0/list/balcony
window-view вид из окон, справочник http://emls.ru/api/v1.0/list/windowview
stove тип плиты, справочник http://emls.ru/api/v1.0/list/stove
quality состояние квартиры, справочник http://emls.ru/api/v1.0/list/quality
phone-supply наличие телефона, справочник http://emls.ru/api/v1.0/list/phone
bathroom тип санузла, справочник http://emls.ru/api/v1.0/list/bathroom
bath тип ванны, справочник http://emls.ru/api/v1.0/list/bath
hotwater-supply обеспечение горячей водой, справочник http://emls.ru/api/v1.0/list/hotwater
floor-covering основное покрытие пола, справочник http://emls.ru/api/v1.0/list/floorcovering
description текст не менее 20 буквенных симв. и до 1950 симв
building-id код дома, справочник http://emls.ru/api/list_gk.php Обязательно для переуступок.
Разрешена привязка только к сданным домам. (см.поле built-house в справочнике)
floor этаж объекта
floors-total этажность здания
building-type тип дома, справочник http://emls.ru/api/v1.0/list/flathousetype
built-year Год постройки 1954
repair-year год капремонта 2005
building-input вход в дом, справочник http://emls.ru/api/v1.0/list/inputinhouse
rubbish-chute мусоропровод, справочник http://emls.ru/api/v1.0/list/chute
lift наличие лифта, справочник http://emls.ru/api/v1.0/list/lift
groundfloor-height высота первого этажа, м 3.5
price цена в рублях
deal-type тип сделки, справочник http://emls.ru/api/v1.0/list/type
price-note примечание к цене (мах 25 симв.)
mortgage возможность продажи по ипотеке «true»/«false», «1»/«0», «+»/«-»
auction-marker аукцион «true»/«false», «1»/«0», «+»/«-»
part-numerator числитель части доли Обязательно, если продажа доли. Например, 1
part-denominator знаменатель части доли Обязательно, если продажа доли. Например, 2 (вместе с предыдущим полем получаем 1/2)
apartment апартаменты «true»/«false», «1»/«0», «+»/«-»
penthouse пентхауз «true»/«false», «1»/«0», «+»/«-»
ramp есть пандус «true»/«false», «1»/«0», «+»/«-»
parking парковка, справочник http://emls.ru/api/v1.0/list/parking
cadastr Кадастровый номер объекта
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
investor-last-name Фамилия дольщика (только для переуступки в сданном доме) обязательно для дольщика физического лица
investor-first-name Имя дольщика (только для переуступки в сданном доме) обязательно для дольщика физического лица
investor-second-name Отчество дольщика (только для переуступки в сданном доме) обязательно для дольщика физического лица
investor-inn ИНН дольщика (только для переуступки в сданном доме) обязательно для дольщика юридического лица
</offer>

Комнаты

<offer type="room" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
region Субъект РФ (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/region
district Регион/район (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/district/NNN, где NNN – region-id (см.пред.пункт)
locality Район/нас.пункт (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/locality/NNN, где NNN – district-id (см.пред.пункт)
street улица (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/street/NNN, где NNN – locality-id (см.пред.пункт). Обязательно для города.
house-number Номер дома
house-case Номер корпуса 1, 2, 3 (только цифры)
house-letter литера «А» «Б» «В» или «/1» ( для адресов вида дом 6/1 ) или «-34» (для адресов вида дом 32-34)
station Метро/станция http://emls.ru/api/v1.0/list/station/NNN, где NNN – district-id (см.2-й пункт). Обязательно для города.
station-howget Как добраться от метро/станции http://emls.ru/api/v1.0/list/stationhowget
latitude Широта например, 60.03835700
longitude Долгота например, 30.03835700

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
rooms кол-во комнат участвующих в сделке
rooms-type планировка комнат, значение из справочника. http://emls.ru/api/v1.0/list/typerooms
all-space Общая площадь всей квартиры. м.кв.
living-space жилая площадь,
для комнат - продаваемая площадь
м.кв.
kitchen-space площадь кухни м.кв. Обязательно всем кроме студий.
living Разбивка по площадям комнат, 12+15 - изолированные
(12.25+15.5) смежные
(12.25+15.5)+14.0 смежно-изол.
corridor-space площадь коридора м.кв.
hall-space площадь прихожей м.кв.
ceiling высота потолка в метрах 3.20
property-type тип собственности, значение из справочника http://emls.ru/api/v1.0/list/typeproperty
warrants кол-во ордеров, если существенно для сделки.
tenants кол-во жильцов, если существенно для сделки.
children кол-во детей, если существенно для сделки.
balcony наличие балкона, справочник http://emls.ru/api/v1.0/list/balcony
window-view вид из окон, справочник http://emls.ru/api/v1.0/list/windowview
stove тип плиты, справочник http://emls.ru/api/v1.0/list/stove
quality состояние квартиры, справочник http://emls.ru/api/v1.0/list/quality
phone-supply наличие телефона, справочник http://emls.ru/api/v1.0/list/phone
bathroom тип санузла, справочник http://emls.ru/api/v1.0/list/bathroom
bath тип ванны, справочник http://emls.ru/api/v1.0/list/bath
hotwater-supply обеспечение горячей водой, справочник http://emls.ru/api/v1.0/list/hotwater
floor-covering основное покрытие пола, справочник http://emls.ru/api/v1.0/list/floorcovering
description текст не менее 20 буквенных симв. и до 1950 симв
building-id код дома, справочник http://emls.ru/api/list_gk.php Обязательно для переуступок.
Разрешена привязка только к сданным домам. (см.поле built-house в справочнике)
floor этаж объекта
floors-total этажность здания
building-type тип дома, справочник http://emls.ru/api/v1.0/list/flathousetype
built-year Год постройки 1954
repair-year год капремонта 2005
building-input вход в дом, справочник http://emls.ru/api/v1.0/list/inputinhouse
rubbish-chute мусоропровод, справочник http://emls.ru/api/v1.0/list/chute
lift наличие лифта, справочник http://emls.ru/api/v1.0/list/lift
groundfloor-height высота первого этажа, м 3.5
price цена в рублях
deal-type тип сделки, справочник http://emls.ru/api/v1.0/list/type
price-note примечание к цене (мах 25 симв.)
mortgage возможность продажи по ипотеке «true»/«false», «1»/«0», «+»/«-»
rooms-total Общее кол-во комнат
part-numerator числитель части доли Обязательно, если продажа доли. Например, 1
part-denominator знаменатель части доли Обязательно, если продажа доли. Например, 2 (вместе с предыдущим полем получаем 1/2)
ramp есть пандус «true»/«false», «1»/«0», «+»/«-»
parking парковка, справочник http://emls.ru/api/v1.0/list/parking
cadastr Кадастровый номер объекта
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
</offer>

Новостройки (формат для агентств недвижимости)


Формат для застройщиков - обратите внимание, что формат для застройщиков отличается от формата для агентств


Квартиры

<offer type="new-flat" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
rooms кол-во комнат участвующих в сделке
rooms-type планировка комнат, значение из справочника. http://emls.ru/api/v1.0/list/typerooms
ceiling-height высота потолка, метры например, 3.25
balcony наличие балкона, справочник http://emls.ru/api/v1.0/list/balcony
window-view вид из окон, справочник http://emls.ru/api/v1.0/list/windowview
bathroom тип санузла, справочник http://emls.ru/api/v1.0/list/bathroom
all-space Общая площадь всей квартиры. м.кв.
living-space жилая площадь,
для комнат - продаваемая площадь
м.кв.
living Разбивка по площадям комнат, 12+15 - изолированные
(12.25+15.5) смежные
(12.25+15.5)+14.0 смежно-изол.
kitchen-space площадь кухни м.кв.
corridor-space площадь коридора м.кв.
floor этаж объекта
description текст не менее 20 буквенных симв. и до 1950 симв
building-id http://emls.ru/api/list_gk.php
price цена в рублях
mortgage возможность продажи по ипотеке «true»/«false», «1»/«0», «+»/«-»
auction-marker аукцион «true»/«false», «1»/«0», «+»/«-»
action-type-id 1 - переуступка, 2 - продажа по умолч. - продажа
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
investor-last-name Фамилия дольщика (только для переуступки) обязательно для дольщика физического лица
investor-first-name Имя дольщика (только для переуступки) обязательно для дольщика физического лица
investor-second-name Отчество дольщика (только для переуступки) обязательно для дольщика физического лица
investor-inn ИНН дольщика (только для переуступки) обязательно для дольщика юридического лица
</offer>

Коммерческая недвижимость

<offer type="commerce" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
region Субъект РФ (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/region
district Регион/район (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/district/NNN, где NNN – region-id (см.пред.пункт)
locality Район/нас.пункт (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/locality/NNN, где NNN – district-id (см.пред.пункт)
street улица (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/street/NNN, где NNN – locality-id (см.пред.пункт). Обязательно для города.
house-number Номер дома
house-case Номер корпуса 1, 2, 3 (только цифры)
house-letter литера «А» «Б» «В» или «/1» ( для адресов вида дом 6/1 ) или «-34» (для адресов вида дом 32-34)
station Метро/станция http://emls.ru/api/v1.0/list/station/NNN, где NNN – district-id (см.2-й пункт). Обязательно для города.
station-howget Как добраться от метро/станции http://emls.ru/api/v1.0/list/stationhowget
latitude Широта например, 60.03835700
longitude Долгота например, 30.03835700

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
category вид объекта, справочник http://emls.ru/api/v1.0/list/commercialtype
building-type тип здания, справочник http://emls.ru/api/v1.0/list/commercialbuildingtype Обязательно для здания/помещения
class класс объекта, справочник http://emls.ru/api/v1.0/list/commercialclass
subcategory статус встроенного помещения, справочник http://emls.ru/api/v1.0/list/commercialstatus Обязательно для помещения
property-type юридический статус http://emls.ru/api/v1.0/list/commercialtypeproperty
cadastr Кадастровый номер объекта
all-space общая площадь, м.кв.
all-space-min минимальная площадь сделки, м.кв.
possible-assignment возможные назначения (первое значение - основное назначение), перечислимое, справочник Содержит один или более вложенных тегов <value> со значениями из http://emls.ru/api/v1.0/list/commercialpostrzd (здание/помещение) или http://emls.ru/api/v1.0/list/commercialpostrzem (земля)
building-input вход в объект, справочник http://emls.ru/api/v1.0/list/commercialinputinhouse
floor этажи (этаж числом или одно из значений: подвал,цоколь,мансарда) Обязательно для помещения
floors-total этажность здания Обязательно для здания/помещения
quality состояние помещения, справочник. http://emls.ru/api/v1.0/list/commercialquality
water-supply водоснабжение «true»/«false», «1»/«0», «+»/«-»
sewerage-supply канализация «true»/«false», «1»/«0», «+»/«-»
heating-supply теплоснабжение «true»/«false», «1»/«0», «+»/«-»
electricity-supply электроснабжение «true»/«false», «1»/«0», «+»/«-»
phone-supply телефонная линия «true»/«false», «1»/«0», «+»/«-»
lift лифт, если важно «true»/«false», «1»/«0», «+»/«-»
railway Ж/Д пути, если важно «true»/«false», «1»/«0», «+»/«-»
access-road подъездные пути, справочник. http://emls.ru/api/v1.0/list/commercialaccessroad
lot-area площадь земельного участка, Га
lot-rent-year срок аренды земли в годах
lot-sale собственность на земельный участок «true»/«false», «1»/«0», «+»/«-»
land-category категория земель, справочник http://emls.ru/api/v1.0/list/commerciallandcategory Обязательно для земли
description текст не менее 20 буквенных симв. и до 1950 симв
price-sale цена продажи, руб. Возможно указание или цены продажи или цены аренды
price-sale-unit единицы цены продажи Одно из значений:
6 - указана цена за всё,
7 - указана цена за кв.м.
Обязательно если указана цена продажи.
price-rent цена аренды, руб. Возможно указание или цены продажи или цены аренды
price-rent-unit единицы цены аренды Одно из значений:
2 - руб./м в мес.
3 - руб./м в год.
4 - руб. в мес. за всё
Обязательно если указана цена аренды.
vat налог, справочник http://emls.ru/api/v1.0/list/commercialvat Обязательно с 02.04.2018
price-note примечание к цене (мах 25 симв.)
agent-fee размер комиссии агента, % 0 - 100 (обязательно для аренды)
agent-bonus бонус агенту, руб. или % только для продажи
agent-bonus-type единицы поля бонус агенту Одно из значений:
2 - проценты,
3 - рубли
Обязательно если указаны бонусы агенту
rent-advance-payment предоплата в мес. (только для аренды) обязательно для аренды
ppa-marker возможность ППА (только для продажи), справочник http://emls.ru/api/v1.0/list/commercialppa
tenant-marker наличие арендатора «true»/«false», «1»/«0», «+»/«-»
mortgage возможность продажи по ипотеке
auction-marker аукцион «true»/«false», «1»/«0», «+»/«-»
utility-charges коммунальные платежи включены (только для аренды) «true»/«false», «1»/«0», «+»/«-»
security-deposit обеспечительный платеж, руб. (только для аренды)
operational-costs эксплуатационные расходы включены (только для аренды) «true»/«false», «1»/«0», «+»/«-»
lease-type тип аренды (только для аренды), справочник http://emls.ru/api/v1.0/list/commercialleasetype
min-lease минимальный срок аренды от, мес. (только для аренды)
has-grace-period есть арендные каникулы (только для аренды) «true»/«false», «1»/«0», «+»/«-»
building-id только для объектов в новостройках http://emls.ru/api/list_gk.php
bc-id только для объектов в бизнес-центрах http://emls.ru/api/v1.0/list/commercialbusinesscenter
tk-id только для объектов в торговых комплексах http://emls.ru/api/v1.0/list/commercialtorgcomplex
garage тип (обязательно для гаражей), справочник http://emls.ru/api/v1.0/list/commercialgarage
garage-type тип гаража, справочник http://emls.ru/api/v1.0/list/commercialgaragetype
garage-box-type тип бокса, справочник http://emls.ru/api/v1.0/list/commercialgarageboxtype
garage-status статус (для гаражей), справочник http://emls.ru/api/v1.0/list/commercialgaragestatus
light-supply есть свет (для гаражей) «true»/«false», «1»/«0», «+»/«-»
extinguishing-supply есть система пожаротушения (для гаражей) «true»/«false», «1»/«0», «+»/«-»
garage-name название Гаражно-строительного кооператива
garage-parking-type парковка (для гаражей), справочник http://emls.ru/api/v1.0/list/parking
infrastructure инфраструктура (для гаражей), перечислимое, справочник Содержит один или более вложенных тегов <value> со значениями из http://emls.ru/api/v1.0/list/commercialgarageinfra
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
</offer>

Аренда

<offer type="rent" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
region Субъект РФ (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/region
district Регион/район (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/district/NNN, где NNN – region-id (см.пред.пункт)
locality Район/нас.пункт (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/locality/NNN, где NNN – district-id (см.пред.пункт)
street улица (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/street/NNN, где NNN – locality-id (см.пред.пункт). Обязательно для города.
house-number Номер дома
house-case Номер корпуса 1, 2, 3 (только цифры)
house-letter литера «А» «Б» «В» или «/1» ( для адресов вида дом 6/1 ) или «-34» (для адресов вида дом 32-34)
station Метро/станция http://emls.ru/api/v1.0/list/station/NNN, где NNN – district-id (см.2-й пункт). Обязательно для города.
station-howget Как добраться от метро/станции http://emls.ru/api/v1.0/list/stationhowget
latitude Широта например, 60.03835700
longitude Долгота например, 30.03835700

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
category объект сдачи ( квартира - комната) http://emls.ru/api/v1.0/list/renttype
rooms кол-во комнат участвующих в сделке
rooms-type признак студии 40 - студия
all-space Общая площадь всей квартиры. м.кв.
living-space жилая площадь,
для комнат - сдаваемая площадь
м.кв.
living Разбивка по площадям комнат, 12+15 - изолированные
(12.25+15.5) смежные
(12.25+15.5)+14.0 смежно-изол.
kitchen-space площадь кухни м.кв.
beds Количество отдельных спальных мест.
phone-supply наличие телефона http://emls.ru/api/v1.0/list/phone
furniture мебель http://emls.ru/api/v1.0/list/rentfurniture
refrigerator холодильник http://emls.ru/api/v1.0/list/rentrefrigerator
television Телевизор http://emls.ru/api/v1.0/list/renttelevision
bath Ванна http://emls.ru/api/v1.0/list/bath
quality Ремонт http://emls.ru/api/v1.0/list/quality
door входная дверь http://emls.ru/api/v1.0/list/rentdoor
washing стир.машина «true»/«false», «1»/«0», «+»/«-»
balcony балкон http://emls.ru/api/v1.0/list/balcony
internet Наличие интернета «true»/«false», «1»/«0», «+»/«-»
without-children 1 - без детей «true»/«false», «1»/«0», «+»/«-»
without-pets 1 - без животных «true»/«false», «1»/«0», «+»/«-»
floor Этаж
lattice решетки на окнах «true»/«false», «1»/«0», «+»/«-»
description текст не менее 20 буквенных симв. и до 1950 симв
building-type Тип дома, справочник http://emls.ru/api/v1.0/list/flathousetype
lift Наличие лифта «true»/«false», «1»/«0», «+»/«-»
floors-total Всего этажей
lot-area площадь участка, сот. обязательно для загородной
parking автостоянка http://emls.ru/api/v1.0/list/rentparking
price цена в рублях
price-utilities-flag Флаг Ком.Услуги включены в стоимость? «true»/«false», «1»/«0», «+»/«-»
price-utilities Стоимость КУ. Обязательно если не указан или равен нулю тег price-utilities-flag.
rent-ondaily тип аренды 0 - длительная, цена за месяц
1- посуточная, цена в сутки
price-note примечание к цене (мах 25 симв.)
rent-period-min минимальный срок сдачи, мес. число от 1 до 11 (11 - длительная), обязательно для не посуточной
rent-advance-payment кол-во месяцев предоплаты обязательно (0 - если нет предоплаты)
agent-fee Размер комиссии агента, % 0 - 100
pledge Залог, обязательное поле «true»/«false», «1»/«0», «+»/«-»
pledge-summa Сумма залога, руб. обязательно, если есть залог
not-for-agents 1 - Агентам не звонить «true»/«false», «1»/«0», «+»/«-»
rooms-total Общее кол-во комнат, только «аренда комнат».
window-view вид из окон (только аренда жилой), справочник http://emls.ru/api/v1.0/list/rentwindowview
conditioner есть кондиционер «true»/«false», «1»/«0», «+»/«-»
ramp есть пандус (только аренда жилой) «true»/«false», «1»/«0», «+»/«-»
dishwasher есть посудомоечная машина «true»/«false», «1»/«0», «+»/«-»
cadastr Кадастровый номер объекта
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
</offer>

Загородная недвижимость


Формат для коттеджных поселков (от застройщиков) - обратите внимание, что формат для застройщиков отличается от формата для агентств


<offer type="country" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
region Субъект РФ (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/region
district Регион/район (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/district/NNN, где NNN – region-id (см.пред.пункт)
locality Район/нас.пункт (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/locality/NNN, где NNN – district-id (см.пред.пункт)
street улица (код из справочника или текстовая строка) http://emls.ru/api/v1.0/list/street/NNN, где NNN – locality-id (см.пред.пункт). Обязательно для города.
house-number Номер дома
house-case Номер корпуса 1, 2, 3 (только цифры)
house-letter литера «А» «Б» «В» или «/1» ( для адресов вида дом 6/1 ) или «-34» (для адресов вида дом 32-34)
station Метро/станция http://emls.ru/api/v1.0/list/station/NNN, где NNN – district-id (см.2-й пункт). Обязательно для города.
station-howget Как добраться от метро/станции http://emls.ru/api/v1.0/list/stationhowget
latitude Широта например, 60.03835700
longitude Долгота например, 30.03835700

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
category вид объекта, справочник http://emls.ru/api/v1.0/list/countrytype
property-type тип собственности, справочник http://emls.ru/api/v1.0/list/countrytypeproperty
quality готовность дома, справочник http://emls.ru/api/v1.0/list/countryquality
privatization наличие приватизации, справочник http://emls.ru/api/v1.0/list/countryprivatization
document-ready готовность документов, справочник http://emls.ru/api/v1.0/list/countryreadydoc
distance Удаленность от ж.д. станции (км)
transport общественный транспорт, справочник http://emls.ru/api/v1.0/list/countrytransport
road подъездная дорога, справочник http://emls.ru/api/v1.0/list/countryroad
pond наличие водоема, справочник http://emls.ru/api/v1.0/list/countrypond
heating-supply варианты отопления, справочник http://emls.ru/api/v1.0/list/countryheating
toilet канализация, справочник http://emls.ru/api/v1.0/list/countrytoilet
phone-supply наличие телефона http://emls.ru/api/v1.0/list/phone
electricity-supply электричество, справочник http://emls.ru/api/v1.0/list/countryelectro
water-supply водоснабжение, справочник http://emls.ru/api/v1.0/list/countrywater
gas-supply газоснабжение, справочник http://emls.ru/api/v1.0/list/countrygas
lot-area площадь участка, сот.
lot-condition состояние земельного участка, справочник http://emls.ru/api/v1.0/list/countrylotcondition
lot-property юридический статус земли, справочник http://emls.ru/api/v1.0/list/countrylotproperty
floors-total этажей всего
building-size габариты дома, м.
6х8
rooms количество комнат
all-space общая площадь, м.кв. обязательно для всех, кроме участков
living-space жилая площадь, м.кв.
kitchen-space площадь кухни, м.кв.
living жилая площадь по комнатам 12+15 - изолированные
(12.25+15.5) смежные
(12.25+15.5)+14.0 смежно-изол.
built-year год постройки дома 1985
building-type материал стен дома, справочник http://emls.ru/api/v1.0/list/countrywall
building-base фундамент дома, справочник http://emls.ru/api/v1.0/list/countrybase
building-roof крыша дома, справочник http://emls.ru/api/v1.0/list/countryroof
interior внутр.отделка, справочник http://emls.ru/api/v1.0/list/countryinterior
additional-constructions дополнительные постройки, перечислимое, справочник Содержит один или более вложенных тегов <value> со значениями из
http://emls.ru/api/v1.0/list/countrypostr
landscape окружающий ландшафт, перечислимое, справочник Содержит один или более вложенных тегов <value> со значениями из
http://emls.ru/api/v1.0/list/countryland
infrastructure инфраструктура, перечислимое, справочник Содержит один или более вложенных тегов <value> со значениями из
http://emls.ru/api/v1.0/list/countryinfra
description текст не менее 20 буквенных симв. и до 1950 симв
price цена, руб.
price-note примечание к цене (мах 25 симв.)
mortgage возможность продажи по ипотеке «true»/«false», «1»/«0», «+»/«-»
auction-marker аукцион «true»/«false», «1»/«0», «+»/«-»
part-numerator Числитель части дома Обязательно, если вид объекта - часть дома. Например, 1
part-denominator Знаменатель части дома Обязательно, если вид объекта - часть дома. Например, 2 (вместе с предыдущим полем получаем 1/2)
cadastr Кадастровый номер объекта
vas-title заголовок объявления (только для Топ 3 и Премиум объявления) от 8 до 33 буквенных символов
</offer>

Зарубежная

<offer type="foreign" id="...">
Элемент Описание Дополнительно
creation-date Дата занесения объекта в базу
last-update-date Дата последнего изменения в объекте

тег <location>

Элемент Описание Дополнительно
country Страна (код из справочника) http://emls.ru/api/v1.0/list/foreigncountry
city Город (текстовая строка)
address Адрес (текстовая строка)

закрывающий тег </location>



тег <sales-agent>

Элемент Описание Дополнительно
agent-id id агента

закрывающий тег </sales-agent>

Элемент Описание Дополнительно
category тип объекта, справочник http://emls.ru/api/v1.0/list/foreigntype
property-type тип сделки, справочник http://emls.ru/api/v1.0/list/foreignaction
all-space общая площадь, м.кв.
floor этаж
floors-total этажей всего
rooms количество комнат
price цена
price-unit единицы цены, справочник http://emls.ru/api/v1.0/list/foreignprice
credit возможность кредита «true»/«false», «1»/«0», «+»/«-»
description текст не менее 20 буквенных симв. и до 1950 симв
</offer>