Ako realitka nahrá celý katalóg z CRM do Seeki
Naposledy revidované: 2026-04-14
Realitka môže nahrať celý katalóg z CRM do Seeki cez ingest API. V dashboarde si vygeneruje kľúč, pošle dávku ponúk v podporovanom formáte a každá ponuka sa spracuje a publikuje naprieč európskymi trhmi, ktoré obsluhujeme, bez písania vlastného kódu. Dashboard ukazuje priebeh každej položky, vypisuje prípadné chyby a umožňuje opakovať zlyhané riadky bez nahrávania celej dávky znova.
Tento článok je orientácia, ktorú by sme priali každému prevádzkovému riaditeľovi realitky, ktorý sa na Seeki pozerá prvýkrát. Prevedie vás celým importom, od „máme tisíce ponúk v CRM" po „sú živé na portáli vo všetkých jazykoch, ktoré obsluhujeme", a popíše, čo očakávať v každom kroku.
5 krokov onboardingu
- Získajte API kľúč. Prihláste sa do dashboardu realitky a v sekcii API kľúče vygenerujte kľúč. Kľúč je viazaný na vašu kanceláriu.
- Pripravte dáta. Namapujte export z CRM do podporovaného formátu. Prijímame Seeki-JSON (naše kanonické schéma), OpenImmo (európsky OASIS štandard hojne používaný v DACH CRM) a Idealista XML-ML (bežný v Španielsku a Portugalsku).
- Pošlite dávku. Pošlite súbor na ingest API. Veľmi rozsiahle katalógy sa posielajú po blokoch.
- Sledujte prehľad importov. Každá ponuka má vlastný riadok so živým stavom, dôvodom prípadnej chyby a tlačidlom na opakovanie.
- Ponuky sa publikujú. Akonáhle je ponuka spracovaná, je živá vo všetkých podporovaných jazykoch a vyhľadateľná na krajinských stránkach aj v AI vyhľadávači.
Väčšina práce je v kroku 2. Kroky 3 až 5 už bežia na strane Seeki.
Čo sa s ponukou deje po prijatí
Ponuka sa na portáli neobjaví v momente, keď váš POST vráti 200. Každá položka sa asynchrónne zvaliduje, doplní o odvodené dáta, oskóruje a publikuje. Väčšina ponúk je hotová počas sekúnd. Ak má ponuka opraviteľný problém (chýba povinné pole, URL fotografie nereaguje, adresu nemožno umiestniť na mapu), je v dashboarde označená ako zlyhaná s konkrétnym dôvodom a zvyšok dávky pokračuje ďalej.
Nepotrebujete vedieť, čo beží pod kapotou. Čo potrebujete vedieť, je, že dashboard presne ukazuje, kde každá ponuka je, a že oprava jedného zlého záznamu nevyžaduje nahrávanie celého feedu znova.
Ručné zadávanie, web import a API ingest
Tri spôsoby publikácie na Seeki, každý pre úplne iný rozsah.
| Prístup | Náročnosť nastavenia | Čas na jednu ponuku | Pre koho | Škáluje na |
|---|---|---|---|---|
| Ručné zadávanie | Žiadna, stačí sa prihlásiť | 10 až 20 minút | Pár prémiových ponúk, kancelárie testujúce platformu | Desiatky |
| Webový import (vložiť / nahrať) | Nízka, jednorazové mapovanie | Sekundy na ponuku | Stredne veľké kancelárie bez vývojára | Stovky až niekoľko tisíc |
| API ingest | Doobeda integračnej práce | Sub-sekundu na ponuku | Kancelárie s CRM, častými aktualizáciami, viackrajinským inventárom | Desaťtisíce |
Rozhodnutie je obvykle praktické: ak vaše CRM už exportuje OpenImmo alebo máte vývojára, ktorý vie vyrobiť Seeki-JSON, je API cesta najlacnejšia. Ak ste butiková kancelária s pár desiatkami prémiových ponúk, vystačíte si s ručným zadávaním.
Čo dashboard importov ukazuje
V dashboarde trávi prevádzkový pracovník realitky po prvom importe najviac času. Hore je súhrn každého importu (spolu položiek, úspešných, prebiehajúcich, neúspešných) a tabuľka pod tým presne hovorí, čo sa s každým záznamom deje. Vyfiltrujete si zlyhané, prejdete stĺpec dôvodu, opravíte dáta v CRM a stlačíte opakovať na dotknutých riadkoch. Nie je potrebné nahrávať celý feed znova kvôli niekoľkým zlým záznamom.
Keď sa ponuka publikuje, riadok odkazuje priamo na verejnú stránku, takže si overíte, ako vyzerá v cieľovom jazyku.
Spravujte importy tu hneď po vygenerovaní kľúča.
Predplatné a prístup
API ingest je platená funkcia pre realitky. Onboarding obsahuje krok s predplatným cez Stripe: vyberiete tarif, vyplníte platobné údaje alebo údaje na fakturáciu a váš API kľúč sa aktivuje. Predplatné sa fakturuje mesačne s možnosťou ročnej platby vopred. Ak predplatné vyprší, ingest sa pozastaví. Existujúce ponuky zostávajú publikované, ale nové importy sa odmietajú, kým nie je fakturácia v poriadku. Aktuálny tarif, využitie a prípadné upozornenia na obnovenie zobrazí dashboard na prehľadovej obrazovke.
Nad rámec predplatného sa neúčtuje poplatok za jednotlivú ponuku. Priepustnosť sa líši podľa tarifu. Ak potrebujete naozaj vysokú súbežnú priepustnosť, ozvite sa nám pred objednávkou, nech vám pomôžeme vybrať správny plán.
Časté otázky
Aký formát dát je podporovaný?
Tri formáty. Seeki-JSON je naše kanonické schéma, plochý a dobre zdokumentovaný JSON pokrývajúci všetky polia ponuky a URL fotografií. OpenImmo (európsky OASIS štandard hojne používaný v DACH CRM) sa prijíma ako XML alebo ako zip s XML aj súbormi fotografií. Idealista XML-ML sa prijíma od španielskych a portugalských kancelárií, ktorých CRM už týmto dialektom hovorí. Sekcia API kľúčov v dashboarde odkazuje na úplnú referenciu schémy a interaktívne ihrisko.
Ako sa riešia duplicity?
Ponuky sa identifikujú kombináciou vášho ID realitky a externého ID ponuky, teda identifikátora, ktorý už používa vaše CRM. Keď pošlete ponuku s rovnakým externým ID znova, Seeki ju považuje za aktualizáciu, nie za novú. Vďaka tomu rutinné obnovy katalógu (denné, hodinové, alebo kedykoľvek vaše CRM emituje zmenu) fungujú bez akejkoľvek logiky deduplikácie na vašej strane.
Môžem aktualizovať ponuky hromadne?
Áno. Ingest endpoint je rovnaký pre vytvorenie aj aktualizáciu. Opätovné odoslanie ponuky so zmenenými poľami aktualizuje živý záznam. Ak chcete aktualizovať iba podmnožinu, pošlite iba tie ponuky. Seeki sa nedotkne ponúk, ktoré v dávke nie sú. Ponuku odstránite tým, že ju v CRM označíte ako neaktívnu a pošlete so stavom predané alebo stiahnuté. Bude archivovaná z vyhľadávania.
Čo realitky mimo EÚ s európskym inventárom?
API nekontroluje, kde má vaša realitka sídlo. Kontroluje, či je krajina ponuky jedným z európskych trhov, ktoré Seeki obsluhuje. Kancelária v Londýne alebo New Yorku, ktorá drží španielsky alebo český inventár, používa rovnaký ingest endpoint. Daňová a zmluvná štruktúra na vašej strane je vaša zodpovednosť. Zmluva so Seeki je za inzertnú službu.
Ako rýchlo sa nové ponuky objavia?
Ponuka je obvykle hotová počas sekúnd. Celkový čas od vášho POST po verejne vyhľadateľnú ponuku závisí od veľkosti dávky a aktuálneho zaťaženia, ale malé dávky sa obvykle publikujú s časom pod minútu na ponuku. Preklady do ďalších jazykov sa generujú pri prvom zobrazení. Ponuka je teda plne vyhľadateľná v zdrojovom jazyku ihneď a v preloženej podobe sa objaví, len čo ju niekto prvýkrát otvorí v inej lokalizácii.
Čo ak ponuka neprejde validáciou?
Je v dashboarde označená ako zlyhaná s konkrétnym dôvodom: chýbajúce povinné pole, nedostupná URL fotografie, cena pod hranicou vierohodnosti a podobne. Zvyšok dávky pokračuje. Opravte dáta v CRM, znova exportujte a buď pošlite celú dávku, alebo zopakujte zlyhané riadky z dashboardu. Za opakovanie nie je žiadny postih a deduplikácia podľa externého ID bráni náhodným duplicitám.
Ďalšie kroky
Ak je vaša kancelária pripravená, cesta je krátka: vygenerujte kľúč, pošlite malú testovaciu dávku z exportu CRM, sledujte ju v dashboarde a potom zapnite plný feed. Zámerne držíme najmenšiu možnú vzdialenosť medzi „mám CSV" a „ponuky sú živé po celej Európe". Prevádzkovú zložitosť má absorbovať platforma, nie ju vracať späť vám.
Keď budete pripravení, stránka onboardingu vás prevedie generovaním kľúča, platbou aj prvým importom v jednom toku.