Le logiciel ImmoFacile, édité par le groupe AC3, génère automatiquement un flux XML qui contient l'intégralité de votre portefeuille de mandats. Ce fichier est la matière première de toute synchronisation vers votre site vitrine, vos portails partenaires ou votre outil de multidiffusion. Pourtant, sa structure reste mal documentée pour les non-techniciens — et c'est souvent là que les projets de passerelle bloquent. Voici un guide complet des champs à connaître et de leur exploitation concrète pour les agences immobilières de la Somme.
Comment ImmoFacile génère son flux XML
ImmoFacile produit le flux XML selon un calendrier automatique, généralement deux à trois fois par jour. Le fichier est déposé sur un serveur FTP dédié ou accessible via une URL sécurisée communiquée par AC3 lors de la configuration. Chaque bien de votre portefeuille est représenté par un nœud <bien> ou <annonce> selon la version du format AC3 utilisée par votre agence.
La structure racine ressemble à ceci :
<biens>
<bien>
<reference>...</reference>
<transaction>...</transaction>
<typebien>...</typebien>
<prix>...</prix>
...
</bien>
</biens>
Les champs obligatoires à maîtriser
Ces champs sont présents sur tous les biens exportés et constituent le socle de votre affichage en ligne. Leur absence ou leur malformation est la première cause de rejet lors d'une intégration sur un site vitrine.
| Champ XML | Contenu | Statut |
|---|---|---|
<reference> |
Identifiant unique du mandat dans ImmoFacile. Sert de clé primaire pour les mises à jour. | Obligatoire |
<transaction> |
Type de transaction : Vente, Location, Viager. Détermine le filtrage sur votre site. |
Obligatoire |
<typebien> |
Catégorie du bien : Appartement, Maison, Terrain, Local commercial, etc. |
Obligatoire |
<prix> |
Prix en euros, sans espace ni symbole. Mis à jour à chaque génération du flux. | Obligatoire |
<surface> |
Surface habitable en m². Champ numérique. | Obligatoire |
<ville> |
Commune du bien. Utilisée pour le filtrage géographique et le SEO des pages annonces. | Obligatoire |
<codepostal> |
Code postal. Complète <ville> pour la géolocalisation et les filtres de recherche. |
Obligatoire |
<statut> |
État du bien : Disponible, Option, Compromis, Vendu. Clé pour masquer automatiquement les biens non disponibles. |
Obligatoire |
Les champs enrichis pour un affichage de qualité
Ces champs ne bloquent pas l'import s'ils sont absents, mais leur présence fait toute la différence entre une annonce basique et une annonce qui convertit.
| Champ XML | Contenu | Statut |
|---|---|---|
<descriptif> |
Texte libre de présentation du bien. Intégré tel quel dans la fiche annonce de votre site. | Recommandé |
<nb_pieces> |
Nombre de pièces principales. Affiché dans les filtres de recherche et les résumés de carte. | Recommandé |
<nb_chambres> |
Nombre de chambres. Très attendu par les acquéreurs dans les critères de recherche. | Recommandé |
<photos> / <photo> |
URLs des photos du bien hébergées sur le serveur AC3. Importées automatiquement dans la galerie de la fiche. | Recommandé |
<dpe_lettre> |
Classe énergétique (A à G). Obligatoire légalement sur les annonces publiées — à toujours renseigner dans ImmoFacile. | Recommandé |
<ges_lettre> |
Classe GES (A à G). Même obligation légale que le DPE. | Recommandé |
<mandat_exclusif> |
Booléen (1 / 0). Permet d'afficher un badge "Exclusivité" sur les annonces concernées. |
Optionnel |
<latitude> / <longitude> |
Coordonnées GPS du bien. Nécessaires pour l'affichage sur carte (Google Maps, Leaflet). | Optionnel |
Les erreurs de flux les plus fréquentes chez les agences de la Somme
Lors de la mise en place d'une passerelle entre ImmoFacile et un site vitrine, voici les problèmes que je rencontre systématiquement :
- Encodage UTF-8 mal géré : les accents et caractères spéciaux (œ, é, â) se transforment en caractères illisibles si la passerelle ne force pas l'encodage UTF-8 à la lecture du fichier XML.
- Photos non accessibles : les URLs d'images du flux AC3 pointent vers le serveur FTP d'AC3, qui peut nécessiter une authentification ou expirer. La passerelle doit rapatrier et héberger les photos localement.
- Biens en option ou sous compromis toujours affichés : si le filtre sur
<statut>n'est pas configuré, ces biens restent visibles. À gérer explicitement dans la passerelle. - Flux non mis à jour après modification de prix : une modification de prix dans ImmoFacile est répercutée dans le flux lors de la prochaine génération (toutes les 8h environ). Si la synchronisation côté site est moins fréquente, le décalage peut durer plus d'une journée.
Exploiter le flux AC3 au-delà de votre site vitrine
Une fois la passerelle XML AC3 maîtrisée, le même fichier peut être reformaté pour alimenter d'autres canaux sans aucune ressaisie : portails SeLoger et Leboncoin via leurs formats d'import propriétaires, Facebook Marketplace Immobilier, ou un réseau d'agences partenaires dans la Somme qui partage un référentiel commun de mandats.