Jak realitka nahraje katalog z CRM do Seeki.eu

Naposledy revidováno: 2026-08-11

Vaše CRM už drží každou nemovitost, kterou kancelář spravuje, i s fotkami, cenami a popisy. Dostat tenhle katalog na jiný portál obvykle znamená, že ho provozní kolega přepisuje nabídku po nabídce, nebo že vývojář hádá specifikaci feedu, kterou nikdo nesepsal. Takhle vypadá cesta na Seeki.eu doopravdy, od exportu z CRM po nabídky, které najdou kupující po celé Evropě.

Co musí realitka pro onboarding skutečně udělat?

Pět kroků a jen jeden z nich stojí opravdovou práci.

1. Nejdřív spusťte předplatné. API klíč se vydává proti aktivnímu předplatnému: dashboard klíč nevytvoří dřív, než ho máte, a importní API odmítne klíč, jehož předplatné mezitím vypršelo. Tarif je jediný, takže není co dimenzovat ani vyjednávat. Co obsahuje, popisuje stránka pro realitky.
2. Vygenerujte API klíč. Dashboard ukáže celý klíč přesně jednou při vytvoření a uchová z něj jen hash, takže si ho uložte do trezoru na hesla dřív, než dialog zavřete. Klíče lze později ze stejné obrazovky rotovat nebo zneplatnit.
3. Namapujte export z CRM do podporovaného formátu. Přijímáme tři: JSON schéma Seeki.eu, zdokumentované pole po poli; OpenImmo, jako prosté XML nebo jako zip, který balí XML spolu se soubory fotografií; a Idealista XML-ML. Pokud váš systém už jeden z nich vydává, jde v tomto kroku hlavně o konfiguraci.
4. Pošlete katalog na importní API na ingest.seeki.eu. Rozsáhlé katalogy jdou jako série dávek, nikoli jako jeden obří soubor.
5. Sledujte obrazovku importů. Každá nabídka má vlastní řádek s aktuálním stavem, důvodem případné chyby a opakováním, které nevyžaduje poslat celý feed znovu.

Práce leží v kroku 3. Kroky 4 a 5 běží na naší straně.

Co se s nabídkou děje po přijetí?

Nabídka se na portálu neobjeví v okamžiku, kdy váš požadavek doběhne. Každá položka se zpracovává zvlášť a asynchronně: zvaliduje se, její adresa se převede na bod na mapě, spočítají se odvozená pole, zapíše se do katalogu a oskóruje se. Problém v kterékoli z těch fází označí tuto jedinou položku jako selhanou s konkrétním důvodem a zbytek dávky nechá běžet dál.

V praxi se chyby shlukují na dvou místech. První je chybějící povinné pole, které zachytí schéma dřív, než se stane cokoli dalšího. Druhým je poloha: adresa, kterou nelze převést na bod, nebo souřadnice, které padnou mimo zemi dané nabídky. Obojí je datový problém na vstupu, obojí se v dashboardu samo pojmenuje a obojí lze opravit v CRM a zopakovat bez odeslání celého feedu.

Každá nabídka, která dorazí, dostane také hodnocení nabídky a skóre lokality, tedy dva signály, podle kterých kupující filtrují a řadí. Co tato dvě čísla měří stojí provoznímu manažerovi za deset minut, protože hodnocení reaguje přímo na kvalitu vašeho exportu: kolik polí vyplníte, kolik fotek pošlete i jak obsažný je popis, tím vším se hýbe.

Jak dlouho zůstane importovaná nabídka živá?

Šedesát dní od posledního úspěšného importu. Denní úloha odpublikuje vše, co je za touto hranicí, a dashboard označí nabídky, kterým do týdne vyprší platnost, ještě než se to stane.

Právě tohle jedno pravidlo formuje integraci víc než cokoli jiného na této stránce. Opětovné odeslání nabídky obnoví její život i tehdy, když se na ní nic nezměnilo, takže vzorec, který se má postavit, je noční resync aktivního inventáře, nikoli jednorázový hromadný upload. Kancelář, která naimportuje jednou a už nikdy, sleduje, jak jí katalog po dvou měsících tiše vyteče.

Dává vám to i druhou, měkčí cestu, jak nemovitost stáhnout: přestaňte ji zahrnovat do resyncu a vyprší sama.

Ruční zadávání, nebo API import: co sedí vaší kanceláři?

Dvě reálné cesty na platformu, každá pro úplně jiný rozsah.

Přístup	Náročnost nastavení	Pro koho	Škáluje na
Ruční zadávání v dashboardu	Žádná. Přihlaste se a začněte psát.	Pár prémiových nemovitostí nebo kancelář, která platformu zkouší, než něco propojí	Desítky
Feed nebo API import	Dopoledne integrační práce, méně, pokud vaše CRM už vydává OpenImmo nebo Idealista XML	Kancelář s CRM, častými změnami cen a stavů nebo inventářem ve více zemích	Tisíce, posílané po dávkách

Rozhodnutí je obvykle praktické. Pokud váš systém už exportuje OpenImmo nebo máte vývojáře, který umí vyrobit náš JSON, je API nejlevnější místo k přistání a jediné, které přežije noční obnovu. Butiková kancelář s tuctem prémiových nemovitostí je na tom líp, když je zadá ručně a ušetřené dopoledne věnuje fotografiím, které pohnou zájmem kupujících víc než potrubí.

Co přehled importů vlastně ukazuje?

Přehledová obrazovka nese čísla, podle kterých provozní pracovník řídí den: živé nabídky, importy stále v běhu, importy, které selhaly, a nabídky, kterým do týdne vyprší platnost. Pod ní obrazovka importů vypisuje každou položku s externím ID, které používá vaše CRM, jejím stavem, chybovým kódem a srozumitelnou zprávou, když se něco pokazilo, s filtrem, kterým si vytáhnete jen chyby.

Když řádek otevřete, uvidíte vedle chyby i data, která jsme přijali, což obvykle stačí k odlišení datového problému v CRM od problému s mapováním v exportu. Selhané řádky nesou opakování, které zařadí do fronty jedinou položku. Není potřeba nahrávat celý feed znovu kvůli několika špatným záznamům.

Proč dávat domácí katalog na celoevropský portál?

Protože váš kupující nemusí bydlet ve vaší zemi ani hledat ve vašem jazyce. Katalog, který existuje jen na národním portálu, dosáhne na lidi, kteří už tam v daném jazyce hledají, a tím končí. Seeki.eu je jeden portál pro celý kontinent: titul a popis nabídky se čtou v jazyce, ve kterém návštěvník prochází web, cena se zobrazí v měně, kterou si zvolí, a nabídka sedí ve stejné sadě výsledků jako bydlení za hranicí pro každého, kdo trhy porovnává.

Dosah nekončí u webu. Kupující, kteří hledají přes AI asistenta, se ke katalogu dostanou přímo z ChatGPT i z Claude, bez účtu a bez jakéhokoli nastavení na vaší straně. Pokud vážíte, kde má inventář kanceláře ležet, náš přehled hlavních realitních webů v Evropě rozebírá, v čem je který typ portálu opravdu dobrý.

Co předplatné pokrývá?

Jeden tarif: 99 € měsíčně, nebo 990 € ročně, což vychází o dva měsíce levněji. Neomezený počet nabídek, výpověď kdykoli. Nad rámec toho se neúčtuje poplatek za nabídku, není co dokupovat v kreditech a není žádná propustnostní hladina, kterou byste museli vyjednat, než začnete.

Jeden důsledek stojí za to znát před objednávkou, ne až po ní. Když se předplatné zruší nebo pozastaví, publikované nabídky té kanceláře jdou dolů spolu s ním a reaktivace je vrátí zpět. Pouhá opožděná platba tohle nedělá: dokud je faktura po splatnosti, importy fungují dál a nabídky zůstávají nahoře. Stav fakturace, konec aktuálního období i faktury najdete na fakturační obrazovce dashboardu, obsluhované přes zákaznický portál Stripe.

Časté dotazy

Jaké formáty feedu mohu poslat?

Tři. JSON schéma Seeki.eu je naše: plochý zdokumentovaný tvar pokrývající pole nabídky a URL fotografií. OpenImmo, XML standard, který exportuje většina německojazyčných systémů, se přijímá buď jako prosté XML, nebo jako zip balící XML se soubory fotografií. Idealista XML-ML se přijímá od španělských a portugalských systémů, jejichž export už jím mluví. Referenční dokumentace API obsahuje úplný seznam polí.

Jak se řeší duplicity?

Nabídka se identifikuje vaší kanceláří a externím ID, které pro ni už používá vaše CRM. Opětovné odeslání téhož externího ID aktualizuje existující záznam místo vytvoření druhého a zároveň obnoví jeho šedesátidenní život. Právě proto je noční plný resync bezpečný: nepotřebujete žádnou vlastní deduplikační logiku a odeslání nezměněné nabídky vás nic nestojí.

Mohu aktualizovat nabídky hromadně?

Ano a není k tomu co zvlášť volat. Vytvoření a aktualizace jsou tatáž operace: pošlete nabídku se změněnými poli znovu a živý záznam se obnoví. Pošlete jen tu podmnožinu, která se změnila, a nabídky, které v dávce nejsou, zůstanou nedotčené, s jednou výhradou, kterou stojí za to zopakovat: nabídce, kterou přestanete posílat, se také přestane obnovovat šedesátidenní život.

Jak nabídku stáhnu?

Dvěma způsoby a ani jeden není stavový příznak ve feedu. Pozastavte ji na obrazovce nabídek v dashboardu kanceláře, což ji vyřadí z vyhledávání a stejně snadno se to vrátí zpět; nebo ji přestaňte zahrnovat do resyncu a nechte její šedesátidenní život doběhnout. Pokud se nemovitost prodala a chcete stránku pryč ještě dnes, pozastavte ji.

Může realitka mimo EU importovat evropský inventář?

Ano. Kde má kancelář sídlo, se nekontroluje. Záleží na tom, aby nemovitost ležela v jednom z evropských trhů, které pokrýváme, a aby se její adresa převedla na bod uvnitř vlastní země. Kancelář v Londýně nebo New Yorku, která drží španělský nebo český inventář, používá přesně stejnou integraci. Vaše daňová a smluvní struktura zůstává vaší odpovědností; naše smlouva je za inzertní službu.

Jak rychle jde importovaná nabídka živě?

Každá položka se zpracuje samostatně hned po doručení, místo aby čekala na noční přestavbu, takže je nabídka obvykle vyhledatelná krátce po přijetí dávky. Její titul a popis se překládají na vyžádání pro kupující, kteří web prochází v jiném jazyce, což znamená, že je od začátku dohledatelná ve zdrojovém jazyce a čte se v jazyce návštěvníka ve chvíli, kdy ji otevře.

Co se stane s nabídkami, když předplatné zruším?

Odpublikují se spolu s ním a vrátí se, pokud předplatné reaktivujete. S opožděnou platbou se zachází jinak: dokud je faktura po splatnosti, importy fungují dál a publikované nabídky zůstávají nahoře. Při ukončení předplatného se nic nemaže, takže reaktivace katalog obnoví, místo aby vás nutila importovat znovu.

Další kroky

Pokud je vaše kancelář připravená, cesta je krátká: spusťte předplatné, vygenerujte klíč, pošlete malou testovací dávku z reálného exportu CRM, sledujte ji v dashboardu a pak zapněte noční feed. Záměrně držíme vzdálenost mezi „mám export" a „nabídky jsou živé po celé Evropě" tak krátkou, jak to jde, a provozní složitost má absorbovat platforma, ne ji vracet zpátky vám.

Stránka pro realitky popisuje, co předplatné obsahuje, a referenční dokumentace API pokrývá seznam polí, chybové kódy i interaktivní konzoli, kterou bude váš vývojář první ráno chtít mít otevřenou.