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.