Domoplius importas V1

Greita pradžia

Paruoškite UTF-8 XML dokumentą su domoplius, announcements ir kategorijų grupėmis. Naujame šaltinyje pasirinkite V1.

1. 1Pradėkite nuo V1 XML šablono ir pasirinkite kategorijų grupę: flats, commercials, garages, sites, buildings, fp_flats, fp_buildings, fp_cottages, fp_commercials, fp_sites.
2. 2Kiekvienam skelbimui skirkite nekintantį external_id arba id; toje pačioje kategorijoje jo nekartokite.
3. 3Paskelbkite XML viešu URL ir perduokite nuorodą bei skelbimų savininko paskyrą Domoplius kontaktui.

Pavyzdžiai naudoja esamus Domoplius placereg_* skaitinius ID. Patikrinkite ID reikšmes ir jų hierarchiją.

<?xml version="1.0" encoding="UTF-8"?>
<domoplius>
  <!--Replace location and option IDs using the versioned endpoints, and supply public image URLs.-->
  <announcements>
    <flats>
      <external_id>100001</external_id>
      <action_type>1</action_type>
      <sell_price>145000</sell_price>
      <fk_placereg_adm_units_id>461</fk_placereg_adm_units_id>
      <fk_placereg_settlements_id>1</fk_placereg_settlements_id>
      <flat_size>50.5</flat_size>
      <flat_rooms>1</flat_rooms>
    </flats>
  </announcements>
</domoplius>

Importo eiga

V1 XML srautas saugiai atsisiunčiamas, patikrinamas ir apdorojamas po vieną įrašą. Srauto patikimumas lemia, ar galima suderinti trūkstamus skelbimus.

1. 1. Atsisiuntimas

   Importuotojas atsisiunčia viešą XML, laikydamasis dydžio, laiko ir nukreipimų ribų.

2. 2. Pirminė patikra

   Tikrinama announcements struktūra, unikalios kategorijos ir ID tapatybės, tuščias srautas, DTD bei išorinės esybės.

3. 3. Srautinis apdorojimas

   Senieji laukai ir alias normalizuojami, tada tikrinami pagal kategoriją.

4. 4. Įrašymas

   Galiojantys įrašai sukuriami arba dalinai atnaujinami; klaidos pateikiamos ataskaitoje.

5. 5. Suderinimas

   Trūkstami skelbimai vertinami tik patikimai užbaigus visus įjungtus savininko Laravel šaltinius.

6. 6. Ataskaita

   Prieš įjungiant šaltinį peržiūrimi rezultatai, įspėjimai ir atmesti įrašai.

V1 XML reikalavimai

V1 išlaiko seno importuotojo struktūrą ir tolerantišką laukų apdorojimą.

Kainų atnaujinimas

Nepateiktos kainų sumos išlaiko tos kainos valiutų reikšmes. Aiškiai tuščia bendrojo arba _eur lauko suma kartu išvalo EUR, LTL, USD ir valiutos ID. Teigiamas alias turi pirmenybę prieš tuščią ir perskaičiuoja visas valiutas; prieštaringi teigiami alias atmeta skelbimą. Privalomos pagrindinės arba dienos kainos išvalyti negalima.

V1 apimtis ir viešas įrankis

V1 apima dešimt Lietuvos ir užsienio kategorijų. Viešas įrankis tikrina pasirengimą konvertuoti į V2. Tikras importas papildomai tikrina savininką, planą, esamus skelbimus, atsisiuntimus ir suderinimą.

Tapatybė, veiksmas ir kainos

Pateikite external_id arba id. action_type numatytoji reikšmė yra 1. Veiksmams 1 ir 3 būtina sell_price arba sell_price_eur. Veiksmui 9 būtina short_rent_price_day arba short_rent_price_day_eur; bendra kaina neprivaloma.

Senųjų valiutų interpretacija

Atpažintos LTL kainos konvertuojamos į EUR. USD pažymėtos bendros kainos išlaiko senojo importuotojo naudotą efektyvią EUR sumą; keitiklis pateikia diagnostiką. Nežinomi valiutų ID blokuoja konvertavimą.

Ypatybių numeriai ir antraštės

V1 ypatybių parinktys grąžina senuosius nr nuo 1 iki 85; V2 grąžina duomenų bazės ID. Pateiktos V1 antraštės ignoruojamos ir pažymimos ataskaitoje; antraštės generuojamos iš skelbimo duomenų.

Adresų išvalymas ir alternatyvūs laukai

Nepateikti neprivalomi gatvės ir mikrorajono laukai paliekami. Aiškiai pateiktas nulis arba tuščia reikšmė juos išvalo. Nesutampantys alternatyvūs laukai atmeta skelbimą. site_size su site_measure arba site_measures palaiko arus, hektarus ir kvadratinius metrus; priimami įdėtiniai window_direction sąrašai.

XML struktūra

Naudokite <domoplius><announcements><flats>…</flats></announcements></domoplius> be vardų srities. Kategorijos: flats, commercials, garages, sites, buildings, fp_flats, fp_buildings, fp_cottages, fp_commercials, fp_sites.

Tik XML

V1 nepalaiko JSON. JSON srautams naudokite V2 kontraktą.

Saugumas

DTD, DOCTYPE ir išorinės XML esybės draudžiamos. XML skaitomas srautiniu būdu ir jam taikomos dydžio, įrašų bei laiko ribos.

Suderinamumas

Palaikomi seno importo alias, kainų ir valiutų normalizavimas, skaitiniai parinkčių ID, features/add_features ir photos. Nežinomi laukai registruojami kaip įspėjimai.

Kaip atnaujinami skelbimai

V1 naudoja dalinius atnaujinimus. Skelbimą identifikuoja savininkas, kategorija ir external_id arba id.

Nepateiktas laukas

Esama reikšmė paliekama nepakeista.

Pateiktas tuščias laukas

Laukas aiškiai išvalomas, jei konkretaus lauko taisyklės tai leidžia.

Ypatumai ir nuotraukos

Nepateiktos kolekcijos paliekamos, o pateiktos kolekcijos pakeičia esamą importuotą rinkinį.

Trūkstami skelbimai

Suderinami tik patikimai užbaigus visus įjungtus to savininko Laravel šaltinius.

Validacija ir klaidos

Netinkamas V1 įrašas gali būti praleistas, tačiau pasikartojanti tapatybė, tuščias srautas ar struktūros klaida atmeta visą XML ir sustabdo suderinimą.

Esami Domoplius adresai

Užsienio kategorijoms privalomi esami country_id ir city_id iš /api/v1/imports/locations/countries bei /api/v1/imports/locations/cities?country_id=3397. Miestas turi priklausyti šaliai; importas vietovių nekuria. V1 nekeičia adresų sistemos. Naudokite fk_placereg_adm_units_id, fk_placereg_settlements_id, fk_placereg_microdistricts_id ir fk_placereg_streets_id. Taip pat priimami formos alias: address_1 yra savivaldybės ID, address_2 – 2_<gyvenvietės ID> arba 3_<mikrorajono ID>, address_3 – gatvės ID. V1 užsienio objekto vietai palaikomi country_id ir city_id bei wgs_lat/wgs_long koordinatės. Senieji žemyno, gatvės, mikrorajono ir redaguojamos vietos laukai į šį kontraktą neįtraukti. Savininko fk_place_* laukai nenurodo objekto vietos.

1. 1. Administracinis vienetas

   Naudokite esamą skaitinį savivaldybės ID.

   /api/v1/imports/locations/administrative-unitsKopijuoti

   GET /api/v1/imports/locations/administrative-units

2. 2. Gyvenvietė

   Filtruokite pagal administrative_unit_id.

   /api/v1/imports/locations/settlements?administrative_unit_id=461Kopijuoti

   GET /api/v1/imports/locations/settlements?administrative_unit_id=461

3. 3. Mikrorajonas

   Jei taikoma, filtruokite pagal settlement_id.

   /api/v1/imports/locations/microdistricts?settlement_id=1Kopijuoti

   GET /api/v1/imports/locations/microdistricts?settlement_id=1

4. 4. Gatvė

   Gatvė turi priklausyti tai pačiai gyvenvietei.

   /api/v1/imports/locations/streets?settlement_id=1Kopijuoti

   GET /api/v1/imports/locations/streets?settlement_id=1

<fk_placereg_adm_units_id>461</fk_placereg_adm_units_id>
<fk_placereg_settlements_id>1</fk_placereg_settlements_id>
<fk_placereg_microdistricts_id>31</fk_placereg_microdistricts_id>
<fk_placereg_streets_id>22328</fk_placereg_streets_id>

Nuotraukos ir vaizdo įrašai

Nuotraukas ir vaizdo įrašą nurodykite V1 XML kategorijos įraše.

Nuotraukų sąrašas

Naudokite photos/photo elementus ir siųskite iki 30 viešų HTTP(S) URL norima tvarka.

Nepateiktos nuotraukos

Jei photos nėra, ankstesnis importuotas rinkinys nekeičiamas; pateiktas rinkinys jį pakeičia.

Ypatumai

features/feature ir add_features/add_feature sujungiami; nepateikus ankstesnės reikšmės lieka.

Vaizdo įrašas

Naudokite has_video su palaikomu YouTube URL arba ID; nepateikus ankstesnė reikšmė lieka.

V1 XML pavyzdys

Atsisiųskite pilną V1 XML pavyzdį su senąja kategorijų grupių struktūra.

Pavyzdžiai naudoja esamus Domoplius placereg_* skaitinius ID. Patikrinkite ID reikšmes ir jų hierarchiją.

<?xml version="1.0" encoding="UTF-8"?>
<domoplius>
  <!--Replace location and option IDs using the versioned endpoints, and supply public image URLs.-->
  <announcements>
    <flats>
      <external_id>100001</external_id>
      <action_type>1</action_type>
      <contacts_name>Partnerio brokeris</contacts_name>
      <contacts_phone>+37060000000</contacts_phone>
      <contacts_email>[email protected]</contacts_email>
      <sell_price>145000</sell_price>
      <fk_placereg_adm_units_id>461</fk_placereg_adm_units_id>
      <fk_placereg_settlements_id>1</fk_placereg_settlements_id>
      <fk_placereg_microdistricts_id>31</fk_placereg_microdistricts_id>
      <fk_placereg_streets_id>22328</fk_placereg_streets_id>
      <wgs_lat>54.687157</wgs_lat>
      <wgs_long>25.279652</wgs_long>
      <comments>Šviesus butas.</comments>
      <features>
        <feature>2</feature>
        <feature>7</feature>
      </features>
      <photos>
        <photo>https://example.lt/photo.jpg</photo>
      </photos>
      <flat_size>50.5</flat_size>
      <flat_rooms>1</flat_rooms>
      <window_directions>n,e</window_directions>
      <adress_building_number>12A</adress_building_number>
    </flats>
    <commercials>
      <external_id>100002</external_id>
      <action_type>1</action_type>
      <contacts_name>Partnerio brokeris</contacts_name>
      <contacts_phone>+37060000000</contacts_phone>
      <contacts_email>[email protected]</contacts_email>
      <sell_price>145000</sell_price>
      <fk_placereg_adm_units_id>461</fk_placereg_adm_units_id>
      <fk_placereg_settlements_id>1</fk_placereg_settlements_id>
      <fk_placereg_microdistricts_id>31</fk_placereg_microdistricts_id>
      <fk_placereg_streets_id>22328</fk_placereg_streets_id>
      <wgs_lat>54.687157</wgs_lat>
      <wgs_long>25.279652</wgs_long>
      <comments>Komercinės patalpos.</comments>
      <features/>
      <photos>
        <photo>https://example.lt/photo.jpg</photo>
      </photos>
      <is_price_for_all_place>false</is_price_for_all_place>
      <commercial_room_size>50.5</commercial_room_size>
      <adress_building_number>12A</adress_building_number>
      <commercial_room_purposes_id>
        <commercial_room_purpose_id>408</commercial_room_purpose_id>
        <commercial_room_purpose_id>410</commercial_room_purpose_id>
      </commercial_room_purposes_id>
    </commercials>
  </announcements>
</domoplius>

Dažnos klaidos

Siunčiamas JSON

V1 priima tik XML. JSON naudokite su V2 kontraktu.

Kartojama tapatybė

Tą patį external_id arba id vienoje kategorijoje pateikite tik kartą.

Sumaišomi V1 ir V2 laukai

V1 naudoja announcements, daugiskaitines kategorijų grupes ir senuosius laukų pavadinimus.

Nepateikiama vietos hierarchija

Savivaldybės, gyvenvietės, mikrorajono ir gatvės ID turi priklausyti vienai hierarchijai.

Tikimasi pilnos kopijos semantikos

V1 nepateikti pasirinktiniai laukai ir kolekcijos paliekami nepakeisti.

Versijos ir pakeitimai

V1 palaiko tik senojo importuotojo XML srautus. Naujiems XML arba JSON srautams rekomenduojamas griežtas V2 kontraktas.

Pakeitimų istorija

Importas V1 · 2026-09-04

Dokumentuotas XML-only dalinio atnaujinimo kontraktas ir V1 perkėlimo į V2 įrankis.