Trois façons de faire sortir vos biens du logiciel
Avant de choisir une passerelle, il faut savoir ce que votre logiciel immobilier sait produire. Presque tous proposent l'une de ces trois sorties — et le confort d'exploitation n'est pas du tout le même selon celle dont vous disposez.
| Mode d'export | Principe | Fraîcheur des données |
|---|---|---|
| Fichier plat (CSV, texte) | Un fichier de lignes déposé sur un FTP, une ligne par bien | Celle du dernier dépôt |
| Flux XML | Un fichier structuré, souvent au format d'un portail, avec les médias en pièces jointes ou en URLs | Celle de la dernière génération du flux |
| API | Le site interroge le logiciel bien par bien, à la demande | Immédiate |
Le fichier plat : simple et fragile
Un CSV déposé sur un FTP reste très répandu, notamment pour les flux dérivés des formats de portails. C'est le mode d'export le plus simple à mettre en place et le plus facile à casser : l'ordre des colonnes fait office de contrat, et personne ne le documente. Ajoutez une colonne au milieu du fichier et tout ce qui suit se décale — le nombre de pièces atterrit dans le champ « étage », la surface dans le champ « prix ».
Deux précautions changent tout :
- traiter les colonnes par nom quand un en-tête existe, jamais par position ;
- refuser un fichier dont le nombre de colonnes ne correspond pas à celui attendu, plutôt que d'importer des valeurs décalées.
Le flux XML : le format de référence
Le XML domine parce que c'est le format historique des portails d'annonces : les logiciels savent déjà le produire, puisqu'ils diffusent vers ces portails. Chaque bien est un nœud, chaque caractéristique une balise, les photos sont listées avec leur ordre d'affichage.
Ses avantages sont réels : la structure est explicite, les champs sont nommés, les valeurs à choix fermé (type de bien, mode de chauffage, exposition) sont codifiées. Ses pièges le sont tout autant.
Les codes ne veulent rien dire sans leur table
Un type de bien vaut 1, une exposition vaut SO, un mode de chauffage vaut 7. Ces codes n'ont de sens qu'avec la table de correspondance du format, et deux formats différents attribuent des sens différents au même chiffre. Une passerelle qui devine au lieu de mapper produit des fiches où toutes les maisons deviennent des appartements.
Le même mot ne désigne pas la même chose
C'est l'écueil récurrent des exports immobiliers : selon le format, une balise prix contient le prix hors honoraires ou honoraires inclus, une balise loyer contient le loyer hors charges ou charges comprises, un « parking » désigne aussi bien un box fermé qu'une place extérieure. Le sens exact se lit dans la spécification du format, pas dans le nom de la balise.
Les médias ne suivent pas toujours
Certains flux transportent les photos en base64 dans le fichier, d'autres ne fournissent que des URLs, parfois protégées ou valables quelques heures. Un flux qui référence des URLs expirées produit des annonces sans photo, alors même que le flux est correctement lu.
L'API : le plus confortable, quand elle existe
Une API permet de demander précisément ce dont on a besoin : la liste des biens modifiés depuis hier, le détail d'un bien, ses médias. Les mises à jour sont immédiates, les suppressions explicites, et les erreurs remontent avec un code plutôt qu'un silence.
Trois questions à poser avant de s'y engager :
- Y a-t-il un filtre par date de modification ? Sans lui, chaque cycle relit l'intégralité du portefeuille, ce qui n'est tenable ni pour vous ni pour l'éditeur.
- Quelles sont les limites d'appel ? Une API limitée à quelques centaines de requêtes par heure impose une stratégie de cache et d'échelonnement.
- Comment sont signalés les biens retirés ? Une API qui se contente de ne plus renvoyer un bien oblige la passerelle à déduire la suppression, avec le risque d'effacer un portefeuille entier le jour où l'API répond mal.
Le point aveugle commun aux trois : la panne
Quel que soit le mode d'export, la question décisive est la même : que fait la passerelle quand la source ne répond pas correctement ? Un flux vide, un FTP inaccessible, une API en erreur ne signifient pas « le portefeuille est vide ». Une passerelle qui interprète une panne comme une suppression dépublie tout le catalogue en une nuit.
Les garde-fous à exiger :
- ne rien supprimer si la source renvoie une erreur, un fichier vide ou tronqué ;
- refuser un cycle qui supprimerait une proportion anormale du portefeuille sans validation ;
- garder une trace horodatée de chaque cycle : biens créés, mis à jour, archivés, erreurs rencontrées.
Comment choisir
En pratique, vous ne choisissez pas vraiment : vous prenez ce que votre logiciel expose. L'ordre de préférence reste API, puis XML, puis fichier plat — mais un flux XML bien mappé et surveillé vaut mieux qu'une API mal exploitée. Ce qui fait la différence sur la durée, c'est la qualité du mapping et la gestion des cas d'erreur, pas l'élégance du protocole.
Pour aller plus loin sur la mise en œuvre, voyez le guide complet de l'intégration d'une passerelle immobilière sur WordPress.
À lire également
