Feed per i siti di Gruppo 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, che sono descritte di seguito. La procedura di importazione degli annunci è totalmente automatizzata e permette aggiornamenti giornalieri dell'elenco degli annunci.

Come funziona l'integrazione di un nuovo flusso di annunci

L'integrazione degli annunci avviene ogni notte; il nostro sistema carica tutti i flussi XML inseriti dai partner nelle apposite aree 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

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.2.xsd">

/feed/version [es.]
Il numero di versione del documento XML. Questa pagina tratta la versione 2.2. 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.
  • archive: Archivia 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,@ownership] [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 ownership specifica il tipo di proprietà e può assumere i seguente valori:
  • intera proprietà
  • nuda proprietà
  • parziale proprietà
  • usufrutto
  • multiproprietà
  • diritto di superficie

/feed/properties/property/building[@category,@type,@detail] [es.]
[-]
NOTA BENE
Questo nodo gestisce in modo più ordinato la tipologia immobiliare rispetto alle versioni precedenti.
Se avete già implementato il feed alla versione 2.1 o inferiore non avete bisogno di sostituire i nodi category, property-type e building-status che sono rimasti pienamente retrocompatibili (vedi oltre). Potete quindi ignorare il tag building.
Indica la categoria e la tipologia dell'annuncio Obbligatorio
I valori ammessi dell'attributo category sono:Obbligatorio
  • C: immobile COMMERCIALE;
  • R: immobile RESIDENZIALE;
  • V: casa VACANZE;

L'attributo type (che indica le tipologie) è Obbligatorio
Tipologie di immobili Residenziali:
  • Appartamento
  • Attico
  • Mansarda
  • Garage
  • Casa Indipendente
  • Palazzo
  • Stabile
  • Rustico
  • Casale
  • Villa
  • Villetta a schiera
  • Loft
  • Open Space
  • Multiproprietà
  • Other
Tipologie di immobili Commerciali:
  • Attività
  • Terreno
  • Immobile
Tipologie di immobili Vacanze:
  • Appartamento
  • Casa Indipendente
  • Villa
  • Villetta
  • Multiproprietà
  • Agriturismo
  • Bed and Breakfast
  • Barca
  • Bungalow
  • Chalet
  • Baita
  • Hotel
  • Parco Vacanze
  • Residence
  • Roulotte
  • Rustico
  • Casale
  • Stanza
  • Camera
  • Casa per ferie (gruppi)
  • Other
Per retrocompatibilità la categoria Vacanze accetta anche tutti i valori presenti nella categoria Residenziali, associandole automaticamente alla tipologia più adatta (es. la tipologia Garage, per le case vacanze, finisce in Other). Si invita comunque ad utilizzare unicamente le tipologie in elenco.

L'attributo detail è riservato alla categoria di annunci Commerciali
In base all'attributo type i valori consentiti sono:
  • Attività e/o licenze
    • Centro commerciale
    • Azienda agricola
    • Ristorante
    • Bar
    • Pizzeria
    • Pizza Al Taglio - Pizza al taglio, fast food, Kebab
    • Pub
    • Alimentari
    • Rosticceria
    • Pasticceria
    • Discoteca
    • Hotel
    • Bed and Breakfast
    • Pensione
    • Gelateria
    • Panetteria
    • Altro | Alimentare
    • Negozio
    • Ferramenta
    • Casalinghi
    • Palestra
    • Abbigliamento
    • Estetica / Solarium
    • Parrucchiere uomo/donna
    • Auto officina
    • Videonoleggio
    • Tabaccheria
    • Tintoria
    • Lavanderia
    • Cartoleria
    • Libreria
    • Informatica
    • Telefonia
    • Edicola
    • Altro | Non alimentare
    • Giochi
    • Scommesse
  • Terreno
    • Residenziale - terreno edificabile residenziale
    • Commerciale - terreno edificabile commerciale
    • Industriale - terreno edificabile industriale
    • Agricolo - terreno agricolo o non edificabile
  • Immobile commerciale e/o industriale
    • Capannone
    • Azienda Agricola
    • Garage - Garage / Parcheggio / Autosilos
    • Negozio
    • Ufficio
    • Stabile - Stabile, palazzo
    • Capannone Industriale
    • Casa di cura
    • Magazzino
    • Showroom
    • Scuderia - Stalle e scuderie
    • Stabilimento Balneare
    • Laboratorio
    • Albergo - Alberghi e strutture ricettive
    • Altro

/feed/properties/property/building/terrains [es.]
Nodo che contiene le tipologie dei terreni agricoli (vedi punto precedente). Qualora business-type non valga Agricolo questo campo sarà ignorato dal sistema.

/feed/properties/property/building/terrains/terrain [es.]
Tipo di terreno (solo per i terreni agricoli)
I valori previsti sono:
  • seminativo
  • seminativo irriguo
  • seminativo arborato
  • seminativo arborato irriguo
  • prato
  • prato irriguo
  • prato arborato
  • prato a marcita
  • risaia stabile
  • pascolo
  • pascolo arborato
  • pascolo cespugliato
  • giardino
  • orto
  • orto irriguo
  • agrumeto
  • vigneto
  • uliveto
  • frutteto
  • gelseto
  • colture speciali
  • castagneto da frutto
  • canneto
  • bosco alto fusto
  • bosco ceduo
  • bosco misto
  • incolto produttivo
  • incolto sterile
Sono ammessi tag multipli.

/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:
  • signorile
  • medio
  • economico


ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/
/feed/properties/property/category [es.]
Indica la categoria a cui appartiene l'immobile. Alternativo al tag /building
I valori ammessi sono:
  • C: immobile COMMERCIALE;
  • R: immobile RESIDENZIALE;
  • V: casa VACANZE;

ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/
/feed/properties/property/property-type [es.][-]
Nodo contenitore della tipologia dell'immobile. Alternativo al tag /building
Deve contenere uno ed uno soltanto dei nodi figli qui sotto.
/feed/properties/property/property-type/type [es.]
Riservato agli annunci non commerciali, ovvero alla categoria residenziale e vacanze. Obbligatorio

Tipologie di immobili Residenziali:
  • Appartamento
  • Attico
  • Mansarda
  • Garage
  • Casa Indipendente
  • Palazzo
  • Stabile
  • Rustico
  • Casale
  • Villa
  • Villetta a schiera
  • Loft
  • Open Space
  • Multiproprietà
  • Other
Tipologie di immobili Vacanze:
  • Appartamento
  • Casa Indipendente
  • Villa
  • Villetta
  • Multiproprietà
  • Agriturismo
  • Bed and Breakfast
  • Barca
  • Bungalow
  • Chalet
  • Baita
  • Hotel
  • Parco Vacanze
  • Residence
  • Roulotte
  • Rustico
  • Casale
  • Stanza
  • Camera
  • Casa per ferie (gruppi)
  • Other
Per retrocompatibilità la categoria Vacanze accetta anche tutti i valori presenti nella categoria Residenziali, associandole automaticamente alla tipologia più adatta (es. la tipologia Garage, per le case vacanze, finisce in Other). Si invita comunque ad utilizzare unicamente le tipologie in elenco.

ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/
/feed/properties/property/property-type/business-type[@category] [es.][-]
Riservato alla categoria di annunci Commerciali Alternativo al tag /building
L'attributo category può valere:
  • Attività
  • Terreno
  • Immobile
In base all'attributo category i valori consentiti sono:
  • Attività e/o licenze
    • Centro commerciale
    • Azienda agricola
    • Ristorante
    • Bar
    • Pizzeria
    • Pizza Al Taglio - Pizza al taglio, fast food, Kebab
    • Pub
    • Alimentari
    • Rosticceria
    • Pasticceria
    • Discoteca
    • Hotel
    • Bed and Breakfast
    • Pensione
    • Gelateria
    • Panetteria
    • Altro | Alimentare
    • Negozio
    • Ferramenta
    • Casalinghi
    • Palestra
    • Abbigliamento
    • Estetica / Solarium
    • Parrucchiere uomo/donna
    • Auto officina
    • Videonoleggio
    • Tabaccheria
    • Tintoria
    • Lavanderia
    • Cartoleria
    • Libreria
    • Informatica
    • Telefonia
    • Edicola
    • Altro | Non alimentare
    • Giochi
    • Scommesse
  • Terreno
    • Residenziale - terreno edificabile residenziale
    • Commerciale - terreno edificabile commerciale
    • Industriale - terreno edificabile industriale
    • Agricolo - terreno agricolo o non edificabile
  • Immobile commerciale e/o industriale
    • Capannone
    • Azienda Agricola
    • Garage - Garage / Parcheggio / Autosilos
    • Negozio
    • Ufficio
    • Stabile - Stabile, palazzo
    • Capannone Industriale
    • Casa di cura
    • Magazzino
    • Showroom
    • Scuderia - Stalle e scuderie
    • Stabilimento Balneare
    • Laboratorio
    • Albergo - Alberghi e strutture ricettive
    • Altro

ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/terrains
/feed/properties/property/property-type/terrains [es.]
Nodo che contiene le tipologie dei terreni agricoli (vedi punto precedente). Qualora business-type non valga Agricolo questo campo sarà ignorato dal sistema.

ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/terrains/terrain
/feed/properties/property/property-type/terrains/terrain [es.]
Tipo di terreno (solo per i terreni agricoli)
I valori previsti sono:
  • seminativo
  • seminativo irriguo
  • seminativo arborato
  • seminativo arborato irriguo
  • prato
  • prato irriguo
  • prato arborato
  • prato a marcita
  • risaia stabile
  • pascolo
  • pascolo arborato
  • pascolo cespugliato
  • giardino
  • orto
  • orto irriguo
  • agrumeto
  • vigneto
  • uliveto
  • frutteto
  • gelseto
  • colture speciali
  • castagneto da frutto
  • canneto
  • bosco alto fusto
  • bosco ceduo
  • bosco misto
  • incolto produttivo
  • incolto sterile
Sono ammessi tag multipli.

ATTENZIONE
nodo obsoleto rimasto attivo per retrocompatibilità: sostituito da /feed/properties/property/building/status
/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/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).

/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.]
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'

  • district se si tratta di una zona come riportata su immobiliare.it, ad es. 'Prati - Borgo' - Deprecato

Per una lista completa delle nostre zone, 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, se sono state fornite le coordinate (i 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).

/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).


/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. Obbligatorio
L'attributo unit indica l'unità di misura scelta:
  • m2 - metri quadri
  • sft - Square feet

/feed/properties/property/features/price[@currency,@reserved] [es.]
Prezzo dell'immobile. Obbligatorio
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.

/feed/properties/property/features/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 [es.]
Classe energetica dell'abitazione. Obbligatorio
La classe energetica dipende dall'IPE (vedi energy-performance). Le fasce variano da comune a comune.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
NOTA BENE
  • il valore esente (sotto la responsabilità dell'agenzia) indica un immobile non soggetto all'obbligo di certificazione energetica

/feed/properties/property/features/energy-performance[@certified,@unit] [es.]
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
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


/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.]
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

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.

/feed/properties/property/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/properties/property/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/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/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/properties/property/features/energy-class [es.]
Classe energetica dell'abitazione. Obbligatorio
La classe energetica dipende dall'IPE (vedi energy-performance). Le fasce variano da comune a comune.
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • esente
  • default
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

/feed/properties/property/features/energy-performance[@certified] [es.]
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.]
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'

  • district se si tratta di una zona come riportata su immobiliare.it, ad es. 'Prati - Borgo' - Deprecato

Per una lista completa delle nostre zone, 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.