Feed per le anagrafiche delle agenzie

Se avete la necessità di passare le anagrafiche delle agenzie immobiliari a Gruppo Immobiliare.it, ad esempio per permettere la contrattualizzazione delle vostre agenzie che ancora non hanno un contratto con i nostri portali, vi chiediamo di creare un secondo feed XML in cui inserire l'anagrafica delle agenzie.

Funzionamento dell'integrazione dell'anagrafica agenzie

Per semplicita', vi chiediamo di depositare una lista completa delle agenzie esportate nella vostra area ftp, con nome "agencies.xml"

Se il file si trova nella vostra area ftp ed è correttamente formattato, i nostri operatori saranno in grado di inserire l'anagrafica dei vostri clienti nel nostro sistema in maniera agevole e veloce

Formato xml

<?xml version="1.0" encoding="UTF-8" ?> Intestazione del file XML indica la versione dello standard XML seguita (1.0), la codifica del documento (è obbligatoria la codifica unicode utf-8 per i feed XML). Obbligatorio
feed Nodo radice del documento XML. Obbligatorio È obbligatorio, al fine della validazione, che nel nodo di radice vengano dichiarati il namespace e lo schemaLocation del feed:
                  
                  
feed/version Il numero di versione del documento XML. Questa pagina tratta la versione 1.5. Obbligatorio
feed/metadata Contenitore dei metadati che riguardano il partner, la struttura del feed e la data di pubblicazione. Obbligatorio
feed/metadata/publisher Contenitore i dati che riguardano il partner. Obbligatorio
feed/metadata/publisher/name Nome del partner. Obbligatorio
feed/metadata/publisher/site Il sito web del partner.
feed/metadata/publisher/email Indirizzo email a cui comunicare eventuali problemi e/o mandare report riguardo all'integrazione. Obbligatorio
feed/metadata/publisher/phone Numero di telefono a cui comunicare eventuali problemi e/o mandare report riguardo all'integrazione. Il numero di telefono deve essere in formato internazionale (+3906XXXXX). Obbligatorio
feed/metadata/build-date Data di generazione del feed. Questa, come tutte le altre date del feed deve essere in formato ISO 8861, come raccomandato dal W3 consortium in tema di interoperabilità sul web. Obbligatorio
feed/agencies Nodo che contiene tutte le anagrafiche. Obbligatorio
feed/agencies/agency Nodo che contiene l'anagrafica della singola agenzia. Obbligatorio
feed/agencies/agency/name Nome dell'agenzia Obbligatorio
feed/agencies/agency/email Email dell'agenzia. Deve corrispondere all'email che si trova nel feed degli annunci. Obbligatorio
feed/agencies/agency/phone Telefono dell'agenzia. Il formato accettato e' il numero in notazione puramente numerica (es. 0612345678) Obbligatorio
feed/agencies/agency/vat-id Identificativo univoco dell'agenzia a fini fiscali. Nel caso di aziende italiane corrisponde alla partita iva.Obbligatorio
feed/agencies/agency/administrative-area Stringa che indica il nome della maggior suddivisione amministrativa della nazione. Nel caso dell'Italia, si tratta del nome per esteso della regione (es. Lazio, Valle d'Aosta, Emilia Romagna). Obbligatorio
feed/agencies/agency/sub-administrative-area Stringa che indica il nome della successiva suddivisione amministrativa della nazione. Nel caso dell'Italia, si tratta del nome per esteso della provincia (es. Roma, Pesaro Urbino, Reggio Calabria). Obbligatorio
feed/agencies/agency/city[@code] Stringa che indica la città (comune). Nell'attributo "code" √® possibile inserire il codice ISTAT del comune italiano. Obbligatorio
feed/agencies/agency/address Indirizzo dell'agenzia (es. via ottaviano)Obbligatorio
feed/agencies/agency/street-number Numero civico dell'ubicazione dell'agenzia
feed/agencies/agency/postal-code CAP dell'agenzia.
feed/agencies/agency/owner Nodo che contiene le informazioni sul titolare
feed/agencies/agency/owner/first-name Nome del titolare
feed/agencies/agency/owner/last-name Cognome del titolare
feed/agencies/agency/owner/phone Numero di telefono del titolare