Pourquoi maintenir un export XML
Les portails immobiliers français acceptent quasi-exclusivement du XML pour l'import de catalogues. Une agence qui veut diffuser sur SeLoger, Leboncoin, Bien'ici, Logic-Immo doit nécessairement produire un flux XML conforme au format pivot d'Ubiflow ou aux specs propres de chaque portail.
Architecture recommandée
Plutôt que de générer le XML directement dans le CRM, mieux vaut : ingérer les données dans une passerelle (Ts-Immo), normaliser au modèle unifié, puis exposer un endpoint /exports/xml qui génère à la demande le flux dans le format demandé.
Bénéfice
Cette architecture découple le CRM source des contraintes portail. Si Leboncoin change son format demain, vous modifiez la passerelle, pas tous vos CRM sources.
Les formats portails
| Portail | Format | Particularité |
|---|---|---|
| Ubiflow | Format pivot Ubiflow | Standard, riche, accepté par la plupart des portails |
| SeLoger direct | Format SeLoger propriétaire | Très spécifique, peu documenté |
| Leboncoin direct | Format LBC | Limité, contraintes strictes |
| Bien'ici | Format spécifique | Riche en data géolocalisée |
Génération à la demande vs flux statique
Deux approches : un flux statique régénéré toutes les heures (URL stable, fichier physique) ou une génération à la demande (endpoint dynamique). Les portails préfèrent les flux statiques avec checksum, pour pouvoir cacher et détecter les changements.
Exemple de structure
<?xml version="1.0" encoding="UTF-8"?>
<biens>
<bien id="ts-12345">
<reference>APT-PARIS-001</reference>
<type>appartement</type>
<transaction>vente</transaction>
<prix>485000</prix>
<surface>72.5</surface>
<pieces>3</pieces>
<ville>Paris</ville>
<code_postal>75011</code_postal>
<dpe lettre="C">145</dpe>
<ges lettre="C">28</ges>
<photos>
<photo ordre="1">https://cdn.ts-immo.org/.../1.jpg</photo>
</photos>
</bien>
</biens>Encodage et caractères spéciaux
UTF-8 obligatoire, sans BOM. Les caractères spéciaux des descriptions (apostrophes typographiques, ponctuation française) doivent être correctement échappés. Les portails rejettent silencieusement les biens avec encodage invalide.
Authentification
Les flux XML statiques sont protégés par une URL secrète (token dans l'URL) ou Basic Auth. Pour Ts-Immo, chaque agence dispose d'une URL unique avec token signé, révocable depuis le dashboard.