Спецификација за XML увоз

1. Да започнеме

Добредојдовте во европската спецификација за увоз на недвижности во XML. Овој документ ги содржи сите технички детали што ви се потребни за да креирате информации за недвижности што се интегрира со нашата платформа.

2. Преглед

XML-фидот за европски недвижнини е апсолутен фид, што значи дека треба да ги содржи сите ваши активни својства секој пат кога ќе се генерира. Својствата што не се вклучени во фидот автоматски ќе бидат отстранети од нашата платформа.

Како се обработуваат својствата

3. Насоки и конвенции

Технички барања

• Сите XML ознаки МОРА да биде со мали букви
• Фидот МОРА да биде кодирано во UTF-8
• Прекините на редовите во описите мора да користат вистински знаци за нов ред (\n)
• Do НЕ употреба CDATA делови
• URL-адресите мора да бидат апсолутни (вклучете целосни https:// префикс)
• Секоја сметка бара единствена URL адреса на фид

Стандарди за формат на податоци

4. Структура на храна

Секој фид ја следи оваа основна структура со коренски елемент што содржи идентификација на фидот, информации за агентот и еден или повеќе јазли на својства.

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

    <european_realestate>
        <feed_version>1</feed_version>
    </european_realestate>

    <agent>
        <id>YOUR_AGENT_ID</id>
        <name>Agency Name</name>
        <email>contact@agency.com</email>
        <!-- Additional agent fields... -->
    </agent>

    <property>
        <!-- Property 1 fields... -->
    </property>

    <property>
        <!-- Property 2 fields... -->
    </property>

    <!-- Additional properties... -->

</root>

Полиња на јазли на агент

5. Референца на јазли на својства

Основни полиња

<id>987654</id>

<date>2026-01-08 12:00:00</date>

<ref>ABC-123</ref>

Цени

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Локација

<country_code>ES</country_code>

<town>Marbella</town>

<region>Málaga</region>

<postcode>29600</postcode>

<location_detail>Costa del Sol</location_detail>

<location>
    <latitude>36.5108</latitude>
    <longitude>-4.8855</longitude>
</location>

Детали за имот

<type>apartment</type>

<condition>good_condition</condition>

<bedrooms>3</bedrooms>
<bathrooms>2</bathrooms>
<rooms>6</rooms>
<garage>1</garage>

<year_built>2020</year_built>

<surface_area>
    <built>150</built>
    <plot>500</plot>
</surface_area>

<energy_rating>
    <consumption>B</consumption>
    <emissions>C</emissions>
</energy_rating>

содржина

<title>Stunning 3-Bedroom Apartment with Sea Views</title>

<desc>Beautiful modern apartment located in the heart of Marbella...</desc>

<url>https://example.com/property/123456</url>

<notes>Key available at office. Call before viewing.</notes>

МЕДИУМИ

<images>
    <image id="1">
        <url>https://example.com/images/main.jpg</url>
        <title>Living Room</title>
    </image>
    <image id="2">
        <url>https://example.com/images/bedroom.jpg</url>
        <title>Master Bedroom</title>
    </image>
</images>

<virtual_tour>https://my.matterport.com/show/?m=XXXXX</virtual_tour>

<video>
    <url>https://youtube.com/watch?v=XXXXX</url>
    <type>youtube</type>
</video>

<features>
    <feature>swimming_pool</feature>
    <feature>air_conditioning</feature>
    <feature>sea_views</feature>
</features>

6. Видови на имот

Користете ги овие вредности за <type> Поле:

Апартмани

Комерцијална сопственост

Селски куќи

Земја и урнатини

други

Градски куќи

Вили

7. Список со карактеристики

Вклучете ги само карактеристиките што се однесуваат на вашиот имот:

8. Поддржани земји

Користете ISO 3166-1 алфа-2 кодови за <country_code> Поле:

9. Кодирање на знаци

Вашиот фид МОРА да биде кодирано во UTF-8Специјалните знаци во текстуалната содржина мора правилно да се избегнуваат:

10. Тестирање на вашиот фид

Чекор 1: Валидирајте ја XML структурата

Пред да го поднесете вашиот фид, потврдете го со помош на XML валидатор:

• Услуга за потврдување на ознаката W3C
• XMLValidation.com
• Повеќето модерни прелистувачи (отворете ја XML датотеката директно)

Чекор 2: Проверете го кодирањето на знаците

Проверете дали вашиот фид е правилно кодиран во UTF-8:

• Проверка на интернационализација на W3C

Чекор 3: Потврдете ги задолжителните полиња

Осигурајте се дека сите задолжителни полиња се присутни за секој имот:

• <id> — Уникатен ID на имотот
• <date> — Датум на последна измена
• <price> — Цена на имотот
• <status> — Статус на продажба/изнајмување
• <type> — Тип на имот
• <country_code> — ISO код на земјата
• <town> — Име на град/населено место
• <desc> — Опис на имотот

11. Автоматизирање на ажурирањата

Откако вашиот фид ќе биде одобрен, нашиот систем автоматски ги синхронизира вашите својства секојдневно.

Распоред за синхронизација

• Фидовите се обработуваат автоматски на секои 24 часа
• Обработката обично се случува помеѓу 01:00 - 05:00 часот по средноевропско време
• Обработката на големи количини храна може да потрае подолго.

Најдобри практики

• секогаш вклучуваат СИТЕ активни својства во вашиот фид
• Ажурирајте го <date> поле кога податоците за својствата се менуваат
• Осигурајте се дека URL-адресата на вашиот фид останува конзистентна и достапна
• Следете ги грешките во валидацијата на вашата контролна табла

12. Добивање помош

Доколку имате прашања или наидете на проблеми со вашиот XML фид:

• Е-пошта: info@european.realestate
• Формулар за контакт: european.realestate/contact

Кога контактирате со поддршката, ве молиме наведете:

• Вашиот ID на агент
• URL-адресата на вашиот фид
• Опис на проблемот
• Сите примени пораки за грешка