Documentazione XML per sviluppatori

Il tracciato Wimmo per importare immobili e gallerie fotografiche.

Tracciato XML multiagenzia

Questo formato consente a un fornitore di includere nel medesimo file annunci di più agenzie Wimmo, anche di tipologie diverse. Il caricamento massivo è riservato all’admin Wimmo: non è il formato da caricare nel CP della singola agenzia.

Scarica XML multiagenzia di esempio

Il file scaricabile contiene tre annunci completi di esempio (RS, CR e TR), attribuiti a due codici cliente dimostrativi. Prima dell’uso occorre sostituire i codici con quelli delle agenzie effettivamente presenti nel CRM e aggiornare i dati degli immobili. La galleria mostra un nodo immagine commentato: attivarlo solo con un URL HTTPS reale.

Struttura distintiva

<?xml version="1.0" encoding="UTF-8"?>
<wimmo_import versione="1.0" fornitore_id="1" modalita="incremental" generato_il="2026-10-02T10:00:00+02:00">
    <annunci>
        <annuncio codice_cliente="CODICE_AGENZIA_1" tipo="RS" id_esterno="RS-ESEMPIO-001" operazione="insert" modificato_il="2026-10-02T10:00:00+02:00">
            <dati>...</dati>
        </annuncio>
        <annuncio codice_cliente="CODICE_AGENZIA_2" tipo="CR" id_esterno="CR-ESEMPIO-001" operazione="insert" modificato_il="2026-10-02T10:00:00+02:00">
            <dati>...</dati>
        </annuncio>
    </annunci>
</wimmo_import>

A differenza del formato CP, non esiste un nodo unico <agenzia>: il codice_cliente è richiesto su ogni nodo <annuncio>. Ogni codice viene verificato nel CRM e determina l’agenzia del relativo pending e delle sue immagini.

L’attributo fornitore_id è obbligatorio nel file XML massivo. L’ID è generato e comunicato da Wimmo, è specifico e univoco per ogni fornitore abilitato a discrezione di Wimmo. Nell’esempio, sostituire 1 con l’ID assegnato al proprio fornitore.

ElementoRegolaObbligatorietà
annuncio.codice_clienteCodice cliente Wimmo esistente nel CRM, solo cifre; può variare tra annunci dello stesso file.Obbligatorio
annuncio.tipoRS, CR o TR; le tipologie possono essere mescolate nel file.Obbligatorio
annuncio.operazioneinsert, update o delete.Obbligatorio
annuncio.modificato_ilData e ora ISO 8601 con fuso orario.Obbligatorio
annuncio/datiCampi completi per insert e update; assente per delete.Condizionale
wimmo_import.fornitore_idID alfanumerico assegnato da Wimmo, massimo 96 caratteri. Se assente o vuoto, il file è rifiutato; se non corrisponde a un fornitore attivo, i pending entrano in stato drop.Obbligatorio
annuncio.id_esternoIdentificativo stabile presso la fonte, massimo 50 caratteri.Obbligatorio
annuncio/galleriaFino a 50 immagini, con modalita="replace".Facoltativo

Valgono gli stessi obblighi e formati dei campi <dati> descritti nelle sezioni Residenziali, Commerciali e Terreni; per la galleria valgono le specifiche immagini. Il file ammette da 1 a 5.000 annunci e massimo 50 MB. Il batch è transazionale: se un annuncio non è valido, il caricamento viene annullato interamente.

Vuoi scoprire le funzionalità di Wimmo Business?

Scopri tutti i piani e confronta le funzionalità della piattaforma, scegli il piano più idoneo.

Esplora i piani