Pubblicazione Annunci in formato Trovit

Transcript

Pubblicazione Annunci in formato Trovit
I TUOI ANNUNCI SU CERCASICASA.IT in formato TROVIT
Pubblicazione Annunci in formato Trovit
CercasiCasa.it richiede ulteriori informazioni rispetto Il formato TROVIT che deve essere integrato con alcuni
Tag obbligatori.
Queste sono le istruzioni per generare un feed XML con il fine di includere le tue offerte su CercasiCasa.it.
La codificazione dell’archivio 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>.
Adeguamento Formato Trovit
Struttura del Feed XML, in rosso le informazioni aggiuntive:
<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:
<?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>
<energy_class>G</energy_class>
<epi unit="kwh/m2 p.a.">170.00</epi>
</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></agency> . Potranno essere utilizzati uno o più tag <agency> in base alla
necessità, 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.
Scarica il Template XML
Cercasicasa-Trovit.XML
TAG <agency>
<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.
TAG <ad>
<id><![CDATA[3936]]></id>
Il tag id è obbligatorio ed indica l'identificativo univoco dell'annuncio immobiliare. Sono ammessi anche
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 (zona CENTRO ECUMENICO) - 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
Con i valori in verde sarà possibile specificare successivamente il tag <property-type>.
<category><![CDATA[R]]></category>
Il tag type è obbligatorio ed indica la destinazione d'uso dell'immobile. I valori ammessi sono:
•
“residential”: Residenziale
•
“commercial”: Commerciale
•
“holiday”: Affitto Vacanze, B&B, Albergo, Hotel. 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[Appartamento]]></property_type>
Il tag property_type è obbligatorio ed indica la tipologia dell'immobile. Elenco delle tipologie:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Agriturismo
Albergo-Hotel
Altro
Appartamento
Attico-Mansarda
Attività Commerciale
Azienda Agricola
Baita-Chalet-Trullo
Bar
Bed and Breakfast
Bilocale
Box-Posto Auto
Camera d'Albergo
Capannone
Casa Indipendente
Casa Semi indipendente
Casa Vacanze
Casa Bifamiliare
Casa Trifamiliare
Casa Quadrifamiliare
Castello
Complesso Industriale
Deposito-Magazzino
Discoteca
Edificio-Stabile-Palazzo
Laboratorio
Licenza
Locale Commerciale
Loft-Open Space
Magazzino
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Monolocale
Multiproprietà
Negozio
Stanze
Residence
Ristorante
Rustico-Casale-Corte
Seminterrato
Show Room
Terreno
Ufficio
Villa
Villa Bifamiliare
Villa Trifamiliare
Villa QuadriFamiliare
Villa a Schiera
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 solo valori numerici.
<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>
l 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.
<energy_class>G</energy_class>
Il tag energy_class è obbligatorio ed indica la classe energetica dell'edificio. Obbligatorio dal 1 gennaio
2012. Valori ammessi: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.
<epi unit="kwh/m2 p.a.">170.00</epi>
Il tag è 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. Obbligatorio dal 1 gennaio 2012. 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 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.