Главная
XML выгрузка

XML выгрузка

На портал townhouse.ru возможна выгрузка объявлений о продаже или аренде таунхаусов в автоматическом режиме.

Файлы для загрузки объявлений должны соответствовать стандарту XML.

Не разрешено использовать первые 32 ASCII-символа в текстовых полях (исключения — табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы: " & > < '

Кодировка: Файл должен быть создан в кодировке UTF-8.

Общая информация об объявлении

Корневой элемент realty-feed содержит предложения offer (каждый из этих элементов содержит информацию из объявления) и дату создания фида. Обязательный атрибут internal-id должен быть уникальным для каждого объявления. Этот атрибут можно заполнять, например, идентификатором объявления в вашей базе данных.

Поля со * - обязательные

Важно – обязательно учитывайте регистр, например:

Не верно - <renovation>С отделкой</renovation>

Верно - <renovation>c отделкой</renovation>

Общая информация об объекте
Дата создания*	creation-date
Дата обновления*	last-update-date
Дата окончания*	expire-date
География - location
страна*	country. Всегда указывается только Россия
субъект РФ*	region. только Москва, Московская обл, Санкт-Петербург, Ленинградская обл
район субъекта РФ	district
название населенного пункта	locality-name (Для Москвы здесь будет – Бутово, Дегунино, Зеленоград и т.д., для Петербурга – Зеленогорск, Колпино, Кронштадт и т.д.)
шоссе*	direction. Указывается ближайшее шоссе к объекту. Если рядом с объектом расположено несколько шоссе, то каждое из них передается в дополнительном теге direction
адрес	address. Точный адрес объекта
название КП*	cottage-village. Точное название поселка, как в базе townhouse.ru /xml/objects.xml
расстояние от МКАД (КАД)	distance, указывается в километрах
координаты объекта	latitude и longitude
Теги об объекте - offer
internal-id*	уникальный для каждого объявления
Тип объявления*	type Продать - 1 Сдать - 2
тип дома*	category. Обязательно указывается одна из категорий: дуплексы - 1 триохаусы - 2 детачды - 3 клиф-хаусы – 4 флетхаусы- 5 датчхаусы – 6 твинхаусы – 7 лэйнхаусы – 8 квадрохаусы – 9 таунхаусы - 10
ремонт*	renovation (могут передавать значения поля состояние отделки) с отделкой - 1 без отделки - 2 под ключ - 3
площадь дома*	area, value — значение, unit — единицы измерения, указывать м2
площадь участка*	lot-area, value — значение, unit — единицы измерения, соток
описание*	description. Подробный текст предложения без указания контактных данных и стоимости
изображение*	image. Обязательно размещается хотя бы одно изображение. Дополнительные передаются в тегах image
Теги о стоимости — price
цена объекта*	value. Сумма указывается без пробелов
валюта*	currency. Допускаются только рублевые цены, для этого значение тега должно быть «RUR» или «RUB»
Теги контактные данные — sales-agent
имя продавца*	name
телефон*	phone

Пример корректного фида:

<?xml version="1.0″ encoding="UTF-8″?>

<creation-date>2017-07-03T13:58:46+03:00</creation-date>

<last-update-date>2017-07-03T13:58:46+03:00</last-update-date>

<expire-date>2017-07-04T13:58:46+03:00</expire-date>

<country>Россия</country>

<region>Московская область</region>

<locality-name>Красногорск</locality-name>

<direction>Волоколамское</direction>

<cottage-village>Новая Опалиха</cottage-village>

</location>

<type>продать</type>

<category>дуплексы</category>

<renovation>с отделкой</renovation>

<area>

</area>

<lot-area>

</lot-area>

<image>ссылка на изображение</image>

</images>

<description>Подробное описание предложения</description>

<price>

</price>

<sales-agent>

<name>Иван Иванов</name>

</sales-agent>

</offer>

</xml>

Если у вас есть уже готовый XML файл, вы можете самостоятельно проверить его в валидаторе кода.