Documentazione XML per sviluppatori

Terreni (TR)

Ogni file XML contiene da 1 a 100 annunci di una sola tipologia e di una sola agenzia. Il file non può superare 5 MB. L’agenzia carica il file dal proprio CP: il codice cliente è ricavato dalla sessione, mentre il codice annuncio Wimmo viene assegnato dal sistema. Gli annunci accettati entrano prima nella coda pending e non sono pubblicati immediatamente.

Struttura del file

<?xml version="1.0" encoding="UTF-8"?>
                            <wimmo_import versione="1.0" fornitore_id="" modalita="incremental" generato_il="2026-10-02T10:00:00+02:00">
                                <agenzia>
                                    <annunci>
                                        <annuncio tipo="TR" id_esterno="TR-ESEMPIO-001" operazione="insert" modificato_il="2026-10-02T10:00:00+02:00">
                                            <dati>
                                                <tipologia>tr_edificabile</tipologia>
                                                <!-- gli altri campi obbligatori e gli eventuali facoltativi -->
                                            </dati>
                                            <galleria modalita="replace">...</galleria>
                                        </annuncio>
                                    </annunci>
                                </agenzia>
                            </wimmo_import>

fornitore_id può essere omesso o lasciato vuoto per un XML creato dall’agenzia. Se il file proviene da un fornitore accreditato Wimmo, indicare il suo codice alfanumerico: se non è presente o attivo nel CRM, gli annunci entrano in stato drop e non sono evadibili.

Le operazioni ammesse sono insert, update e delete. Per insert e update inviare <dati> completo; per delete non inviare né dati né galleria. Update e delete individuano l’annuncio tramite agenzia, origine del file e id_esterno: mantenere quindi la stessa scelta per fornitore_id usata nell’insert. Il codice annuncio Wimmo viene assegnato al primo inserimento. Un annuncio assente dal file non viene cancellato.

Campi di <dati>

I nomi sotto sono gli elementi XML. Non inviare codice immobile Wimmo, codice agenzia, stato pending o altri campi interni. I flag ammettono soltanto 0 o 1. Importi e superfici sono interi, senza decimali.

Identificazione e posizione

Caratteristiche del terreno

Contratto e prezzi

Stato e visibilità

Testi e collegamenti

Valori di tipologia

Inviare esattamente il dt_codice corrispondente alla tipologia desiderata. Non inviare l’ID numerico né il nome descrittivo: il sistema converte il codice nell’ID interno durante l’import.

La galleria è facoltativa. Le regole per URL, formati e nodi fotografici sono nella sezione Specifiche immagini.