NT skelbimų eksportas į svetainę ir portalus: kaip veikia TopBroker

Butą TopBroker sistemoje aprašote vieną kartą. Tą patį aprašymą nori gauti jūsų svetainė, projekto puslapis, partnerių agentūra, naujas NT portalas, o kartais ir dirbtinio intelekto (DI) paieškos įrankiai. Kiekvienas jų prašo savo formato.

Todėl sukūrėme universalų NT eksportą. Duomenis pateikiame viešai aprašytu „Open Property Feed“ formatu: JSON ir XML failuose rasite eksportui pažymėtus laisvus ir rezervuotus objektus bei visų naudojamų kodų paaiškinimus. Formato aprašymas: topbroker.lt/spec/v1.

Kas yra universalus NT eksportas ir kuo jis kitoks?

Tai kiekvienam gavėjui atskirai generuojamas failas su jūsų NT objektais, pateikiamas JSON ir XML formatais, kurių turinys vienodas. Failo pradžioje pateikiami jame naudojamų kodų paaiškinimai lietuvių ir anglų kalbomis, todėl gavėjui nereikia atskirai siųstis kodų sąrašo.

Pavyzdžiui, objekto skiltyje building įrašyta "heating": "district". Tame pačiame faile, skiltyje vocabulary, yra šio kodo paaiškinimas:

"building_heating": {
  "district": {
    "lt": "Centrinis kolektorinis",
    "en": "District",
    "def": "Municipal district heating delivered through a shared collector."
  }
}

Kodo reikšmę svetainės kūrėjas ar portalo programuotojas randa tame pačiame faile, o DI įrankis ją gauna kartu su duomenimis.

Kas	Kaip veikia
Formatai	JSON ir XML, turinys vienodas
Kodų paaiškinimai	Tame pačiame faile, lietuvių ir anglų kalbomis
Generavimas	Kas valandą, visas failas iš naujo
Parduoti ar išimti objektai	Naujame faile jų nebėra
Plotai	Visada kvadratiniais metrais
Paslėptas adresas	Gatvė, namo numeris ir koordinatės nepateikiami
Aprašymas	/spec/v1, JSON Schema, XSD, llms-full.txt

Formatas apima 15 kodų sąrašų: nuo objekto rūšies ir šildymo tipo iki 68 patogumų kodų.

Kaip agentūros svetainėje rodyti eksportuojamus NT skelbimus?

Svetainės kūrėjai vieną kartą sukuria duomenų importavimą pagal viešą formato aprašymą, o objektus toliau tvarkote tik TopBroker. Svetainė periodiškai parsisiunčia eksporto failą ir atnaujina savo objektų sąrašą.

Eksportas generuojamas kas valandą. Kaip greitai pakeitimas pasirodys svetainėje, priklauso ir nuo to, kaip dažnai svetainė failą parsisiunčia. Jei svetainė failą parsisiunčia kas valandą ir abu procesai veikia be sutrikimų, nauja kaina ar nuotrauka joje pasirodo maždaug per dvi valandas.

Objektas, kurio nebeliko naujame faile, turi dingti ir iš svetainės. Priežastis faile nenurodoma: objektas galėjo būti parduotas, išimtas iš prekybos ar išjungtas šiam eksportui.

Iš failo svetainė gauna:

• aprašymus keliomis kalbomis, jei juos turite sistemoje;
• nuotraukas, vaizdo įrašus ir 3D turus jūsų nustatyta tvarka;
• už objektą atsakingo brokerio kontaktus;
• tik rajono lygio vietą, jei tikslų objekto adresą slepiate.

Jei jūsų svetainė jau jungiasi prie TopBroker per API, jos keisti nebūtina. Universalus eksportas praverčia, kai svetainę kuria nauja studija arba kai tų pačių objektų reikia partnerių ar franšizės tinklo svetainėms: kiekviena gauna atskirą nuorodą. Ko dar reikia gerai NT svetainei, rašėme straipsnyje apie specializuotų NT puslapių kūrimą.

Ką NT vystytojas gali rodyti naujo projekto svetainėje?

Laisvus ir rezervuotus projekto butus. Projekto svetainei sukuriate atskirą eksportą ir pažymite, kuriuos butus į jį įtraukti. Nustatymuose galite įjungti ir tik to projekto objektus. Svetainė gauna failą, kuriame yra tik šie butai.

Būsena TopBroker	Eksporto faile	Ką rodo svetainė
Aktyvus	Yra, status: available	Laisvas
Rezervuotas	Yra, status: reserved	Rezervuotas
Parduotas	Nėra	Nerodomas
Archyvuotas	Nėra	Nerodomas

Kas ir iki kada butą rezervavo, į failą nepatenka.

Vien eksporto duomenų nepakaks visam projekto butų sąrašui, nes parduoti butai į failą nepatenka. Pirmoje formato versijoje taip pat nėra projekto, pastato ar laiptinės identifikatorių, o planuojamą statybų pabaigos datą svetainėje reikia pateikti atskirai.

Jei projekto butus parduoda ir partnerių agentūros, kiekviena gali gauti savo eksporto nuorodą su tais pačiais butais. Baigę bendradarbiauti su viena agentūra, išjungiate tik jos eksportą: nuoroda iškart nustoja veikti, o kitų partnerių tai nepaveikia.

Kaip NT vystytojui pasirinkti CRM sistemą, kuri valdo projektus ir rezervacijas, aprašėme atskirame gide.

Kaip NT portalas ar DI paieškos platforma gali priimti TopBroker skelbimus?

Portalo kūrėjai vieną kartą parengia duomenų importavimą pagal šį formatą. Gavęs eksporto failo nuorodą, portalas gali importuoti bet kurios TopBroker naudojančios agentūros skelbimus.

TopBroker šiandien palaiko eksportus į Aruodą, Domoplių, Kampą, Alio, Realu ir dar du portalus. Kiekvienas turi savo formatą, ir kiekvienam rašėme apie 400 eilučių atskiro kodo. Taip kūrėme ir eksportą į Realu.lt. Naujas nišinis ar užsienio portalas gali naudoti universalų NT eksportą: jo kūrėjai pritaiko duomenų importavimą pagal mūsų paskelbtą formato aprašymą.

Portalui dirbant su failu, užtenka keturių taisyklių:

1. Pagal gautą nuorodą parsisiųsti JSON arba XML failą, pavyzdžiui, kas valandą.
2. Objektus sutapatinti pagal id, o pakeitimus rasti pagal updated_at.
3. Objektą, kurio nebeliko naujame faile, pašalinti.
4. Jei failo gauti nepavyko, skelbimų nešalinti ir laukti kito sėkmingai gauto failo.

Už duomenų importavimą ir klaidų taisymą atsako portalo kūrėjai, o agentūra pasirenka eksportuojamus objektus. Failą galima automatiškai patikrinti pagal JSON Schema ar XSD, o DI platformoms visą formato aprašymą paruošėme vienu tekstiniu failu llms-full.txt.

Kokie duomenys į eksportą nepatenka?

Į failą gali patekti tik formato aprašyme išvardyti laukai. Savininko kontaktų, komisinių, vidinių pastabų, derybų istorijos, pirkėjų duomenų, apžiūrų ir užduočių laukai neeksportuojami.

Objekto kontaktiniuose duomenyse visada nurodomas brokeris. Objekto būsena system_status turi 4 reikšmes, bet faile gali būti tik dvi: active ir reserved. Parduoti ir archyvuoti objektai į failą nepatenka visai.

Jei tikslų adresą slepiate, pavadinimas ar aprašymas, kuriame minima gatvė, į failą nepatenka. Kitą aprašymų ir nuotraukų turinį sistema eksportuoja tokį, kokį įkėlėte, todėl aprašyme įrašytas savininko telefono numeris pateks ir į failą.

Išjungus eksportą, nuoroda nustoja veikti iš karto. Jau parsisiųstų failų kopijos lieka pas gavėją.

Kaip pradėti ir kiek tai kainuoja?

Eksportą susikuria TopBroker naudotojas, turintis prieigą prie nustatymų: skiltyje „Integracijos“ rasite „Universalus NT eksportas“. Pačioje TopBroker sistemoje už jį atskirai nemokate, nes visos funkcijos įskaičiuotos į bazinę kainą, kuri prasideda nuo 34 € per mėnesį vienam naudotojui (be PVM).

1. Sukurkite atskirą eksportą kiekvienam gavėjui: svetainei, projekto puslapiui, partneriui ar portalui.
2. Pažymėkite objektus, kuriuos norite įtraukti į šį eksportą. Jei eksportas skirtas vienam projektui, nustatymuose įjunkite tik jo objektus.
3. Nusiųskite gavėjui eksporto nuorodą ir formato aprašymą topbroker.lt/spec/v1.
4. Gavėjo programuotojai sukuria duomenų importavimą ir nustato, kaip dažnai failą parsisiųsti.

Dėl importavimo darbų ir jų kainos susitarkite su savo svetainės kūrėjais ar portalu.

Pradėkite nuo vieno gavėjo, dažniausiai savo svetainės, ir nusiųskite jos kūrėjams formato aprašymą.

---

Norite prijungti savo svetainę, projekto puslapį ar portalą prie TopBroker? Susisiekite su mumis, padėsime susikurti pirmąjį eksportą.