Documentation | Feed Export Annunci

feed

Nodo radice del feed

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	metadata	publisher		1	Descrive il feed aggiungendo alcuni metadati
	properties	properties			Contiene l'elenco degli annunci attivi

publisher

Descrive il feed aggiungendo alcuni metadati

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo	max	descrizione
name	string		Il sito da cui provengono gli annunci
version	string	1	La versione del feed in uso
site	string		Base url del sito da cui provengono gli annunci
email	emailType		Contatto tecnico di riferimento
phone	string		Contatto tecnico di riferimento
build-date	boundedDateType		La data di generazione del feed

transactions

Descrive la lista dei contratti dell'annuncio. Opzionalmente è possibile un contratto di affitto alternativo oltre a quello di vendita.

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	transaction	transaction	required	2

transaction

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	price	priceType	required	1	Il prezzo di vendita o affitto del'immobile
@	type	saleOrRent	required	1	Descrive il tipo di contratto con cui viene proposto l'immobile nell'annuncio
@	auction	boolean		1	Specifica se l'annuncio descrive un immobile all'asta o meno
@	for-revenue	boolean		1	Specifica se l'immobile è indicato come investimento
@	on-redeem	boolean		1	Specifica se l'immobile è disponibile con la formula 'affitto con riscatto'
@	ownership	ownershipType		1	Descrive il titolo di possesso con cui viene proposto l'immobile

buildingType

Tipo: string

Descrive la tipologia immobiliare

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	id	string		1	L'id univoco della tipologia immobiliare. Vedere tabella di riferimento

building

Descrive le tipologie dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo		max	descrizione
type	buildingType	required	1	Descrive la tipologia immobiliare
status	status		1	Stato di conservazione dell'immobile
building-class	building-class		1	Descrive la classe immobiliare

locationStructure

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo		max	descrizione
country-code	country-code	required	1	Il codice (2 caratteri) della nazione in cui si trova l'immobile. Formato ISO 3166 (Alpha 2)
administrative-area	string			Il nome della regione in cui si trova l'immobile
sub-administrative-area	sub-administrative-area			Il nome della provincia in cui si trova l'immobile
city	city	required	1	Il nome della città in cui si trova la risorsa
locality	locality			Contiene i dettagli geografici della risorsa

sub-administrative-area

Tipo: string

Il nome della provincia in cui si trova l'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	code	string		1	Il codice identificativo dell'area amministrativa. Per le località italiane corrisponde sempre alla sigla della provincia

city

Tipo: string

Il nome della città in cui si trova la risorsa

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	code	string		1	Codice identificativo della località. Per le città Italiane è il codice ISTAT.

locality

Contiene i dettagli geografici della risorsa

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo	max	descrizione
	neighbourhood	string	1	Nome del quartiere o zona
	thoroughfare	thoroughfare	1	Indirizzo in cui si trova la risorsa
	postal-code	string	1	Valore del codice postale
	latitude	double	1	La latitudine in cui è localizzata la risorsa
	longitude	double	1	La longitudine in cui è localizzata la risorsa
@	map	map-type	1	Modalità di visualizzazione dell'elemento sulla mappa.

thoroughfare

Tipo: string

Indirizzo in cui si trova la risorsa

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	display	boolean	required	1	Indica se è possibile pubblicare l'indirizzo

sizeType

Tipo: long

Descrive la superficie dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	unit			1	Unità di misura in cui viene espressa la superficie. Per questo feed è sempre m2

landSizeType

Tipo: long

Descrive la superficie esterna dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	unit			1	Unità di misura in cui viene espressa la superficie. Per questo feed è sempre m2

priceType

Tipo: long

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	currency	string	required	1	La valuta in cui viene espresso il prezzo. Per questo tipo di feed è sempre EUR
@	display	boolean	required	1	Booleano che indica se è possibile pubblicare il prezzo o meno

langtxt

Tipo: string

La lingua in cui è espresso il testo. Codifica ISO 639-1.

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	language	langcode		1	Descrive la lista delle lingue ammesse. Codifica ISO 639-1.

description

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	title	string		1	Breve titolo descrittivo dell'annuncio
	content	string	required	1	Descrizione testuale dell'annuncio
@	language	langcode	required	1	La lingua della della descrizione

box

Tipo: int

Descrive il tipo ed il numero di box auto dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	type	string		1	I seguenti valori sono ammessi: No No Box Box PostoAuto Posto auto

floor

Tipo: nullInteger

Descrive il numero ed il tipo di piano a cui l'immobile si trova

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	type	string		1	I seguenti valori sono ammessi: Intermedio Intermedio Interrato Interrato Controterra Controterra Seminterrato Seminterrato PianoTerra Piano terra Rialzato Rialzato PianoNobile Piano nobile Multipiano Multipiano Ultimo Ultimo Attico Attico Edificio Edificio

classEnergy

Descrive la classe energetica dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo	max	descrizione
	energy-performance	energy-performance	no limit	Indice di prestazione energetica
	energy-season	energy-season	no limit	Introdotto in accompagnamento all'APE. Rappresenta il livello di efficienza della climatizzazione in base alla stagione dell'anno (estate/inverno)
@	zero	boolean	1	Indica se l'edificio è a dispersione energetica 0
@	scale	energy-scale	1	Definisce il tipo di regolamentazione energetica in uso. Il tipo APE si riferisce alla legge entrata in vigore il 1 Luglio 2015
@	value	string	1	I valori relativi all'indice di prestazione energetica
@	certified	boolean	1	Indica se l'immobile è stato certificato o è ancora in stato di attesa della certificazione

energy-performance

Tipo: double

Indice di prestazione energetica

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	unit	string	required	1	I seguenti valori sono ammessi: kWh/m2anno kWh/m2/anno kWh/m3anno kWh/m3/anno
@	type	string	required	1	Indica il tipo di APE specificando se l'indice deriva da energie rinnovabili (ren) o meno (nren)

energy-season

Introdotto in accompagnamento all'APE. Rappresenta il livello di efficienza della climatizzazione in base alla stagione dell'anno (estate/inverno)

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	season	string		1	I seguenti valori sono ammessi: summer winter
@	level	string		1	I seguenti valori sono ammessi: low normal high

additionalCostsType

Tipo: double

Costi aggiuntivi. Es. spese condominialiAdditional costs (e.g. building expenses)

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	currency	string	required	1	La valuta con cui sono espressi i costi. Per questo feed è sempre EUR

features-property

Contiene le principali caratteristiche che descrivono l'immobileMain characteristics of the property

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo		max	descrizione
rooms	int			Il numero di stanze dell'immobile
size	sizeType		1	Descrive la superficie dell'immobile
descriptions	descriptions		1	Contiene l'elenco delle descrizioni dell'annuncio
energy-class	classEnergy	required		Descrive la classe energetica dell'immobile

descriptions

Contiene l'elenco delle descrizioni dell'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	description	description	required	no limit

properties

Contiene l'elenco degli annunci attivi

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	property	property		no limit	Un annuncio attivo

agent

Descrive l'agenzia immobiliare che pubblica l'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	name	string		1	Il nome dell'agenzia
	email	pmailType	required	1	Proxy mail dell'agenzia, da usare esclusivamente per comunicazioni di carattere commerciale destinate all'agenzia e NON per l'invio dei lead.
	phone	string		1	Il numero di telefono fisso dell'agenzia
	phone2	string		1	Il numero di telefono secondario dell'agenzia
	mobile-phone	string		1	Il numero di telefono cellulare dell'agenzia
	fax	string		1	Il numero di fax dell'agenzia
	description	langtxt			Testo descrittivo dell'agenzia
	location	locationStructure		1	Contiene i riferimenti geografici dell'agenzia
	logo	string		1	Url da cui scaricare il logo dell'agenzia
	target-account	string		1	Codice identificativo dell'agenzia da utilizzare nel flusso di integrazione
	extra	agent-extra		1	Dati aggiuntivi relativi all'agenzia
@	id	long	required	1	Identificativo univoco dell'agenzia
@	date-updated	dateTime		1	Data di aggiornamento dell'agenzia
@	group	string		1
@	watermark	boolean		1

property

Descrive un annuncio pubblicato

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	internal-reference	string	required	1	Codice di riferimento dell'annuncio. Nb. Questo NON è il codice univoco dell'annuncio, usare l'attributo ID per questo scopo
	published-on	boundedDateType		1	La data di pubblicazione dell'annuncio
	date-updated	boundedDateType		1	La data di ultima modifica dell'annuncio
	agent	agent	required	1	L'agenzia immobiliare che pubblica l'annuncio
	location	locationStructure	required	1	Contiene i riferimenti geografici dell'annuncio
	pictures	pictures		1	Le immagini dell'annuncio
	videos	videos		1	I video dell'annuncio
@	ID	long	required	1	Il codice identificativo univoco dell'annuncio
	transactions	transactions		1	Descrive la lista dei contratti dell'annuncio
	building	building	required	1	Descrive le tipologie dell'immobile
	features	features-property	required	1	Descrive le caratteristiche dettagliate dell'annuncio
	extra-features	extra-features		1	Descrive le caratteristiche dettagliate aggiuntive dell'annuncio
	documents	documents		1	I documenti dell'annuncio
	blueprints	blueprints		1	Le planimetrie dell'annuncio
	extended	extended		1
	site-url	anyURI		1	Url al dettaglio annuncio su immobiliare.it
	contact-email	pmailType		1	Proxy mail a cui inoltrare il contatto (lead)

agent-extra

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo	max	descrizione
original-email-hash	original-email-hash	1	Deprecato. Hash dell'email originale dell'agenzia
code	string	1	Codice di riferimento interno
original-email	emailType	1	Deprecato. Email originale dell'agenzia

original-email-hash

Tipo: string

Deprecato. Hash dell'email originale dell'agenzia

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	algorithm	hash-algorithm	required	1

blueprints

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	blueprint	picture		no limit	Riferimento ad una planimetria

extra-features

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo	max	descrizione
bedrooms	int		Il numero di camere da letto
bathrooms	int		Il numero di bagni
garage	box		Numero e tipo di box auto
kitchen	kitchen		Il tipo di cucina dell'immobile
garden	garden		Descrive il tipo di giardino dell'immobile
terrace	boolean		Specifica se l'immobile è provvisto di una terrazza
balcony	boolean		Specifica se l'immobile è provvisto di uno o più balconi
elevator	boolean		Specifica se l'immobile è provvisto di ascensore
floor	floor		Descrive il numero ed il tipo di piano a cui l'immobile si trova
num-floors	int		Specifica il numero di piani dell'edificio
available-now	boolean		Specifica se l'immobile è immediatamente disponibile
virtual-tour	string		La url con cui accedere al virtual tour
rent-contract	rental		Descrive il tipo di contratto di affitto con cui l'immobile viene proposto
additional-costs	additionalCostsType		Costi aggiuntivi. Es. spese condominialiAdditional costs (e.g. building expenses)
additional-heating-costs	additionalCostsType		Costi aggiuntivi. Es. spese condominialiAdditional costs (e.g. building expenses)
furniture	furniture		Specifica se l'immobile è arredato
security-alarm	boolean		Specifica se l'immobile è provvisto di impianto di allarme
reception	boolean		Specifica se l'immobile è provvisto di una reception o portineria
net	boolean		Presenza o meno della cablatura di rete
external-area	landSizeType		Descrive la superficie esterna dell'immobile
build-year	year		L'anno di costruzione dell'immobile
doc-specification	string
doc-description	string
free-conditions	free-conditions		Condizioni necessarie per liberare l'immobile
available-date	boundedDateType		Specifica la data a partire dalla quale l'immobile sarà disponibile
minimum-stay	int		Periodo minimo di permanenza nell'immobile, in mesi
bills-included		1
costs		1
flatmate		1
sleeping-accommodation	int	1
ambience	ambience		Descrive le caratteristiche legate a condizionamento e riscaldamento dell'immobile
luxury	boolean

free-conditions

Tipo: string

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	free	boolean		1

ambience

Descrive le caratteristiche legate a condizionamento e riscaldamento dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	heating	heating		1	Descrive l'impianto di riscaldamento dell'immobile
	air-conditioning	air-conditioning		1	Descrive l'impianto di condizionamento dell'immobile

heating

Descrive l'impianto di riscaldamento dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo	max	descrizione
	system	string		I seguenti valori sono ammessi: a radiatori A radiatori a pavimento A pavimento ad aria Ad aria a stufa A stufa
	source	heating-source		Tipo di fonte di riscaldamento
@	type	heat	1	Descrive il tipo di impianto di riscaldamento dell'immobile

air-conditioning

Descrive l'impianto di condizionamento dell'immobile

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	effect	airConditioningEffectType			Tipo di impianto di condizionamento
@	type	airConditioningType		1	Sistema di impianto di condizionamento

videos

La lista dei video dell'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	video	video	required	5	Url del video relativo all'annuncio

video

Tipo: string

Url del video relativo all'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	type	string		1	I seguenti valori sono ammessi: local remote

documents

Lista di documenti allegati all'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	document	document	required	no limit	Descrive un documento allegato all'annuncio

document

Tipo: string

Descrive un documento allegato all'annuncio

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo	max	descrizione
@	position	int	1	Rappresenta l'ordine con cui presentare le risorse
@	mimetype	string	1	Il tipo MIME del documento allegato. es. 'application/pdf'
@	url	anyURI	1	La url da cui scaricare la risorsa

pictures

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	picture	picture	required	no limit	Riferimento ad una immagine, il testo contenuto nell'elemento rappresenta la didascalia dell'immagine, per la url vedere l'attributo url

picture

Tipo: string

Riferimento ad una immagine, il testo contenuto nell'elemento rappresenta la didascalia dell'immagine, per la url vedere l'attributo url

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	id	long		1
@	position	int		1	Rappresenta l'ordine con cui presentare le risorse
@	url	string	required	1	La url da cui scaricare la risorsa
@	etag	string		1	etag dell'immagine
@	thumb-s	string		1	La url della thumb in formato 'small' da cui scaricare la risorsa
@	thumb-m	string		1	La url della thumb in formato 'medium' da cui scaricare la risorsa
@	thumb-xl	string		1	La url della thumb in formato 'extra large' da cui scaricare la risorsa
@	cdn-template	string		1	Il template da utilizzare per ottenere l'immagine dalla cdn

extended

I seguenti elementi/attributi sono attesi in questa sezione

nome	tipo	max
amount-parking	int	1
amount-terrace	int	1
amount-balcony	int	1
inner-exposition	boolean	1
outer-exposition	boolean	1
entrance	boolean	1
closet	boolean	1
basement	boolean	1
penthouse	boolean	1
tavern	boolean	1
fireplace	boolean	1
security-door	boolean	1
tub	boolean	1
security-alarm	boolean	1
swimming-pool	boolean	1
tennis	boolean	1
electric-gate	boolean	1
optical-fiber	boolean	1
concierge	boolean	1
video-intercom	boolean	1
external-frames	external-frames	1
tv	tv	1
registry	registry	1
sharable	boolean	1
certified	boolean	1
building-site-status	string	1
ranking	int	1
visibility	advert-visibility	1

external-frames

Tipo: external-frames-value

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	id	external-frames-id-value	required	1

tv

Tipo: tv-value

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
@	id	tv-id-value	required	1

registry

I seguenti elementi/attributi sono attesi in questa sezione

	nome	tipo		max	descrizione
	income
@	class	string		1	I seguenti valori sono ammessi: A/1 A/2 A/3 A/4 A/5 A/6 A/7 A/8 A/9 A/10 A/11 B/1 B/2 B/3 B/4 B/5 B/6 B/7 B/8 C/1 C/2 C/3 C/4 C/5 C/6 C/7 D/1 D/2 D/3 D/4 D/5 D/6 D/7 D/8 D/9 D/10 D/11 D/12 E/1 E/2 E/3 E/4 E/5 E/6 E/7 E/8 E/9 F/1 F/2 F/3 F/4 F/5 F/6 T