﻿<?xml version="1.0" encoding="UTF-8"?>

<!-- 
Формат WinNER-XML предназначается для описания объектов рынка недвижимости в разделе 
"Продажа квартир и комнат в Москве и Московской области".


Общие замечания по формату.

WinNER-XML основан на стандарте XML (http://www.w3.org/XML), т.е. на WinNER-XML накладываются все требования 
и ограничения формата XML.


Требования к фиду.

1. В фиде должна передаваться актуальная информация об объектах и изменении их состояния.
2. Объявления, поступающие в Базу WinNER, должны обновляться, а не удаляться и создаваться заново.
3. В данных не допускается присутствие HTML-тегов.


Описание элементов формата WinNER-XML.

Замечание: 
- знаком "!" отмечены обязательные элементы;
- значения из перечня допустимых вариантов берутся без обрамляющих кавычек и указываются в WinNER-XML по правилам заполнения XML.


! <id> 

Уникальный идентификатор объекта. Для одного и того же объекта значение данного элемента не должно изменяться.


! <date>  

Дата обновления состояния объекта, в формате 'DD.MM.YYYY', например: 12.02.2013.


! <actual>

Актуальность объявления.

Если объявление неактуально, необходимо указать для него значение <actual>продана</actual>.
В случае отсутствия объявления в XML, оно автоматически получит статус "Продано" - только через сутки.
С помощью данного тега можно оперативно изменить статус объявления (измените значение в XML и перезапустите его в нашем ЛК).

Допустимые варианты:
"продается"
"аванс"
"продана"


! <aptp> 

Тип объекта. 

Допустимые варианты:
"квартира"
"комната"


! <nova> 

Является ли объект новостройкой или нет. 

Допустимые варианты:
"+" - объект является новостройкой
"-" - объект не является новостройкой - вторичная недвижимость


! <area> 

Регион - область, край, республика или город федерального значения Москва, Санкт-Петербург, Севастополь.


! <locality> 

Район или городской округ области (края, республики и тд), если он есть. Для городов федерального и регионального подчинения он не заполняется.


! <town> 

Город, нас. пункт, СНТ/КП

Населенные пункты в черте городов или других нас. пунктов указываются через запятую.

Варианты сокращения для типа населенного пункта:
- "г." - город
- "д." - деревня
- "пос." - поселок
- "с." - село
- "пгт" - поселок городского типа

Пример заполнения элемента <town>:
...
<town>Гжель пос.</town>
...
<town>Московский г.</town>
...
<town>Захарово д., Агаларов Эстэйт КП</town>
...



! <metro_list> 

Список ближайших к объекту станций метро. Данный элемент заполняется для регионов "Москва" и "Московская обл.", 
для объектов по региону "Москва" элемент обязателен!

Содержит дочерние элементы <metro> (максимум 4 элемента), каждый из которых описывает доступность отдельной станци метро.


! <metro>

Доступность отдельной станци метро, дочерний элемент для элемента <metro_list>. 

В значении данного элемента указывается название связанной станции метро.

В атрибутах элемента указываются параметры удаленности объекта от станции метро:
- атрибут "farval" - удаленность в минутах
- атрибут "fartp" - тип удаленности объекта, допустимые варианты: 
	"п" - пешком
	"т" - транспортом

Пример заполнения элементов <metro_list> и <metro>:
...
<metro_list>
<metro farval="5" fartp="п">Сокол</metro>
<metro farval="15" fartp="п">Аэропорт</metro>
<metro farval="10" fartp="т">Владыкино (МЦК)</metro>
</metro_list>
...


! <address> 

Улица с указанием ее типа после названия: ул., бул., проезд и т.д. 
Данный элемент обязателен только для объектов по Москве, 
для объектов по региону "Московская обл." его заполнение желательно, но не обязательно.
Если в населенном пункте нет улиц, то тег <address> следует оставить пустым.


! <dom> 

Номер дома, корпуса. Данный элемент обязателен для заполнения только для городов, для сельских нас.пунктов его заполнение желательно, но не обязательно.

Правила заполнения элемента <dom>:
<номер дома>[/<возможное дробное значение номера дома>][К<номер корпуса>][С<номер строения>]

Примеры заполнения элемента <dom>:	
...
<dom>10/2С1</dom> - дом 10/2, строение 1
...
<dom>14К3С1</dom> - дом 14, корпус 3, строение 1
...

<coordinates>

Координаты объекта недвижимости.

Содержит дочерние элементы lat - Широта, lon - Долгота.

Пример заполнения элемента <coordinates>:
...
<coordinates>
    <lat>55.725990</lat>
    <lon>37.749008</lon>
</coordinates>
...

<housing_complex>

Название жилого комплекса.

<built_year>

Год постройки.

<ready_quarter>

Квартал сдачи дома (строго ограниченные значения — «1», «2», «3», «4»), только для новостроек.

! <price>

Стоимость объекта.

В значении данного элемента указывается числовое значение стоимости объекта.

В атрибуте "currency" элемента <price> указывается тип валюты, в которой указана стоимость объекта. Допустимые варианты 
значения атрибута "currency":
"RUB" - российские рубли
"USD" - доллары США
"EUR" - евро

Пример заполнения элемента <price>:
...
<price currency="RUB">15500000</price>
...


! <flats>

Количество комнат в квартире. Значение элемента <flats> должно быть больше значения, указанного в элементе <rooms>.

Допустимые варианты:
"студия"
"свободная планировка"
Числовое значение количества комнат в квартире.

<apartment>

Апартаменты.

Допустимые варианты:
"+" - тип помещения - апартаменты
"-" - тип помещения - не апартаменты


! <rooms> 

Количество продаваемых комнат в квартире. Обязательный элемент только если тип объекта "комната".


! <sq>

Площадь объекта. В атрибутах элемента <sq> указываются:
- "pl_ob" - всегда общая площадь всей квартиры
- "pl" - жилая площадь, если тип объекта "квартира"  или площадь продаваемой комнаты, если тип объекта "комната"
- "kitch" - площадь кухни
- "pl_r" - разбивка площади по комнатам, где "+" смежные, "-" раздельные

Пример заполнения элемента <sq>:
...
<sq pl_ob="78.5" pl="48.3" kitch="12.5" pl_r="18+15.3+15"></sq>
...


! <floor> 

Этаж, на котором расположен объект.


! <fl_ob>

Этажность строения, в котором расположен объект.


<ceiling_height> 

Высота потолков в метрах. 


<parking>

Наличие парковки.

Допустимые варианты:
"нет"
"есть"
"стихийная"
"закрепленное место"
"охраняемая"
"подземная"


<territory>

Территория.

Допустимые варианты:
"не огорожена"
"огороженная"
"огороженная и охраняемая"


<building_type> 

Тип дома.

Допустимые варианты:
"М" - монолитный
"П" - панельный
"К" - кирпичный
"Б" - блочный
"С" - сталинский
"Э" - элитный
"МК" - монолитно-кирпичный
"БП" - блочно-панельный


<house_series>

Серия дома.


<lift>

Тип лифта.

Допустимые варианты:
"без лифта"
"лифт"
"лифт пассажирский"
"лифт грузовой"
"лифт пассажирский и лифт грузовой"


<chute>

Мусоропровод.

Допустимые варианты:
"+" - да
"-" - нет


<balcony>

Наличие балконов, лоджий. 

Допустимые варианты:
"-" - балкон/лоджия отсутствует
"Б" - один балкон
"Л" - одна лоджия
"Эрк" - эркер
"ЭркЛ" - эркер и лоджия
"БЛ" - балкон и лоджия
"2Б" - два балкона
"2Л" - две лоджии
"3Б" - три балкона
"3Л" - три лоджии
"4Л" - четыре и более лоджий
"Б2Л" - балкон и две лоджии
"2Б2Л" - два балкона и две лоджии


<water_closet> 

Санузел.

Допустимые варианты:
"-" - нет санузла
"+" - есть санузел
"2" - два санузла
"3" - три санузла
"4" - четыре санузла
"С" - совмещенный санузел
"Р" - раздельный санузел
"2С" - два совмещенных санузла
"2Р" - два раздельных санузла
"3С" - три совмещенных санузла
"3Р" - три раздельных санузла
"4С" - четыре и более совмещенных санузла
"4Р" - четыре и более раздельных санузла


<window_view>

Вид из окон.

Допустимые варианты:
"окна на улицу"
"окна во двор"
"окна во двор и на улицу"


<flooring>

Тип полов.

Допустимые варианты:
"-" - не определен
"Д" - дерево
"п/д" - паркетная доска
"ЛМ" - ламинат
"К" - ковролин
"П" - паркет
"ЛН" - линолеум
"Стяж" - Стяжка пола


<condition>

Тип состояния (ремонта) объекта.

Допустимые варианты:
"требуется капитальный ремонт"
"без отделки"
"требуется ремонт"
"среднее состояние"
"хорошее состояние"
"отличное состояние"
"евроремонт"
"дизайнерский ремонт"
"первичная отделка"


<has_phone> 

Наличие телефонной линии.

Допустимые варианты:
"-" - нет телефонной линии
"Т" - есть телефонная линия
"2Т" - две и более телефонные линии


<own_reason> 

Тип документа-основания права собственности.

Допустимые варианты:
"купля/продажа"
"ЖСК"
"приватизация"
"дарение"
"наследство"
"мена"
"инвестирование"
"рента"
"решение суда"
"залог (ипотека)"
"иное"
"договор долевого участия"
"договор уступки прав требования"
"предварительный договор купли-продажи"


<own_year>

Год вступления в право собственности (дата последней сделки).


<owners_count>

Количество собственников квартиры.


<regs_count>

Количество проживающих.


<owners_minor>

Признак наличия несовершеннолетних собственников.

Допустимые варианты:
"+" - среди собственников есть несовершеннолетние
"-" - среди собственников нет несовершеннолетних


<status>

Статус, тип сделки, операции:

Допустимые варианты:
"прямая продажа"
"альтернатива"


<mortgage>

Возможность покупки по ипотеке.

Допустимые варианты:
"-" - нет возможности покупки по ипотеке
"+" - ипотека возможна


! <phones>

Номера телефонов для контактов в формате "8xxxxxxxxxx" или "7xxxxxxxxxx". В списке значения разделяются символом ";"


<email>

e-mail для контактов. В списке значения разделяются символом ";".


<company_url>

URL сайта агентства.


<object_url>

URL карточки объекта на сайте агентства.


<photos>

Список URL фотографий объекта. В списке значения разделяются символом ";".

Допустимо не более 100 фотографий.

<layout_photos>

Изображение планировки, для новостроек идет первой картинкой, если не новостройка идет в конце списка фотографий. 

<videos>

Элемент для видео.

Ссылка на видео указывается в атрибуте <url>

Допускается указание только 1(одной) ссылки с YouTube.

Пример заполнения элементов <videos>:
...
<videos>
	<url>https://www.youtube.com/</url>
</videos>
...

<online_presentation>

Есть возможность показать объект онлайн с помощью сервисов видеосвязи

Допустимые варианты:
"-" - нет возможности онлайн показа
"+" - онлайн показ возможен


<cadastral_number>

кадастровый номер.


<remark>

Дополнительная информация об объекте. Значение данного элемента необходимо указывать в секции <![CDATA[...]]>.


<pledged>

Залоговое имущество

Допустимые варианты:
"-" - без обременения (залога)
"+" - под залогом

<auction> 

Продажа объекта на торгах.

Допустимые варианты:
"+" - Да
"-" - Нет

<agency_bonus>

Бонус для агента

В атрибуте "currency" элемента <agency_bonus> указывается тип валюты, в которой указана стоимость объекта. 
Допустимые варианты значения атрибута "currency":
"RUB" - российские рубли
"USD" - доллары США
"EUR" - евро

В атрибуте "bonus_type" указывается бонус агенту - сумма или процент от сделки.
Допустимые варианты значения атрибута "bonus_type":
"percent" - процент
"money"   - сумма

Пример заполнения элемента <agency_bonus>:
<agency_bonus currency="RUB" bonus_type="money">50000</agency_bonus>
<agency_bonus bonus_type="percent">5</agency_bonus>


<pub_rule>

Правила публикации объекта на других порталах.
Элемент указывается, если к объявлению должна быть применена дополнительная услуга.

Содержит дочерние элементы <rule>, каждый из которых описывает правила публикации объекта на других порталах.

<rule>

Допустимые варианты:
"sob_attractive" - привлекательный объект на сайте sob.ru
"sob_elevated" - поднятый объект на сайте sob.ru
"sob_highlighted" - выделенный объект на сайте sob.ru
"winner_only" - публиковать объект только в Базе WinNER

В атрибуте "end-time" элемента <rule> указывается дата окончания дополнительной услуги в формате 'YYYY-MM-DD', например: 2017-01-30.
...

Пример заполнения элементов <pub_rule> и <rule> для публикации Привлекательного объявления на Sob.ru:

Публикация на 1 день:
<pub_rule>
<rule>sob_attractive</rule>
</pub_rule>
Публикация до заданной даты:
<pub_rule>
<rule end-time="2017-01-30">sob_attractive</rule>
</pub_rule>
...


-->

<flats xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="flats.xsd">
	<flat>
		<id>343424</id>
		<date>01.04.2014</date>
		<actual>продается</actual>
		<aptp>квартира</aptp>
		<nova>-</nova>
		<area>Москва</area>
		<metro_list>
			<metro farval="10" fartp="п">Аэропорт</metro>
			<metro farval="5" fartp="т">Полежаевская</metro>
			<metro farval="7" fartp="п">Владыкино (МЦК)</metro>
		</metro_list>
		<address>Часовая ул.</address>
		<dom>3</dom>
		<housing_complex>ЖК Черняховского 19</housing_complex>
		<built_year>2019</built_year>
		<ready_quarter>3</ready_quarter>
		<price currency="RUB">9500000</price>
		<flats>2</flats>
		<sq pl_ob="78.8" pl="46.8" kitch="10.4" pl_r="30-16"></sq>
		<floor>5</floor>
		<fl_ob>9</fl_ob>
		<parking>нет</parking>
		<territory>не огорожена</territory>
		<building_type>К</building_type>
		<house_series>П-44Т</house_series>
		<lift>лифт пассажирский и лифт грузовой</lift>
		<chute>+</chute>
		<balcony>2Б</balcony>
		<water_closet>Р</water_closet>
		<window_view>окна во двор</window_view>
		<flooring>ЛН</flooring>
		<condition>без отделки</condition>
		<has_phone>Т</has_phone>
		<own_reason>купля/продажа</own_reason>
		<owners_count>0</owners_count>
		<regs_count>0</regs_count>
		<owners_minor>-</owners_minor> 
		<status>прямая продажа</status>
		<mortgage>+</mortgage>
		<phones>89261234567;84959876543</phones>
		<email>test@mail.ru</email>
		<company_url>http://host.com</company_url>
		<object_url>http://host.com/objects/343424.html</object_url>
		<photos>http://host/image_1.jpg;http://host/image_2.jpg</photos>
		<videos><url>https://www.youtube.com/</url></videos>
		<online_presentation>+</online_presentation>
		<remark><![CDATA[отличное сост., просторная квартира]]></remark>
		<pledged>-</pledged>
		<agency_bonus currency="RUB" bonus_type="money">50000</agency_bonus>
		<pub_rule>
			<rule end-time="2017-09-30">sob_attractive</rule>
		</pub_rule>
	</flat>
	<flat>
		<id>343439</id>
		<date>01.04.2014</date>
		<actual>продается</actual>
		<aptp>квартира</aptp>
		<nova>+</nova>
		<area>Москва</area>
		<town>Завода Мосрентген пос.</town>
		<metro_list>
			<metro farval="10" fartp="т">Юго-Западная</metro>
		</metro_list>
		<address>Героя России Соломатина пр.</address>
		<dom>1</dom>
		<housing_complex></housing_complex>
		<price currency="RUB">6800000</price>
		<flats>2</flats>
		<sq pl_ob="78.8" pl="46.8" kitch="10.4" pl_r="30-16"></sq>
		<floor>5</floor>
		<fl_ob>9</fl_ob>
		<parking>есть</parking>
		<territory>огороженная и охраняемая</territory>
		<building_type>К</building_type>
		<house_series>П-44Т</house_series>
		<lift>лифт пассажирский и лифт грузовой</lift>
		<chute>+</chute>
		<balcony>2Б</balcony>
		<water_closet>Р</water_closet>
		<window_view>окна во двор</window_view>
		<flooring>ЛН</flooring>
		<condition>без отделки</condition>
		<has_phone>Т</has_phone>
		<own_reason>купля/продажа</own_reason>
		<owners_count>0</owners_count>
		<regs_count>0</regs_count>
		<owners_minor>-</owners_minor> 
		<status>прямая продажа</status>
		<mortgage>+</mortgage>
		<phones>89261234567;84959876543</phones>
		<email>test@mail.ru</email>
		<company_url>http://host.com</company_url>
		<object_url>http://host.com/objects/343424.html</object_url>
		<photos>http://host/image_1.jpg;http://host/image_2.jpg</photos>
		<videos><url>https://www.youtube.com/</url></videos>
		<online_presentation>-</online_presentation>
		<remark><![CDATA[отличное сост., просторная квартира]]></remark>
		<pledged>+</pledged>
		<pub_rule>
			<rule>winner_only</rule>
		</pub_rule>
	</flat>
	<flat>
		<id>123456</id>
		<date>01.04.2014</date>
		<actual>продается</actual>
		<aptp>комната</aptp>
		<nova>-</nova>
		<area>Московская обл.</area>
		<locality>Раменский р-н</locality>
		<town>Гжель пос.</town>
		<address>Почтовая ул.</address>
		<dom>5</dom>
		<housing_complex></housing_complex>
		<price currency="RUB">950000</price>
		<flats>студия</flats>
		<apartment>+</apartment>
		<sq pl_ob="53" pl="20" kitch="15" pl_r="18-20"></sq>
		<floor>5</floor>
		<fl_ob>9</fl_ob>		
		<building_type>К</building_type>
		<lift>лифт</lift>
		<chute>-</chute>
		<balcony>2Б</balcony>
		<water_closet>2Р</water_closet>
		<window_view>окна во двор</window_view>
		<flooring>ЛН</flooring>
		<condition>хорошее состояние</condition>
		<has_phone>Т</has_phone>
		<own_reason>наследство</own_reason>
		<own_year>2010</own_year>
		<owners_count>1</owners_count>
		<regs_count>1</regs_count>
		<owners_minor>-</owners_minor>
		<status>альтернатива</status>
		<mortgage>-</mortgage>
		<phones>89261234567;84959876543</phones>
		<email>test@mail.ru</email>
		<company_url>http://host.com</company_url>
		<object_url>http://host.com/objects/252525.html</object_url>
		<photos>http://host/image_1.jpg;http://host/image_2.jpg</photos>
		<videos><url>https://www.youtube.com/</url></videos>
		<remark><![CDATA[Сделан ремонт, просторная комната]]></remark>
		<agency_bonus bonus_type="percent">5</agency_bonus>
	</flat>
</flats>
