1. Bachecacase.com
  2. Pubblicazione automatica
  3. Specifiche XML

Specifiche XML per l'import degli Annunci

Per Inserire i vostri immobili su BachecaCase.com in maniera automatica occorre produrre un file xml con i dati delle agenzie inserzioniste ed un file XML con i dati degli immobili.

Struttura generale

Tutti i file XML inviati dovranno prevedere la seguente intestazione


<?xml version="1.0" encoding="UTF-8"?>

Tutti i campi di tipo Stringa, dovranno essere inseriti all'interno di CDATA, i campi di tipo Boolean dovranno assumere i valori 1 (true) o 0 (false).
I campi definiti come obbligatori dovranno SEMPRE presenti e valorizzati nei feed.

Struttura file agenzie

Il file agenzie.xml conterrà un nodo iniziale radice <agenzie> e all'interno un nodo <agenzia> per ogni inserzionista, con tutti i dati di seguito riportati:

Nome del campo Descriione Tipo di campo Obbligatorio
id Identificativo agenzia Numerico
datamodifica Data ultima modifica anagrafica nel formato dd/mm/yyyy HH:mm Stringa
nome Nome/Ragione sociale Stringa
description Testo descrittivo agenzia Stringa
indirizzo Indirizzo comprensivo di civico Stringa
comune Può essere omesso se viene indicato il codice istat Stringa
istat Codice ISTAT del comune Numerico
provincia Stringa
region Stringa
latitude Coordinate ubicazione agenzia Numerico
longitude Coordinate ubicazione agenzia Numerico
referente Stringa
telefono Stringa
cellulare Stringa
email Indirizzo email (cui saranno inviati comunicazione e richieste degli utenti) Stringa
web Stringa
logo Logo agenzia in formato JPG o PNG Stringa

Esempio di file agenzie.xml:


<?xml version="1.0" encoding="UTF-8"?>
<agenzie>
    <agenzia>
        <id>12345</id>
        <datamodifica><![CDATA[19/10/2022 14:52:01]]></datamodifica>
        <nome><![CDATA[Agenzia Immobiliare SNC]]></nome>
        <description><![CDATA[Descrizione agenzia (Max 150 char)]]></description>
        <indirizzo><![CDATA[Via roma 12]]></indirizzo>
        <comune><![CDATA[Torino]]></<comune>>
        <istat><![CDATA[000000]]></istat>
        <provincia><![CDATA[Torino]]></provincia>
        <region><![CDATA[Marche]]></region>
        <latitude>45.071003</latitude>
        <longitude>7.694445</longitude>
        <referente><![CDATA[Mario Rossi]]></referente>
        <telefono><![CDATA[011/001122]]></telefono>
        <cellulare><![CDATA[333/001122]]></cellulare>
        <email><![CDATA[agenzia@agenzia.com]]></email>
        <web><![CDATA[http://www.agenzia.com]]></web>
        <logo><![CDATA[http://www.agenzia.com/logo.png]]></logo>
    </agenzia>
    <agenzia>
    	...
    </agenzia>
</agenzie>

Struttura file immobili

Il file immobili.xml conterrà un nodo iniziale radice <immobili> e all'interno un nodo <immobile> per ogni annuncio, con tutti i dati di seguito riportati:

Nome del campo Descriione Tipo di campo Obbligatorio
id Identificativo immobile Numerico
id_agenzia Identificativo Agenzia inserzionista Numerico
datapubblicazione Data prima pubblicazione nel formato dd/mm/yyyy HH:mm Stringa
datamodifica Data ultima modifica nel formato dd/mm/yyyy HH:mm Stringa
title Titolo/Descrizione sintetica immobile Stringa
description Descrizione immobile Stringa
riferimento Codice di riferimento annuncio Stringa
comune Può essere omesso se viene indicato il codice istat Stringa
istat Codice ISTAT del comune Numerico
provincia Stringa
region Stringa
latitude Coordinate ubicazione immobile Numerico
longitude Coordinate ubicazione immobile Numerico
zona Zona/Indirizzo immobile Stringa
mq Dimensioni totali Numerico
costo Numerico
trattativa_riservata Nel caso di trattativa riservata valorizzare a 1 Booleano
tipo Può assumere i seguenti valori:
  • Vendita
  • Affitto
 Stringa
vani Numero totale di vani Numerico
camere Numero camere Numerico
bagni Numero bagni Numerico
tipoimmobile Vedi tabella tipologie Stringa
nuda_proprieta Nel caso di nuda proprietà valorizzare a 1 Booleano
categoria Vedi tabella cartegorie Stringa
cucina Può assumere i seguenti valori:
  • No
  • Angolo cottura
  • Cucinotto
  • Semi abitabile
  • Abitabile
  • Ampia metratura
 Stringa
cucina_desc Eventuale testo descrittivo Stringa
giardino Può assumere i seguenti valori:
  • Nessuno
  • Privato
  • Comune
 Stringa
giardino_desc Eventuale testo descrittivo Stringa
box Può assumere i seguenti valori:
  • No
  • Singolo
  • Doppio
  • Posto auto
 Stringa
box_desc Eventuale testo descrittivo Stringa
terrazzo Può assumere i seguenti valori:
  • Si
  • No
 Stringa
terrazzo_desc Eventuale testo descrittivo Stringa
balcone Può assumere i seguenti valori:
  • Si
  • No
 Stringa
balcone_desc Eventuale testo descrittivo Stringa
piano Es.: piano terra Stringa
ascensore Può assumere i seguenti valori:
  • Si
  • No
 Stringa
stato_immobile Può assumere i seguenti valori:
  • Nuovo
  • Discreto
  • Buono
  • Ottimo
  • In costruzione
  • Da ristrutturare
 Stringa
riscaldamento Può assumere i seguenti valori:
  • Assente
  • Centralizzato
  • Autonomo
 Stringa
anno Anno di costrizione Stringa
classe_energetica Può assumere i seguenti valori
  • A -> G,A1,A2,A3,A4
  • N = Immobile non soggetto/esente
 Stringa
ipe Numerico
ipe_um Accetta solamente i valori kwh/m2 e kwh/m3 Stringa
images Stringa
panorama Stringa
virtual_tour Stringa video Stringa

Esempio di file immobili.xml:


<?xml version="1.0" encoding="UTF-8"?>
<immobili>
    <immobile>
        <id>12345</id>
        <id_agenzia>111</id_agenzia>
        <datapubblicazione><![CDATA[19/03/2011 14:52:01]]></datapubblicazione>
        <datamodifica><![CDATA[19/03/2011 14:52:01]]></datamodifica>
        <title><![CDATA[Appartamento ammobilliato]]></title>
        <description><![CDATA[appartamento di mq 83 composto da soggiorno, cucina semiabitabile, due camere e doppi servizi. garage]]></description>
        <istat><![CDATA[000000]]></istat>
        <town><![CDATA[Ancona]]></town>
        <zona><![CDATA[Centro Storico]]></zona>
        <provincia><![CDATA[Ancona]]></provincia>
        <region><![CDATA[Marche]]></region>
        <mq>83</mq>
        <costo>285000</costo>
        <trattativa_riservata>0</trattativa_riservata>
        <tipo><![CDATA[Vendita]]></tipo>
        <vani>5</vani>
        <camere>3</camere>
        <bagni>1</bagni>
        <tipoimmobile><![CDATA[APPARTAMENTO]]></tipoimmobile>
        <nuda_proprieta>0</nuda_proprieta>
        <categoria><![CDATA[Residenziale]]></categoria>
        <cucina><![CDATA[abitabile]]></cucina>
        <cucina_desc><![CDATA[eventuale descrizione aggiuntiva]]></cucina_desc>
        <giardino><![CDATA[Privato]]></giardino>
        <giardino_desc><![CDATA[eventuale descrizione aggiuntiva]]></giardino_desc>
        <box><![CDATA[Doppio]]></box>
        <box_desc><![CDATA[eventuale descrizione aggiuntiva]]></box_desc>
        <terrazzo><![CDATA[No]]></terrazzo>
        <terrazzo_desc><![CDATA[eventuale descrizione aggiuntiva]]></terrazzo_desc>
        <balcone><![CDATA[Si]]></balcone>
        <balcone_desc><![CDATA[eventuale descrizione aggiuntiva]]></balcone_desc>
        <piano>2</piano>
        <ascensore><![CDATA[No]]></ascensore>
        <stato_immobile><![CDATA[Da ristrutturare]]></stato_immobile>
        <riscaldamento><![CDATA[Centralizzato]]></riscaldamento>
        <anno>1950</anno>
        <classe_energetica>A</classe_energetica>
        <ipe>17</ipe>
        <ipe_um>kwh/m2</ipe_um>
        <lat>45.776024<lat>
        <lon>12.99556</lon>
        <images>
            <img main=”1”>http://www.tuosito.it/immagini/1.jpg</img>
            ...
            <img>http://www.tuosito.it/immagini/9.jpg</img>
        </images>
        <panorama>
            <img>http://www.tuosito.it/immagini360/1.jpg</img>
        ...
            <img>http://www.tuosito.it/immagini360/9.jpg</img>
        </panorama>
        <virtual_tour><![CDATA[http://virtualtrour/link]]></virtual_tour>
        <video><![CDATA[http://video/link]]></video>
    </immobile>
    <immobile>
        ...
    </immobile>
</immobili>

Tabella Tipologie

Valore Descriione
AGRITURISMO
APPARTAMENTO
ATTICO
ATTIVITA_COMMERCIALE
BILOCALE
BOX_GARAGE
CAPANNONE
CASA_DI_CORTE
CASA_SEMIINDIPENDENTE
CANTINA
CASA_BIFAMILIARE
CASA_INDIPENDENTE
CASA_VACANZA
CASA
CASALE
DUPLEX
IMMOBILE_COMMERCIALE
IMMOBILE
LABORATORIO
LOCALE_INDUSTRIALE
LOCALE_COMMERCIALE
LOCALI
LOFT
MAGAZZINO
MANSARDA
MINIAPPARTAMENTO
MONOLOCALE
NEGOZIO
PALAZZINA
QUADRILOCALE
RESIDENCE
RUSTICO
STANZA_CONDIVISA
STANZA_SINGOLA
TERRENO_AGRICOLO
TERRENO_EDIFICABILE
TERRENO
TERRATETTO
TRILOCALE
UFFICIO
VILLA
ALBERGO
BAITA
BUNGALOW
CAMERA
CANTIERE
CAPANNA
CASA_IN_COSTRUZIONE
CASA_QUADRIFAMILIARE
CASA_TRIFAMILIARE
GREZZO
LAMIA
MAISONETTE
NUDA_PROPRIETA
PORZIONE_DI_FABBRICATO
POSTO_LETTO
TERRENO_ARTIGIANALE
TERRENO_COMMERCIALE
TERRENO_INDUSTRIALE
TRULLO
VIAREGGINA
AZIENDA_AGRICOLA
BED_AND_BREAKFAST

Tabella Categorie

Valore Descriione
residenziale Immobile di tipo residenziale
commerciale Immobile commerciale, licenze e negozi
garage Garage, Box e posti auto
palazzi Palazzi, palazzine e stabili
camere Stanze e camere in affitto
ufficio
magazzini Magazzini, depositi e capannoni
terreni
nuovacostruzione Immobili non ultimati
vacanze Immobili ad uso transitorio/vacanze

Importante

  • I campi classe_energetica ed ipe sono obbligatori. Dal 01 gennaio 2012 è infatti obbligatoria la pubblicazione di tali informazioni su gli annunci immobiliari prodotti su qualsiasi media.
  • Il campo classe_energetica potrà contenere i seguenti valori: A4,A3,A2,A1,B,C,D,E,F,G
  • Il campo prezzo dovrà contenere solamente valori numerici privi di decimanli: es. 150000
  • Il campo ipe dovrà contenere solamente valori numerici
  • il campo ipe_um può contenere l'unità di misura del valore ipe come kWh/mq oppure kWh/mc
  • L'id dell'annuncio deve essere univoco per il tuo sito
    Non devono essere presenti due annunci diversi con lo stesso ID.
  • Le immagini dell'immobile non devono essere immagini corporative, loghi aziendali o immagini con il messaggio "immagine non dispobibile" o simili.