Qu'est-ce qu'un flux XML immobilier ?
Un flux XML immobilier est un fichier exporté périodiquement par un CRM ou un logiciel métier. Il décrit le portefeuille de biens d'une agence ou d'une étude notariale : références, prix, surfaces, descriptifs, photos, DPE, GES, géolocalisation, etc.
Pourquoi le XML reste-t-il dominant ?
- Format textuel lisible, parsing rapide et robuste
- Compatible avec des décennies d'outils immobiliers existants
- Supporte les pièces jointes (photos, plans) via références d'URL ou fichiers zip joints
- Permet la validation par XSD / DTD
Principaux formats XML supportés par Ts-Immo
| Logiciel | Format | Transport |
|---|---|---|
| Hektor | XML propriétaire (et CSV) | FTP / SFTP |
| Netty | XML / CSV | FTP |
| Iris / FNAIM | XML FNAIM | URL |
| Immofacile (AC3) | XML AC3 | URL |
| Apimo | JSON (via API) | API REST |
| Convert Immo | XML | URL |
| AdNov | XML notarial | FTP / SFTP |
| Transim | XML notarial | FTP / SFTP |
| Netprofil | XML notarial | FTP / SFTP |
Limites des flux XML bruts
- Chaque éditeur définit son propre schéma — pas de standard universel
- Encodage parfois exotique (latin1, ISO-8859-1) qui rompt sur les caractères accentués
- Photos référencées en URL ou en pièces jointes — gestion variable
- Aucune notion de différentiel (full export à chaque fois → coûteux)
- Risque de rupture lorsque l'éditeur change le schéma sans préavis
Comment Ts-Immo normalise les flux XML
Ts-Immo récupère le flux brut, détecte l'encodage, parse le XML, mappe les champs vers un modèle unifié, télécharge les photos en haute définition une par une, calcule un diff par rapport à la version précédente, puis pousse les modifications via l'API et le webhook.
Modèle unifié Ts-Immo (extrait)
{
"reference": "VENTE-1024",
"type": "vente",
"category": "appartement",
"price": 285000,
"currency": "EUR",
"surface": 72,
"rooms": 3,
"city": "Nantes",
"postalCode": "44000",
"dpe": { "value": "C", "ges": "B" },
"photos": [{ "url": "https://cdn.ts-immo.org/photos/1024-1.jpg" }]
}Bonnes pratiques pour exploiter un flux XML
- Toujours valider l'encodage avant de parser
- Garder une trace du dernier hash pour détecter les modifications réelles
- Télécharger les images une par une avec un timeout serveur agressif
- Logger chaque erreur de parsing avec la référence du bien concerné
- Mettre en place une alerte en cas de chute brutale du nombre d'annonces (rupture de flux)