Ako realitka nahrá katalóg z CRM do Seeki.eu

Naposledy revidované: 2026-08-11

Vaše CRM už drží každú nehnuteľnosť, ktorú kancelária spravuje, aj s fotografiami, cenami a popismi. Dostať ten katalóg na ďalší portál obvykle znamená, že prevádzkový pracovník ho prepisuje ponuku po ponuke, alebo že vývojár háda špecifikáciu feedu, ktorú nikto nespísal. Takto vyzerá cesta na Seeki.eu v skutočnosti, od exportu z CRM po ponuky, ktoré nájdu kupujúci po celej Európe.

Čo musí realitka pre onboarding naozaj urobiť?

Päť krokov a skutočnú prácu si vyžiada len jeden z nich.

1. Najprv spustite predplatné. API kľúč sa vydáva proti aktívnemu predplatnému: dashboard kľúč nevygeneruje skôr, než ho máte, a importné API odmietne kľúč, ktorého predplatné medzitým vypršalo. Plán je jediný, takže niet čo dimenzovať ani vyjednávať. Čo obsahuje, popisuje stránka pre realitky.
2. Vygenerujte API kľúč. Dashboard zobrazí celý kľúč práve raz pri vytvorení a uchová si už len jeho hash, takže ho pred zatvorením dialógu uložte do svojho trezoru na tajomstvá. Kľúče sa dajú neskôr z tej istej obrazovky vymeniť alebo zrušiť.
3. Namapujte export z CRM do podporovaného formátu. Prijímame tri: schému Seeki.eu JSON, zdokumentovanú pole po poli, OpenImmo ako čisté XML alebo ako zip, ktorý spája XML so súbormi fotografií, a Idealista XML-ML. Ak váš systém už jeden z nich vydáva, je tento krok väčšinou len konfigurácia.
4. Pošlite katalóg na importné API na adrese ingest.seeki.eu. Rozsiahle katalógy idú ako séria dávok, nie ako jeden obrovský súbor.
5. Sledujte obrazovku importov. Každá ponuka dostane vlastný riadok s aktuálnym stavom, dôvodom prípadnej chyby a opakovaním, ktoré nepotrebuje poslať celý feed znova.

Úsilie leží v kroku 3. Kroky 4 a 5 bežia na našej strane.

Čo sa s ponukou deje po prijatí?

Ponuka sa na portáli neobjaví v okamihu, keď vaša požiadavka dobehne. Každá položka sa spracúva samostatne a asynchrónne: zvaliduje sa, jej adresa sa preloží na bod na mape, vypočítajú sa odvodené polia, zapíše sa do katalógu a oskóruje sa. Problém v ktorejkoľvek z týchto fáz označí práve tú jednu položku ako zlyhanú s konkrétnym dôvodom a zvyšok dávky nechá bežať ďalej.

V praxi sa chyby zhlukujú na dvoch miestach. Prvým je chýbajúce povinné pole, ktoré zachytí schéma ešte pred čímkoľvek iným. Druhým je poloha: adresa, ktorú sa nedá preložiť na bod, alebo súradnice, ktoré padnú mimo krajiny samotnej ponuky. Oboje sú dátové problémy na vstupe, oboje sa v dashboarde samy pomenujú a oboje sa dajú opraviť v CRM a zopakovať bez opätovného posielania feedu.

Každá ponuka, ktorá dorazí, dostane aj známku ponuky a skóre lokality, teda dva signály, podľa ktorých kupujúci vedia filtrovať a triediť. Čo tie dve čísla merajú stojí prevádzkovému pracovníkovi za desať minút, pretože známka reaguje priamo na kvalitu vášho exportu: koľko polí vyplníte, koľko fotografií pošlete a aký obsažný je popis, to všetko ňou hýbe.

Ako dlho zostane importovaná ponuka živá?

Šesťdesiat dní od posledného úspešného importu. Denná úloha stiahne všetko za touto hranicou a dashboard ponuky, ktorým platnosť vyprší v nasledujúcom týždni, označí ešte predtým, než sa to stane.

Práve toto jediné pravidlo formuje integráciu viac než čokoľvek iné na tejto stránke. Opätovné odoslanie ponuky obnoví jej životnosť aj vtedy, keď sa na nej nič nezmenilo, takže vzor, ktorý treba postaviť, je nočná resynchronizácia aktívneho inventára, nie jednorazové hromadné nahranie. Realitka, ktorá naimportuje raz a nikdy viac, sleduje, ako sa jej katalóg po dvoch mesiacoch potichu vyprázdni.

Dáva vám to aj druhý, mäkší spôsob, ako nehnuteľnosť stiahnuť: prestaňte ju zahŕňať do resynchronizácie a vyprší sama.

Ručné zadávanie alebo import cez API: čo sedí vašej kancelárii?

Dve reálne cesty na platformu, každá pre úplne iný rozsah.

Prístup	Náročnosť nastavenia	Pre koho	Škáluje na
Ručné zadávanie v dashboarde	Žiadna. Prihlásite sa a začnete písať.	Pár prémiových nehnuteľností alebo kancelária, ktorá platformu skúša skôr, než čokoľvek zapojí	Desiatky
Import feedom alebo cez API	Doobeda integračnej práce, menej, ak vaše CRM už vydáva OpenImmo alebo Idealista XML	Kancelária s CRM, s častými zmenami cien a stavov alebo s inventárom vo viacerých krajinách	Tisíce, posielané v dávkach

Voľba je obvykle praktická. Ak váš systém už exportuje OpenImmo alebo máte vývojára, ktorý vie vyrobiť náš JSON, je API najlacnejšie miesto na pristátie a jediné, ktoré prežije nočnú obnovu. Butiková kancelária s tuctom prémiových nehnuteľností na tom bude lepšie, keď ich zadá ručne a ušetrené doobedie venuje fotografiám, ktoré so záujmom kupujúcich hýbu viac než potrubie pod kapotou.

Čo obrazovka importov naozaj ukazuje?

Prehľadová obrazovka nesie čísla, podľa ktorých prevádzka riadi deň: živé ponuky, importy stále v behu, zlyhané importy a ponuky, ktorým platnosť vyprší v priebehu týždňa. Pod ňou obrazovka importov vypisuje každú položku s externým ID, ktoré používa vaše CRM, jej stav, chybový kód a zrozumiteľnú správu, keď sa niečo pokazilo, s možnosťou vyfiltrovať len zlyhania.

Keď riadok otvoríte, dostanete vedľa chyby aj dáta, ktoré sme prijali, čo obvykle stačí na odlíšenie dátového problému v CRM od problému s mapovaním v exporte. Zlyhané riadky nesú opakovanie, ktoré zaradí do fronty práve tú jednu položku. Nie je potrebné nahrávať celý feed znova kvôli niekoľkým zlým záznamom.

Prečo dávať domáci katalóg na celoeurópsky portál?

Pretože váš kupujúci nemusí bývať vo vašej krajine ani hľadať vo vašom jazyku. Katalóg, ktorý existuje len na národnom portáli, dosiahne na ľudí, ktorí už hľadajú tam a v tom jazyku, a tým končí. Seeki.eu je jeden portál pre celý kontinent: názov a popis ponuky sa čítajú v jazyku, v ktorom návštevník prezerá, cena sa zobrazí v mene, ktorú si vyberie, a ponuka sedí v tom istom výsledku ako bývanie na druhej strane hranice pre každého, kto trhy porovnáva.

Dosah siaha aj za samotný web. Kupujúci, ktorí hľadajú cez AI asistenta, sa ku katalógu dostanú priamo z ChatGPT aj Claude, bez účtu a bez akéhokoľvek nastavovania na vašej strane. Ak zvažujete, kde má inventár kancelárie sedieť, náš prehľad hlavných realitných webov v Európe rozoberá, v čom je ktorý typ portálu naozaj dobrý.

Čo predplatné pokrýva?

Jeden plán: 99 € mesačne alebo 990 € ročne, čo vyjde o dva mesiace lacnejšie. Neobmedzený počet ponúk, zrušenie kedykoľvek. Nad rámec toho niet poplatku za ponuku, niet balíka kreditov na dokúpenie a niet tarifu priepustnosti, ktorý by ste museli pred štartom vyjednávať.

Jeden dôsledok sa oplatí vedieť pred objednávkou, nie po nej. Ak sa predplatné zruší alebo pozastaví, zverejnené ponuky danej kancelárie idú dole s ním a reaktivácia ich vráti späť. Iba oneskorená faktúra toto nespôsobí: kým je platba po splatnosti, importy fungujú ďalej a ponuky zostávajú hore. Stav fakturácie, koniec aktuálneho obdobia aj faktúry žijú na fakturačnej obrazovke v dashboarde a rieši ich zákaznícky portál Stripe.

Časté otázky

Aké formáty feedu môžem posielať?

Tri. Schéma Seeki.eu JSON je naša: plochý zdokumentovaný tvar pokrývajúci polia ponuky a URL fotografií. OpenImmo, štandard XML, ktorý väčšina nemecky hovoriacich systémov exportuje, sa prijíma buď ako čisté XML, alebo ako zip spájajúci XML so súbormi fotografií. Idealista XML-ML sa prijíma od španielskych a portugalských systémov, ktorých export ním už hovorí. Referencia API nesie úplný zoznam polí.

Ako sa riešia duplicity?

Ponuka sa identifikuje kombináciou vašej kancelárie a externého ID, ktoré pre ňu už používa vaše CRM. Opätovné poslanie toho istého externého ID aktualizuje existujúci záznam namiesto vytvorenia druhého a zároveň obnoví jeho 60-dňovú životnosť. Práve to robí nočnú úplnú resynchronizáciu bezpečnou: nepotrebujete vlastnú logiku deduplikácie a opätovné poslanie nezmenenej ponuky vás nič nestojí.

Môžem aktualizovať ponuky hromadne?

Áno, a niet čo volať zvlášť. Vytvorenie a aktualizácia sú tá istá operácia: pošlite ponuku so zmenenými poľami znova a živý záznam sa obnoví. Pošlite len tú podmnožinu, ktorá sa zmenila, a ponuky, ktoré v dávke nie sú, zostanú nedotknuté, s jednou výhradou, ktorú stojí za to zopakovať: ponuke, ktorú prestanete posielať, sa prestane obnovovať aj jej 60-dňová životnosť.

Ako ponuku stiahnem?

Dvoma spôsobmi a ani jeden z nich nie je príznak stavu vo feede. Buď ju pozastavíte na obrazovke ponúk v dashboarde realitky, čím zmizne z vyhľadávania a rovnako ľahko sa dá vrátiť, alebo ju prestanete zahŕňať do resynchronizácie a necháte jej 60-dňovú životnosť vypršať. Ak sa nehnuteľnosť predala a chcete stránku preč ešte dnes, pozastavte ju.

Môže realitka mimo EÚ importovať európsky inventár?

Áno. Kde má vaša kancelária sídlo, sa nekontroluje. Podstatné je, aby nehnuteľnosť ležala v jednom z európskych trhov, ktoré pokrývame, a aby sa jej adresa dala preložiť na bod vnútri jej vlastnej krajiny. Kancelária v Londýne alebo New Yorku, ktorá drží španielsky alebo český inventár, používa presne tú istú integráciu. Vaša daňová a zmluvná štruktúra zostáva vašou zodpovednosťou, naša zmluva je za inzertnú službu.

Ako rýchlo ide importovaná ponuka do živého?

Každá položka sa vyzdvihne samostatne hneď po príchode a nečaká na nočné prestavanie, takže ponuka býva vyhľadateľná krátko po prijatí dávky. Jej názov a popis sa prekladajú na vyžiadanie pre kupujúcich prezerajúcich v inom jazyku, čo znamená, že je od začiatku nájditeľná vo svojom zdrojovom jazyku a v jazyku návštevníka sa prečíta v okamihu, keď ju otvorí.

Čo sa stane s mojimi ponukami, keď zruším predplatné?

Stiahnu sa spolu s ním a vrátia sa, ak predplatné znova aktivujete. S oneskorenou platbou sa zaobchádza inak: kým je faktúra po splatnosti, importy fungujú ďalej a zverejnené ponuky zostávajú hore. Pri ukončení predplatného sa nič nemaže, takže reaktivácia katalóg obnoví namiesto toho, aby ste ho museli importovať znova.

Ďalšie kroky

Ak je vaša kancelária pripravená, cesta je krátka: spustite predplatné, vygenerujte kľúč, pošlite malú testovaciu dávku zo skutočného exportu CRM, sledujte ju v dashboarde a potom zapnite nočný feed. Zámerne držíme vzdialenosť medzi „mám export" a „ponuky sú živé po celej Európe" tak krátku, ako sa len dá, a prevádzkovú zložitosť má absorbovať platforma, nie ju vracať späť vám.

Stránka pre realitky popisuje, čo predplatné obsahuje, a referencia API pokrýva zoznam polí, chybové kódy a interaktívnu konzolu, ktorú bude chcieť mať váš vývojár prvé ráno otvorenú.