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

КСНУМКС. Почетак

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

КСНУМКС. Преглед

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>

Cena

<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 валидатора:

• В3Ц услуга провере маркупа
• XMLValidation.com
• Већина модерних прегледача (директно отвара XML датотеку)

Корак 2: Проверите кодирање знакова

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

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

Корак 3: Проверите обавезна поља

Уверите се да су сва обавезна поља присутна за сваку некретнину:

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

11. Аутоматизација ажурирања

Када ваш фид буде одобрен, наш систем аутоматски синхронизује ваше производе свакодневно.

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

• Фидови се обрађују аутоматски сваких sola travel
• Обрада се обично дешава између 01:00 - 05:00 CET
• Обрада великих фидова може трајати дуже

Најбоље праксе

• Увек укључи СВА активна својства у вашем фиду
• Ажурирајте <date> поље када се подаци о својству промене
• Уверите се да је URL вашег фида доследан и приступачан
• Пратите евентуалне грешке у валидацији на контролној табли

12. Добијање помоћи

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

• Email: info@santannadating.com инфо@еуропеан.реалестате
• Контакт формулар: european.realestate/contact

Када контактирате подршку, наведите:

• ИД вашег агента
• URL адреса вашег фида
• Опис проблема
• Све примљене поруке о грешци