XML-importspecifikation

1. Kom godt i gang

Velkommen til den europæiske XML-importspecifikation for fast ejendom. Dette dokument indeholder alle de tekniske detaljer, du har brug for for at oprette et ejendomsfeed, der integreres med vores platform.

2. Oversigt

XML-feedet for europæiske ejendomme er et absolut tilførsel, hvilket betyder, at den skal indeholde alle dine aktive egenskaber, hver gang den genereres. Egenskaber, der ikke er inkluderet i feedet, fjernes automatisk fra vores platform.

Hvordan ejendomme behandles

3. Retningslinjer og konventioner

Tekniske krav

• Alle XML-tags SKAL være med små bogstaver
• Foderet SKAL være UTF-8-kodet
• Linjeskift i beskrivelser skal bruge faktiske linjeskifttegn (\n)
• Do IKKE brug CDATA sektioner
• URL'er skal være absolutte (inkluderer fuldstændige https:// præfiks)
• Hver konto kræver en unik feed-URL

Dataformatstandarder

4. Foderstruktur

Hvert feed følger denne grundlæggende struktur med et rodelement, der indeholder feed-identifikation, agentoplysninger og en eller flere egenskabsnoder.

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

Agentnodefelter

5. Reference til egenskabsnoder

Kernefelter

<id>987654</id>

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

<ref>ABC-123</ref>

Priser

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Lokation

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

Detaljer

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

Indhold

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

Medier

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

Brug disse værdier til <type> Mark:

Lejligheder

Kommerciel Ejendom

Landehuse

Land & Ruiner

Andet

Rækkehuse

Villaer

7. Funktionsliste

Medtag kun de funktioner, der gælder for din ejendom:

8. Understøttede lande

Brug ISO 3166-1 alpha-2-koder til <country_code> Mark:

9. Tegnkodning

Dit feed SKAL være UTF-8-kodetSpecialtegn i tekstindhold skal være korrekt escapet:

10. Test af dit feed

Trin 1: Valider XML-struktur

Før du indsender dit feed, skal du validere det ved hjælp af en XML-validator:

• W3C Markup Validation Service
• XMLValidation.com
• De fleste moderne browsere (åbner XML-filen direkte)

Trin 2: Kontroller tegnkodning

Bekræft, at dit feed er korrekt UTF-8-kodet:

• W3C Internationaliseringstjekker

Trin 3: Bekræft obligatoriske felter

Sørg for, at alle obligatoriske felter er til stede for hver ejendom:

• <id> — Unikt ejendoms-ID
• <date> — Dato for sidste ændring
• <price> — Ejendomspris
• <status> — Salgs-/lejestatus
• <type> — Ejendomstype
• <country_code> — ISO-landekode
• <town> — By/bynavn
• <desc> — Ejendomsbeskrivelse

11. Automatisering af opdateringer

Når dit feed er godkendt, synkroniserer vores system automatisk dine ejendomme dagligt.

Synkroniseringsplan

• Feeds behandles automatisk hver 24 timer
• Behandlingen sker typisk mellem 01:00 - 05:00 CET
• Store feeds kan tage længere tid at behandle

Best Practices

• Inkluder altid ALLE aktive ejendomme i dit feed
• Opdatér <date> felt når ejendomsdata ændres
• Sørg for, at din feed-URL forbliver ensartet og tilgængelig
• Overvåg eventuelle valideringsfejl i dit dashboard

12. Få hjælp

Hvis du har spørgsmål eller støder på problemer med dit XML-feed:

• E-mail: info@european.realestate
• Kontaktformular: europæisk.fast ejendom/kontakt

Når du kontakter support, bedes du inkludere:

• Dit agent-ID
• Din feed-URL
• En beskrivelse af problemet
• Eventuelle modtagne fejlmeddelelser