Notes regarding the usage and format of the XML for exporting real estate objects to ImmoGalaxy.ch Take care! The only valid XML file is the one in ITALIAN, the one in ENGLISH is just a reference file for helping you in the preparation of the real one) ================================================================================ 1. Sending of XML file happens once a day. 2. Sendings happens in an INCREMENTAL way, that is: first sending is FULL with all of the objects of the customer, then the following daily sending have to be incremental (that is; only the with daily updates) or 2. Starting 5th September 2018 it is possibile to execute the transmission in both "incremental" and "full" transmission. The requested standard during the week remains the same; type "incremental"; the "full" type can be execute only on Saturda, Sunday or Monday morning in case you want to be sure of your objects export shall some weekly type "incr" have missed some update. 2.1 incremental transmission; only daily updates or deletes (if not differently specified, this is the default): 2.2 Full transmission; all active objects marked for export on your site: 2.3 As specified, transmissions must be incremental: first transmission full with all of the objects, following transmission with only daily updates and deletes. Both transmission types "incr" and type "full" support: and please note that in "full" type it is not needed to send "DELETE"s anymore possible objects not active anymore on your site but still active on immogalaxy will be blocked automatically. How to use the tag and meaning of the "type": . UPDATE -> for new objects or updates to their data / images . DELETE -> for deletes or suspension on your site 3. Preparation and activation phases: PHASE 1: test ------------- . you will send us your first/s XML test files by email to nikita@immogalaxy.ch . the XML files must contain real objects data with real URL addresses (both for images, and for possible pdf files) - that is needed to fully validate your XML file . once the first validation has been passed, we proceed with a two-days test with real data: . first sending FULL (all of the customer' objects) . second sending INCREMENTAL (that is only "UPDATE" and/or "DELETE") . PHASE 1 completed, we proceed with PHASE 2 PHASE 2: production ------------------- . the first two XML files with real data will be processed manually on our immogalaxy.ch server and will load the real estate objects on www.immogalaxy.ch . we will send you the FTP account info for your daily XML transfer to our server immogalaxy.ch . activation of the automatic procedure for importing your XML files. 4. NOTES: details on the TAG found in the XML file . it's your responsability to set the TAGs () and () for each parent; once set, these values MUST NOT/NEVER change in future; they are used to identify real estate agencies, contact persons and real-estate-objects in your future sendings. Usually, they are set by using an identifier of your DB. . the TAG represents the real-estate-agency pubblishing the objcts (in such a way the XML is able to contain the of many different agencies at once, even if this method is actually not used so far) . each object MUST have at least 1 image (and a maximum of 12), they have to be identified with an URL pointing to an image of good quality, our automatic procedure will get it and convert it in on our server to the immogalaxy.ch standard formats (customers' picture are read only during the execution of the automatic procedure during their load and to check they have been modified since last "reading", that is during the night) . PDF documents, maximu 3 each of them with a maximum weight of 2MB . we handle all Swiss and Italian cities wither their postal code () . the tipical name of the file to be sent is: YYYYMMDD.annunci.xml . "" code in the fields () is NOT accepted (we do accept only
and
  • ), in which case, to be a valid XML format you have put the text within "" 5. Possible/valid values for TAGs with a code/category (ALL mandatory): ----------------------------------------------------------------------- () () (categoria_oggetto>) 1 = rustici (cottages) 2 = case (houses) 3 = appartamenti (apartments) 4 = locali commerciali (commercial surfaces) 5 = progetti (projects) 6 = terreni (lands) 7 = ville (villas) 8 = stabili di reddito (income buildings) 9 = garages parcheggi (garages parking lots) 10 = bar ristoranti hotel (Bars Restaurants Hotels) 11 = attici (Penthouses) () () () () 1 = affitto (for rent) 2 = vendita (for sale) () () () () 1 = unitario (unitary) 2 = m2/grezzo (m2/rough) 3 = m2/finito (m2/finished) 4 = m3/grezzo (m3/rough) 5 = m3/finito (m3/finished) 6 = m2 (m2) 7 = trattabile (negotiable) 8 = a partire da (starting from) 9 = mensile (monthly) 10 = trimestrale (quarterly) 11 = semestrale (half-yearly) 12 = annuale (yearly) () () (1 mandatory, max 12) ( or ) (optional, max 10MB) () (optional, max 1 link) () () () YYYY-MM-GG (real date) or da subito (immediate) or da concordare (to discuss) () () () () 6. Reminder: TAGs with mandatory value -------------------------------------- . for the node () () () () () () () () ( 2 chars) () () () ( 0 or integer) (CHF) NOTE: if empty we assume "CHF" () () ( () () () () () () 7. Values for all the other TAGs are optional but warmly recommended --------------------------------------------------------------------