Documentazione export annunci CasaOnClick

Questo documento, i cui destinatari sono gli sviluppatori di siti web per le agenzie immobiliari, contiene le specifiche per prelevare dal server di CasaOnClick gli annunci depositati dal software installato presso l'agenzia immobiliare e poterli quindi pubblicare su un proprio sito.

Versioning

La versione di XML descritta in questo file è la numero 2.0.

Eventuali modifiche di anagrafiche (con la sola eccezione dei nodi negotiation e subnegotiation) causeranno la modifica della sola sottoversione, tutte le altre modifiche (ad es. aggiunta di nuovi campi) saranno introdotte con un cambio di numero di versione. Quindi, ad esempio, se si aggiunge un nuovo tipo di immobile, la nuova versione sarà la 1.1, se si aggiunge un campo in più la nuova versione sarà la 2.0.

Download dell'XML

All'atto dell'attivazione Noxia fornirà all'utente la URL e la password per il prelievo del file, che, a titolo di esempio, si supporranno essere http://xml.casaonclick.it/adv.xml e PASSWORD.

Per scaricare il file, qualsiasi sia la sua versione, la URL sarà quindi http://xml.casaonclick.it/adv.xml?pw=PASSWORD.

Per scaricare il file, forzando l'output in formato compatibile con la versione 1.x, la URL sarà http://xml.casaonclick.it/adv.xml?pw=PASSWORD&version=1.

Non è invece possibile richiedere l'invio di una sotto-versione specifica (es. 1.0).

Il file andrà periodicamente scaricato, via HTTP, a cura del sito dell'utente e i relativi annunci aggiornati. Il campo lastupdate può essere utile per evitare l'aggiornamento del database qualora l'utente non abbia a sua volta pubblicato gli annunci successivamente al precedente download.

Per quanto riguarda le immagini, queste saranno fornite in JPEG già ridimensionate a 800 pixel nel loro lato più lungo (quindi, ad esempio, 640x800 o 800x640), scaricabili da una URL fornita. Di tali file verranno trasmessi dimensione e CRC32: tali dati possono essere utilizzati per evitare, in seguito, il download di immagini che sono già state scaricate.

Ulteriori requisiti

Per consentire la pubblicazione degli annunci sui diversi portali, è necessario che il sito supporti due ulteriori requisiti:

• presenti, all'indirizzo /img/logo_portali.jpg un logo dell'agenzia da utilizzarsi per la registrazione automatica sui portali
   
• indipendentemente dall'URL mapping scelto per la pubblicazione degli annunci, il link /go/XX deve portare l'utente, tramite un redirect, alla pagina dell'annuncio il cui identificatore univoco numerico (che è quello fornito nell'XML) sia uguale a XX.

Supporto

Il supporto agli sviluppatori per l'integrazione sarà fornito esclusivamente via mail all'indirizzo xml@casaonclick.it; riportare, nella mail di richiesta, gli estremi dell'agenzia per la quale si sta effettuando la richiesta.

Formato xml

<?xml version="1.0" encoding="UTF-8" ?>	Intestazione del file XML, che verrà fornito con codifica UTF-8.
casaonclick	Nodo radice del documento XML.
casaonclick/error	In caso di errore, contiene la descrizione dell'errore (e il file XML non contiene altri nodi). Se non vi è errore, il nodo non è presente.
casaonclick/version	Versione del file XML. Al momento, 2.0.
casaonclick/lastupdate	Contiene la data, in formato ISO 8861 in cui l'utente ha effettuato l'ultimo aggiornamento con il software.
casaonclick/negotiation@name	Nodo contenitore delle zone per ciascuna negoziazione, già ordinate come inserite nel software. Le zone sono sempre due, anche se vuote, e sono: Vendesi Fittasi
casaonclick/negotiation/zone@name	Nodo contenitore delle sottozone per ciascuna zona, già ordinate come inserite nel software. Il valore di name è il nome della zona. Le zone sono quelle definite autonomamente dall'agenzia per ripartire i propri immobili.
casaonclick/negotiation/zone/subzone@name	Nodo contenitore degli annunci per ciascuna sottozona, già ordinati come inserite nel software. Il valore di name è il nome della sottozona. Le sottozone sono quelle definite autonomamente dall'agenzia per ripartire i propri immobili.
casaonclick/negotiation/zone/subzone/adv@id	Nodo contenente il singolo annuncio, del quale è sepecificato l'identificatore univoco id.
casaonclick/negotiation/zone/subzone/adv/windowno	Posizione nelle vetrine
casaonclick/negotiation/zone/subzone/adv/subnegotiation	Sotto-negoziazione, assume uno dei seguenti valori: Residenziale Commerciale
casaonclick/negotiation/zone/subzone/adv/municipality@code	Nome del comune dove è ubicato l'immobile; code è il codice catastale (es. F839).
casaonclick/negotiation/zone/subzone/adv/quarter	Nome del quartiere dove è ubicato l'immobile. I quartieri (e i comuni) sono quelli della geografia interna di CasaOnClick, utilizzata per la pubblicazione dei portali. Per la ripartizione degli annunci sul sito, si consiglia l'utilizzo delle zone e delle sottozone, che sono invece definite dall'utente.
casaonclick/negotiation/zone/subzone/adv/latitude	Latitudine dell'immobile.
casaonclick/negotiation/zone/subzone/adv/longitude	Longitudine dell'immobile.
casaonclick/negotiation/zone/subzone/adv/address	Indirizzo dell'immobile.
casaonclick/negotiation/zone/subzone/adv/description	Descrizione dell'immobile.
casaonclick/negotiation/zone/subzone/adv/type	Tipo immobile, assume uno dei seguenti valori: Appartamento Attico Attività Attività Bar/Ristorante Box Cantinola Capannone Casa indipendente Deposito Laboratorio Locale commerciale Loft Magazzino Mansarda Monolocale Negozio Open Space Palazzina Rustico Studio professionale Terreno Ufficio Villa Villetta a schiera
casaonclick/negotiation/zone/subzone/adv/rentalstatus	Stato locativo, può assumere uno dei seguenti valori: Libero Locato Nuda proprietà
casaonclick/negotiation/zone/subzone/adv/flatstatus	Condizioni immobile, può assumere uno dei seguenti valori: Ottime Buone Discrete Da ristrutturare
casaonclick/negotiation/zone/subzone/adv/price	Prezzo in euro dell'immobile; stringa vuota è da interpretarsi come Trattativa riservata o, più genericamente, Non specificato.
casaonclick/negotiation/zone/subzone/adv/surface	Quadratura, in metri quadri, dell'immobile.
casaonclick/negotiation/zone/subzone/adv/rooms	Numero vani dell'immobile.
casaonclick/negotiation/zone/subzone/adv/bathrooms	Numero bagni dell'immobile.
casaonclick/negotiation/zone/subzone/adv/heating	Riscaldamento dell'immobile, può assumere uno dei seguenti valori: No Centralizzato Autonomo
casaonclick/negotiation/zone/subzone/adv/car_parking	Posto auto, può assumere uno dei seguenti valori: No Scoperto Coperto Condomin. scop. Condomin. cop. Box Box singolo+posto auto Box singolo+2 posti auto Box doppio Box doppio+posto auto Box doppio+2 posti auto
casaonclick/negotiation/zone/subzone/adv/lift	Ascensore; se specificato può essere true o false.
casaonclick/negotiation/zone/subzone/adv/terrace	Terrazzo; se specificato può essere true o false.
casaonclick/negotiation/zone/subzone/adv/balcony	Numero balconi dell'immobile.
casaonclick/negotiation/zone/subzone/adv/garden	Giardino, può assumere uno dei seguenti valori: No Privato Comune
casaonclick/negotiation/zone/subzone/adv/floor	Piano dell'immobile (testo libero).
casaonclick/negotiation/zone/subzone/adv/condominial_expenses	Spese condominiali mensili (numero intero).
casaonclick/negotiation/zone/subzone/adv/energy_class	Classe energetica, se non vuoto assume uno dei seguenti valori: Esente A+ A B C D E F G
casaonclick/negotiation/zone/subzone/adv/energy_ipe@unit	Indice di prestazione energetica, se specificato (float con max 2 decimali e il punto come separatore); unit è m2 se l'indice è espresso in kWh/anno/m², m3 se l'indice è espresso in kWh/anno/m³, può invece non essere presente se l'indice è vuoto o pari a zero.
casaonclick/negotiation/zone/subzone/adv/vtour	Codice Virtual Tour (testo libero come inserito dall'utente, se è impostato il Virtual Tour HTML).
casaonclick/negotiation/zone/subzone/adv/images	Nodo contenitore delle foto dell'immobile.
casaonclick/negotiation/zone/subzone/adv/images/image@type, @size, @crc32	Nodo contenitore della singola foto dell'immobile; type è impostato a map se la foto è una piantina, a vtour se la foto è un virtual tour, a photo altrimenti. I campi size e crc32 contengono la dimensione e il crc32 del file di immagine e possono essere utilizzati per stabilire se una foto va scaricata o meno.
casaonclick/negotiation/zone/subzone/adv/images/image/description	Descrizione della foto.
casaonclick/negotiation/zone/subzone/adv/images/image/url	Url da cui scaricare la foto.

Esempio

Segue un XML di esempio, scaricabile anche alla URL http://xml.casaonclick.it/xml/sample.xml. Le foto presenti nel file di esempio sono effettivamente pubblicate, per cui il file può essere utilizzato a fini di sviluppo.

<?xml version="1.0" encoding="UTF-8"?> <casaonclick> <version>1.0</version> <lastupdate>2010-04-20T09:28:09+02:00</lastupdate> <negotiation name="Vendesi"> <zone name="Napoli"> <subzone name="Vomero"> <adv id="420"> <windowno>1</windowno> <subnegotiation>Residenziale</subnegotiation> <municipality code="F839">NAPOLI</municipality> <quarter> <![CDATA[Vomero / Vomero Alto]]> </quarter> <latitude>40.84459307197389</latitude> <longitude>14.227294921875</longitude> <address> <![CDATA[Via Alessandro Scarlatti 209]]> </address> <description> <![CDATA[Testo descrittivo prova test ciao]]]> </description> <type>Appartamento</type> <rentalstatus> <![CDATA[Libero]]]> </rentalstatus> <flatstatus>Ottime</flatstatus> <price>550000</price> <surface>70</surface> <rooms>3</rooms> <bathrooms>1</bathrooms> <heating>Autonomo</heating> <car_parking>No</car_parking> <lift>true</lift> <terrace>false</terrace> <balcony>2</balcony> <garden>No</garden> <floor> <![CDATA[6 (Seminterrato)]]]> </floor> <condominial_expenses>75</condominial_expenses> <energy_class>A</energy_class> <energy_ipe unit="m2">33.33</energy_ipe> <vtour> <![CDATA[]]> </vtour> <images> <image map="true" size="62150" crc32="3339089368"> <description></description> <url>http://xml.casaonclick.it/img/420_M_800_800.jpg</url> </image> </images> </adv> <adv id="417"> <subnegotiation>Residenziale</subnegotiation> <municipality code="F839">NAPOLI</municipality> <quarter> <![CDATA[Vomero / Vomero Alto]]> </quarter> <latitude>40.84214192905569</latitude> <longitude>14.228410720825195</longitude> <address> <![CDATA[Via Luca Giordano]]> </address> <description> <![CDATA[La prestigiosa unità immobiliare proposta è ubicata in una delle principali piazze della città. L'appartamento è accogliente e raccolto. Posizione: Centralissima, in un quartiere signorile ed esclusivo a pochi passi dalla metropolitana. Caratteristiche: si tratta di un appartamento fuori dal comune caratterizzato da un'ampia terrazza su cui si affacciano soggiorno, cucina bagno e studio; la camera. Ristrutturato pochi anni fa, si trova in ottimo stato; il bagno è dotato di doccia idromassaggio, a disposizione anche posto auto, balcone, terrazzo, giardino, aria condizionata, riscaldamento autonomo. Interni come nuovi, perfetti. Dotata di tenda parasole con comandi elettrici , è l'ambiente più suggestivo della casa. Ideale per prendere l'aperitivo e cenare a lume di candela. Posizione silenziosa e tranquilla. Condominio: con ascensore e spese condominiali contenute [Tutti i dati relativi a questo annuncio non sono reali, ma sono stati caricati per il solo scopo dimostrativo]]> </description> <type>Villa</type> <rentalstatus> <![CDATA[Libero]]> </rentalstatus> <flatstatus>Ottime</flatstatus> <price>100000</price> <surface>300</surface> <rooms>5</rooms> <bathrooms>2</bathrooms> <heating>Autonomo</heating> <car_parking>Scoperto</car_parking> <lift>true</lift> <terrace>true</terrace> <balcony>1</balcony> <garden>Privato</garden> <floor> <![CDATA[5]]> </floor> <condominial_expenses>100</condominial_expenses> <vtour> <![CDATA[]]> </vtour> <images> <image type="photo" size="76699" crc32="4056631756"> <description /> <url>http://xml.casaonclick.it/img/417_0_800_800.jpg</url> </image> <image type="photo" size="9229" crc32="882085084"> <description /> <url>http://xml.casaonclick.it/img/417_1_800_800.jpg</url> </image> <image type="photo" size="5948" crc32="762682743"> <description /> <url>http://xml.casaonclick.it/img/417_2_800_800.jpg</url> </image> <image type="photo" size="2030" crc32="2739916779"> <description /> <url>http://xml.casaonclick.it/img/417_3_800_800.jpg</url> </image> </images> <images> <image type="map" size="58035" crc32="2934043544"> <description /> <url>http://xml.casaonclick.it/img/417_M_800_800.jpg</url> </image> </images> <images> <image type="vtour" size="24328438" crc32="1927411853"> <description>VT #1</description> <url>http://xml.casaonclick.it/img/417_0_vt.jpg</url> </image> </images> </adv> </subzone> </zone> <zone name="Avellino"> <subzone name="Centro Storico"> <adv id="418"> <subnegotiation>Residenziale</subnegotiation> <municipality code="A509">AVELLINO</municipality> <quarter> <![CDATA[Centro città]]> </quarter> <latitude></latitude> <longitude></longitude> <address> <![CDATA[Corso Vittorio Emanuele]]> </address> <description> <![CDATA[La prestigiosa unità immobiliare proposta è ubicata in una delle principali piazze della città. L'appartamento è accogliente e raccolto. Posizione: Centralissima, in un quartiere signorile ed esclusivo a pochi passi dalla metropolitana. Caratteristiche: si tratta di un appartamento fuori dal comune caratterizzato da un'ampia terrazza su cui si affacciano soggiorno, cucina bagno e studio; la camera. Ristrutturato pochi anni fa, si trova in ottimo stato; il bagno è dotato di doccia idromassaggio, a disposizione anche posto auto, balcone, terrazzo, giardino, aria condizionata, riscaldamento autonomo. Interni come nuovi, perfetti. Dotata di tenda parasole con comandi elettrici , è l'ambiente più suggestivo della casa. Ideale per prendere l'aperitivo e cenare a lume di candela. Posizione silenziosa e tranquilla. Condominio: con ascensore e spese condominiali contenute [Tutti i dati relativi a questo annuncio non sono reali, ma sono stati caricati per il solo scopo dimostrativo]]]> </description> <type>Appartamento</type> <rentalstatus> <![CDATA[Libero]]> </rentalstatus> <flatstatus>Ottime</flatstatus> <price>800000</price> <surface>100</surface> <rooms>4</rooms> <bathrooms>2</bathrooms> <heating>Centralizzato</heating> <car_parking>No</car_parking> <lift>true</lift> <terrace>true</terrace> <balcony>3</balcony> <garden>No</garden> <floor> <![CDATA[5 (Intermedio)]]> </floor> <condominial_expenses>50</condominial_expenses> <energy_class>Esente</energy_class> <energy_ipe></energy_ipe> <vtour> <![CDATA[]]> </vtour> </adv> </subzone> </zone> </negotiation> <negotiation name="Fittasi"> <zone name="Avellino"> <subzone name="San Tommaso"> <adv id="419"> <subnegotiation>Residenziale</subnegotiation> <municipality code="A509">AVELLINO</municipality> <quarter>Centro città</quarter> <latitude></latitude> <longitude></longitude> <address>Via Due Principati</address> <description>Capannone con uffici, mq. 6425 ca., ascensore. Immobile cosi suddiviso: - piano seminterrato con permanenza di persone (ai fini commerciali calcolato al 50%): mq 431 ca. di uffici, mq 134 ca. di locali tecnici e mq 26 ca. di cantine. - piano terra: mq 195 ca. di ingresso, mq 710 ca. di uffici, mq 2849 ca. di magazzini, mq 768 ca. di cortile (ai fini commerciali calcolati al 10%). - 1 piano: mq 2157 ca. di uffici, mq 141 ca. di magazzini. Accatastato D8, 3 passi carrai, ht. Media 3,30 mt., ht. Massima 5,50 mt, ht magazzini sottotrave 5 mt., superficie fondiaria mq 4695 ca.. Possibilita' di frazionamento in 3 parti Disponibilita' n. 16 posti auto scoperti. [Tutti i dati relativi a questo annuncio non sono reali, ma sono stati caricati per il solo scopo dimostrativo]</description> <type>Capannone</type> <rentalstatus>Libero</rentalstatus> <flatstatus>Ottime</flatstatus> <price>550000</price> <surface>600</surface> <rooms>2</rooms> <bathrooms>2</bathrooms> <heating>Autonomo</heating> <car_parking>Condomin. cop.</car_parking> <lift></lift> <terrace></terrace> <balcony></balcony> <garden></garden> <floor>-1</floor> <condominial_expenses></condominial_expenses> <energy_class>A+</energy_class> <energy_ipe unit="m3">123.45</energy_ipe> <vtour></vtour> </adv> </subzone> </zone> </negotiation> </casaonclick>