Aller au contenu principal
Aller au contenu principal

Guide

SwissRETS : le standard suisse d’échange d’annonces immobilières

Mis à jour le 12 novembre 2026

En bref

SwissRETS est le format ouvert dans lequel les logiciels immobiliers suisses décrivent les biens à publier : adresse, prix, surfaces, textes en plusieurs langues, photos. Il est maintenu par Qualipool, une association d’éditeurs de logiciels et de portails, et publié librement sur GitHub. Deux versions coexistent : le JSON, qui évolue (3.6 aujourd’hui), et le XML, figé à la 2.7.

À quoi il sert

Un courtier saisit ses biens une seule fois, dans son logiciel de gestion. Le logiciel les exporte en SwissRETS, et chaque portail lit ce même document. Rien n’est ressaisi, et une modification dans le logiciel se retrouve partout.

Ce qu’un document SwissRETS contient

  • L’inventaire complet de l’agence : chaque bien en ligne, à chaque export.
  • Pour chaque bien : type et catégorie (99 catégories, de l’appartement à la place de parc), adresse et coordonnées, prix (vente, loyer net, charges, loyer brut, au mètre carré ou par période), surfaces, pièces, étage, année de construction, équipements, disponibilité.
  • Les textes (titre, description, situation) dans chaque langue publiée, avec les photos, les plans et les documents.
  • Les projets : une promotion et ses lots.
  • Le contact : l’agence, le courtier, l’adresse de réception des demandes.

JSON ou XML ?

Le JSON (version 3.x) est celui qui évolue. Les nouveautés n’arrivent que là, et Qualipool le recommande à ceux qui commencent. Le XML est figé à la version 2.7 et maintenu sans nouvelles fonctions, mais beaucoup de logiciels l’exportent encore. Les deux décrivent les mêmes biens.

Et IDX 3.01 ?

IDX 3.01 est le format plus ancien, que certains logiciels exportent encore, souvent en déposant des fichiers sur un serveur. Sa spécification n’est pas publique et ses champs n’évoluent plus depuis longtemps : SwissRETS en est le successeur.

Comment ImmGate l’utilise

ImmGate lit SwissRETS en JSON comme en XML, que votre logiciel publie le document à une adresse ou qu’il nous l’envoie. Chaque champ de la norme est lu, ou écarté pour une raison écrite. Un test le vérifie à chaque changement.

La documentation : brancher votre logiciel

Sources