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

Пролог или заголовок документа.

Фид должен начинаться со стандартного XML-заголовка, с нулевого символа первой строки и должен указывать версию языка и информацию о кодировке.

или

Корневой элемент flats_sale.

Корневой элемент xml-файла. Должен содержать в только элементы offer, в каждом из которых должна находиться информация из одного объявления.

<flats_sale>
	<offer>
		…
	</offer>
	…
</flats_sale>
			

Элемент offer.

Элемент несет всю инфомацию об одном размещаемом объявлении. Информация об объявлении передается в элементах и их атрибутах раположенных внутри элемента offer.

…
<offer>
	<id>1</id>
	<address …/>
</offer>
…
			

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

Элемент id.
Идентификатор объявления на ресурсе источнике. Целое положительное число. (Заполняется обязательно).

Элемент rooms_num.
Идентификатор количества комнат в объекте. Целое число от 0 до 5. (Заполняется обязательно).
0 = комната, 5 = 5 комнат и более.

Элемент address.
Информация о расположении объекта. Пустой элемет, всю информацию несет в атрибутах.
Атрибут locality - наименование населенного пункта. Cтрока.
Атрибут street - наименование улицы. Cтрока.
Атрибут house_str - строковое представление номера дома. Cтрока.
(пример: д. 17/1, д. 17 кор. 1 и т.п.)
Атрибут full_address - строковое представление полного адреса. Cтрока.
(пример: МО, Ивантеевка, Хлебозаводская, 41а)
Должны быть заполнены либо locality, street и house_str, либо full_address (объявления без адреса на ресурс могут не загружаются).

Элемент area.
Информация о площадях объекта. Пустой элемент, всю информацию несет в атрибутах.
Атрибут total - общая площадь объекта. Положительное десятичное число.
Атрибут living - жилая площадь объекта. Положительное десятичное число.
Атрибут kitchen - площадь кухни. Положительное десятичное число.
Атрибут rooms - строковое представление площадей объекта. Cтрока (максимум 100 символов).
(пример: 57/45.5/20/16/9.5)

Элемент price.
Информация о стоимости объета в рублях. Положительное целое число. (Заполняется обязательно).

Элемент floor.
Номер этажа на котором расположен объект. Положительное целое число. (Заполняется обязательно).
Атрибут total - общее количество этажей в доме в котором распологается объект. Положительное целое число. (Заполняется обязательно).

Элемент phone.
Контактный телефон. Cтрока. (Заполняется обязательно).
Допускается до двух номеров по 10 цифр без пробелов, разделенные между символом ";".
(примеры: один номер "9653331155", два номера "9653331155;4957757575")

Необязательные элементы

Элемент metro.
Станция метро (для Москвы). Пустой элемент, всю информацию несет в атрибутах.
Атрибут mid - Идентификатор станции метро согласно списка идентификаторов станций. Положительное целое число. (Заполняется обязательно).

Элемент options.
Информация по дополнительным условиям и ограничениям сдачи объекта. Пустой элемент, всю информацию несет в атрибутах.
"0" - означает: нет или запрещено, "1" - означает: есть или разрешено.
Атрибут object_type - Вторичное жилье или новостройка. Положительное целое число. (значения "1" – вторичное жилье, "2" – новостройка. По умолчанию, вторичное жилье.).
Атрибут sale_type - Тип сделки. Строка (значения "F" – свободная продажа, "A" – альтернатива. По умолчанию, свободная продажа.).
Атрибут phone - Наличие телефона. Строка (значения "1" или "0") По умолчанию "0".
Атрибут lift_passanger - Количество пассажирских лифтов. Положительное целое число (допустимые значения "0" - "9") По умолчанию "0".
Атрибут lift_cargo - Количество грузовых лифтов. Положительное целое число (допустимые значения "0" - "9") По умолчанию "0".
Атрибут wc_combined - Количество совмещенных санузлов. Строка (допустимые значения "0" - "9") По умолчанию "0".
Атрибут wc_separated - Количество раздельных санузлов. Строка (допустимые значения "0" - "9") По умолчанию "0".
Атрибут balcony - Количество балконов. Строка (допустимые значения "0" - "9". По умолчанию "0") По умолчанию "0".
Атрибут loggia - Количество лоджий. Строка (допустимые значения "0" - "9". По умолчанию "0") По умолчанию "0".
Атрибут windows - Вид из окна. Строка (значения "1" - на улицу, "2" - во двор, "3" - на улицу и во двор. По умолчанию "1").
Атрибут garbage - Наличие мусоропровода. Строка (значения "1" или "0". По умолчанию "0").
Атрибут repair - Общее состояние объекта. Строка (значения "1" - требуется капитальный ремонт, "2" - плохое состояние, "3" - без отделки, "4" - требуется ремонт, "5" - среднее состояние, "6" - хорошее состояние, "7" - сделан ремонт, "8" - отличное состояние, "9" - евроремонт, "10" - эксклюзивный евроремонт, "11" - первичная отделка, "12" - не указанно. По умолчанию "4", для новостройки "3").
Атрибут ipoteka - Возможность ипотеки. Положительное целое число (значения "1" или "0". По умолчанию "0").

Элемент photo.
Постоянная, абсолютная ссылка на изображение. Строка.
(В одном элементе допускается только одна ссылка. Если изображений больше одного, то ссылку на каждое изображение помещать в отдельный элемент photo)

Элемент note.
Комментарии к объявлению. Текст помещенный внутрь раздела символьных данных элемента CDATA.

Элемент source_link.
Ссылка на страницу объявления на сайте пользователя.
(примеры: " www.my_site.my/folder?id=1, http://my_site.my/folder?id=1, https://my_site.my/offer ")