﻿<?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> 

Тип объекта. 

Допустимые варианты:
"Офис"
"Магазин"
"Склад"
"Иное"
"Бизнес-центр"
"Торговый центр"
"Производственно-промышленное помещение"
"Предприятие питания"
"ПСН"
"ОСЗ"
"Гостиница"
"Земельный участок"                                
"Автомойка"
"Автосервис"
"Ателье"
"Гараж. комплекс"
"Медцентр"
"Парикмахерская"
"Стоматология"
"Турфирма"
"Учеб. цели"
"Фотоателье"
"Химчистка"
"Офисное здание"
"Торговая площадь"
"Промышленные земли"
"Сельхоз. земли"
"Банк"
"Кафе/Ресторан"                                
"Инвестиционный проект"
"Готовый бизнес"
"База отдыха/Лагерь"

<office_class>

Класс офиса.

Допустимые варианты:
"A+"
"A"
"B+"
"B"
"C+"
"C"
"D+"
"D"

! <optp> 

Тип операции.

Допустимые варианты:
"аренда"
"продажа"


! <area> 

Регион объекта. 

Допустимые варианты:
"Москва"
"Московская обл."


! <locality> 

Район или городской округ Московской области. Данный элемент обязателен и заполняется только для объектов по региону "Московская обл.".


! <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> 

Улица с указанием ее типа после названия: ул., бул., проезд и т.д. 
Данный элемент обязателен только для объектов по региону "Москва", 
для объектов по региону "Московская обл." его заполнение желательно, но не обязательно.


<dom> 

Номер дома, корпуса.

<coordinates>

Координаты объекта недвижимости.

Содержит дочерние элементы lat - Широта, lon - Долгота.

Пример заполнения элемента <coordinates>:
...
<coordinates>
    <lat>55.725990</lat>
    <lon>37.749008</lon>
</coordinates>
...

! <price>

Стоимость всего объекта (НЕ за кв.м).

В значении данного элемента указывается числовое значение стоимости объекта.

В атрибуте "currency" элемента <price> указывается тип валюты, в которой указана стоимость объекта. Допустимые варианты 
значения атрибута "currency":
"RUB" - российские рубли
"USD" - доллары США
"EUR" - евро

Пример заполнения элемента <price>:
...
<price currency="RUB">15500000</price>
...


<factor> 

Период оплаты за весь объект.

Допустимые варианты:
"в год"
"в месяц"
"в квартал"
"в сутки"


!<price_sq>

Стоимость квадратного метра (обязательный параметр при отсутствии цены за общую площадь)

В значении данного элемента указывается числовое значение стоимости объекта.

В атрибуте "currency" элемента <price_sq> указывается тип валюты, в которой указана стоимость объекта. Допустимые варианты 
значения атрибута "currency":
"RUB" - российские рубли
"USD" - доллары США
"EUR" - евро

Пример заполнения элемента <price_sq>:
...
<price_sq currency="RUB">15500</price_sq>
...


<factor_sq> 

Период оплаты за площадь за кв.м.

Допустимые варианты:
"в год"
"в месяц"
"в квартал"
"в сутки"


! <sq>

Площадь объекта.

В атрибутах элемента указывается минимальная и/или максимальная площадь помещений/участков:
- атрибут "pl_min" - минимальная площадь
- атрибут "pl_max" - максимальная площадь

Пример заполнения элемента <sq>:
...
<sq pl_min="50" pl_max="400"></sq>
...


<floor> 

Этаж, на котором расположен объект.


<fl_ob>

Этажность строения, в котором расположен объект.


<ceiling_height> 

Высота потолков в метрах. 


<parking> 

Парковка.

Допустимые варианты:
"+" - есть парковка
"-" - нет парковки


<ohrana> 

Охрана.

Допустимые варианты:
"+" - есть охрана
"-" - нет охраны

<auction> 

Продажа объекта на торгах.

Допустимые варианты:
"+" - Да
"-" - Нет



! <phones>

Номера телефонов для контактов в формате "8xxxxxxxxxx" или "7xxxxxxxxxx". В списке значения разделяются символом ";"


<email>

e-mail для контактов. В списке значения разделяются символом ";".


<company_url>

URL сайта агентства.


<object_url>

URL карточки объекта на сайте агентства.


<photos>

Список URL фотографий объекта. В списке значения разделяются символом ";".

Допустимо не более 100 фотографий.

<videos>

Элемент для видео.

Ссылка на видео указывается в атрибуте <url>

Допускается указание только 1(одной) ссылки с YouTube.

Пример заполнения элементов <videos>:
...
<videos>
	<url>https://www.youtube.com/</url>
</videos>
...

<online_presentation>

Есть возможность показать объект онлайн с помощью сервисов видеосвязи

Допустимые варианты:
"-" - нет возможности онлайн показа
"+" - онлайн показ возможен

<remark>

Дополнительная информация об объекте. Значение данного элемента необходимо указывать в секции <![CDATA[...]]>.

-->

<commercials xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="commercial.xsd">
	<commercial>
		<id>343423</id>
		<date>01.04.2014</date>
		<actual>продается/арендуется</actual>
		<aptp>Склад</aptp>
		<office_class>B+</office_class>
		<optp>продажа</optp>
		<area>Москва</area>
		<metro_list>
			<metro farval="10" fartp="п">Первомайская</metro>
			<metro farval="15" fartp="т">Измайловская</metro>
		</metro_list>
		<address>Парковая ул.</address>
		<dom>35</dom>
		<price currency="RUB">4000000</price>
		<price_sq currency="RUB">18000</price_sq>
		<sq pl_min="50" pl_max="400"></sq>
		<floor>1</floor>
		<fl_ob>3</fl_ob>
		<parking>-</parking>
		<ohrana>+</ohrana>
		<phones>89261234567;84959876543</phones>
		<email>test@mail.ru</email>
		<company_url>http://host.com</company_url>
		<object_url>http://host.com/objects/343423.html</object_url>
		<photos>http://host/image_1.jpg;http://host/image_2.jpg</photos>
		<online_presentation>-</online_presentation>
		<remark><![CDATA[Охраняемый склад]]></remark>
	</commercial>
	<commercial>
		<id>252525</id>
		<date>01.04.2014</date>
		<actual>продается/арендуется</actual>
		<aptp>Офис</aptp>
		<optp>аренда</optp>
		<area>Московская обл.</area>
		<locality>Раменский р-н</locality>
		<town>Гжель пос.</town>
		<address>Почтовая ул.</address>
		<dom>5</dom>
		<price currency="RUB">70000</price>
		<factor>в месяц</factor>
		<sq pl_min="40.5" pl_max="40.5"></sq>
		<floor>2</floor>
		<fl_ob>4</fl_ob>
		<parking>+</parking>
		<ohrana>+</ohrana>
		<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>
		<online_presentation>+</online_presentation>
		<remark><![CDATA[Первая линия домов, новые офисные помещения.]]></remark>
	</commercial>
</commercials>