Feed per i siti di Immobiliare.it

Se volete pubblicare degli annunci (di vendita di immobili o progetti di nuova costruzione) in modo automatico sui siti del network di gruppo Immobiliare.it, il modo migliore è fornirci un file XML che segua le nostre specifiche per lo scambio dati. La procedura di importazione degli annunci è totalmente automatizzata e permette aggiornamenti regolari dell'elenco degli annunci.

Nuove integrazioni

Se per la prima volta vi trovate a sviluppare un flusso di esportazione vero Immobiliare.it, vi invitiamo ad abbandonare questa pagina ed a considerare invece le specifiche disponibili qui:

Come funziona l'integrazione di un flusso di annunci

L'integrazione degli annunci avviene ogni notte; il nostro sistema carica i flussi XML inseriti dai partner nelle propria area FTP. Se volete attivare l'importazione di un vostro feed nei siti del nostro network, basta compiere i seguenti passi:

  1. Leggete con attenzione le specifiche del formato XML che dovrete realizzare (e confrontatelo con gli esempi)
  2. Realizzate un software che vi permetta di esportare gli annunci desiderati nel formato XML di cui sopra
  3. Una volta che il feed viene generato correttamente potremo attivare la procedura di importazione, e i vostri annunci verranno caricati sui siti del network Immobiliare Pro

Modalità di caricamento

Tutti gli annunci che volete importare sui siti del nostro network devono essere inclusi in un singolo file chiamato properties-full.xml. Solo nel caso in cui il feed superi i 10 mila annunci è possibile dividere il feed in più file. In questo caso, i file dovranno essere denominati properties-full.N.xml, dove N è un numero che deve corrispondere al valore del nodo /feed/metadata/multipage/current contenuto nel file medesimo (vedi sotto).

Il feed che viene caricato ogni notte deve contenere TUTTI gli annunci di TUTTI i clienti che devono essere integrati. Flussi incrementali possono essere accettati in casi particolari solo per partner che carichino piu' di 10000 annunci sul portale, e solo previo accordo con il reparto tecnico.

Per chiarimenti sulle specifiche o sulle modalità di importazione degli annunci potete far riferimento all'indirizzo di email del settore tecnico che vi è stata fornita in precedenza

Questa pagina è disponibile anche allo Short URL: http://goo.gl/VhzSB

Formato xml

Intestazione

<?xml version="1.0" encoding="UTF-8" ?>
Intestazione del file XML indica la versione dello standard XML seguita (1.0), la codifica del documento; è obbligatoria la codifica unicode utf-8 per i feed XML.

/feed [es.]
Nodo radice del documento XML. Obbligatorio
È obbligatorio al fine della validazione che nel nodo di radice - e solo in esso - vengano dichiarati il namespace e lo schemaLocation del feed:
            <feed xmlns="http://feed.immobiliare.it"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://feed.immobiliare.it/import/docs/xsd/v2.8.xsd">
          

/feed/version [es.]
Il numero di versione del documento XML. Questa pagina tratta la versione 2.8. Obbligatorio

/feed/metadata [es.] [-]
Contenitore dei metadati che riguardano il partner, la struttura del feed e la data di pubblicazione. Obbligatorio
/feed/metadata/publisher [es.]
Contenitore i dati che riguardano il partner. Obbligatorio

/feed/metadata/publisher/name [es.]
Identificativo del partner. Obbligatorio

/feed/metadata/publisher/site [es.]
Il sito web del partner.

/feed/metadata/publisher/email [es.]
Indirizzo email a cui comunicare eventuali problemi e/o mandare report riguardo all'integrazione. Obbligatorio

/feed/metadata/publisher/phone [es.]
Numero di telefono a cui comunicare eventuali problemi e/o mandare report riguardo all'integrazione. Il numero di telefono deve essere in formato internazionale (+3906XXXXX). Obbligatorio

/feed/metadata/build-date [es.]
Data di generazione del feed. Obbligatorio
Questa, come tutte le altre date del feed deve essere in formato ISO 8861, come raccomandato dal W3 consortium in tema di interoperabilità sul web.

/feed/metadata/multipage [es.]
Nodo radice del controllo della gestione multipagina.

/feed/metadata/multipage/current [es.]
Pagina corrente del feed.

/feed/metadata/multipage/last [es.]
Numero totale di pagine che costituiscono il feed.


Annunci immobiliari in vendita o affitto

Di seguito riportiamo la struttura dedicata agli annunci immobiliari, che permettono di definire annunci presso agenzie di immobili in vendita od in affitto con contratti a lungo ed a breve termine (case vacanza). Ogni annuncio deve riferirsi ad un unico immobile e ad un unico contratto.

/feed/properties [es.]
Intestazione della sezione rlativa agli annunci immobiliari.

/feed/properties/property[@operation] [es.] [-]
Contenitore del singolo annuncio. Obbligatorio
L'attributo operation indica che operazioni si devono effettuare sull'annuncio:
  • write Inserisce od aggiorna l'annuncio
  • archiveArchivia l'annuncio; permette una sua successiva ripubblicazione senza doverlo reinserire da zero
  • delete Elimina permanentemente l'annuncio
/feed/properties/property/unique-id [es.]
Codice identificativo univoco per l'annuncio. Deve essere univoco per la singola agenzia. Di norma va bene il "riferimento agenzia". Obbligatorio
Attenzione Questo nodo è essenziale al corretto caricamento degli annunci. Il sistema di importazione si basa su questo id univoco e sull'indirizzo email dell'agenzia per determinare se l'annuncio è nuovo o se è già presente nel nostro database.

/feed/properties/property/date-updated [es.]
Data dell'ultimo aggiornamento dell'annuncio. La data deve essere in formato ISO 8861. Obbligatorio

/feed/properties/property/date-expiration [es.]
Data di cessazione dell'annuncio. La data deve essere in formato ISO 8861. Non viene usato per far scadere gli annunci sul network ImmobiliarePro, ma puo' essere utile ad alcuni partner esterni a cui vengono propagati gli annunci.

/feed/properties/property/transaction-type[@auction,@for-revenue,@ownership,@on-redeem] [es.]
Indica se l'immobile è in affitto o vendita. Obbligatorio
I valori ammessi sono:
  • S immobile in VENDITA (for Sale)
  • R immobile in AFFITTO (for Rent)

L'attributo auction assume valori yes o no e indica se l'immobilie è stato messo all'asta.

L'attributo for-revenue indica se l'immobile è adatto come investimento yes o si presta maggiormente ad un utilizzo tradizionale no.

L'attributo on-redeem indica se è prevista la cessione dell'immobile con la formula dell'affitto a riscatto yes o meno no.

L'attributo ownership specifica il tipo di proprietà e può assumere i seguente valori:
  • intera proprietà
  • nuda proprietà
  • parziale proprietà
  • usufrutto
  • multiproprietà
  • diritto di superficie

NOTA BENE
Questo nodo gestisce le tipologie immobiliari come introdotte nel luglio 2014. Il sistema adottato fino a tale data è da considerarsi obsoleto e dismesso.
/feed/properties/property/building[@map] [es.]
v.2.6
[-]
Le tipologie immobiliari vengono definite attraverso un albero che riassume nel dettaglio, partendo dalla categoria immobiliare, ciascuna tipologia. È possibile scaricare l'albero completo in formato XML. Obbligatorio
La struttura è bilanciata su tre livelli. Per esempio la vecchia tipologia Residenziale 'Appartamento' si colloca come:
  • Residenziale / Appartamento / Appartamento
Notare che al terzo livello possiamo trovare anche:
  • Residenziale / Appartamento / Attico
  • Residenziale / Appartamento / Mansarda
In riferimento al file XML di cui sopra fate riferimento agli attributi sell e rent. Ciascuna tipologia puo' essere valida in caso di vendita (sell="1"), affitto (rent="1").
Per esempio, questa notazione è sbagliata:
  • Residenziale / Appartamento
in quanto al secondo livello di profondità gli attributi sell e rent sono sempre a 0 (zero).
I nodi di terzo livello (foglie) non sono sufficienti, da soli, a definire una tipologia:
  • Residenziale / Appartamento / Appartamento
  • Case vacanza / Casa / Appartamento
hanno significati molto diversi!
Nel feed XML i tre livelli che compongono le tipologie vengono composti in maniera simile ad un percorso URL per formare una sorta di breadcrumb da inserire nell'attributo map:
<building map="Residenziale/Villa/Villa bifamiliare" />
Il carattere '/' (slash) usato come separatore non ha bisogno di spazi, mentre vanno rispettati (insieme al charset) quelli contenuti nella descrizione di ogni tipologia
/feed/properties/property/building/maps [es.]
v.2.6
[-]
Tipologie aggiuntive.
È possibile definire fino a due (2) tipologie addizionali per definire meglio l'immobile.
le tipologie addizionali possono migliorare le ricerche e descrivono meglio l'uso dell'immobile. Sono ovviamente opzionali e sono in secondo piano rispetto alla tipologia principale.
GLi esempi che seguono utilizzano la notazione divulgativa adottata per le tipologie principali. Si consideri il primo elemeno come tipologia principale:
  • Residenziale / Appartamento / Appartamento
  • Commerciale / Ufficio / Ufficio
Puo' essere un appartamento che si presta particolarmente bene, per struttura e dimensioni, ad essere utilizzato come ufficio (notare che si è cambiata addirittura la categoria immobiliare - ossia la tipologia di base di primo livello).
E anche:
  • Commerciale / Attività - Licenza / Bar
  • Commerciale / Attività - Licenza / Tabacchi
Puo' essere un'unica attività commerciale in cui si esercita prevalentemente l'attività di Bar alla quale si affianca la vendita al dettaglio di tabacchi.
/feed/properties/property/building/maps/additional[@map] [es.]
v.2.6
Tipologia addizionale. Fare riferimento alla tipologia principale per le meccaniche di funzionamento.


/feed/properties/property/building/status [es.]
Stato dell'immobile. Obbligatorio
I valori previsti sono:
  • in costruzione immobile in costruzione
  • nuovo immobile nuovo, mai abitato
  • ottimo Ottimo stato
  • buono Buono stato
  • discreto Discreto ma abitabile
  • ristrutturato Recentemente ristrutturato
  • da ristrutturare Da ristrutturare
  • nd Non dichiarato (valore predefinito)

/feed/properties/property/building/class [es.]
Classe dell'immobile.
I valori previsti sono:
  • di lusso
  • signorile
  • economico


/feed/properties/property/agent [es.] [-]
Nodo che contiene le informazioni che riguardano l'agente immobiliare. Obbligatorio
Qui le informazioni sono limitate ad identificare con sicurezza l'agenzia di riferimento. Se avete necessità di passare l'anagrafica completa delle agenzie ad Immobiliare.it, dovete far riferimento alle specifiche di importazione delle agenzie
/feed/properties/property/agent/office-name [es.]
Nome dell'agenzia immobiliare.

/feed/properties/property/agent/email [es.]
Email dell'agenzia immobiliare. Obbligatorio
Questo nodo è essenziale. Il sistema di importazione si basa su di esso e sull'id univoco unique-id per determinare se l'annuncio è nuovo o se è già presente nel nostro database.


/feed/properties/property/location [es.] [-]
Nodo che contiene le informazioni che riguardano la posizione dell'immobile. Per ottimizzare la geolocazione dei vostri annunci, vi consigliamo di consultare l'XML contenente la nostra struttura di geolocazione. Obbligatorio
/feed/properties/property/location/country-code [es.]
Codice della nazione in formato ISO 3166 (Alpha 2). Obbligatorio

/feed/properties/property/location/administrative-area [es.]
Stringa che indica il nome della maggior suddivisione amministrativa della nazione. Nel caso dell'Italia, si tratta del nome per esteso della regione (es. Lazio, Valle d'Aosta, Emilia Romagna). Obbligatorio

/feed/properties/property/location/sub-administrative-area [es.]
Stringa che indica il nome della successiva suddivisione amministrativa della nazione. Nel caso dell'Italia, si tratta del nome per esteso della provincia (es. Roma, Pesaro Urbino, Reggio Calabria). Obbligatorio

/feed/properties/property/location/city[@code] [es.]
Stringa che indica la città (comune). Obbligatorio
Nell'attributo "code" è possibile inserire il codice ISTAT del comune italiano (altamente consigliato).
Per i comuni francesi è possibile utilizzare i codici INSEE

/feed/properties/property/location/locality [es.] [-]
Nodo che contiene i dettagli per la localizzazione degli annunci, come la località, la zona, l'indirizzo e le coordinate per visualizzare gli annunci su mappa.
/feed/properties/property/location/locality/neighbourhood[@type,@id] [es.]
v.2.2
Nome per esteso della località o della zona della città a cui si riferisce l'annuncio
L'attributo "type" puo' assumere i valori:
  • area se si tratta di una zona, ad es. 'Prati'
    • id correlato all'attributo area contiene il geocoding dell'attributo area
      NB: l'attributo è opzionale e sostituisce il nome per esteso della località o della zona della città

  • locality se si tratta di una frazione, ad es. 'Acilia'

Per una lista completa delle nostre aree, potete far riferimento all'XML che contiene il geocoding completo di immobiliare.it.

/feed/properties/property/location/locality/thoroughfare[@display] [es.]
La strada comprensiva di numero civico. Esempio: "Via Ottaviano, 6".
L'attributo display assume valori 'yes' o 'no' e indica se l'indirizzo deve essere mostrato o meno sui siti del network. Questo attributo determina anche la comparsa o meno del "segnalino" sulla mappa (in base ai valori presenti nei nodi latitude e longitude).

/feed/properties/property/location/locality/postal-code [es.]
Codice di avviamento postale per l'annuncio.

/feed/properties/property/location/locality/latitude [es.]
Latitudine dell'annuncio . Va espressa in gradi, la divisione dei decimali avviene con un punto, (es 45.8745). Obbligatorio

/feed/properties/property/location/locality/longitude [es.]
Longitudine dell'annuncio . Va espressa in gradi, la divisione dei decimali avviene con un punto, (es 12.7622). Obbligatorio



/feed/properties/property/features [es.] [-]
Nodo contenitore di tutti i nodi che aggiungono i dettagli fondamentali dell'annuncio. Obbligatorio
/feed/properties/property/features/rooms [es.]
Numero di locali dell'immobile. Obbligatorio

/feed/properties/property/features/size[@unit] [es.] [-]
Dimensione dell'immobile. Può essere espressa direttamente con un valore numerico oppure può essere descritta in termini di consistenze: Obbligatorio
L'attributo unit indica l'unità di misura scelta:
  • m2 metri quadri
  • sft Square feet
/feed/properties/property/features/size/details [es.]
v.2.8
[-]
Nodo contenitore con lo sbobinamento delle superfici dell'immobile (posso avere diverse righe).
/feed/properties/property/features/size/details/detail[@main] [es.] [-]
Dettaglio di una superficie dell'immobile
L'attributo main indica se la consistenza è principale ('Y', concorre al calcolo della superficie complessiva) o accessoria ('N', concorre solo al calcolo della superficie commerciale). Se omesso si assume che la consistenza sia principale.
/feed/properties/property/features/size/details/detail/type [es.]
Consistenza. Obbligatorio
Può assumere i valori:
  • Abitazione default 100%
  • Ufficio default 100%
  • Studio default 100%
  • Negozio default 100%
  • Magazzino default 50%
  • Garage default 50%
  • Cantina default 50%
  • Soffitta default 50%
  • Balcone default 30%
  • Terrazzo default 30%
  • Giardino default 10%
  • Terreno default 10%
  • Parti comuni default 0%
  • Altro default 0%

/feed/properties/property/features/size/details/detail/floor[@type] [es.]
Indica il numero di piano (valore numerico) a cui si trova l'immobile.
L'attributo type assume uno dei seguenti valori:
  • Intermedio valore di default
  • Interrato
  • Seminterrato
  • PianoTerra
  • Rialzato
  • Multipiano su più livelli (con scala, rampa e/o ascensore interni od esterni)
  • Ultimo

/feed/properties/property/features/size/details/detail/size [es.]
Superficie, utilizza come unità di misura quella definita in /feed/properties/property/features/size[@unit]

/feed/properties/property/features/size/details/detail/weight [es.]
Peso percentuale applicato nel calcolo della superficie commerciale (a nostro carico) può assumere valori decimali da 0 a 100. Usare il punto (.) come separatore decimale. Se omesso si applicano i valori di default della consistenza.




/feed/properties/property/features/price[@currency,@reserved] [es.]
Prezzo dell'immobile.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR". L'attributo reserved indica invece se il prezzo dell'immobile va nascosto ('yes') o mostrato ('no') sul sito.
Obbligatorio

/feed/properties/property/features/descriptions [es.] [-]
Nodo contenitore con le descrizioni dell'immobile in diverse lingue.
/feed/properties/property/features/descriptions/description[@language] [es.]
Descrizione dell'immobile. Sono ammessi tag multipli purchè associati a lingue differenti. Obbligatorio
In generale dovrebbe essere limitata a 3000 caratteri. L’attributo language indica la lingua della descrizione, indicata dal codice della nazione in codifica ISO 639-1.


/feed/properties/property/features/energy-class[@scale,@value,@certified] [es.]
v.2.7
[-]
Classe energetica dell'immobile.
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica
Obbligatorio
La classe energetica dipende dall'APE (vedi energy-performance). A partire dal 1 Luglio 2015, obbligatoria da ottobre dello stesso anno, le classi energetiche sono classificate in modo nuovo. L'attributo scale definisce il tipo di regolamentazione in uso in base ai valori:
  • 1 - Certificazione IPE antecedente al 1 Ottobre 2015
  • 2 - default - Certificazione APE (raccomandato)
Si noti che rispetto al vecchio formato la scala di default è ora quella nuova.
L'attributo value, per la nuova scala, può assumere i seguenti valori:
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
I vecchi valori della classe energetica restano utilizzabili anche se se ne raccomanda l'abbandono.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
L'attributo certified Opzionale indica se l'IPE è stato certificato; ha i seguenti valori:
  • yes (default)
  • no
ATTENZIONE
il valore no per l'attributo certified pone l'immobile in attesa di certificazione. Escludendo la pubblicazione di ogni altra informazione sulla classe energetica e sull'APE. Utilizzare solo se si è consapevoli di cosa si sta facendo.
/feed/properties/property/features/energy-class/energy-performance[@unit,@type] [es.]
APE: indice di prestazione energetica sul rendimento energetico nell'edilizia (D.M. 26/06/2015)

Può essere espresso in valori multipli purché con @type differenti. Obbligatorio con energy-class/@value diverso da esente
  • Questo nodo è figlio di //energy-class
  • Il suo valore deve essere espresso in kWh/m2anno o in kWh/m3anno; utilizzare il punto per dividere i decimali dalla parte intera (es: 60.5)
L'attributo unit definisce l'unità di misura adottata e può valere:
  • kWh/m2anno
  • kWh/m3anno
L'attributo type indica il tipo di APE; ha i seguenti valori:
  • nren EP da energie non rinnovabili
  • ren EP da energie rinnovabili
  • (ignorato) nel caso di //energy-class/@scale=1 ossia: vecchia IPE

/feed/properties/property/features/energy-class/energy-season[@season,@level] [es.]
Introdotto in accompagnamento all'APE. Rappresenta il livello di efficienza della climatizzazione in base alla stagione dell'anno (estate/inverno). Nel format ufficiale (etichetta) sono rappresentati con tre smile.
L'attributo season definisce l'unità di misura adottata e può valere:
  • summer Estate
  • winter Inverno
L'attributo level indica il livello di efficienza; ha i seguenti valori:
  • low Scarso :(
  • normal Sufficiente :|
  • high Buono :)

/feed/properties/property/features/energy-class/zero [es.]
Introdotto in accompagnamento all'APE. E' un attributo che definisce se l'energia consumata dall'edificio è ridotta al punto di potersi definire 'quasi zero' (near zero energy buildings NZEB). Valori ammessi:
  • Yes
  • No default


NOTA BENE
Questo nodo gestisce le classi energetiche anteriori ad ottobre 2015. Il sistema adottato fino a tale data è ancora utilizzabile ma per la piena compatibilità con le nuove regole è necessaria una struttura differente.
/feed/properties/property/features/energy-class[@scale] [es.]
obosoleto
Classe energetica dell'abitazione.
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica
Obbligatorio, se non presente nella versione più aggiornata.
La classe energetica dipende dall'IPE (vedi energy-performance). A partire dal 1 Luglio 2015 le classi energetiche sono classificate in modo nuovo. L'attributo scale definisce il tipo di regolamentazione in uso in base ai valori:
  • 1 - default
  • 2 - entrata in vigore dal 1 Luglio 2015 (raccomandato)
La nuova scala è così composta:
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
I vecchi valori della classe energetica restano utilizzabili anche se se ne raccomanda l'abbandono.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente

NOTA BENE
Questo nodo gestisce le prestazioni energetiche anteriori ad ottobre 2015. Il sistema adottato fino a tale data è ancora utilizzabile ma per la piena compatibilità con le nuove regole è necessaria una struttura differente, che include ora le prestazioni energetiche nella forma richiesta dalla legge.
/feed/properties/property/features/energy-performance[@certified,@unit] [es.]
obosoleto
IPE: indice di prestazione energetica sul rendimento energetico nell'edilizia (direttiva 2002/91/CE del parlamento europeo del 16 dicembre 2002 attiva dal 01 gennaio 2012)
Obbligatorio con energy-class diverso da esente, se non presente nella versione più aggiornata.
Deve essere espresso in kWh/m2anno o in kWh/m3anno; utilizzare il punto per dividere i decimali dalla parte intera (es: 60.5)

L'attributo unit definisce l'unità di misura adottata e può valere:
  • kWh/m2anno
  • kWh/m3anno
L'attributo certified Opzionale indica se l'IPE è stato certificato; ha i seguenti valori:
  • yes (default)
  • no
ATTENZIONE
il valore no per l'attributo certified pone l'immobile in attesa di certificazione. Esckudendo la pubblicazione di ogni altra informazione sulla classe energetica e sull'IPE. Utilizzare solo se si sa bene cosa si sta facendo.


/feed/properties/property/extra-features [es.] [-]
Nodo contenitore di tutti i nodi che aggiungono dettagli all'annuncio.
Tutti i campi presenti in questa sezione sono opzionali. Per tutti i tag elencati di seguito vale la medesima regola aurea: se vuoti o non presenti risulteranno non definiti. Se non si è certi dell'esistenza o meno di una caratteristica dell'immobile, lo stato di non definito risulta maggiormente auspicabile.
/feed/properties/property/extra-features/bedrooms [es.]
Numero di stanze da letto dell'immobile.

/feed/properties/property/extra-features/bathrooms [es.]
Numero di bagni dell'immobile.

/feed/properties/property/extra-features/garage[@type] [es.]
Numero di Box o posti auto compresi nell'offerta.
L’attributo type indica se si tratta di posti auto o di box privati, i valori consentiti sono:
  • No
  • Box
  • Rimessa posto auto coperto
  • PostoAuto

/feed/properties/property/extra-features/kitchen [es.]
Struttura della cucina.
I valori previsti sono:
  • Abitabile
  • Semi abitabile
  • Cucinotto
  • Angolo cottura

/feed/properties/property/extra-features/heating [es.]
Caratteristiche del riscaldamento dell'immobile.
I valori ammessi sono:
  • Assente
  • Autonomo
  • Centralizzato
  • Teleriscaldamento

/feed/properties/property/extra-features/garden [es.]
Caratteristiche del giardino dell'immobile.
I valori ammessi sono:
  • Privato
  • Comune
  • Nessuno

/feed/properties/property/extra-features/terrace [es.]
Indica se il terrazzo è presente ('Y') o assente ('N').

/feed/properties/property/extra-features/balcony [es.]
Indica se il balcone è presente ('Y') o assente ('N').

/feed/properties/property/extra-features/elevator [es.]
Indica se l'ascensore è presente ('Y') o assente ('N').

/feed/properties/property/extra-features/air-conditioning [es.]
Indica se il condizionatore è presente ('Y') o assente ('N').

/feed/properties/property/extra-features/furniture [es.]
Indica se l'immobile è arredato o meno.
I valori ammessi sono:
  • Arredato
  • Non Arredato
  • Parzialmente Arredato

/feed/properties/property/extra-features/floor[@type] [es.]
Indica il numero di piano (valore numerico) a cui si trova l'immobile.
L'attributo type dovrebbe riferirsi a come l'immobile si affaccia al lato strada ed assume uno dei seguenti valori:
  • Intermedio valore di default
  • Interrato
  • Controterra almeno un lato controterra
  • Seminterrato
  • PianoTerra
  • PianoNobile
  • Rialzato
  • Multipiano su più livelli (con scala, rampa e/o ascensore interni od esterni)
  • Ultimo
  • Attico
  • Edificio intero edificio
Note:
  1. Il sistema accetta che un seminterrato si trovi, per esempio, al secondo piano. La condizione reale che descrive tale situazione è quella di un edificio costruito su un terreno scosceso, che si affacci alla strada a partire dal terzo piano ed abbia i piani inferiori controterra.

/feed/properties/property/extra-features/num-floors [es.]
Numero di piani dello stabile.

/feed/properties/property/extra-features/floorplanner-url [es.]
Url che punta ad una planimetria su floorplanner.com

/feed/properties/property/extra-features/virtual-tour [es.]
L'URL con il link al tour virtuale dell'edificio.
Può essere un file video, un file Flash, una galleria di immagini esterna ad Immobiliare.it ecc.

/feed/properties/property/extra-features/rent-contract [es.]
Tipo di contratto di affitto.
Può avere i seguenti valori:
  • 3+2 (tre anni rinnovabile di due)
  • 4+4 (quattro anni rinnovabile di quattro)
  • 6+6 (sei anni rinnovabile di sei)
  • 9+9 (nove anni rinnovabile di nove)
  • Transitorio
  • Concordato
  • Libero
  • Studenti (da 6 a 36 mesi)

/feed/properties/property/extra-features/additional-costs[@currency] [es.]
v.2.2
Spese mensili aggiuntive da sostenere.

L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".


/feed/properties/property/extra-features/security-alarm [es.]
Indica se è presente ('Y') o assente ('N') un impianto di allarme antifurto.

/feed/properties/property/extra-features/reception [es.]
Indica la presenza ('Y') o meno ('N') del servizio di portineria e reception.

/feed/properties/property/extra-features/net [es.]
Indica la presenza ('Y') o meno ('N') del cablaggio per l'accesso ad Internet.

/feed/properties/property/extra-features/external-area[@unit] [es.]
Dimensione dell'area esterna dell'immobile.
L'attributo unit indica l'unità di misura scelta:
  • m2 metri quadri
  • ha Ettaro (10.000 m2)
  • sft Square feet

/feed/properties/property/extra-features/build-year [es.]
Anno di costruzione, 1000 ≤ build-year ≤ anno corrente

/feed/properties/property/extra-features/free-conditions [es.]
Condizioni necessarie per liberare l'immobile (tipicamente una data)
Campo di testo libero.

/feed/properties/property/extra-features/overhead-crane [es.]
Presenza di un carroponte (per edifici industriali).
Il campo può prendere i seguenti valori:
  • Yes
  • No
  • Ready mensole predisposte per l'installazione

/feed/properties/property/extra-features/beam-height [es.]
Altezza sottotrave (per edifici industriali)

/feed/properties/property/extra-features/office-size[@unit] [es.]
Area riservata agli uffici (per edifici industriali).
L'attributo unit indica l'unità di misura scelta:
  • m2 metri quadri
  • sft Square feet

/feed/properties/property/extra-features/available-now [es.]
Indica se l'immobile è libero subito ('Y') o meno ('N').

ATTENZIONE
il seguente nodo è utilizzabile sono in presenza del tag /feed/properties/property/building/ con valore in costruzione
/feed/properties/property/extra-features/doc-specification [es.]
Url che punta ad un documento Adobe PDF© che contenga il capitolato di costruzione.

ATTENZIONE
il seguente nodo è utilizzabile sono in presenza del tag /feed/properties/property/building/ con valore in costruzione
/feed/properties/property/extra-features/doc-description [es.]
Url che punta ad un documento Adobe PDF© che contenga la descrizione del progetto.

NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Stanze in affitto
/feed/properties/property/extra-features/available-date [es.]
Data a partire dalla quale la stanza è disponibile.
Questa, come tutte le altre date del feed deve essere in formato ISO 8861, come raccomandato dal W3 consortium in tema di interoperabilità sul web.

NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Stanze in affitto
/feed/properties/property/extra-features/minimum-stay [es.]
Numero di mesi di permamenza minima.
Deve essere espresso come numero intero.

NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Stanze in affitto
/feed/properties/property/extra-features/bills-included [es.] [-]
Nodo contenitore delle spese comuni e non.
/feed/properties/property/extra-features/bills-included/powerline [es.]
Indica se le spese relative ai consumi elettrici sono comprese ('Y') o se devono essere considerate a parte ('N').

/feed/properties/property/extra-features/bills-included/gas [es.]
Indica se le spese relative ai consumi del gas per uso civile sono comprese ('Y') o se devono essere considerate a parte ('N').

/feed/properties/property/extra-features/bills-included/phone [es.]
Indica se le spese relative ai consumi telefonici sono comprese ('Y') o se devono essere considerate a parte ('N').

/feed/properties/property/extra-features/bills-included/internet [es.]
Indica se le spese relative all'eventuale connessione ad internet sono comprese ('Y') o se devono essere considerate a parte ('N').


NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Stanze in affitto
/feed/properties/property/extra-features/costs [es.] [-]
Nodo contenitore delle spese extra.
/feed/properties/property/extra-features/costs/services[@currency] [es.]
Costo a forfait mensile dei servizi (vedi anche blocco bills-included).
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".

/feed/properties/property/extra-features/costs/other[@currency] [es.]
Costi aggiuntivi a forfait mensile.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".

/feed/properties/property/extra-features/costs/deposit[@currency] [es.]
Caparra.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".


NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Stanze in affitto
/feed/properties/property/extra-features/flatmate [es.] [-]
Nodo contenitore delle caratteristiche richieste al coinquilino.
/feed/properties/property/extra-features/flatmate/gender [es.]
Sesso del coinquilino: Maschio (Male), Femmina (Female) o Indifferente (DoesntMatter)

/feed/properties/property/extra-features/flatmate/couples [es.]
Indica se sono ammesse coppie: (Y) Sì (N) No, (Any) Indifferente

/feed/properties/property/extra-features/flatmate/smoker [es.]
Indica se sono ammessi fumatori: (Y) Sì (N) No, (Any) Indifferente

/feed/properties/property/extra-features/flatmate/pets [es.]
Indica se sono ammessi animali domestici: (Y) Sì (N) No, (Any) Indifferente

/feed/properties/property/extra-features/flatmate/age[@from,@to] [es.]
Indica un intervanno di età consentita da (from) a (to), entrambe le età devono essere espresse in anni (numeri interi). È anche possibile introdurre solo l'età minima o l'età massima.



/feed/properties/property/auction-features[@type] [es.]
v.2.7
[-]
Nodo contenitore di tutti i nodi relativi alla vendita giudiziaria (disponibile solo per gli immobili all'asta).
L'attributo type può prendere i seguenti valori:
  • Esecuzione immobiliare
  • ... (altro da lookup. Un bel link, magari!)
/feed/properties/property/auction-features/auctions [es.] [-]
Calendario aste.
/feed/properties/property/auction-features/auctions/auction[@type] [es.]
Appuntamento asta. Contiene la data ed ora in cui è fissata l'asta. La data deve essere in formato ISO 8861
L'attributo type può prendere i seguenti valori:
  • con incanto
  • senza incanto
  • a mezzo commissionario
  • vendita al dettaglio
  • vendita online


/feed/properties/property/auction-features/starting-price[@currency] [es.]
Base d'asta
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".

/feed/properties/property/auction-features/minimum-bid[@currency] [es.]
Rilancio minimo. Il rilancio può contenere valori decimali.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".

/feed/properties/property/auction-features/success-price[@currency] [es.]
Offerta minima. Offerta minima da raggiungere per chiudere l'asta con successo.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".

/feed/properties/property/auction-features/court[@type] [es.]
Tribunale Giudiziario o altro ente
L'attributo type può prendere i seguenti valori:
  • court tribunale
  • other altro ente

/feed/properties/property/auction-features/reference[@year] [es.]
Numero pratica
L'attributo year contiene l'anno giudiziario di riferimento.

/feed/properties/property/auction-features/reference[@year] [es.]
Numero pratica

/feed/properties/property/auction-features/actors [es.] [-]
Attori (persone fisiche o giuridiche) coinvolte.
/feed/properties/property/auction-features/actors/actor[@type] [es.] [-]
Attore (persona fisica o giuridica) coinvolta
L'attributo type può prendere i seguenti valori:
  • giudice Giudice curatore
  • delegato
  • custode Custode giudiziario
  • creditore
  • richiedente
  • referente Referente procedura
/feed/properties/property/auction-features/actors/actor/name [es.]
Nome dell'attore

/feed/properties/property/auction-features/actors/actor/phone [es.]
Telefono dell'attore

/feed/properties/property/auction-features/actors/actor/email [es.]
Indirizzo di posta elettronica dell'attore

/feed/properties/property/auction-features/actors/actor/fax [es.]
Fax dell'attore



/feed/properties/property/auction-features/notes [es.]
Note


/feed/properties/property/documents [es.]
v.2.7
[-]
Nodo contenitore dei file di documentazione dell'immobile (disponibile solo per gli immobili all'asta).
Attenzione: attualmente questo container viene gestito solo per gli immobili all'asta (se ne prevede l'estensione ad altre tipologie di annuncio, ma attualmente viene ignorato).
/feed/properties/property/documents/document[@type][@position][@mimetype][@url] [es.]
File di documentazione
L'attributo type può prendere i seguenti valori:
  • ordinanza di vendita
  • avviso di vendita
  • planimetria
  • perizia
  • modalità di partecipazione
  • altro-asta
L'attributo position è un valore intero che definisce l'ordine in cui si vuole presentare un documento rispetto agli altri (numeri bassi in testa)
L'attributo mimetype rappresenta il tipo di file (es. application/pdf). Se non presente viene rilevato dal sistema in base all'estensione del file. L'attributo url è un indirizzo http valido dal quale sia possibile scaricare il documento.


NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Immobili turistici
/feed/properties/property/rates [es.] [-]
Nodo che contiene le tariffe di affitto stagionali.
/feed/properties/property/rates/rate [es.] [-]
Nodo che raccoglie i dati su una tariffa stagionale.
/feed/properties/property/rates/rate/season [es.]
Stagione. Valori ammessi:
  • AA Altissima
  • A Alta
  • M Media
  • B Bassa

/feed/properties/property/rates/rate/begin [es.]
Stagione. Data di inizio. La data deve essere in formato ISO 8861.

/feed/properties/property/rates/rate/end [es.]
Stagione. Data di fine. La data deve essere in formato ISO 8861.

/feed/properties/property/rates/rate/prices [es.] [-]
Nodo che contiene i prezzi di affitto per il periodo descritto nei nodi precedenti.
/feed/properties/property/rates/rate/prices/week[@currency] [es.]
Prezzo per settimana di permanenza
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"

/feed/properties/property/rates/rate/prices/weekend[@currency] [es.]
Prezzo per fine settimana di permanenza
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"

/feed/properties/property/rates/rate/prices/night[@currency] [es.]
Prezzo per singola notte di permanenza
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"


/feed/properties/property/rates/rate/note [es.]
Note.



NOTA BENE
  • Il nodo seguente si applica unicamente alla tipologia Immobili turistici
/feed/properties/property/costs [es.] [-]
Nodo che contiene i costi aggiuntivi di fine villeggiatura.
/feed/properties/property/rates/rate/costs/deposit[@currency] [es.]
Cauzione.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"

/feed/properties/property/rates/rate/costs/services[@currency] [es.]
Costo servizi.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"

/feed/properties/property/rates/rate/costs/cleaning[@currency] [es.]
Costo pulizie.
L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR"


/feed/properties/property/pictures [es.] [-]
Nodo che contiene tutte le immagini dell'immobile
attualmente sono supportate fino a 10 immagini, ma potete indicarne un numero superiore.
/feed/properties/property/pictures/picture[@position,@url] [es.]
v.2.7
Url da cui recuperare la singola immagine. L'attributo "position" indica la posizione relativa in cui deve comparire la foto.

/feed/properties/property/pictures/picture-url[@position] [es.]
obosoleto
Url da cui recuperare la singola immagine. L'attributo "position" indica la posizione relativa in cui deve comparire la foto.


/feed/properties/property/blueprints [es.]
v.2.5
[-]
Nodo che contiene tutte le planimetrie dell'immobile
attualmente sono supportate fino a 4 planimetrie, ma potete indicarne un numero superiore.
/feed/properties/property/blueprints/blueprint[@position,@url] [es.]
Url da cui recuperare la singola planimetria. L'attributo "position" indica la posizione relativa in cui deve comparire l'immagine.


/feed/properties/property/videos [es.] [-]
Nodo che contiene tutti i video collegati al progetto. Si possono caricare un video locale e 4 video su youtube.com.
/feed/properties/property/videos/video[@type] [es.]
Url del video.
L'attributo type puo' assumere i valori "local", se il video deve essere caricato e convertito in formato flash da immobiliare.it, oppure "remote" se il video risiede su un sito dedicato all'hosting dei video. Attualmente sono supportati solo video su youtube.com.



Nuove costruzioni

Di seguito riportiamo la struttura dedicata a progetti di nuova costruzione, che permettono di definire progetti complessi, contenenti varie lottizzazioni; questi progetti verranno importati nella sezione dedicata su immobiliare.it e sul sito dedicato NuoveCostruzioni.it.

/feed/projects [es.]
Intestazione della sezione di progetti di nuove costruzioni

/feed/projects/project[@operation] [es.]
Contenitore del singolo progetto. Obbligatorio
L'attributo operation indica che operazioni si devono effettuare sul progetto:
  • write: Inserisce od aggiorna il progetto.
  • archive: Archivia il progetto; permette una sua successiva ripubblicazione senza doverlo reinserire da zero.
  • delete: Cancella permanentemente il progetto.
/feed/projects/project/unique-id [es.]
Codice identificativo univoco per l'annuncio. Deve essere univoco per la singola agenzia. Di norma va bene il "riferimento agenzia".
Obbligatorio

Questo nodo è essenziale al corretto caricamento degli annunci. Il sistema di importazione si basa su questo id univoco e sull'indirizzo email dell'agenzia per determinare se l'annuncio è nuovo o se è già presente nel nostro database.


/feed/projects/project/date-updated [es.]
Data di ultimo aggiornamento di questo progetto. Determina se il progetto, qualora gia' presente, debba essere aggiornato. La data deve essere in formato ISO 8861. Obbligatorio

Nota bene: sia le modifiche al progetto che ai propri lotti devono aggiornare questo valore.


/feed/projects/project/agent [es.]
Nodo che contiene le informazioni che riguardano il costruttore.
/feed/projects/project/agent/name [es.]
Nome dell'entità proponente il progetto. Obbligatorio

/feed/projects/project/agent/email [es.]
Email dell'agenzia immobiliare; deve corrispondere allo username di tale agenzia/impresa edile su immobiliare.it.
Obbligatorio

Questo nodo è essenziale. Il sistema di importazione si basa su di esso e sull'id univoco unique-id per determinare se l'annuncio è nuovo o se è già presente nel nostro database.


/feed/projects/project/agent/sales-office [es.]
Nodo che contiene le informazioni sull'ufficio vendite. Obbligatorio

/feed/projects/project/agent/sales-office/country-code [es.]
Codice della nazione in formato ISO 3166 (Alpha 2). Obbligatorio

/feed/projects/project/agent/sales-office/administrative-area [es.]
Regione in cui si trova l'ufficio vendite. Bisogna indicare per esteso il nome della regione (es. Lazio, Valle d'Aosta, Emilia Romagna). Obbligatorio

/feed/projects/project/agent/sales-office/sub-administrative-area [es.]
Provincia in cui si trova l'ufficio vendite. Bisogna indicare per esteso il nome della Provincia (es. Roma, Aosta, Piacenza). Obbligatorio

/feed/projects/project/agent/sales-office/city[@code] [es.]
Comune in cui si trova l'ufficio vendite. Bisogna indicare per esteso il nome della Provincia (es. Affile, Aosta, Bobbio). Obbligatorio
Nell'attributo "code" è possibile inserire il codice ISTAT del comune italiano (altamente consigliato).

/feed/projects/project/agent/sales-office/locality [es.]
Nodo che contiene i dettagli per la localizzazione dell'agenzia. Anche se semplificato, rispecchia lo standard interno utilizzato per la localizzazione.

/feed/projects/project/agent/sales-office/locality/thoroughfare [es.]
Indirizzo dell'ufficio vendite per il progetto. Obbligatorio

/feed/projects/project/agent/sales-office/phone [es.]
Numero di telefono fisso per il progetto.

/feed/projects/project/agent/sales-office/mobile [es.]
Numero di telefono cellulare per il progetto


/feed/projects/project/features [es.]
Nodo che contiene le caratteristiche del progetto.
/feed/projects/project/features/building-status [es.]
Descrive lo stato di avanzamento del progetto; è un testo libero

/feed/projects/project/features/start-date [es.]
Data di inizio dei lavori. La data deve essere in formato ISO 8861.

/feed/projects/project/features/end-date [es.]
Data di fine dei lavori. La data deve essere in formato ISO 8861.

/feed/projects/project/features/name [es.]
Denominazione del progetto. Obbligatorio

/feed/projects/project/features/specification [es.]
Url che punta ad un documento Adobe PDF© che contenga il capitolato di costruzione.

/feed/projects/project/features/floorplanner-url [es.]
Url che punta ad una planimetria su floorplanner.com

/feed/projects/project/features/virtual-tour [es.]
L'URL con il link al tour virtuale dell'edificio.

Un file Flash; attualmente sono supportati i virtual tours dei seguenti partners: officecasa.it, suitcasa.com, previsite.net, panora.eu, previsite.com, valurimmobiliare.it, realtourestate.it. Altri virtual tours possono essere ammessi su richiesta e previa approvazione del nostro team web.


/feed/projects/project/features/descriptions [es.] [-]
Nodo contenitore delle descrizioni del progetto in diverse lingue
/feed/projects/project/features/descriptions/description[@language] [es.]
Descrizione del progetto. Obbligatorio

In generale dovrebbe essere limitata a 3000 caratteri. L’attributo language indica la lingua della descrizione, indicata dal codice della nazione in codifica ISO 639-1.



/feed/projects/project/features/energy-class[@scale,@value,@certified] [es.]
v.2.7
[-]
Classe energetica dell'immobile.
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica
Obbligatorio
La classe energetica dipende dall'APE (vedi energy-performance). A partire dal 1 Luglio 2015, obbligatoria da ottobre dello stesso anno, le classi energetiche sono classificate in modo nuovo. L'attributo scale definisce il tipo di regolamentazione in uso in base ai valori:
  • 1 - Certificazione IPE antecedente al 1 Ottobre 2015
  • 2 - default - Certificazione APE (raccomandato)
Si noti che rispetto al vecchio formato la scala di default è ora quella nuova.
L'attributo value, per la nuova scala, può assumere i seguenti valori:
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
I vecchi valori della classe energetica restano utilizzabili anche se se ne raccomanda l'abbandono.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
L'attributo certified Opzionale indica se l'IPE è stato certificato; ha i seguenti valori:
  • yes (default)
  • no
ATTENZIONE
il valore no per l'attributo certified pone l'immobile in attesa di certificazione. Escludendo la pubblicazione di ogni altra informazione sulla classe energetica e sull'APE. Utilizzare solo se si è consapevoli di cosa si sta facendo.
/feed/projects/project/features/energy-class/energy-performance[@unit,@type] [es.]
APE: indice di prestazione energetica sul rendimento energetico nell'edilizia (D.M. 26/06/2015)

Può essere espresso in valori multipli purché con @type differenti. Obbligatorio con energy-class/@value diverso da esente
  • Questo nodo è figlio di //energy-class
  • Il suo valore deve essere espresso in kWh/m2anno o in kWh/m3anno; utilizzare il punto per dividere i decimali dalla parte intera (es: 60.5)
L'attributo unit definisce l'unità di misura adottata e può valere:
  • kWh/m2anno
  • kWh/m3anno
L'attributo type indica il tipo di APE; ha i seguenti valori:
  • nren EP da energie non rinnovabili
  • ren EP da energie rinnovabili
  • (ignorato) nel caso di //energy-class/@scale=1 ossia: vecchia IPE

/feed/projects/project/features/energy-class/energy-season[@season,@level] [es.]
Introdotto in accompagnamento all'APE. Rappresenta il livello di efficienza della climatizzazione in base alla stagione dell'anno (estate/inverno). Nel format ufficiale (etichetta) sono rappresentati con tre smile.
L'attributo season definisce l'unità di misura adottata e può valere:
  • summer Estate
  • winter Inverno
L'attributo level indica il livello di efficienza; ha i seguenti valori:
  • low Scarso :(
  • normal Sufficiente :|
  • high Buono :)


NOTA BENE
Questo nodo gestisce le classi energetiche anteriori ad ottobre 2015. Il sistema adottato fino a tale data è ancora utilizzabile ma per la piena compatibilità con le nuove regole è necessaria una struttura differente.
/feed/projects/project/features/energy-class[@scale] [es.]
obosoleto
Classe energetica dell'abitazione. , se non presente nella versione più aggiornata.
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica
Obbligatorio
La classe energetica dipende dall'IPE (vedi energy-performance). A partire dal 1 Luglio 2015 le classi energetiche sono classificate in modo nuovo. L'attributo scale definisce il tipo di regolamentazione in uso in base ai valori:
  • 1 - default
  • 2 - entrata in vigore dal 1 Luglio 2015 (raccomandato)
La nuova scala è così composta:
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
I vecchi valori della classe energetica restano utilizzabili anche se se ne raccomanda l'abbandono.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente

NOTA BENE
Questo nodo gestisce le prestazioni energetiche anteriori ad ottobre 2015. Il sistema adottato fino a tale data è ancora utilizzabile ma per la piena compatibilità con le nuove regole è necessaria una struttura differente, che include ora le prestazioni energetiche nella forma richiesta dalla legge.
/feed/projects/project/features/energy-performance[@certified,@unit] [es.]
obosoleto
IPE: indice di prestazione energetica sul rendimento energetico nell'edilizia (direttiva 2002/91/CE del parlamento europeo del 16 dicembre 2002 attiva dal 01 gennaio 2012)
Obbligatorio con energy-class diverso da esente, se non presente nella versione più aggiornata.
Deve essere espresso in kWh/m2anno o in kWh/m3anno; utilizzare il punto per dividere i decimali dalla parte intera (es: 60.5)

L'attributo unit definisce l'unità di misura adottata e può valere:
  • kWh/m2anno
  • kWh/m3anno
L'attributo certified Opzionale indica se l'IPE è stato certificato; ha i seguenti valori:
  • yes (default)
  • no
ATTENZIONE
il valore no per l'attributo certified pone l'immobile in attesa di certificazione. Esckudendo la pubblicazione di ogni altra informazione sulla classe energetica e sull'IPE. Utilizzare solo se si sa bene cosa si sta facendo.


/feed/projects/project/features/energy-class[@scale] [es.]
Classe energetica dell'abitazione.
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica
  • il valore default indica la classe energetica G e un valore dell'energy-performance maggiore di 160 o 5 della nuova classificazione
Obbligatorio
La classe energetica dipende dall'IPE (vedi energy-performance). A partire dal 1 Luglio 2015 le classi energetiche sono classificate in modo nuovo. L'attributo scale definisce il tipo di regolamentazione in uso in base ai valori:
  • 1 - default
  • 2 - entrata in vigore dal 1 Luglio 2015 (raccomandato)
La nuova scala è così composta:
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
I vecchi valori della classe energetica restano utilizzabili anche se se ne raccomanda l'abbandono.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente

/feed/projects/project/features/energy-performance[@certified] [es.]
v.2.2
IPE: indice di prestazione energetica sul rendimento energetico nell'edilizia (direttiva 2002/91/CE del parlamento europeo del 16 dicembre 2002 attiva dal 01 gennaio 2012)
Obbligatorio con energy-class diverso da esente e default
Va espresso in kW/mq anno; utilizzare il punto per dividere i decimali dalla parte intera (es: 60.5)

L'attributo certified indica se l'immobile è stato certificato ufficialmente; ha i seguenti valori:
  • yes
  • no


/feed/projects/project/location [es.]
Nodo che contiene le informazioni di geolocalizzazione del progetto. Obbligatorio

Per ottimizzare la geolocazione dei vostri annunci, vi consigliamo di consultare l'XML contenente la nostra struttura di geolocazione.

/feed/projects/project/location/country-code [es.]
Codice della nazione in formato ISO 3166 (Alpha 2). Obbligatorio

/feed/projects/project/location/administrative-area [es.]
Stringa che indica il nome della maggior suddivisione amministrativa della nazione. Obbligatorio

Nel caso dell'Italia, si tratta del nome per esteso della regione (es. Lazio, Valle d'Aosta, Emilia Romagna).


/feed/projects/project/location/sub-administrative-area [es.]
Stringa che indica il nome della successiva suddivisione amministrativa della nazione. Obbligatorio

Nel caso dell'Italia, si tratta del nome per esteso della provincia (es. Roma, Pesaro Urbino, Reggio Calabria).


/feed/projects/project/location/city[@code] [es.]
Stringa che indica il nome del luogo in cui è situato il progetto. Obbligatorio

Nel caso dell'Italia, si tratta del nome per esteso del comune (es. Fornovo Val di Taro, Pesaro, Siracusa). Nell'attributo "code" è possibile inserire il codice ISTAT del comune italiano (altamente consigliato).


/feed/projects/project/location/locality [es.]
/feed/projects/project/location/locality/neighbourhood[@type,@id] [es.]
v.2.2
Nome per esteso della località o della zona della città a cui si riferisce l'annuncio.
Obbligatorio nelle grandi città.
L'attributo "type" puo' assumere i valori:
  • area se si tratta di una zona, ad es. 'Prati'
    • id correlato all'attributo area contiene il geocoding dell'attributo area
      NB: l'attributo è opzionale e sostituisce il nome per esteso della località o della zona della città

  • locality se si tratta di una frazione, ad es. 'Acilia'

Per una lista completa delle nostre aree, potete far riferimento all'XML che contiene il geocoding completo di immobiliare.it.

/feed/projects/project/location/locality/thoroughfare[@display] [es.]
La strada comprensiva di numero civico. Esempio: "Via Ottaviano, 6".

L'attributo display assume valori 'yes' o 'no' e indica se l'indirizzo deve essere mostrato o meno sui siti del network.


/feed/projects/project/location/locality/postal-code [es.]
Codice di avviamento postale per l'annuncio.

/feed/projects/project/location/locality/longitude [es.]
Longitudine dell'annuncio. Obbligatorio

Va espressa in gradi, la divisione dei decimali avviene con un punto, (es 12.7622).


/feed/projects/project/location/locality/latitude [es.]
Latitudine dell'annuncio. Obbligatorio

Va espressa in gradi, la divisione dei decimali avviene con un punto, (es 45.8745).




/feed/projects/project/pictures [es.]
Nodo che contiene tutte le immagini per il progetto
attualmente sono supportate fino a 10 immagini, ma potete tranquillamente indicarne anche un numero maggiore.

/feed/projects/project/pictures/picture-url[@position] [es.]
Url da cui recuperare la singola immagine. L'attributo "position" indica la posizione relativa in cui deve comparire la foto.

/feed/projects/project/videos [es.]
Nodo che contiene tutti i video collegati al progetto. Si possono caricare un video locale e 4 video su youtube.com.

/feed/projects/project/videos/video[@type] [es.]
Url del video.
L'attributo type puo' assumere i valori "local", se il video deve essere caricato e convertito in formato flash da immobiliare.it, oppure "remote" se il video risiede su un sito dedicato all'hosting dei video. Attualmente sono supportati solo video su youtube.com.

/feed/projects/project/lots [es.]
Nodo che contiene le informazioni sui singoli lotti in vendita. Obbligatorio
/feed/projects/project/lots/residential [es.]
Numero totale di lotti residenziali. Obbligatorio

/feed/projects/project/lots/commercial [es.]
Numero totale di lotti a destinazione commerciale. Obbligatorio

/feed/projects/project/lots/lot[@total, @forsale] [es.]
Nodo che descrive il singolo lotto. È obbligatorio inserire almeno un lotto, o il progetto non sara' visualizzabile.

Gli attributi @total e @forsale contengono rispettivamente il numero totale di unità immobiliari ed il numero delle unità immobiliari ancora in vendita.

/feed/projects/project/lots/lot/unique-id [es.]
Identificativo univoco del lotto all'interno del singolo progetto. Obbligatorio

/feed/projects/project/lots/lot/property-type [es.]
Tipologia del lotto in vendita. Obbligatorio
I valori possibili sono:
  • Appartamento
  • Negozio
  • Ufficio
  • Box Auto
  • Villa
  • Villetta
  • Capannone
  • Loft
  • Magazzino

/feed/projects/project/lots/lot/price[@currency] [es.]
Prezzo (minimo) di una unità immobiliare per questo lotto. Obbligatorio

L'attributo currency indica la valuta, nel formato ISO 4217. Esempio: "EUR".


/feed/projects/project/lots/lot/size[@unit] [es.]
Dimensione dell'unità immobiliare. Obbligatorio
L'attributo unit indica l'unità di misura scelta:
  • m2 - metri quadri
  • sft - Square feet

/feed/projects/project/lots/lot/rooms [es.]
Numero di locali del lotto. Obbligatorio

/feed/projects/project/lots/lot/bathrooms [es.]
Numero di bagni del lotto.

/feed/projects/project/lots/lot/floor[@type] [es.]
Indica il numero di piano (valore numerico) a cui si trova l'unità immobiliare.
L'attributo type dovrebbe riferirsi a come l'unità immobiliare si affaccia al lato strada ed assume uno dei seguenti valori:
  • Intermedio (valore di default)
  • Interrato
  • Seminterrato
  • PianoTerra
  • Rialzato
  • Multipiano su più livelli (con scala, rampa e/o ascensore interni od esterni)
  • Ultimo
  • Attico

/feed/projects/project/lots/lot/garage[@type] [es.]
Numero di Box o posti auto compresi nell'offerta.
L’attributo type indica se si tratta di posti auto o di box privati, i valori consentiti sono:
  • No
  • Box
  • PostoAuto

/feed/projects/project/lots/lot/description [es.]
Descrizione - in italiano - dell'unità immobiliare.

/feed/projects/project/lots/lot/specification [es.]
Url che punta ad un documento Adobe PDF© che contenga il capitolato di costruzione specifico per l'unità immobiliare.

/feed/projects/project/lots/lot/pictures [es.]
Nodo che contiene tutte le immagini specifiche per l'unità immobiliare. Il numero massimo accettato è di 5 foto.

/feed/projects/project/lots/lot/pictures/picture-url[@position] [es.]
Url da cui recuperare la singola immagine. L'attributo "position" indica la posizione relativa in cui deve comparire la foto.



Esempio di file XML

Potete scaricare il nostro file XML di esempio come reference per la vostra implementazione del feed.
© 2014 Immobiliare.it S.p.A. a socio unico