TranslateSpécifications techniques — Flux XML
Guide d'intégration pour les agences partenaires
Ce document décrit le format attendu pour le flux d'annonces immobilières que votre agence peut diffuser sur VIP By HDI. Il vous permet d'automatiser la publication de vos biens sur notre plateforme sans saisie manuelle.
Mise en place du partenariat
Cette section explique comment démarrer la diffusion de vos annonces sur la plateforme. Le détail technique des champs XML figure dans les sections suivantes.
Comment ça marche
- ▸Les comptes Agences, Directions de réseau et Mandataires se créent directement sur la plateforme.
- ▸La convention de diffusion est générée automatiquement à la création du compte. Elle est disponible dans votre espace sécurisé avec les boutons « Lire », « Télécharger » et « Imprimer ».
- ▸La convention est considérée acceptée et signée dès la première diffusion d'une annonce (idem pour chaque agent commercial rattaché).
- ▸Les agents commerciaux peuvent aussi créer leur compte eux-mêmes ; une convention de diffusion est alors générée à leurs coordonnées.
Aucune installation de votre côté
Contrairement à d'autres plateformes qui demandent à votre logiciel de « pousser » un fichier vers un endpoint FTP ou une API, VIP By HDI fonctionne en mode « pull » : c'est notre serveur qui vient lire votre flux à intervalles réguliers (toutes les 6 heures). Vous n'avez rien à installer, rien à configurer côté serveur, et aucune URL de destination à renseigner.Il suffit de nous transmettre l'URL d'export de votre logiciel métier — nous faisons le reste.
Agence indépendante
Vous êtes une agence seule, non rattachée à un réseau
- 1URL du flux XML
Exportée depuis votre logiciel métier (Hektor, Apimo, Netty, Logic-Immo…)
- 2Format du flux
Poliris, Apimo, Ubiflow ou autre — détection automatique si vous ne savez pas
- 3Accès au flux
Idéalement une URL publique sans mot de passe. Si elle est protégée, communiquez-nous les identifiants
- 4Référence unique
Chaque annonce doit avoir une référence stable pour que les mises à jour et suppressions fonctionnent
Réseau d'agences ou de mandataires
Vous dirigez un réseau avec des agences ou mandataires affiliés
- 1URL du flux principal
Le flux central du réseau
- 2URL de chaque sous-flux
Un flux par mandataire ou agence affiliée
- 3Email du compte principal
C'est lui qui permet de regrouper tous les sous-flux ensemble dans l'administration
Création d'un sous-compte agent
Vous ajoutez un agent commercial rattaché à votre réseau ou agence
- 1Informations de l'agent
Renseignez les coordonnées fournies par le directeur de réseau ou d'agence (voir le formulaire ci-dessous)
- 2Invitation par email
Le compte est créé déjà validé. Un email d'invitation est envoyé à l'agent pour qu'il définisse son mot de passe
- 3URL du flux de l'agent
Si l'agent a un flux XML différent du responsable, fournissez-le. Sinon, ne pas redonner le même flux que le responsable pour éviter les annonces en doublon
En une phrase, pour l'agence :
« Pouvez-vous me transmettre l'URL de votre flux d'export XML d'annonces (depuis votre logiciel métier), accessible sans mot de passe, avec une référence unique par bien ? »
Champs pour créer un sous-compte agent
Ces informations servent à générer automatiquement la convention de diffusion du sous-compte.
* champs obligatoires
Convention de diffusion : elle est considérée comme lue et acceptée dès la première diffusion d'une annonce et vaut accord de diffusion.
1. Formats XML supportés
Notre système d'import reconnaît automatiquement la structure de votre flux XML. Aucune transformation n'est nécessaire de votre côté : exportez le flux tel quel depuis votre logiciel métier.
<annonce>Format utilisé par Hektor, Netty, Immobilier.fr, Logic-Immo…
<property>Format du logiciel Apimo (agences indépendantes)
<ad>Format Ubiflow (diffuseur multi-portails)
<item>Tout autre format XML structuré (analyse automatique)
2. Champs attendus
Le parser reconnaît de multiples noms de balises pour chaque champ (synonymes français/anglais). Le tableau ci-dessous liste les principaux. Si votre flux utilise d'autres noms, le système tente une détection automatique — sinon contactez-nous pour un mapping personnalisé.
| Champ | Balises XML reconnues | Oblig. | Note |
|---|---|---|---|
| Référence | ref, reference, id | ● | Identifiant unique de l'annonce (upsert) |
| Titre | titre, title, name | ● | Titre affiché dans l'annonce |
| Type de bien | type, bien_type, categorie | ○ | Appartement, maison, terrain… |
| Prix (€) | prix, price, montant | ● | Prix TTC en euros |
| Surface (m²) | surface, superficie, area | ○ | Surface habitable |
| Nb pièces | nb_pieces, rooms, pieces | ○ | Nombre de pièces |
| Nb chambres | nb_chambres, bedrooms | ○ | Nombre de chambres |
| Ville | ville, city, commune | ● | Commune du bien |
| Code postal | code_postal, cp, zip | ● | Code postal (département auto-déduit) |
| Description | description, texte, descriptif | ○ | Texte de l'annonce (max 1000 car.) |
| Photos | photos, images, gallery | ○ | URLs complètes (https://…), max 10 |
| DPE | dpe_lettre, classe_energie | ○ | Étiquette énergie A à G |
| Email contact | email, contact_email | ○ | Pour les sous-comptes mandataires |
| Téléphone | telephone, tel, phone | ○ | Téléphone de contact |
Référence unique : chaque annonce doit avoir une référence stable. C'est elle qui permet de détecter les annonces modifiées (mise à jour) ou retirées (suppression automatique de la plateforme).
3. Fonctionnement de la synchronisation
- ▸Fréquence automatique : toutes les 6 heures
- ▸Sync manuelle : l'administrateur peut déclencher une synchronisation immédiate à tout moment
- ▸Création : les nouvelles annonces du flux sont importées automatiquement
- ▸Mise à jour : les annonces dont la référence existe déjà sont actualisées (prix, photos, description…)
- ▸Suppression : les annonces présentes sur la plateforme mais absentes du flux sont supprimées automatiquement
- ▸Limite : 50 annonces traitées par synchronisation (par flux) pour éviter les surcharges
- ▸Photos : jusqu'à 10 photos par annonce (URLs complètes en https)
4. Réseaux d'agences & sous-comptes
Si votre structure est un réseau (franchise, groupement) avec des mandataires ou agences indépendantes, chaque sous-compte peut avoir son propre flux XML. Le système regroupe automatiquement les flux partageant le même email de compte principal.
- ↳ Flux « Agence Safti Lyon Centre » (compte principal)
- ↳ Flux « Mandataire Jean Dupont » (sous-compte)
- ↳ Flux « Mandataire Marie Martin » (sous-compte)
L'administrateur de la plateforme peut synchroniser tous les flux d'un réseau d'un seul clic.
5. Sécurité & RGPD
- ▸L'application est diffusée en France. Elle est hébergée par la plateforme Base44 (fournisseur Wix), dont les serveurs sont situés aux États-Unis.
- ▸Conformément au RGPD, les transferts de données hors de l'Union européenne sont encadrés par des Clauses Contractuelles Types (SCC) et des mécanismes approuvés garantissant un niveau de protection adéquat des données personnelles.
- ▸Les données sont chiffrées en transit (TLS) et au repos.
- ▸Vos données d'annonces ne sont jamais revendues à des tiers
- ▸Les coordonnées de contact (email, téléphone) issues du flux ne sont pas exposées publiquement
- ▸Vous pouvez demander la suspension ou suppression de vos flux à tout moment
- ▸L'URL de votre flux est stockée de manière chiffrée et n'est accessible qu'à l'administrateur plateforme
6. Comment transmettre son flux
Procédure d'intégration :
- Exportez le flux XML depuis votre logiciel métier (Hektor, Apimo, Netty…)
- Vérifiez que l'URL est accessible publiquement (sans authentification par mot de passe)
- Transmettez l'URL à l'administrateur de la plateforme par email
- L'administrateur enregistre le flux et déclenche une première synchronisation de test
- Vous recevez une confirmation avec le nombre d'annonces importées
Contact : didier.herve8@gmail.com · 0679219676
Checklist avant envoi
- ✓Le flux est au format XML valide
- ✓Chaque annonce a une référence unique stable
- ✓Les prix sont en euros ( TTC )
- ✓Les photos sont des URLs complètes en https
- ✓Le code postal et la ville sont renseignés
- ✓L'URL est accessible sans mot de passe (ou alors communiquez-le nous)
