XML specifikacija uvoza

1. Početak

Dobrodošli u europsku XML specifikaciju uvoza nekretnina. Ovaj dokument pruža sve tehničke detalje potrebne za izradu feeda nekretnina koji se integrira s našom platformom.

2. Pregled

XML feed za europske nekretnine je apsolutni feed, što znači da bi trebao sadržavati sva vaša aktivna svojstva svaki put kada se generira. Svojstva koja nisu uključena u feed automatski će se ukloniti s naše platforme.

Kako se obrađuju nekretnine

3. Smjernice i konvencije

Tehnički zahtjevi

• Sve XML oznake MORA biti malo slovo
• Feed MORA biti kodirano u UTF-8 formatu
• Prijelomi redaka u opisima moraju koristiti stvarne znakove za novi redak (\n)
• Do NE koristiti CDATA dijelovi
• URL-ovi moraju biti apsolutni (uključujući pune https:// prefiks)
• Svaki račun zahtijeva jedinstveni URL feeda

Standardi formata podataka

4. Struktura feedova

Svaki feed slijedi ovu osnovnu strukturu s korijenskim elementom koji sadrži identifikaciju feeda, informacije o agentu i jedan ili više čvorova svojstava.

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

Polja čvora agenta

5. Referenca čvorova svojstava

Osnovna polja

<id>987654</id>

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

<ref>ABC-123</ref>

Cijene

<price>250000</price>

<currency>EUR</currency>

<price_period>month</price_period>

Lokacija

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

Detalji nekretnine

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

Sadržaj

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

Mediji

<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. Vrste nekretnina

Koristite ove vrijednosti za <type> polje:

Apartmani

Poslovni prostor

Kuće za odmor

Zemlja i ruševine

Ostalo

Gradske kuće

Vile

7. Popis značajki

Uključite samo značajke koje se odnose na vašu nekretninu:

8. Podržane zemlje

Koristite ISO 3166-1 alpha-2 kodove za <country_code> polje:

9. Kodiranje znakova

Vaš feed MORA biti kodirano u UTF-8 formatuPosebni znakovi u tekstualnom sadržaju moraju biti pravilno izbjegnuti:

10. Testiranje vašeg feeda

Korak 1: Validacija XML strukture

Prije slanja feeda, provjerite ga pomoću XML validatora:

• W3C Markup Validation Service
• XMLValidation.com
• Većina modernih preglednika (izravno otvaranje XML datoteke)

Korak 2: Provjerite kodiranje znakova

Provjerite je li vaš feed ispravno kodiran UTF-8:

• W3C Provjera internacionalizacije

Korak 3: Provjerite obavezna polja

Provjerite jesu li sva obavezna polja prisutna za svako svojstvo:

• <id> — Jedinstveni ID nekretnine
• <date> — Datum posljednje izmjene
• <price> — Cijena nekretnine
• <status> — Status prodaje/najma
• <type> — Vrsta nekretnine
• <country_code> — ISO kod države
• <town> — Naziv grada/mjesta
• <desc> — Opis nekretnine

11. Automatizacija ažuriranja

Nakon što je vaš feed odobren, naš sustav automatski sinkronizira vaša svojstva svakodnevno.

Raspored sinkronizacije

• Feedovi se obrađuju automatski svakih 24 sati
• Obrada se obično odvija između 01:00 - 05:00 CET
• Obrada velikih feedova može dulje trajati

Najbolje prakse

• Uvijek uključi SVA aktivna svojstva u vašem feedu
• Ažuriraj <date> polje kada se promijene podaci o svojstvu
• Osigurajte da URL vašeg feeda ostane dosljedan i dostupan
• Pratite sve pogreške u validaciji na svojoj nadzornoj ploči

12. Dobivanje pomoći

Ako imate pitanja ili naiđete na probleme sa svojim XML feedom:

• E-mail: info@european.realestate
• Kontakt obrazac: european.realestate/contact

Prilikom kontaktiranja podrške, molimo vas da navedete:

• Vaš ID agenta
• URL vašeg feeda
• Opis problema
• Sve primljene poruke o pogrešci