iCase.it

Standard Feed di iCase 2.0

Come funziona?

Il funzionamento è semplice se vengono seguiti questi passi:

1leggi con attenzione le specifiche relative al file XML che dovrai realizzare e confronta l'esempio proposto;

2tramite il linguaggio di programmazione che preferisci realizza un piccolo programma che estrapola dal tuo database gli annunci e le visualizza secondo le specifiche al "punto 1";

3assicurati che non ci siano errori di sintassi nel file utilizzando un qualsiasi XML validator disponibile in internet, come ad esempio http://www.xml.com/pub/a/tools/ruwf/check.html

4verifica la correttezza del file che hai generato tramite il nostro validatore on-line;

5segnalaci tramite questo modulo che hai realizzato ed è disponibile un Feed XML di annunci immobiliari per iCase.it;

6in breve tempo i tuoi annunci saranno indicizzati e ricercabili da migliaia di utenti su iCase.it!

Specifiche del Feed XML iCase 2.0

Leggere con attenzione le specifiche del Feed XML di iCase 2.0 di seguito illustrate.

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:g="http://www.icase.it/ns/1.0">
L'intestazione del file XML.
Obbligatorio.
channel Questo è il nodo channel
Obbligatorio.
channel/title Titolo del feed
Obbligatorio.
channel/description Descrizione del feed
Obbligatorio.
channel/link Link del tuo portale
Obbligatorio.
channel/item Questo è il nodo root e contiene tutto il Feed XML di iCasa 2.0
Obbligatorio.
channel/item/g:id Questo è il nodo più importante contiene infatti l'identificatore univoco dell'annuncio.
iCase.it utilizzerà questo identificatore per riferirsi all'annuncio inserito.
Qualora l'identificatore esista già nei nostri indici verrà scartato.
Obbligatorio.
channel/item/g:mls_listing_id L'ID MLS (Multiple Listing Service).
channel/item/g:mls_name Il nome del "Multiple Listing Service" dove l'immobile è elencato.
channel/item/title Questo nodo contiene il titolo dell'annuncio
channel/item/link Contiene la URL dell'annuncio.
L'indirizzo è utilizzato nelle pagine dei risultati per condurre l'utente alla visualizzazione dell'inserzione sul sito dell'editore.
Obbligatorio.
channel/item/description Descrizione dettagliata e completa dell'immobile. Non può contenere tag HTML e deve essere ovviamente codificato in UTF-8.
Tale testo non deve essere troncato o abbreviato.
Obbligatorio.
channel/item/g:publish_date Data di ultimo aggiornamento dell'annuncio sul sito dell'editore.
Obbligatorio.
channel/item/g:istat Codice ISTAT della città.
channel/item/g:province Provincia di ubicazione dell'immobile.
Obbligatorio.
channel/item/g:locality Comune di ubicazione dell'immobile.
Obbligatorio.
channel/item/g:full_address È l'indirizzo completo nella forma "Nome strada, numero civico, CAP Città, Provincia estesa (Regione), Italy".
channel/item/g:address La strada comprensiva di numero civico. Esempio: "Via Roma, 10"
(Se inserita verrà attivata anche la funzionalità di iCase | Visual)
channel/item/g:address_hide Questo nodo indica se l'indirizzo deve essere nascosto agli utenti:
  • N: Indirizzo Nascosto;
Se il nodo non viene valorizzato o per altri valore diversi da 'N' l'indirizzo verrà visualizzato.
channel/item/g:city_area La zona dell'immobile.
channel/item/g:latitude La latitudine esatta del luogo al quale ci si riferisce (nell'intervallo +90/-90 per indicare rispettivamente 90° NORD/90° SUD).
(Se inserita verrà attivata anche la funzionalità di iCase | Visual)
channel/item/g:longitude La longitudine esatta del luogo al quale ci si riferisce (nell'intervallo +180/-180 per indicare rispettivamente 180° EST/180° OVEST)
(Se inserita verrà attivata anche la funzionalità di iCase | Visual)
channel/item/g:ref Il codice di riferimento dell'annuncio per l'agenzia.
channel/item/g:advertiser Il nome dell'entità (privato o azienda) che offre in vendita o affitto l'immobile.
Esempio: Immobili & Co. S.r.l.
channel/item/g:email L'indirizzo di posta elettronica dell'entità (privato o azienda) che offre in vendita o affitto l'immobile.
Obbligatorio.
channel/item/g:phone_number Il numero telefonico dell'entità (privato o azienda) che offre in vendita o affitto l'immobile.
È possibile ripetere più volte questo nodo per indicare numeri telefonici aggiuntivi.
channel/item/g:listing_type Indica se l'immobile è in affitto o vendita. I valori ammessi sono:
  • S: immobile in VENDITA (for Sale);
  • R: immobile in AFFITTO (for Rent).
Obbligatorio.
channel/item/g:category Questo nodo indica se si tratta di un'offerta Commerciale, Residenziale o Affitto Vacanze. I valori ammessi sono:
  • C: immobile COMMERCIALE (Commercial);
  • R: immobile RESIDENZALE (Residential).
  • H: immobile AFFITTO VACANZE (holiday).
Obbligatorio.
channel/item/g:property_type Questo nodo indica definisce il tipo di immobile.
Esempio: Appartamento, Villa, Capannone ...
Obbligatorio.
channel/item/g:energy_class Classe Energetica
  • A4
  • A3
  • A2
  • A1
  • B
  • C
  • D
  • E
  • F
  • G
  • ND: Esente da certificazione
Obbligatorio dal 2012

La legge regionale n. 3/2011 (Collegato ordinamentale 2011), entrata in vigore l'11 marzo 2011,
stabilisce infatti all'articolo 17 che la Giunta regionale detta disposizioni per
"rendere obbligatoria la dichiarazione della classe e dell'indice di prestazione energetica dell'edificio o della singola unità abitativa in tutti gli annunci commerciali finalizzati alla relativa vendita o anche locazione".
channel/item/g:ipe l'indice di prestazione energetica (IPE)
Nel caso di edifici residenziali espresso in kWh/m2 anno.
Nel caso di altri edifici espresso in kWh/m3 anno.

Obbligatorio dal 2012

La legge regionale n. 3/2011 (Collegato ordinamentale 2011), entrata in vigore l'11 marzo 2011,
stabilisce infatti all'articolo 17 che la Giunta regionale detta disposizioni per
"rendere obbligatoria la dichiarazione della classe e dell'indice di prestazione energetica dell'edificio o della singola unità abitativa in tutti gli annunci commerciali finalizzati alla relativa vendita o anche locazione".
channel/item/g:rooms Numero dei locali.
channel/item/g:bathrooms Numero dei bagni.
channel/item/g:garden Tipo giardino.
  • 1: Privato
  • 2: Comune
  • 3: Nessuno
channel/item/g:box Box / garage.
  • 1: Si, singolo
  • 2: Si, doppio
  • 3: No
channel/item/g:parking Posto auto.
  • 1: Coperto
  • 2: Scoperto
  • 3: No
channel/item/g:floor_number Numero del piano.
  • Interrato
  • Semi interrato
  • Piano terra
  • Piano rialzato
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • >10
  • Ultimo
  • Su più livelli
channel/item/g:is_new
  • N: Se è una costruzione antica
  • S: Se è una nuova costruzione
channel/item/g:s_condition Esempio "ristrutturato recentemente".
channel/item/g:year Anno di costruzione dell'immobile in formato AAAA.
channel/item/g:foreclosure S: Se la proprietà è all'asta per pignoramento.
channel/item/g:area Dimensione dell'immobile in metri quadri (m2).
channel/item/g:price Il prezzo dell'immobile in euro (EUR).
Obbligatorio.
channel/item/g:price_period Il periodo del prezzo.
  • daily: PREZZO AL GIORNO
  • monthly: PREZZO AL MESE
  • weekly: PREZZO ALLA SETTIMANA
channel/item/g:price_type Il tipo del prezzo.
  • 1: Tratt. Riservata
  • 2: Trattabile
  • 3: Non Trattabile
  • 4: Di Partenza
channel/item/g:expenses Spese condominiali annuali in euro (EUR).
channel/item/g:image_link Contiene i riferimenti alle immagini o piante relative all'immobile.
È possibile ripetere più volte questo nodo per indicare numeri telefonici aggiuntivi.
channel/item/g:video_link Contiene i riferimenti ai video (virtual-tour) dell'immobile.
È possibile ripetere più volte questo nodo per indicare numeri telefonici aggiuntivi.

Feed XML di esempio per iCase.it

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:g="http://www.icase.it/ns/1.0">
    <channel>
        <title><![CDATA[case e appartamenti in vendita]]></title>
        <description><![CDATA[Appartamenti in vendita su example.com]]></description>
        <link><![CDATA[http://www.example.com]]></link>
        <item>
            <g:id><![CDATA[DFRTGYH]]></g:id>
            <g:mls_listing_id><![CDATA[]]></g:mls_listing_id>
            <g:mls_name><![CDATA[]]></g:mls_name>
            <title><![CDATA[Trilocale di 120 mq]]></title>
            <link><![CDATA[http://www.example.com/case/toscana-siena-pienza/vendita/rustico/CODID-Z9A8B43]]></link>
            <description>
                <![CDATA[
                    In palazzina, appartamento al piano terra con ingresso semindipendente, 
                    composto da soggiorno, cucina, due camere matrimoniali e bagno
                ]]>
            </description>
            <g:publish_date><![CDATA[11/01/2011]]></g:publish_date>
            <g:istat><![CDATA[]]></g:istat>
            <g:province><![CDATA[MI]]></g:province>
            <g:locality><![CDATA[Sesto San Giovanni]]></g:locality>
            <g:full_address><![CDATA[Via Gramsci, 3, 20100 Sesto San Giovanni, Milano (Lombardia), Italy]]></g:full_address>
            <g:address><![CDATA[Via Gramsci, 3]]></g:address>
            <g:city_area><![CDATA[Centro]]></g:city_area>
            <g:latitude><![CDATA[13.678409]]></g:latitude>
            <g:longitude><![CDATA[48.076547]]></g:longitude>
            <g:advertiser><![CDATA[Mario Rossi]]></g:advertiser>
            <g:email><![CDATA[mario.rossi@example.com]]></g:email>
            <g:phone_number><![CDATA[02-234567]]></g:phone_number>
            <g:phone_number><![CDATA[339-234567]]></g:phone_number>
            <g:listing_type><![CDATA[S]]></g:listing_type>
            <g:category><![CDATA[R]]></g:category>
            <g:property_type><![CDATA[appartamento]]></g:property_type>
            <g:energy_class><![CDATA[B]]></g:energy_class>
            <g:ipe><![CDATA[35,0]]></g:ipe>
            <g:rooms><![CDATA[3]]></g:rooms>
            <g:bathrooms><![CDATA[1]]></g:bathrooms>
            <g:floor_number><![CDATA[1]]></g:floor_number>
            <g:is_new><![CDATA[S]]></g:is_new>
            <g:s_condition><![CDATA[da ristrutturare]]></g:s_condition>
            <g:year><![CDATA[2001]]></g:year>
            <g:garden><![CDATA[1]]></g:garden>
            <g:box><![CDATA[3]]></g:box>
            <g:parking><![CDATA[3]]></g:parking>
            <g:foreclosure><![CDATA[N]]></g:foreclosure>
            <g:area><![CDATA[120]]></g:area>
            <g:price><![CDATA[180000]]></g:price>
            <g:price_period><![CDATA[]]></g:price_period>
            <g:price_type><![CDATA[2]]></g:price_type>
            <g:expenses><![CDATA[1000]]></g:expenses>
            <g:image_link><![CDATA[http://www.example.com/case/toscana-siena-pienza/vendita/rustico/img1.png]]></g:image_link>
            <g:image_link><![CDATA[http://www.example.com/case/toscana-siena-pienza/vendita/rustico/img2.png]]></g:image_link>
            <g:image_link><![CDATA[http://www.example.com/case/toscana-siena-pienza/vendita/rustico/img3.png]]></g:image_link>
            <g:image_link><![CDATA[http://www.example.com/case/toscana-siena-pienza/vendita/rustico/img4.png]]></g:image_link>
            <g:video_link><![CDATA[http://www.youtube.com/watch?v=-X-GiLMfrtt]]></g:video_link>
            <g:video_link><![CDATA[http://www.youtube.com/watch?v=-X-ewwMfyu]]></g:video_link>
            <g:video_link><![CDATA[http://www.youtube.com/watch?v=-X-dqeMfwqr]]></g:video_link>
        </item>
        <item>
            ...
        </item>
    </channel>
</rss>

Modulo di verifica validità del Feed XML

Utilizza questo modulo per sottoporre alla verifica di validità il tuo Feed XML.

Standard del feed:
URL del feed da verificare:
 

Modulo di segnalazione di nuovo Feed XML

Utilizza questo modulo per segnalare allo staff di iCase.it l'esistenza di un Feed XML di annunci immobiliari.

URL del feed da segnalare:
Email di contatto:
Breve descrizione:
(opzionale)
Captcha: