Hledat

Začínáme

Vítejte Evropské nemovitosti Specifikace importu XML. Tento dokument poskytuje všechny technické podrobnosti potřebné k vytvoření feedu nemovitostí, který se integruje s naší platformou.

Vytvořte si svůj kanál

Vytvořte si XML feed podle specifikace uvedené v tomto dokumentu. Vyplňte povinná pole pro každou vlastnost a použijte názvy prvků přesně tak, jak jsou uvedeny – prvek, který není v tomto dokumentu, se nepřečte.

Otestujte svůj feed

Ověřte strukturu XML a kódování znaků. Před odesláním použijte standardní validátor XML ke kontrole syntaktických chyb.

Odeslat na recenzi

Jakmile bude váš feed správně ověřen, odešlete URL adresu feedu našemu týmu k finální kontrole. Ověříme integraci a aktivujeme automatickou synchronizaci.

Přehled

XML feed pro evropské nemovitosti je absolutní posuv, což znamená, že by měl při každém vygenerování obsahovat všechny vaše aktivní vlastnosti.

⚠️ Důležité: Pravidlo absolutního krmení Váš feed musí obsahovat VŠECHNY aktivní vlastnosti. Vlastnost, která ve feedu chybí, je platformou odebrána, takže neúplný feed způsobí, že nabídky z webu zmizí.

Jak se zpracovávají nemovitosti

ScénářAkce
Nový <id> detekovánaNemovitost je VLOŽENO jako nový inzerát
Stávající <id> se změněnými údajiNemovitost je AKTUALIZOVÁNO s novými informacemi
<id> chybí ve feeduNemovitost je STÁHNUTO OFFLINE po třech po sobě jdoucích synchronizacích. Nebude smazán: pokud se vrátí do kanálu, bude při další synchronizaci opět online s neporušenými obrázky a daty.
💡 Tip Jedno <id> je klíčové. Platforma porovnává data každé vlastnosti při každé synchronizaci a zpracovává ta, která se změnila, takže není třeba uchovávat žádné pole s datem: ponechte <id> stabilní a odešlete své aktuální hodnoty.

Pokyny a konvence

Technické požadavky

  • Všechny tagy XML MUSÍ být malými písmeny
  • Krmivo MUSÍ být kódováno UTF-8
  • Zalomení řádků v popisech musí používat skutečné znaky nového řádku (\n)
  • Do NENÍ použití CDATA sekce a neodesílat HTML <desc>
  • URL adresy musí být absolutní (včetně celých https:// předpona)
  • Každý účet vyžaduje jedinečnou URL adresu zdroje.
  • Uzly vlastností musí být přímými potomky uzlů vlastností <root>

Standardy datových formátů

Typ poleFormátPříklad
CenaPouze čísla, žádné symboly250000
Plocha (m²)Číselné, metry čtvereční150
Souřadnice GPSDesetinné stupně36.5108, -4.8855
ZeměNázev ze seznamu podporovaných zemí nebo ISO 3166-1 alpha-2Spain or ES
Rok výrobyČtyři číslice2018

Struktura krmných kanálů

Každý feed se řídí touto základní strukturou: kořenový element s verzí formátu, následovaný jedním uzlem vlastnosti pro každou aktivní vlastnost.

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

Co platforma čte z feedu

PrvekVýznam
<european_realestate>Identifikace formátu. Odeslat <feed_version>2</feed_version>
<property>Jedna vlastnost. Vše, co platforma ukládá, pochází z tohoto uzlu.
💡 Údaje o agentuře Název vaší agentury, logo, kontaktní údaje a odkaz mezi vaším feedem a vaším účtem registrujeme pro každý feed zvlášť. Z feedu se nenačítají, takže není třeba nic odesílat ani v souboru nic aktualizovat. Pokud se údaje o vaší agentuře změní, pošlete nám zprávu.

Referenční informace o uzlech vlastností

Každý níže uvedený prvek patří do jednoho <property> uzel. Názvy prvků jsou přesně tak, jak jsou zde napsány.

Klíčová pole

Požadovaný Typ: Řetězec/Celé číslo

Jedinečný identifikátor vlastnosti. Ten musí zůstat konzistentní napříč aktualizacemi kanálu: je to klíč, podle kterého platforma vyhledává shody.

<id>987654</id>

volitelný Typ: Řetězec

Váš interní referenční kód nemovitosti. V dalších podrobnostech nabídky se zobrazuje jako „Referenční číslo“.

<ref>ABC-123</ref>

Ceník

Požadovaný Typ: Celé číslo

Cena nemovitosti jako číslo bez symbolů měn a oddělovačů.

<price>250000</price>

volitelný Typ: Řetězec Výchozí: EUR

Kód měny. Podporované měny: EUR, GBP, USD, CHF, PLN, CZK, HUF, RON, SEK, NOK, DKK

<currency>EUR</currency>

Požadovaný Typ: Výčet

Zda je nemovitost na prodej nebo k pronájmu a v případě pronájmu období, na které se cena vztahuje.

HodnotaPopis
saleNemovitost je na prodej
monthNemovitost je k pronájmu, cena za měsíc
weekNemovitost je k pronájmu, cena za týden
yearNemovitost je k pronájmu, cena za rok
<price_freq>sale</price_freq>

Aktuální poloha

Požadovaný Typ: Řetězec

Země nemovitosti. Použijte název z Podporované země seznam; akceptován je také kód ISO 3166-1 alpha-2.

<country>Spain</country>

Požadovaný Typ: Řetězec

Název města nebo obce, kde se nemovitost nachází.

<town>Marbella</town>

volitelný Typ: Řetězec

Provincie, region nebo stát.

<province>Málaga</province>

volitelný Typ: Řetězec

Poštovní směrovací číslo.

<postal_code>29600</postal_code>

volitelný Typ: Řetězec

Další popis lokality (sousedství, urbanizace, oblast). V nabídce je uvedeno jako „Oblast“.

<location_detail>Costa del Sol</location_detail>

volitelný Typ: Kontejner

GPS souřadnice v desetinných stupních. Obě hodnoty jsou potřeba k zobrazení mapového špendlíku.

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

Podrobnosti o nemovitosti

Požadovaný Typ: Výčet

Typ vlastnosti. Použijte hodnotu z Typy vlastností seznam. Při porovnávání se nerozlišují velká a malá písmena.

<type>Apartment</type>

volitelný Typ: Celé číslo

Počet ložnic.

<beds>3</beds>

volitelný Typ: Celé číslo

Počet koupelen.

<baths>2</baths>

volitelný Typ: Celé číslo (4 číslice)

Rok, kdy byla nemovitost postavena.

<year_built>2020</year_built>

volitelný Typ: Kontejner

Zastavěná plocha a velikost pozemku v metrech čtverečních. Pozemek má smysl pouze u pozemků a nemovitostí s pozemky.

<surface_area>
<built>150</built>
<plot>500</plot>
</surface_area>

volitelný Typ: Kontejner

Energetická náročnost, písmena A až G. Odeslat X když není k dispozici žádný certifikát.

<energy_rating>
<consumption>B</consumption>
<emissions>C</emissions>
</energy_rating>

Obsah

Požadovaný Typ: Řetězec

Úplný popis nemovitosti v angličtině, zabalený v <en> element. Překlady se generují automaticky. Pro zalomení odstavců používejte skutečné znaky nového řádku, neodesílejte HTML a nepoužívejte CDATA.

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

volitelný Typ: URL

Odkaz na nemovitost na vašem webu, zabalený v <en> prvek.

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

Media

volitelný Max.: 20 obrázků

Obrázky nemovitosti. První obrázek je titulní. Na inzerát je možné uložit maximálně 20 obrázků. Doporučená velikost 1920x1280px, minimálně 800x600px.

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

volitelný Typ: URL

URL adresa virtuální prohlídky (Matterport, iGuide a podobné).

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

volitelný Typ: URL

URL adresa videa z nemovitosti: YouTube, Vimeo nebo přímý soubor MP4/WebM.

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

volitelný Typ: Kontejner

Seznam vlastností nemovitosti. Použijte názvy z Seznam VlastnostiPři hledání se nerozlišují velká a malá písmena. Odesílejte pouze ty vlastnosti, které se vztahují k danému tématu.

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

Typy vlastností

Použijte tyto hodnoty pro <type> pole. Při porovnávání se nerozlišují velká a malá písmena.

Apartmány

Byt
Přístřešek
studio
Duplex
Triplex
Mezonet

Villas

Vila
Bungalov
Samostatný dům

Městské domy

Městský dům
Dvojdomek
Řadový dům
Vesnický dům

Venkovské domy

Horská chata
Zámek
Statek
Majetek
Statek
Farma
Venkovský dům
Jeskynní dům

Země a ruiny

Přistát
Ostrov
Zřícenina

komerční objekt

businessu
Komerční nemovitosti
Komplex
Hotel
E-shop

Ostatní

mobilní dům
Parkovací místo
💡 Tip Odešlete typ nemovitosti tak, jak by se měl zobrazovat v nabídce. Pokud použijete hodnotu, která v tomto seznamu není, bude nabídka publikována bez typu nemovitosti.

Seznam Vlastnosti

Uveďte pouze vlastnosti, které se vztahují k vaší nemovitosti, jednu <feature> element pro každý prvek. Použijte tyto názvy; při porovnávání se nerozlišují velká a malá písmena.

Bezbariérová nemovitost
Klimatizace
Barbeque
Suterén
Výtah
Vestavěné skříně
Zařízeno
Garáž
Zahrada
tělocvična
Internet
Prádelna
Trávník
Mimo síť
venkovní sprcha
parkování
Telefonní linka
Sauna
Výhled na moře
Komora
Bazén
Terasa
Kabelová TV
WiFi
Okenní krytiny
⚠️ Posílejte tato jména, ne kódy Výše uvedené názvy představují funkce naší platformy. Hodnota, která není v tomto seznamu, je ignorována, takže se v seznamu nezobrazí.
Opravit: <feature>Swimming Pool</feature>
Ignorováno: <feature>swimming_pool</feature>

Podporované země

Použijte název země pro <country> pole nebo kód ISO 3166-1 alpha-2.

ZeměISOZeměISO
AlbánieALLotyšskoLV
RakouskoATLitvaLT
BelgieBELucemburskoLU
Bosna a HercegovinaBAMaltaMT
BulharskoBGMoldavskoMD
ChorvatskoHRČerná HoraME
KyprCYNorskoNE
ČeskoCZPolskoPL
DánskoDKPortugalskoPT
EstonskoEERumunskoRO
FinskoFISrbskoRS
FrancieFRSlovenskoSK
GeorgiaGESlovinskoSI
NěmeckoDEŠpanělskoES
ŘeckoGRŠvédskoSE
MaďarskoHUŠvýcarskoCH
IslandISNizozemíNL
IrskoIEVelká BritánieGB
ItálieIT

Kódování znaků

Váš kanál MUSÍ být kódováno UTF-8Speciální znaky v textovém obsahu musí být správně escapovány:

ZnakbytostPoužívání
<&lt;Méně než
>&gt;Větší než
&&amp;ampersand
"&quot;Dvojité uvozovky (nutné pouze uvnitř atributu)
'&apos;Apostrof (potřebný pouze uvnitř atributu)

✅ Správné <en>Property with pool &amp; garden</en>

❌ Nesprávné <en>Property with pool & garden</en>

Testování vašeho feedu

Krok 1: Ověření struktury XML

Před odesláním ověřte svůj feed pomocí validátoru XML:

Krok 2: Zkontrolujte kódování znaků

Ověřte, zda je váš feed správně kódován v UTF-8:

Krok 3: Ověřte povinná pole

Každá nemovitost potřebuje tyto prvky:

  • <id> — Jedinečné ID nemovitosti
  • <price> — Cena nemovitosti
  • <price_freq> — Prodej nebo pronájem
  • <type> — Typ nemovitosti
  • <country> — Země
  • <town> — Město nebo obec
  • <desc><en> — Popis nemovitosti
💡 Jak se inzerát zveřejní Nové nabídky se vytvářejí v konceptu a publikují se automaticky, jakmile jsou jejich obrázky k dispozici v našem úložišti médií. Nabídka bez obrázků se publikuje okamžitě. Zpracování obrázků se obvykle dokončí do 24 hodin od první synchronizace a nabídka se stejně zveřejní po 48 hodinách.

Automatizace aktualizací

Jakmile je váš feed schválen, náš systém každou noc automaticky synchronizuje vaše vlastnosti.

Plán synchronizace

  • Feedy se zpracovávají automaticky každých 24 hodin
  • Zpracování začíná po 01:00 SEČ a pokračuje až do časného rána
  • Zpracování velkých zdrojů může trvat déle

Doporučené postupy

  • Vždy zahrnout VŠECHNY aktivní nemovitosti ve vašem feedu
  • Udržujte <id> nemovitosti stabilní po celou dobu její životnosti
  • Odeslat až do 20 obrázků na nemovitost; první je krytí
  • Odesílejte absolutní URL adresy obrázků, které zůstanou dosažitelné; obrázky se stáhnou pouze jednou
  • Zajistěte, aby adresa URL vašeho zdroje zůstala konzistentní a přístupná
  • Sledujte případné chyby ověřování hlášené naším týmem
⚠️ Nezapomeňte Nemovitosti, které nejsou ve vašem kanálu, jsou po třech po sobě jdoucích synchronizacích odstaveny do offline režimu a po opětovném zobrazení se ve kanálu automaticky obnoví. Při první chybějící synchronizaci se z vašeho účtu nic nesmaže, ale kanál, ve kterém několik dní chybí nabídky, je z webu odstraní.

Získání nápovědy

Pokud máte dotazy nebo narazíte na problémy s vaším XML feedem:

Při kontaktování podpory prosím uveďte:

  • URL adresa vašeho kanálu
  • Název vaší agentury na European Real Estate
  • Pár z <id> hodnoty zahrnuté
  • Popis problému
  • Veškeré přijaté chybové zprávy