Feed XML formato Trovit Case

Struttura XML Trovit Casa standard

Se sei gi� in possesso di un Feed Case di Trovit puoi inviarci il link con il feed che importeremo con cadenza giornaliera. Il Feed Trovit per come � strutturato � mono agenzia. Puoi trovare le specifiche del feed al seguente link: Feed Trovit Case.

Vi preghiamo di prestare particolare attenzione al tag <eco_score> con le informazioni sulla prestazione energetica dell'immobile, Vi rimandiamo alla sezione ecoscore per maggiori dettagli.

Struttura XML Trovit con adeguamento Multi agenzia

Nel caso di Portali o Gestionali con pi� di un agenzia � possibile indicarle nel feed con poche semplici modifiche. Queste sono le istruzioni per generare un feed XML con il fine di includere le tue offerte su CercasiCasa.it. La codifica del feed deve essere in UTF-8. L'archivio XML conterrà una etichetta principale <trovit> che raccoglierà un insieme di agenzie immobiliari racchiuse tra i tag <agency></agency> e di annunci rappresentati dai tag <ad></ad>. Questa modifica si rende necessaria nel caso si voglia importare pi� agenzie con un singolo file XML.

Struttura semplificata con alberatura del feed XML, in rosso le informazioni obbligatorie:

<?xml version="1.0" encoding="UTF-8"?>
<trovit>
	<agency id="1">...</agency>
	<agency id="2">...</agency>
	<ad><agency id="1"/>...</ad>
	<ad><agency id="1"/>...</ad>
	<ad><agency id="2"/>...</ad>
	<ad><agency id="2"/>...</ad>
</trovit>
	

Gli annunci <ad>, dovranno essere collegati all'agenzia tramite l'attributo agency id.

Formato esteso del Feed XML nel caso di una sola agenzia, in rosso le informazioni aggiuntive rispetto il formato Trovit:

<?xml version="1.0" encoding="UTF-8" ?>
<trovit>               
	<agency id="1">
	<name><![CDATA[Agenzia1]]></name>
	<city><![CDATA[Roma]]></city>
	<country><![CDATA[Italia]]></country>
	<address><![CDATA[via dante 1]]></address>
	<postcode><![CDATA[00100]]></postcode>
	<telephone><![CDATA[0633333333]]></telephone>
	<email><![CDATA[[email protected]]]></email>
	<password><![CDATA[]]></password>
	<url><![CDATA[www.agenzia1.it]]></url>
	<logo><![CDATA[http://www.agenzia1.it/logo.png]]></logo>
	<content><![CDATA[Agenzia immobiliare 1 .......]]></content>
	<vat><![CDATA[11111111111]]></vat>
	</agency>                    
                    
	<ad>	
	<id><![CDATA[3936]]></id>
	<url><![CDATA[http://www.tuacasa.net/modules.php?name=News&file=article&sid=3936]]></url>
	<title><![CDATA[LAVINIO (zona CENTRO ECUMENICO) - VILLINO IN PLURIFAMILIARE UNILIVELLO piano terra]]></title>
	<type><![CDATA[For Sale]]></type>	
	<category><![CDATA[residential]]></category>
	<agency id="1"></agency>
	<content><![CDATA[Descrizione 3936..]]></content>
	<price><![CDATA[125000.00]]></price>
	<property_type><![CDATA[Appartamento]]></property_type>
	<floor_area unit="meters"><![CDATA[50]]></floor_area>
	<city><![CDATA[Anzio]]></city>
	<region><![CDATA[LAZIO]]></region>
	<pictures>
	<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/1.jpg]]></picture_url></picture>
	<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/2.jpg]]></picture_url></picture>
	<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/3.jpg]]></picture_url></picture>
	</pictures>
	<date><![CDATA[02/01/2012]]></date>
	<time><![CDATA[ 18:46:10]]></time>
	<eco_score>D-110.00-kwh/m2 p.a.</eco_score>
	<latitude><![CDATA[41.409583]]></latitude>
	<longitude><![CDATA[2.187223]]></longitude>
	</ad>
</trovit>

Informazioni Aggiuntive

Per importare gli annunci utilizzando i formato TROVIT vi chiediamo di aggiungere le informazioni relative alle agenzie indicate dal tag <agency id="1">...</agency>. Potranno essere utilizzati uno o più tag <agency> in base al numero di agenzie, l'importate è distinguerle con l'attributo id presente nel tag. L'attributo id dovrà identificare l'agenzia in maniera univoca senza mai cambiare, accettiamo anche valori alfanumerici.

Requisiti che occorre soddisfare per un corretto caricamento degli annunci

• Tenere aggiornato il file con cadenza giornaliera.
• Attivare uno share Ftp per lo scaricamento del file. In alternativa possiamo noi creare uno share per la deposizione dello stesso.
• Il file deve avere sempre lo stesso nome, se già presente deve essere sovrascritto.
• E' consigliabile comprimere il file per ridurre i tempi di caricamento preferibilmente in formato gz o zip.
• Il file deve sempre contenere tutti le agenzie e gli annunci validi. Le agenzie e gli annunci non presenti nel file verranno rimossi.
• Non inserite la stessa agenzia più volte.

I campi contrassegnati sono obbligatori.

Descrizione dati Agenzia:

<name><![CDATA[Agenzia1]]></name>
Il tag name è obbligatorio e racchiude la ragione sociale dell'agenzia.

<city><![CDATA[Roma]]></city>
Il tag city è obbligatorio ed indica la città dove risiede l'agenzia.

<country><![CDATA[Italia]]></country>
Il tag country è obbligatorio ed indica la nazione dove risiede l'agenzia.

<address><![CDATA[via dante 1]]></address>
Il tag address è facoltativo ed indica la via dove risiede l'agenzia.

<postcode><![CDATA[00100]]></postcode>
Il tag postcode è facoltativo ed indica in CAP di residenza dell'agenzia.

<telephone><![CDATA[0633333333]]></telephone>
Il tag telephone è facoltativo ed indica il numero di telefono dell'agenzia.

<email><![CDATA[[email protected]]]></email>
Il tag email è obbligatorio ed indica l'indirizzo di posta elettronica dell'agenzia.

<password><![CDATA[]]></password>
Il tag password è facoltativo ed indica la password per accedere a nostro panello di controllo, nel caso in cui non fosse indicata verrà generata in automatico.

<url><![CDATA[www.agenzia1.it]]></url>
Il tag url è facoltativo ed indica l'indirizzo del sito web dell'agenzia.

<logo><![CDTA[http://www.agenzia1.it/logo.png]]></logo>
Il tag logo è facoltativo ed indica a foto o il logo dell'agenzia.

<content><![CDATA[Agenzia immobiliare 1 .......]]></content>
Il tag content è facoltativo ed permette di indicare una piccola descrizione dell'agenzia.

<vat><![CDATA[11111111111]]></vat>
Il tag vat è facoltativo e permette di indicare la Partita IVA dell'agenzia.

Descrizione dati degli Immobili.

<id><![CDATA[3936]]></id>
Il tag id è obbligatorio ed indica l'identificativo univoco dell'annuncio immobiliare. Sono ammessi anche valori alfanumerici.

<reference><![CDATA[Rif123]]></reference>
Il tag reference è facoltativo ed indica il riferimento dell'annuncio da parte dell'agenzia. Sono ammessi valori alfanumerici.

<url><![CDATA[http://www.tuacasa.net/modules.php?name=News&file=article&sid=3936]]></url>
Il tag url è facoltativo ed indica l'indirizzo web dove risiede l'annuncio originale.

<title><![CDATA[LAVINIO - Villino plurifamiliare unilivello piano terra]]></title>
Il tag title è facoltativo ed indica il titolo dell'annuncio. In caso non venisse indicato verrà generato in automatico con le informazione disponibili.

<type><![CDATA[For Sale]]></type>
Il tag type è obbligatorio ed indica il tipo di annuncio.
I valori ammessi sono:

• For Rent: Immobile in affitto (per un periodo significativamente largo)
• For Sale: Immobile in vendita
Valori lasciati per retro compatibilità

• Roommate: Stanza in affitto
• Parking for Rent: Parking in affitto
• Parking for Sale: Parking in vendita
• Office For Rent: Ufficio in affitto
• Office For Sale: Ufficio in vendita
• Land For Sale: Terreno
• Transfer Local: Cambio di gestione
• For Rent Local: Locale in affitto
• For Sale Local: Locale in vendita
• Country House Rentals: Casa di campagna in affitto
• Warehouse For Rent: Magazzino in affitto
• Warehouse For Sale: Magazzino in vendita

<category><![CDATA[residential]]></category>
Il tag category è obbligatorio ed indica la destinazione d'uso dell'immobile.
I valori ammessi sono:

• residential: Residenziale
• commercial: Commerciale
• holiday: Affitto Vacanze, B&B, Albergo, Hotel. Ammesso solo per il tag <type> For Rent.

<agency id="1"></agency>
L'attributo id presente nel tag agency è obbligatorio e rappresenta l'identificativo che si ricollega all'id presente all'interno del tag <agency>. In questo modo sarà possibile associare più annunci alla stessa agenzia.

<content><![CDATA[Descrizione 3936..]]></content>
Il tag content è obbligatorio e rappresenta la descrizione dell'annuncio.

<price period="weekly"><![CDATA[125000.00]]></price<
Il tag price è facoltativo ed indica il prezzo dell'annuncio. In caso di affitto può essere specificato uno dei seguenti periodi:
• monthly
• daily
• weekly

<property_type><![CDATA[APP]]></property_type>
Il tag property_type è obbligatorio ed indica la tipologia dell'immobile.
Elenco delle tipologie:
• AGR - Agriturismo
• ALB - Albergo-Hotel
• ALT - Altro
• APP - Appartamento
• ATT - Attico-Mansarda
• ATC - Attività Commerciale
• AZA - Azienda Agricola
• BCT - Baita-Chalet-Trullo
• BAR - Bar
• BAB - Bed and Breakfast
• BIL - Bilocale
• BOX - Box-Posto Auto
• CDA - Camera d'Albergo
• CAP - Capannone
• CIN - Casa Indipendente
• CSI - Casa Semi indipendente
• CVA - Casa Vacanze
• CBI - Casa Bifamiliare
• CTR - Casa Trifamiliare
• CQU - Casa Quadrifamiliare
• CAS - Castello
• COI - Complesso Industriale
• DEM - Deposito-Magazzino
• DIS - Discoteca
• ESP - Edificio-Stabile-Palazzo
• LAB - Laboratorio
• LIC - Licenza
• LCO - Locale Commerciale
• LOS - Loft-Open Space
• MAG - Magazzino
• MON - Monolocale
• MUL - Multiproprietè
• NEG - Negozio
• STA - Stanza
• RES - Residence
• RIS - Ristorante
• RCC - Rustico-Casale-Corte
• SEM - Seminterrato
• SRO - Show Room
• TER - Terreno
• UFF - Ufficio
• VIL - Villa
• VIB - Villa Bifamiliare
• VTR - Villa Trifamiliare
• VQU - Villa QuadriFamiliare
• VSC - Villa a Schiera
• VSI - Villa Singola

<floor_area unit="meters"><![CDATA[50]]></floor_area>
Il tag floor_area è facoltativo ed indica la superficie, attualmente supportiamo solo l'attributo "meters".

<floor_number>0</floor_number>
Il tag floor_number è facoltativo ed indica il piano, sono ammessi i seguenti valori:

• -2 = "Interrato"
• -1 = "Seminterrato"
• 0 = "Terra"
• 1 = "Primo"
• 2 = "Secondo"
• 3 = "Terzo"
• 4 = "Quarto"
• 5 = "Quinto"
• 6 = "Sesto"
• 7 = "Settimo"
• 8 = ">Settimo"
• a = "Attico"
• s = "Superattico"
• r = "Rialzato"
• u = "Ultimo"

<address><![CDATA[via dante 1]]></address>
Il tag address è facoltativo ed indica la via dove risiede l'immobile.

<city><![CDATA[Anzio]]></city>
Il tag city è obbligatorio ed indica la città dell'annuncio.

<region><![CDATA[LAZIO]]></region>
Il tag region è facoltativo ed indica la regione dell'annuncio.

<country><![CDATA[Italia]]></country>
Il tag country è facoltativo ed indica la nazione dell'annuncio, il valore di default è Italia. Nel caso di paesi stranieri indicare il nome in inglese.

<latitude><![CDATA[41.409583]]></latitude>
Il tag latitude è facoltativo ed indica la regione dell'annuncio.

<longitude><![CDATA[2.187223]]></longitude>
Il tag longitude è facoltativo ed indica la regione dell'annuncio.

<postcode><![CDATA[00100]]></postcode>
Il tag postcode è facoltativo ed indica il codice di avviamento postale.

<rooms><![CDATA[3]]></rooms>
Il tag rooms è facoltativo ed indica le stanze, sono ammessi solo valori numerici.

<pictures>
<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/1.jpg]]></picture_url></picture>
<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/2.jpg]]></picture_url></picture>
<picture><picture_url><![CDATA[http://www.tuacasa.net/public/galleria/narcisi/309/3.jpg]]></picture_url></picture>
</pictures>
Il tag pictures sono facoltativi ed indicano gli url delle foto dell'annuncio.

<date><![CDATA[02/01/2012]]></date>
Il tag date è facoltativo, ed indica la data di pubblicazione. Nel caso non sia indicata verrà utilizzata la data di caricamento.

<time><![CDATA[ 18:46:10]]></time>
ll tag time è facoltativo.

<eco_score>D-111.00-kwh/m2 p.a.</eco_score>
Il tag è obbligatorio e puo' essere utilizzato al posto dei tag <energy_class> e <epi>.

Il formato è il seguente:
<eco_score>ENERGY_CLASS-IPE-UNIT</eco_score>
Il tag eco_score è obbligatorio ed indica la classe energetica dell'edificio. Obbligatorio dal 1 gennaio 2012 ed aggioranto nel 2015. Valori ammessi:A1,A2,A3,A4,A+,A,B,C,D,E,F,G,ND,NC. Per NC si intende si intende Non Classificabile (Esente), mentre per ND si intende Non Disponibile.
L'IPE e' obbligatorio e rappresenta L'indice di prestazione energetica IPE (o EPI) , ovvero la quantità di energia necessaria per riscaldare - raffrescare in un anno, un metro quadrato dell'unità immobiliare certificata espressa in kWh/m*anno. Valori ammessi esempio: 47.00.

L'attributo UNIT può avere i seguenti valori:

• kwh/m2 p.a.
• kwh/m3 p.a.

Nel caso in cui il valore UNIT non venisse indicato il sistema terrà conto della destinazione d'uso precedentemente indicata, se Commerciale il valore sarà kwh/m3 p.a. in tutti gli altri casi kwh/m2 p.a.. Nel caso la classe energetica sia NC o ND l'IPE e l'unità di misura non saranno necessari.

Valori possibili:

• <eco_score>D-110.00-kwh/m2 p.a.</eco_score>
• <eco_score>C-100.00-kwh/m3 p.a.</eco_score>
• <eco_score>A+-5.00</eco_score>
• <eco_score>NC</eco_score>
• <eco_score>ND</eco_score>

Suggerimenti

Nel caso in cui si volesse inserire annunci anche in altra lingua, ciò è possibile solo per quelle di seguito indicate aggiungendo al file XML le seguenti informazioni sia nella parte relativa all'agenzia che nella parte relativa all'immobile :
<descrizione_inglese><![CDATA[DESCRIZIONE]]></descrizione_inglese>
<descrizione_francese><![CDATA[DESCRIZIONE]]></descrizione_francese>
<descrizione_spagnolo><![CDATA[DESCRIZIONE]]></descrizione_spagnolo>
<descrizione_tedesco><![CDATA[DESCRIZIONE]]></descrizione_tedesco>


Contattaci!

Siamo a tua disposizione per qualunque chiarimento.

Contattaci