Se volete pubblicare degli annunci (di vendita di immobili, affitto) in modo automatico nel nostro portale e nei portali collegati potete fornirci un file XML compilato secondo le nostre specifiche descritto di seguito.

La procedura di importazione degli annunci sarà completamente automatizzata e consentirà aggiornamenti giornalieri dell'elenco degli annunci.

L'integrazione degli annunci avviene ogni notte.

Questa la struttura del feed:

• <annunci>
  Il tag principale del feed e' <annunci>, ogni serie di annunci (anche un solo annuncio) deve essere aperta con questo tag e chiuso correttamente con </annunci>
  
• <annuncio>
  Ogni annuncio viene aperto con <annuncio> e chiuso correttamente con </annuncio>
• <azione>
  Per ogni annuncio è necessario indicare l'azione che puo' essere INSERT (inserimento di un nuovo annuncio), UPDATE (aggiornamento di un annuncio esistente), DELETE (eliminazione di un annuncio dal nostro database) nella forma <azione>INSERT</azione> o <azione>DELETE</azione> oppure <azione>UPDATE</azione>
• <id>
  Ogni annuncio deve avere un suo codice univoco (ad esempio l'id nel vostro database) in modo da poter essere aggiornato e/o eliminato nel/dal nostro database. L'id di ogni annuncio dovrà essere indicato con <id>vostro_id_univoco</id>
• <tipo>
  Per ogni annuncio e' necessario indicare la sua tipologia, Affitto o Vendita con A = Affitto, V = Vendita, nella forma <tipo>A</tipo> oppure <tipo>V</tipo>
• <titolo>
  In ogni annuncio dovà essere indicato un titolo con il tag <titolo>Titolo del vostro annuncio</titolo>
• <localita>
  La località dell'immobile deve essere indicata con il tag <localita>indirizzo dell'immobile</localita> E' importante per una corretta geolocalizzazione dell'immobile indicare la localita' nella forma comune, provincia, regione oppure comune, regione oppure latitudine, longitudine. Nel caso vanga indicato latitudine, longitudine verrà considerato il comune più vicino ai dati forniti.
• <zona>
  La zona in cui si trova l'immobile, ad esempio il nome di un quartiere oppure centro, periferia, ecc.
  
• <tipologia>
  La tipologia dell'immobile deve essere indicata con il tag <tipologia>valore in lista</tipologia> Le tipologie possibili (stringa da inserire come valore del tag) sono le seguenti:
  Appartamento Casa Indipendente Villetta a Schiera Villa Casale/Rustico Box/Garage Monolocale Multiproprietà Terreno Edificabile Locale Commerciale Casa vacanze Altro

  Qualora la striga inserita in tipologia non venga riconosciuta tra i valori possibili; per l'annuncio verra' preso automaticamente il valore Altro.

• <superficie_mq>
  Per ogni annuncio deve essere indicata la superficie in metri quadri con un valore numerico nella forma <superficie_mq>valore_numerico</superficie_mq>
• <stato_immobile>
  Per ogni annuncio puo essere indicato lo stato dell'immobile (informazione non obbligatoria) nella forma <stato_immobile>vostra descrizione dello stato</stato_immobile>
• <prezzo>
  Per ogni annuncio deve essere indicato il prezzo nella forma <prezzo>valore_numerico</prezzo>
• <vani>
  Per ogni annuncio deve essere indicato il numero dei vani nella forma <vani>valore_numerico</vani>
• <piano>
  L'indicazione del piano non e' obbligatoria, se indicata va' inserita nella forma <piano>valore_numerico</piano>
• <riscaldamento>
  Il tipo di riscaldamento va' indicato nella forma <riscaldamento>valore_possibile</riscaldamento>. I valori possibili sono A e C dove A=autonomo C=Condominiale
• <ascensore>
  La presenza di ascensore va' indicata con <ascensore>valore_possibile</ascensore>. I valori possibili sono S e N dove S=si N=No
• <email>
  L'email per avere informazioni sull'annuncio da parte dei visitatori va' inserita nella forma <email>email_valida</email>
• <spese_condominiali_annue>
  Qualora vogliate indicare le spese condominiali (non obbligatorie), queste vanno inserite nella forma <spese_condominiali_annue>valore_numerico</spese_condominiali_annue>
• <descrizione>
  La descrizione dell'annuncio puo' contenere formattazione html con i soli tags tipografici ammessi (allineamento e tipologia font grassetto, sottolineato, etc.). La descrizione va' inserita con un particolare item chiamato cdata, al fine di non confondere la lettura dell'xml con tags html. La forma del tag sara': <descrizione><![CDATA[ vostra_descrizione_html ]]></descrizione> La mancata formattazione tramite cdata potrebbe portare ad un non riconoscimento del vostro feed.
• <meta_keywords>
  Non obbligatorio
  E' possibile inserire le keywords relative alla pagina dell'annuncio per i motori di ricerca tramite il tag <meta_keywords> seguito da un elenco di tags <keyword> La forma delle informazioni relative alle keywords sara'
  <meta_keywords><keyword>vostra_keyword_1</keyword>..<keyword>vostra_keyword_n</keyword></meta_keywords>
• <meta_descriptions>
  Non obbligatorio
  E' possibile inserire le descrizioni relative alla pagina dell'annuncio per i motori di ricerca tramite il tag <meta_descriptions> seguito da un elenco di tags <description> La forma delle informazioni relative alle keywords sara'
  <meta_descriptions> <description>vostra_description_1 </description>.. <description>vostra_description_n</description></meta_descriptions>
• <gallery>
  Non obbligatorio
  E' possibile inserire fino a 16 foto per il vostro annuncio per mezzo del tag <gallery> seguito da un elenco di tags <photo_url> La forma delle informazioni relative alla gallery sara'
  <gallery> <photo_url>url_foto_1 </photo_url>.. <photo_url>url_foto_n</photo_url></gallery>

Per gli annunci con azione DELETE basta indicare soltanto il tag id e quello relativo all'azione, per tutti gli altri indicare tutte le informazioni necessarie tranne quelle non obbligatorie.
Vedi il feed di esempio http://www.privatovendecasa.com/test_feeds/feed_corretto.xml
Per la verifica del feed http://www.privatovendecasa.com/ag_feeds/test.php

Esempio di Feed XML

<?xml version="1.0" encoding="UTF-8"?>
<annunci>
	<annuncio>
		<id>xxx1</id>
		<tipo>A</tipo>
		<azione>INSERT</azione>
		<titolo>Fantastico appartamento in centro</titolo>
		<localita>Via del sersimone 40 Terni, (TR) Italia</localita>
		<zona>Centro storico	</zona>	
		<tipologia>Appartamento</tipologia>
		<superficie_mq>50</superficie_mq>
		<stato_immobile>buone condizioni</stato_immobile>
		<prezzo>450</prezzo>
		<vani>2</vani>
		<piano>1</piano>
		<ascensore>S</ascensore>
		<riscaldamento>A</riscaldamento>
		<email>
 Questo indirizzo e-mail è protetto dallo spam bot. Abilita Javascript per vederlo.
 </email>
		<spese_condominiali_annue>120</spese_condominiali_annue>
		<descrizione><![CDATA[<strong>Fantastico appartamento in centro da vedere assolutamente</strong><p>Contattate la nostra agenzia per informazioni</p>]]></descrizione>
		<meta_keywords>
                        <keyword>centro città</keyword>
			<keyword>Terni	</keyword>
			<keyword>Umbria</keyword>
		</meta_keywords>
		<meta_descriptions>
			<description>Appartamenti in Centro</description>
			<description>Appartamenti in affitto a Terni	</description>
			<description>Appartamenti in affitto in Umbria</description>
			<description>Miniappartamento a Terni, Umbria</description>
		</meta_descriptions>
		<gallery>
			<photo_url>http://dominio.it/immagini/xxx1_1.jpg</photo_url>	
			<photo_url>http://dominio.it/immagini/xxx1_2.jpg</photo_url>	
			<photo_url>http://dominio.it/immagini/xxx1_3.jpg</photo_url>	
		</gallery>
	</annuncio>
</annunci>