Se posssiedi un portale immobiliare e desideri che i tuoi annunci appaiano in Nuroa, segui questi semplici passi:

  1. Contattaci inviando un email a partner@nuroa.com per sapere qual è il programma che meglio si adatta alle tue esigenze. Clicca qui per conoscere le diverse opzioni disponibili.
  2. Genera un file UFT-8 XML nel formato descritto sotto.
  3. Assicurati che non ci siano errori di sintassi nel file utilizzando un qualsiasi XML validator disponibile in internet, come ad esempio https://codebeautify.org/xmlvalidate.
  4. Comunicaci l’URL di alloggiamento del file XML. In alternativa, è possibile caricare il file direttamente sul nostro server FTP. Contattaci e ti invieremo i dati per l’accesso.

Non appena riceveremo il tuo file procederemo con l’indicizzazione dei tuoi annunci nel più breve tempo possibile.

Informazioni Importanti

Di seguito troverai le istruzioni per la generazione del feed XML. Per poter processare correttamente il feed, è molto importante che il file XML contenga tutti i campi indicati come obbligatori. Per maggiori informazioni sul formato XML visita la pagina di wikipedia.

Informazioni importanti in merito a come processiamo i feed XML:

  1. Quando un feed viene processato e un annuncio è gia presente in Nuroa.it, verranno aggiornati solo i seguenti campi dell’annuncio: <ad_type>, <category> e <price>. Un annuncio già indicizzato in Nuroa verrà aggiornato completamente (tutti i campi dell’annuncio) quando verrà modificato il campo <last_update>.
  2. L’immagine dell’annuncio visualizzata in Nuroa sarà la prima della serie di immagini contenute nell’XML. Non accettiamo immagini corporative con informazioni del tipo “Immagine non disponibile”.
  3. Nel caso in cui il file XML non compia con tutti i requisiti menzionati in questa pagina, Nuroa non potrà essere considerata responsabile per il mal processamento delle informazioni fornite. Nuroa declina inoltre ogni responsabilità rispetto all’accuratezza o inesattezza dei dati forniti. L’aggiornamento delle informazioni contenute nel file XML è a carico dei rispettivi autori.

Struttura dell’XML

La struttura generale del documento è riportata nel riquadro qui sotto. I campi obbligatori sono indicati in grassetto. Quando un campo è obbligatorio deve contenere informazioni, altrimenti l’annuncio non sarà integrato nel nostro database. Se non vi sono dati disponibili per compilare un campo facoltativo, il campo deve essere lasciato vuoto.

Per quanto riguarda gli annunci, è imperativo avere una singola URL per ciascuno di essi o, in altre parole, non possono esistere due o più annunci associati ad una stessa URL.

<?XML version=“1.0” encoding=“UTF-8”?>
<nuroa>

    <property>
    <id><![CDATA[ . . . ]]></id>
    <link><![CDATA[ . . . ]]></link> 

    <pictures>
        <picture>
            <picture_url><![CDATA[ . . . ]]></picture_url>
            <picture_title><![CDATA[ . . . ]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[ . . . ]]></picture_url>
            <picture_title><![CDATA[ . . . ]]></picture_title>
        </picture> 

    ...

    </pictures> 

    <agency_name><![CDATA[ . . . ]]></agency_name>
    <agency_address><![CDATA[ . . . ]]></agency_address> 

    <ad_type><![CDATA[ . . . ]]></ad_type>
    <category><![CDATA[ . . . ]]></category> 

    <title><![CDATA[ . . . ]]></title>
    <description><![CDATA[ . . . ]]></description>
    <european_energy_class><![CDATA[ . . . ]]></european_energy_class>
    <european_energy_index><![CDATA[ . . . ]]></european_energy_index>
    <rooms><![CDATA[ . . . ]]></rooms>
    <bathrooms><![CDATA[ . . . ]]></bathrooms>
    <square_meters><![CDATA[ . . . ]]></square_meters>
    <floor_number><![CDATA[ . . . ]]></floor_number>
    <condition><![CDATA[ . . . ]]></condition>

    <owner><![CDATA[ . . . ]]></owner>
    <bank><![CDATA[ . . . ]]></bank>

    <price><![CDATA[ . . . ]]></price>
    <price_day><![CDATA[ . . . ]]></price_day>
    <price_week><![CDATA[ . . . ]]></price_week>
    <currency><![CDATA[ . . . ]]></currency>

    <city><![CDATA[ . . . ]]></city>
    <country><![CDATA[ . . . ]]></country>
    <location><![CDATA[ . . . ]]></location>
    <postcode><![CDATA[ . . . ]]></postcode>
    <neighbourhood><![CDATA[ . . . ]]></neighbourhood>
    <longitude><![CDATA [ . . . ]]></longitude>
    <latitude><![CDATA[ . . . ]]></latitude>

    <insertion_date><![CDATA[ . . . ]]></insertion_date>
    </property>
...

</nuroa>

Campi Obbligatori

id: l’id dell’annuncio nella tua pagina web, può essere numerico o alfanumerico però deve essere unico – Stringa di testo alfanumerico libero

link: URL dell’anuncio. È imperativo avere una singola URL per ciascuno di essi o, in altre parole, non possono esistere due o più annunci associati ad una stessa URL.

ad_type: Tipologia dell’annuncio. Stringa di testo predefinita: buy | new development | rent | flatshare

category: Tipologia dell’immobile: casa | appartamento | villa a schiera | commerciale | etc. – Stringa di testo libero

title: Titolo dell’annuncio – Stringa di testo libero

description: Descrizione dell’annuncio – Stringa di testo libero

price: Il prezzo dell’immobile in euro € o in €/mese. Questo campo deve essere utilizzato per annunci di vendita e affitto. Nel caso dell’affitto è obbligatorio utilizzare questo campo solo se il prezzo è espresso in €/mese, in caso contrario è necessario utilizzare uno dei campi appropiati specificati di seguito – Variabile numerica decimale

price_day: Il prezzo dell’immobile in euro al giorno (€/giorno) – Variabile numerica decimale

price_week: Il prezzo dell’immobile in euro alla settimana (€/settimana) – Variabile numerica decimale

currency: la valuta dei prezzi indicati. È obbligatorio usare lo standard ISO 4217 – Testo in formato ISO 4217

city: Città / Municipio di ubicazione dell’immobile – Stringa di testo libero

country: Stato – Stringa di testo libero

longitude: Longitudine. Questo campo ha un’importanza rilevante per il posizionamento dei tuoi annunci tra i risultati di Nuroa, in ogni caso verranno accettati feed che non contengano questo campo  – Variabile numerica decimale

latitude: Latitudine. Questo campo ha un’importanza rilevante per il posizionamento dei tuoi annunci tra i risultati di Nuroa, in ogni caso verranno accettati feed che non contengano questo campo  – Variabile numerica decimale

insertion_date: Data di inserimento dell’annuncio – Formato data: GG/MM/AAA (ex. 01/01/2011)

Campi consigliati per una migliore conversione e posizionamento tra i risultati di Nuroa

pictures: Le URL di alloggiamento delle foto dell’immmobile. In Nuroa non è permessa l’inclusione di immagini corporative con la scritta “immagine non disponibile”

picture: L’elemento “property” può contenere più di un field “picture”. L’immagine che apparirà su Nuroa.it sarà la prima del set di immagini inserite, pertanto assicurati che la prima immagine sia la più attraente per i clienti. Una volta inseriti gli annunci su Nuroa le immagine non verranno aggiornate e non potranno essere modificate.

picture_url: La url della foto

agency_name: Nome dell’agenzia – Stringa di testo libero

agency_address: Indirizzo dell’agenzia (es. via Roma 20, 31022 Treviso) – Stringa di testo libero

european_energy_class: La classe di prestazione energetica presente nell’Attestato di Certificazione Energetica dell’Immobile (ACE): A+, A, B, C, D, E, F, G – Variabile di testo

european_energy_index: Indice di prestazione energetica presente nell’Attestato di Certificazione Energetica dell’Immobile (ACE). Valore numerico con due (2) decimali separati da punto (.) completo di unita’ di misura: kWh/mq anno OPPURE kWh/mc anno – Variabile numerica intera

rooms: Numero di camere da letto – Variabile numerica intera

bathrooms: Numero di bagni – Variabile numerica intera

square_meters: Superfice dell’immobile – Variabile numerica intera

floor_number: Numero piano – Variabile numerica intera

location: Indirizzo dell’immobile – Stringa di testo libero

postcode: Codice postale – Stringa di testo libero

neighbourhood: Quartiere o provincia dell’immobile – Stringa di testo libero

Campi Opzionali

picture_title: Il titolo della foto – Stringa di testo libero

condition: Per esempio “restaurato recentemente” “da restaurare” – Stringa di testo libero

owner: 1 solo se si l’immobile è messo in vendita da un privato. Se l’immobile è gestito da un’agenzia non è necessario includere tale campo – Variabile numerica boleana

bank: 1 solo se si l’immobile è messo in vendita da una banca. Se l’immobile è di proprietà di un privato o gestito da un’agenzia non è necessario includere tale campo – Variabile numerica boleana