Guida
SwissRETS: lo standard svizzero di scambio degli annunci immobiliari
Aggiornato il 12 novembre 2026
In breve
SwissRETS è il formato aperto con cui i software immobiliari svizzeri descrivono gli immobili da pubblicare: indirizzo, prezzi, superfici, testi in più lingue, foto. È mantenuto da Qualipool, un’associazione di editori di software e di portali, e pubblicato liberamente su GitHub. Coesistono due versioni: il JSON, che evolve (oggi 3.6), e l’XML, fermo alla 2.7.
A che cosa serve
Un agente inserisce i suoi immobili una sola volta, nel suo software di gestione. Il software li esporta in SwissRETS, e ogni portale legge lo stesso documento. Niente va reinserito, e una modifica nel software si ritrova ovunque.
Che cosa contiene un documento SwissRETS
- L’inventario completo dell’agenzia: ogni immobile online, a ogni esportazione.
- Per ogni immobile: tipo e categoria (99 categorie, dall’appartamento al posteggio), indirizzo e coordinate, prezzi (vendita, pigione netta, spese accessorie, pigione lorda, al metro quadrato o per periodo), superfici, locali, piano, anno di costruzione, dotazioni, disponibilità.
- I testi (titolo, descrizione, posizione) in ogni lingua pubblicata, con foto, piani e documenti.
- I progetti: una promozione e i suoi lotti.
- Il contatto: l’agenzia, l’agente, l’indirizzo di ricezione delle richieste.
JSON o XML?
Il JSON (versione 3.x) è quello che evolve. Le novità arrivano solo lì, e Qualipool lo raccomanda a chi inizia. L’XML è fermo alla versione 2.7 e mantenuto senza nuove funzioni, ma molti software lo esportano ancora. Entrambi descrivono gli stessi immobili.
E IDX 3.01?
IDX 3.01 è il formato più vecchio, che alcuni software esportano ancora, spesso depositando file su un server. La sua specifica non è pubblica e i suoi campi non evolvono più da tempo: SwissRETS ne è il successore.
Come lo usa ImmGate
ImmGate legge SwissRETS in JSON come in XML, che il vostro software pubblichi il documento a un indirizzo o ce lo invii. Ogni campo dello standard è letto, o scartato per una ragione scritta. Un test lo verifica a ogni modifica.