XML-Importspezifikatioun

1. Ufänken

Wëllkomm bei der XML-Importspezifikatioun fir europäesch Immobilien. Dëst Dokument enthält all déi technesch Detailer, déi Dir braucht, fir e Immobiliefeed ze erstellen, deen sech mat eiser Plattform integréiert.

2. Iwwersiichtskaart

Den XML-Feed vun der Europäescher Immobilienbranche ass en absolut Fudder, dat heescht, et soll all Är aktiv Eegeschaften enthalen, all Kéier wann et generéiert gëtt. Eegeschaften, déi net am Feed abegraff sinn, ginn automatesch vun eiser Plattform geläscht.

Wéi Eegeschafte veraarbecht ginn

3. Richtlinnen & Konventiounen

Technesch Requirements

• All XML-Tags MUSS kleng geschriwwe sinn
• D'Fudder MUSS UTF-8 kodéiert sinn
• Zeilenëmbriech a Beschreiwunge mussen tatsächlech Zeilennei-Zeechen benotzen (\n)
• Do NET Benotzung CDATA Sektiounen
• URLen mussen absolut sinn (mat komplette URLen) https:// Präfix)
• All Kont brauch eng eenzegaarteg Feed-URL

Data Format Standards

4. Fudderstruktur

All Feed follegt dëser Basisstruktur mat engem Root-Element, deen d'Feed-Identifikatioun, Agentinformatiounen an een oder méi Eegeschaftsknoten enthält.

<?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>

Agentenknotenfelder

5. Referenz op d'Eegeschaftsknoten

Kärfelder

<id>987654</id>

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

<ref>ABC-123</ref>

Tarifikatioun

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Standuert

<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>

Property Details

<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>

Inhalt

<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>

Media

<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. Property Zorte

Benotzt dës Wäerter fir d' <type> Feld:

Appartementer

Commercial Property

Land Haiser

Land & Ruinen

aner

Stadhaiser

Villen

7. Fonctiounen Lëscht

Gitt nëmmen déi Funktiounen un, déi op Är Immobilie zoutreffen:

8. Ënnerstëtzte Länner

Benotzt ISO 3166-1 Alpha-2 Coden fir den <country_code> Feld:

9. Zeechenkodéierung

Äre Feed MUSS UTF-8 kodéiert sinnSpezialzeechen am Textinhalt mussen korrekt escaped ginn:

10. Äre Feed testen

Schrëtt 1: XML-Struktur validéieren

Ier Dir Äre Feed ofgitt, validéiert en mat engem XML-Validator:

• W3C Markup Validation Service
• XMLValidation.com
• Déi meescht modern Browser (XML-Datei direkt opmaachen)

Schrëtt 2: Zeechenkodéierung kontrolléieren

Vergewëssert Iech datt Äre Feed richteg UTF-8 kodéiert ass:

• W3C Internationaliséierungschecker

Schrëtt 3: Obligatoresch Felder iwwerpréiwen

Vergewëssert Iech, datt all obligatoresch Felder fir all Propriétéit präsent sinn:

• <id> — Eenzegaarteg Immobilie-ID
• <date> — Datum vun der leschter Ännerung
• <price> — Immobiliepräis
• <status> — Verkafs-/Locatiounsstatus
• <type> — Aart vun der Immobilie
• <country_code> — ISO-Lännercode
• <town> — Numm vun der Stad/Uertschaft
• <desc> — Beschreiwung vun der Immobilie

11. Automatiséierung vun Updates

Soubal Äre Feed guttgeheescht ass, synchroniséiert eise System Är Propriétéiten automatesch all Dag.

Synchroniséierungsplang

• Feeds ginn automatesch all Kéier veraarbecht 24 Stonnen
• D'Veraarbechtung fënnt typescherweis tëscht 01:00 - 05:00 CET
• Grouss Feeds kënnen méi laang daueren fir ze veraarbechten

Best Practices

• Ëmmer enthalen ALL aktiv Eegeschaften an Ärem Feed
• Update de <date> Feld wann d'Eegeschaftsdaten sech änneren
• Vergewëssert Iech datt Är Feed-URL konsequent an zougänglech bleift
• Iwwerwaacht all Validatiounsfehler an Ärem Dashboard

12. Hëllef kréien

Wann Dir Froen hutt oder Problemer mat Ärem XML-Feed hutt:

• Email: info@european.realestate
• Kontaktformular: européenesch.immobilien/kontakt

Wann Dir de Support kontaktéiert, gitt w.e.g. folgend Informatiounen un:

• Är Agenten-ID
• Är Feed-URL
• Eng Beschreiwung vum Problem
• All Feelermeldungen, déi kritt goufen