XML specifikacija uvoza

Dobrodošli u European Real Estate XML specifikacija uvoza. Ovaj dokument pruža sve tehničke detalje potrebne za kreiranje feeda nekretnina koji se integrira s našom platformom.

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.

Kako se obrađuju nekretnine

Tehnički zahtjevi

• Sve XML oznake MORA biti malo slovo
• Feed MORA biti kodirano u UTF-8 formatu
• Prelomi redova u opisima moraju koristiti stvarne znakove za novi red (\n)
• Do NIJE upotreba CDATA sekcije i ne šaljite HTML u <desc>
• URL-ovi moraju biti apsolutni (uključujući pune https:// prefiks)
• Svaki račun zahtijeva jedinstveni URL feeda
• Čvorovi svojstva moraju biti direktni potomci <root>

Standardi formata podataka

Svaki feed prati ovu osnovnu strukturu: korijenski element s verzijom formata, nakon čega slijedi jedan čvor svojstva za svako aktivno svojstvo.

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

<european_realestate>
<feed_version>2</feed_version>
</european_realestate>

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

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

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

</root>

Šta platforma čita iz feeda

Svaki element ispod pripada unutar jednog <property> čvor. Imena elemenata su tačno onako kako su ovdje napisana.

Osnovna polja

<id>987654</id>

<ref>ABC-123</ref>

Cijene

<price>250000</price>

<currency>EUR</currency>

<price_freq>sale</price_freq>

lokacija

<country>Spain</country>

<town>Marbella</town>

<province>Málaga</province>

<postal_code>29600</postal_code>

<location_detail>Costa del Sol</location_detail>

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

Detalji o nekretnini

<type>Apartment</type>

<beds>3</beds>

<baths>2</baths>

<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

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

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

Mediji

<images>
<image>
<url>https://example.com/images/main.jpg</url>
</image>
<image>
<url>https://example.com/images/bedroom.jpg</url>
</image>
</images>

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

<video_url>https://www.youtube.com/watch?v=XXXXX</video_url>

<features>
<feature>Swimming Pool</feature>
<feature>Sea views</feature>
<feature>Air Conditioning</feature>
</features>

Koristite ove vrijednosti za <type> polje. Uparivanje nije osjetljivo na velika i mala slova.

Stanovi

Vile

Town Houses

Country Houses

Zemljište i ruševine

Poslovni Prostor

Ostalo

Uključite samo karakteristike koje se odnose na vašu nekretninu, jednu <feature> svaki element. Koristite ova imena; podudaranje nije osjetljivo na velika i mala slova.

Koristite naziv države za <country> polje ili ISO 3166-1 alpha-2 kod.

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

✅ Ispravno <en>Property with pool &amp; garden</en>

❌ Netačno <en>Property with pool & garden</en>

Korak 1: Validacija XML strukture

Validirajte svoj feed pomoću XML validatora prije slanja:

• W3C Service Validation Service
• XMLValidation.com
• Većina modernih preglednika (direktno otvara XML datoteku)

Korak 2: Provjerite kodiranje znakova

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

• W3C Provjera internacionalizacije

Korak 3: Provjerite obavezna polja

Svakoj nekretnini potrebni su ovi elementi:

• <id> — Jedinstveni ID nekretnine
• <price> — Cijena nekretnine
• <price_freq> — Prodaja ili iznajmljivanje
• <type> — Vrsta nekretnine
• <country> — Zemlja
• <town> — Grad ili mjesto
• <desc><en> — Opis nekretnine

Nakon što vaš feed bude odobren, naš sistem automatski sinhronizuje vaša svojstva svake noći.

Sync Schedule

• Feedovi se obrađuju automatski svakih 24 sati
• Obrada počinje nakon 01:00 CEST i nastavlja se do ranog jutra
• Obrada velikih feedova može trajati duže

najbolje prakse

• Uvijek uključi SVE aktivne nekretnine u vašem feedu
• Zadržite <id> nekretnine stabilne tokom cijelog njenog životnog vijeka
• Pošalji do 20 slike po nekretnini; prvi je naslovnica
• Pošalji apsolutne URL-ove slika koji ostaju dostupni; slike se preuzimaju samo jednom
• Osigurajte da URL vašeg feeda ostane konzistentan i dostupan
• Pratite sve greške u validaciji koje prijavi naš tim

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:

• URL vašeg feeda
• Naziv vaše agencije na European Real Estate
• Par od <id> uključene vrijednosti
• Opis problema
• Sve primljene poruke o grešci