Требования к XML файлу
Условия успешной публикации
Требования к XML файлу
для сайта estate-spain.com
Новые объекты недвижимости могут быть добавлены на сайт estate-spain.com не только вручную, но и с помощью импорта. В этом случае можно добавить или обновить сразу большое количество объектов. Единственное, что нужно сделать — прислать нам подготовленный файл в формате .xml.

Есть ряд важных параметров, которые обязательно должны указываться в системе, чтобы все данные отображались на сайте корректно. Ниже представлен список параметров, обязательных для того, чтобы объект из .xml файла был опубликован на estate.spain.com.

1 — Референс и ID

ID — это основной параметр по которому обновляются данные объекта. ID уникален, в xml файле он выглядит так <Id>12363</id>

Референс — ваш внутренний код объекта, например — <ref> INM-00001</ref>. По нему вы сможете найти этот объект на своем сайте. Если данные загружены верно, то после загрузки вы можете также найти этот объект по этому же номеру на сайте estate-spain.com. Код референса может быть не предусмотрен в вашей базе и выгружать его в XML не обязательно.

1.1 Id объекта — обязательное

Параметр в файле:
<Id></id>

1.2 Референс объекта — не обязательное

Параметр в файле:
<ref></ref>

  • ID объекта должен быть уникальным;
  • Нельзя менять нумерацию референсов и ID, которые уже добавлены в XML.

Примечание: если у объекта были одни данные, а потом вы пронумеровали объект по-другому, мы не сможем обновить по нему информацию, и в следующий раз система его пропустит.


2 — Тип объекта

Параметр в файле:
<type> </type>

По типу объекты разделяются на разные категории. На Estate Spain предусмотрены следующие типы объектов:

  • Апартаменты
  • Квартира
  • Пентхаус
  • Студия
  • Вилла
  • Дом
  • Замок
  • Коттедж
  • Масия
  • Особняк
  • Поместье
  • Сельский дом
  • Усадьба
  • Земля под жилое строительство
  • Земля под коммерческое использование
  • Бунгало
  • Дуплекс
  • Таунхаус
  • Шале
  • Автозаправочная станция
  • Гараж
  • Гостиница
  • Готовый бизнес
  • Жилое здание
  • Кафе
  • Коммерческое помещение
  • Магазин
  • Нежилое здание
  • Отель
  • Офис
  • Паркинг
  • Помещение
  • Ресторан
  • Складское помещение
  • Хостел
Желательно, чтобы типы объектов в .xml соответствовали нашему списку типов. Если в списке нет нужного вам типа, обратитесь к нашим сотрудникам, и мы добавим новый тип на сайт.


3 — Координаты объекта (широта и долгота) или адрес объекта (полностью, код, регион, город, улица, дом)

Обязательно заполните данные координат объекта, без них мы не сможем показать клиентам расположение объекта на карте.

Пример:
<location>
<latitude>38.3136949345744</latitude>
<longitude>-0.5202149000000444</longitude>
</location>


Это верное оформление. Очень важно, чтобы для каждого объекта эти данные были обязательно указаны, иначе система пропустит объект из файла и не загрузит на наш сайт.


4 — Площадь объекта в метрах

Пример:
<surface_area>
<built>52</built>
<plot>0</plot>
</surface_area>


Примечание: если есть участок земли, также укажите площадь в метрах. Если есть данные по террасе — укажите площадь в метрах. Это не обязательно, но желательно, если эти данные есть.

Для земельных участков площадь участка является обязательным значением.


5 — Стоимость объекта в EUR

Пример:
<price>89000</price>


6 — Количество санузлов, спален, общее количество комнат

Пример:
<beds>1</beds> — обязательно
<baths>1</baths> — обязательно
<rooms>2</rooms> — обязательно


7 — Фотографии объекта

Обязательно наличие не менее трех фотографий без водяных марок (watermark). Если фотографий будет меньше, система пропустит такой объект и не опубликует его.


Остальные параметры заполняются по желанию и могут быть названы на усмотрение партнера. Полный список параметров можно посмотреть по ссылке.


8 — Рекомендованные поля

Состояние объекта недвижимости: новостройка / вторичное

<condition></condition>

По-умолчанию всем объектам устанавливается значение «вторичная недвижимость», поэтому если нужно выделить, что объект новый, это нужно указать в XML.


Доступность объекта: продано / продажа

<available></available>

По-умолчанию у всех проставляется «Продажа», а отметка «Продано» на Estate Spain проставляется, когда объект удаляется из .xml. Но если у объекта есть статус продажи, то лучше его тоже указывать.


Пример объекта со всеми заполненными атрибутами:

<property>
<id>705</id>
<date>2018-01-13 16:07:17</date>
<ref>226</ref>
<price>245000</price>
<currency>EUR</currency>
<price_freq>sale</price_freq>
<type>Villa</type>
<available>for sale</available>
<condition>new</condition>
<town>Villamartin</town>
<province>Alicante / Costa Blanca South</province>
<location_detail>Villamartin</location_detail>
<beds>4</beds>
<baths>2</baths>
<rooms>5</rooms>
<pool>1</pool>
<location>
<latitude>37.937710</latitude>
<longitude>-0.746534</longitude>
</location>
<surface_area>
<built>150</built>
<plot>320</plot>
</surface_area>
<desc>
<en>
<![CDATA[
Detached House in perfect condition like new 5 minute drive from the sandy beaches of Orihuela Costa.<br>The property benefits from overlooking the luxury community pool with SPA and large solarium. <br>The Property is very bright and sunny. The House is, equipped with air-conditioning, and electrical appliances. And consist of 4 bedrooms (master bedroom with dressing room), 2 bathrooms, open style kitchen, living room, terrace and off road parking. <br>Villamartin is a fast-growing tourist destination, located on the southern Costa Blanca just west of Torrevieja, which many tourists choose for its proximity to three championship golf courses, Campoamor, Las Ramblas and Villamartin. <br>It also has many sandy Blue Flag beaches just a few minutes' drive away at La Zenia, Cobo Rojg and Playa Flamenca. <br>The Villamartin Plaza is surrounded by shops, cafés, bars, banks and restaurants, where the summer nightlife atmosphere buzzes with life.</p>
]]>
</en>
<es>
<![CDATA[
Villamartín es una zona de Orihuela Costa, situada en el sur de la Costa Blanca conocida por sus campos de golf. La población aquí son en su mayoría residentes europeos. Esta zona de élite cuenta con villas privadas, adosados y bungalows. En poca distancia hay todo lo necesario para la vida y la recreación - supermercados, bares, restaurantes, un colegio Inglés de élite.<br><br>Vivienda unifamiliar en perfecto estado, a 5 minutos en coche de las playas de arena.<br>Vista de la piscina de la urbanización, un spa de lujo y un gran solarium.<br>La casa es muy luminosa y soleada. La casa está equipada con aire acondicionado y electrodomésticos. La casa tiene 4 dormitorios (el principal con vestidor), 2 baños, cocina abierta, sala de estar, terraza y aparcamiento.</p>
]]>
</es>
<ru>
<![CDATA[
Вилламартин — район в Ориуэла Коста, расположен на южном побережье Коста Бланка, знаменитый своими полями для игры в гольф. Население здесь — преимущественно жители из Европы. Это элитный район, застроенный частными виллами, таунхаусами и бунгало. В шаговой доступности есть все необходимое для жизни и отдыха – супермаркеты, бары, рестораны, элитный английский колледж.<br>Частный дом в отличном состоянии, в 5 минутах езды от песчаных пляжей.<br>Вид на бассейн урбанизации, роскошный спа-центр и большой солярий.<br>Дом очень яркий и солнечный. Дом оснащен кондиционером и электрическими приборами. В доме 4 спальни (спальня с гардеробной), 2 ванные комнаты, Открытая кухня, гостиная, терраса и парковка.</p>
]]>
</ru>
</desc>
<features>
<feature>Floor heating</feature>
<feature>Storage room</feature>
<feature>Garden</feature>
<feature>Air Conditioning</feature>
<feature>Communal Swimming Pool</feature>
<feature>Fully furnished</feature>
<feature>Close To Amenities</feature>
<feature>Terrace Balcony</feature>
<feature>Off road parking</feature>
<feature>Overlooking the park</feature>
<feature>Overlooking the pool</feature>
</features>
<images>
<image id="1">
</image>
<image id="2">
<url>
</url>
</image>
<image id="3">
<url>
</url>
</image>
<image id="4">
<url>
</url>
</image>
<image id="5">
<url>
</url>
</image>
<image id="6">
<url>
</url>
</image>
</images>
</property>


9 — Обновление файла импорта

Файл .xml обновляется автоматически по расписанию (в настоящее время каждый понедельник) по предоставленной вам ссылке, либо вы присылаете файл на почту publish@estate-spain.com.

Система проверяет, какие новые объекты были добавлены, какие старые удалены или проданы, где изменились данные (например, цена), и обновляет их на сайте estate-spain.com

Что необходимо делать:

  • регулярно обновлять вашу базу и удалять неактуальные и проданные объекты;
  • регулярно обновлять вашу базу и добавлять новые объекты;
  • следить за качеством фотографий объекта (чем их больше и они лучшего качества, тем больше вероятность того, что клиент заинтересуется объектом);
  • следить за полнотой описания объекта и параметров по нему – чем больше из них будет заполнено, тем вероятнее клиент найдет ваш объект. На сайте Estate Spain можно использовать такие критерии для поиска: город/регион, тип объекта, состояние, цена, расстояние до моря, количество спален/санузлов, площадь помещения, площадь участка. Наличие: террасы, парковки, охраны, вида на море, солярия, бассейна, лифта, сада, мебели.
Если у вас остались вопросы по работе с .xml файлом, вы можете связаться с менеджером Татьяной Трифоновой по адресу xml@estate-spain.com.

Made on
Tilda