Spécifications Flux Promoteur
Guide d'intégration pour la diffusion de vos programmes immobiliers neufs.
Besoin d'aide pour votre intégration ?
Pour toute demande concernant la mise en place de votre flux, contactez notre équipe technique.
Adaptabilité garantie
Les structures présentées dans ce document sont des suggestions. Nous nous adaptons à vos formats existants : XML, JSON, CSV, ou tout autre format. Notre équipe technique peut configurer l'import selon votre flux actuel.
Comment nous transmettre vos données ?
| Méthode | Description | Fréquence |
|---|---|---|
| URL simple | Un lien internet vers un fichier XML/JSON que nous consultons automatiquement | Toutes les heures |
| API REST | Endpoint API avec authentification (voir détails ci-dessous) | Toutes les heures |
| Dépôt FTP/SFTP | Un dossier partagé sécurisé où vous déposez vos fichiers | À chaque dépôt |
| Webhook | Vous nous envoyez les mises à jour en temps réel | Instantané |
| Envoi manuel de fichiers (pour démarrage ou tests) | Manuel |
Authentification API
Bearer Token Token JWT ou API key dans le header AuthorizationAPI Key Clé dans le header (X-API-Key) ou en paramètre URLBasic Auth Identifiant et mot de passeOAuth 2.0 Authentification avec refresh tokenToken URL Token directement dans l'URL (?token=xxx)Custom Header Header personnalisé selon vos spécificationsCommuniquez-nous vos paramètres d'authentification et nous configurerons l'accès à votre API.
Notes importantes
Vous n'avez pas besoin de nettoyer vos données, nous nous en chargeons :
- Description : Le HTML est nettoyé, les balises <br>, <p>, <li> sont converties en retours à la ligne
- Téléphone : Seuls les chiffres sont conservés. Le format +33 est converti en 0
- Prix et surfaces : Les virgules sont converties en points (pour les décimaux). Les espaces sont supprimés
- Caractères spéciaux : Les entités HTML (&, é, etc.) sont décodées automatiquement
Notre système compare l'ensemble du flux à chaque import. Si aucune modification n'est détectée, le programme n'est pas ré-importé (gain de performance).
Conséquence importante : Si vous modifiez une photo ou un document sans changer son URL, nous ne détecterons pas le changement. Pensez à modifier l'URL quand le contenu change.
Informations du Promoteur
| Champ | Description | Statut |
|---|---|---|
promoteur.reference |
Votre identifiant unique de promoteur | Recommandé |
promoteur.nom |
Raison sociale | Obligatoire |
promoteur.logo |
URL de votre logo (PNG ou JPG) | Recommandé |
contact.email |
Email de réception des leads. Plusieurs emails possibles :<emails><email>a@ex.com</email><email>b@ex.com</email></emails>ou <emails>a@ex.com;b@ex.com</emails>Un email spécial peut déclencher un callapi si convenu au préalable. |
Recommandé |
contact.telephone |
Téléphone de contact | Recommandé |
contact.nom |
Nom du contact | Optionnel |
contact.info |
Informations complémentaires (bureau de vente, horaires...) | Optionnel |
| Champ | Description |
|---|---|
promoteur.labels_qualite |
Labels : NF Habitat, HQE, ISO... |
promoteur.garanties |
Garanties spécifiques proposées |
promoteur.engagements_rse |
Engagements environnementaux et sociaux |
promoteur.accompagnement |
Services d'accompagnement client |
promoteur.financement |
Dispositifs de financement proposés (prêt à taux préférentiel, partenariat bancaire, paiement échelonné, frais de notaire offerts...) |
Si vous fournissez un logo de copromotion, tous les visuels des promoteurs doivent être présents dans celui-ci.
| Champ | Description |
|---|---|
copromotion.nom |
Nom du co-promoteur |
copromotion.logo |
Logo du co-promoteur (URL PNG ou JPG) |
Identification du Programme
| Champ | Description | Statut |
|---|---|---|
reference.interne |
Votre référence interne unique | Obligatoire |
reference.api_key |
Identifiant unique pour l'API | Recommandé |
nom |
Nom commercial du programme | Obligatoire |
Localisation
| Champ | Description | Statut |
|---|---|---|
adresse |
Adresse complète | Obligatoire |
code_postal |
Code postal (5 chiffres) | Obligatoire |
ville |
Nom de la ville | Obligatoire |
latitude |
Coordonnée GPS (ex: 45.7485) | Recommandé |
longitude |
Coordonnée GPS (ex: 4.8467) | Recommandé |
Livraison et Avancement
Option 1 : Date complète (recommandée)
| Champ | Description | Exemple |
|---|---|---|
livraison.date |
Date de livraison au format AAAA-MM-JJ | 2025-12-15 |
Nous convertissons automatiquement en année + trimestre.
Option 2 : Année et trimestre
| Champ | Description | Exemple |
|---|---|---|
livraison.annee |
Année de livraison | 2025 |
livraison.trimestre |
Trimestre de livraison (1 à 4) | 4 |
Option 3 : Plusieurs dates (livraisons échelonnées)
<livraison>
<dates>
<date>2025-06-01</date>
<date>2025-12-01</date>
</dates>
</livraison>
Nous prenons la date la plus récente.
| Valeur | Signification |
|---|---|
avant_premiere |
Avant-première |
lancement_commercial |
Lancement commercial |
travaux_en_cours |
Travaux en cours |
livraison_immediate |
Livraison immédiate |
deja_livre |
Déjà livré |
dernieres_opportunites |
Dernières opportunités |
nouvelle_realisation |
Nouvelle réalisation |
Contenu
| Champ | Description | Statut |
|---|---|---|
nom |
Titre du programme | Obligatoire |
description |
Description complète du programme | Obligatoire |
plaquette |
URL de la plaquette PDF | Optionnel |
website |
Site web du programme | Optionnel |
video |
URL vidéo de présentation | Optionnel |
5 points clés (nouveauté recommandée)
Champ : points_cles (tableau de 5 éléments maximum)
points_cles:
- "Vue panoramique sur la mer"
- "À 5 min du métro ligne B"
- "Espaces verts privatifs"
- "Certifié RE2020"
- "Livraison T4 2025"
Description de l'Environnement
| Champ | Description | Exemple |
|---|---|---|
environnement.transports.metro |
Métro le plus proche | "Ligne B - Jean Macé à 200m" |
environnement.transports.bus |
Lignes de bus | "Lignes C7, C12" |
environnement.transports.tram |
Tramway | "T1 à 300m" |
environnement.transports.train |
Gare | "Gare Part-Dieu à 10 min" |
environnement.transports.autoroute |
Accès autoroutier | "A7 à 5 min" |
environnement.commerces |
Commerces de proximité | "Centre commercial à 500m" |
environnement.ecoles.creche |
Crèches | "Crèche municipale à 100m" |
environnement.ecoles.primaire |
Écoles primaires | "École Jean Moulin à 300m" |
environnement.ecoles.college |
Collèges | "Collège à 800m" |
environnement.ecoles.lycee |
Lycées | "Lycée à 1km" |
environnement.ecoles.universite |
Universités | "Campus Lyon 2 à 15 min" |
environnement.loisirs |
Espaces verts, loisirs | "Parc de Gerland à 5 min" |
environnement.sante |
Services de santé | "Médecins et pharmacies à 200m" |
Description de la Ville / Quartier
| Champ | Description |
|---|---|
ville_description.presentation |
Présentation générale de la ville |
ville_description.economie |
Dynamisme économique |
ville_description.projets_urbains |
Projets urbains en cours |
ville_description.qualite_vie |
Qualité de vie |
Informations sur la Résidence
| Champ | Description |
|---|---|
residence.services |
Services collectifs (piscine, salle de sport, coworking...) |
residence.gardien |
Présence d'un gardien/concierge (oui/non) |
residence.local_velos |
Local vélos sécurisé (oui/non) |
residence.bornes_recharge |
Bornes de recharge électrique (oui/non) |
residence.espaces_verts |
Description des espaces verts privatifs |
residence.accessibilite_pmr |
Accessibilité PMR |
| Champ | Description |
|---|---|
copropriete.nb_logements |
Nombre total de logements dans la résidence |
copropriete.nb_etages |
Nombre d'étages du bâtiment |
copropriete.nb_batiments |
Nombre de bâtiments |
copropriete.architecte |
Nom du cabinet d'architectes |
copropriete.paysagiste |
Nom du paysagiste |
copropriete.decorateur |
Nom du décorateur intérieur |
Prestations Intérieures
| Champ | Description |
|---|---|
prestations.cuisine.equipee |
Cuisine équipée (oui/non) |
prestations.cuisine.amenagee |
Cuisine aménagée (oui/non) |
prestations.cuisine.description |
Description des équipements (four, plaques, hotte, etc.) |
prestations.cuisine.marque |
Marque des équipements électroménagers |
| Champ | Description |
|---|---|
prestations.sdb.description |
Description des équipements sanitaires |
prestations.sdb.marque |
Marque des sanitaires (Grohe, Jacob Delafon, etc.) |
prestations.sdb.paroi_douche |
Paroi de douche incluse (oui/non) |
prestations.sdb.meuble_vasque |
Meuble vasque inclus (oui/non) |
| Champ | Description |
|---|---|
prestations.sols.sejour |
Type de sol séjour (parquet, carrelage, etc.) |
prestations.sols.chambres |
Type de sol chambres |
prestations.sols.pieces_eau |
Type de sol pièces d'eau |
prestations.murs.description |
Description des finitions murales |
prestations.menuiseries.type |
Type de menuiseries (PVC, aluminium, bois) |
prestations.volets.type |
Type de volets (roulants électriques, battants, etc.) |
| Champ | Description |
|---|---|
prestations.chauffage.type |
Type de chauffage (collectif, individuel, pompe à chaleur, etc.) |
prestations.chauffage.energie |
Énergie utilisée (gaz, électrique, géothermie, etc.) |
prestations.climatisation |
Climatisation incluse (oui/non) |
prestations.vmc |
Type de VMC (simple flux, double flux) |
| Champ | Description |
|---|---|
prestations.domotique |
Équipements domotiques (oui/non ou description) |
prestations.fibre |
Pré-câblage fibre optique (oui/non) |
prestations.videophone |
Vidéophone / interphone (oui/non) |
Dispositifs Fiscaux et Normes
true ou false
ptz Prêt à Taux Zéropinel Loi Pinelpinel_plus Pinel +tva_reduite TVA réduite 5.5%brs Bail Réel Solidairepsla PSLAjeanbrun Jeanbrunlmnp LMNPlmnp_gere LMNP gérélmp_lmnp LMP/LMNPnue_propriete Nue-propriétépls PLSlli LLIbepas BEPASprix_maitrises Prix maîtrisésre2020 RE 2020re2025 RE 2025bbc BBCrt_2012 RT 2012rt_2005 RT 2005nf Norme NFhqe HQEnf_hqe NF HQEhpe HPEthpe THPEhe HEbiosource Biosourcéresidence_senior Résidence seniorresidence_etudiante Résidence étudianteimmeubles_bureaux Immeubles de bureau| Champ | Description | Valeurs |
|---|---|---|
dpe.classe_energie |
Classe énergie du DPE | A, B, C, D, E, F, G |
dpe.valeur_energie |
Consommation énergétique (kWh/m²/an) | nombre |
dpe.classe_ges |
Classe GES (gaz à effet de serre) | A, B, C, D, E, F, G |
dpe.valeur_ges |
Émission GES (kgCO₂/m²/an) | nombre |
dpe.date |
Date du diagnostic | AAAA-MM-JJ |
| Champ | Description |
|---|---|
chantier.date_permis |
Date d'obtention du permis de construire |
chantier.date_debut |
Date de démarrage des travaux |
chantier.pourcentage |
Pourcentage d'avancement (0-100) |
chantier.phase |
Phase actuelle (terrassement, gros œuvre, second œuvre, finitions) |
chantier.description |
Description de l'avancement |
chantier.webcam |
URL de la webcam chantier (si disponible) |
Commercialisation
| Champ | Description | Valeurs |
|---|---|---|
commercialisation.statut |
Statut commercial du programme | avant_premiere, commercialisation, derniers_lots, complet |
commercialisation.date_ouverture |
Date d'ouverture des ventes | AAAA-MM-JJ |
commercialisation.lots_disponibles |
Nombre de lots encore disponibles | nombre |
commercialisation.lots_total |
Nombre total de lots du programme | nombre |
commercialisation.pourcentage_vendu |
Pourcentage de lots vendus | 0-100 |
| Champ | Description |
|---|---|
bureau_vente.adresse |
Adresse du bureau de vente / appartement témoin |
bureau_vente.horaires |
Horaires d'ouverture |
bureau_vente.sur_rdv |
Visite sur rendez-vous uniquement (oui/non) |
bureau_vente.appartement_temoin |
Appartement témoin disponible (oui/non) |
bureau_vente.latitude |
Coordonnée GPS latitude |
bureau_vente.longitude |
Coordonnée GPS longitude |
evenements.evenement[]
| Champ | Description |
|---|---|
evenement.type |
Type d'événement (portes_ouvertes, vente_privee, inauguration, webinaire) |
evenement.nom |
Nom de l'événement |
evenement.date_debut |
Date et heure de début |
evenement.date_fin |
Date et heure de fin |
evenement.lieu |
Lieu de l'événement |
evenement.description |
Description de l'événement |
evenement.inscription_url |
URL d'inscription (si en ligne) |
Données Investissement
| Champ | Description | Exemple |
|---|---|---|
investissement.loyer_estime |
Loyer mensuel estimé (€/mois) | 850 |
investissement.rentabilite_brute |
Rentabilité brute estimée (%) | 4.2 |
investissement.rentabilite_nette |
Rentabilité nette estimée (%) | 3.1 |
investissement.reduction_impot_pinel |
Réduction d'impôt Pinel estimée (€/an) | 4000 |
investissement.plafond_loyer_pinel |
Plafond de loyer Pinel applicable (€/m²) | 13.09 |
investissement.zone_pinel |
Zone Pinel du programme | A, A bis, B1, B2, C |
investissement.simulation_url |
URL vers un simulateur d'investissement | https://... |
Lots / Typologies
Option 1 : Lots détaillés (recommandée pour une meilleure qualité d'affichage)
Fournissez chaque lot individuellement avec toutes ses caractéristiques.
Option 2 : Agrégation par typologie (si vous n'avez pas le détail)
Si vous ne disposez pas du détail de chaque lot, fournissez un résumé par typologie :
prix min/max, surface min/max, quantité disponible par nombre de pièces.
| Champ | Description | Statut |
|---|---|---|
reference.interne |
Référence du lot (doit être unique et stable) | Obligatoire |
reference.api_key |
Identifiant API du lot | Recommandé |
propriete |
Type de bien | Obligatoire |
nb_pieces |
Nombre de pièces | Recommandé |
prix_min |
Prix minimum (en euros) | Recommandé |
prix_max |
Prix maximum (en euros) | Optionnel |
tva |
Taux de TVA applicable (20 ou 5.5) | Recommandé |
prix_tva_reduite_min |
Prix TVA réduite min (si TVA 5.5%) | Optionnel |
prix_tva_reduite_max |
Prix TVA réduite max (si TVA 5.5%) | Optionnel |
surface_min |
Surface min (en m²) | Recommandé |
surface_max |
Surface max (en m²) | Optionnel |
description |
Description du lot (utilisée pour la diffusion en stock dur) | Optionnel |
statut |
Statut du lot | Optionnel |
plan |
URL du plan | Optionnel |
La référence interne doit rester identique pour un même lot au fil du temps. C'est grâce à cette référence que nous identifions les lots vendus ou retirés.
Deux approches sont possibles :
- Option 1 : Ajoutez un champ
statutsur chaque lot (disponible, réservé, vendu) et transmettez l'intégralité de votre stock. Nous gérons les mises à jour de statut de notre côté. - Option 2 : Ne transmettez que les lots disponibles à la vente, en excluant les lots vendus ou réservés de votre flux.
Les deux approches sont compatibles, choisissez celle qui est la plus simple à mettre en place de votre côté.
prix_tva_reduite_min / prix_tva_reduite_max), précisez le taux dans le champ tva.
Si vous fournissez des valeurs _min et _max différentes (prix, surface), nous basculons en mode compact :
un seul lot est affiché par typologie avec une fourchette de prix/surface.
Exemple : "T3 à partir de 250 000 € - de 65 à 72 m²"
brs dans les options du lot.
appartement Appartementmaison Maisonterrain Terrainparking Parkinglocal_commercial Local commercialbureau Bureaudisponible Lot disponible à la ventereserve Lot réservé (option en cours)vendu Lot vendu| Champ | Description | Type |
|---|---|---|
duplex | Est un duplex | oui/non |
triplex | Est un triplex | oui/non |
etage_min | Étage minimum | nombre |
etage_max | Étage maximum | nombre |
nb_chambres_min | Nombre de chambres min | nombre |
nb_chambres_max | Nombre de chambres max | nombre |
surface_terrain_min | Surface terrain min | m² |
surface_terrain_max | Surface terrain max | m² |
parking | Nombre de parkings | nombre |
balcon | Présence balcon | oui/non |
surface_balcon | Surface balcon | m² |
terrasse | Présence terrasse | oui/non |
surface_terrasse | Surface terrasse | m² |
jardin | Présence jardin | oui/non |
surface_jardin | Surface jardin | m² |
loggia | Présence loggia | oui/non |
surface_loggia | Surface loggia | m² |
cave | Présence cave | oui/non |
surface_cave | Surface cave | m² |
brs | Lot éligible BRS (Bail Réel Solidaire) | oui/non |
stock_dur | Diffusion en stock dur sur Superimmo.com | oui/non |
L'option stock_dur permet de diffuser le lot en tant qu'annonce dans l'ancien sur Superimmo.com (et non uniquement sur Superneuf).
Pour activer cette fonctionnalité :
- Renseignez le champ
descriptiondu lot avec une description détaillée - Passez l'option
stock_duràouioutrue
Note : cette diffusion n'est possible que si votre contrat le prévoit. Contactez-nous pour plus d'informations.
Orientations
nordsudestouestnord_estnord_ouestsud_estsud_ouest| Champ | Description |
|---|---|
tma.disponible |
TMA disponibles pour ce lot (oui/non) |
tma.date_limite |
Date limite pour demander des TMA |
tma.description |
Description des personnalisations possibles |
tma.options |
Liste des options disponibles (tableau) |
Options de personnalisation courantes
cuisine_equipee Cuisine équipéeparquet Parquet dans les chambresplacard Placards sur mesureclimatisation Climatisation réversibledomotique Pack domotiquecarrelage_premium Carrelage premiumVous pouvez également définir les TMA au niveau du programme entier avec les mêmes champs dans programme.tma.
Photos
| Champ | Description | Statut |
|---|---|---|
url |
URL de l'image (JPEG, PNG) | Obligatoire |
position |
Ordre d'affichage (1, 2, 3...) | Recommandé |
legende |
Légende de la photo | Optionnel |
Notre système détecte les changements en comparant les URLs des photos.
Si vous modifiez une image sans changer son URL, la mise à jour ne sera pas détectée.
Bonnes pratiques :
- Utilisez un nom de fichier différent pour chaque nouvelle version (ex:
facade-v2.jpg) - Ou ajoutez un paramètre de version à l'URL (ex:
facade.jpg?v=2) - Ou incluez un timestamp dans le nom (ex:
facade-20240315.jpg)
Notre système télécharge les images en parallèle pour optimiser les temps d'import.
Si votre serveur a des restrictions (limite de requêtes par seconde, rate limiting...), merci de nous en informer pour que nous adaptions notre configuration.
Nos adresses IP publiques :
146.185.45.94146.185.45.103146.185.45.209
Pensez à les autoriser si vous avez un pare-feu ou des règles de filtrage.
Documents et Visites Virtuelles
Les documents peuvent être associés :
- Au programme : plaquette commerciale, vidéo de présentation, visite virtuelle de la résidence
- Au lot : plan du lot, visite virtuelle de l'appartement, vue 3D spécifique
Précisez le niveau dans la structure du flux pour un affichage optimal.
Documents globaux associés à l'ensemble du programme (dans documents.document[])
| Champ | Description | Valeurs possibles |
|---|---|---|
code |
URL ou code du document | URL complète |
type |
Type de document | video, visite_3d, gif |
categorie |
Catégorie du document | visite_virtuelle, plaquette, video_presentation |
Types de documents courants au niveau programme
visite_virtuelle Visite 3D de la résidenceplaquette Plaquette commerciale PDFvideo_presentation Vidéo de présentationvideo_drone Vue aérienne dronevue_3d Vue 3D extérieure
Documents spécifiques à un lot (dans lots.lot[].documents.document[] ou via le champ plan)
| Champ | Description |
|---|---|
plan |
URL du plan du lot (PDF ou image) |
visite_virtuelle |
URL de la visite virtuelle du lot |
vue_3d |
URL de la vue 3D intérieure |
YouTube, Vimeo, Habiteo, Axeon, VirtualBuilding, Evimmo, LD3D, MyLumion, Visiolab, Viewwer, Rhinov, Archithèse, Habx, Miysis, VOR Immobilier, MP4 direct
Offres Spéciales
| Champ | Description | Statut |
|---|---|---|
reference |
Référence de l'offre | Recommandé |
nom |
Nom de l'offre | Obligatoire |
accroche |
Accroche / titre court | Optionnel |
description |
Description de l'offre | Obligatoire |
mentions_legales |
Mentions légales | Recommandé |
date_debut |
Date de début (AAAA-MM-JJ) | Optionnel |
date_fin |
Date de fin (AAAA-MM-JJ) | Optionnel |
Exemples Complets
{
"programmes": {
"programme": {
// ══════════════════════════════════════════════════════════════════════
// PROMOTEUR
// ══════════════════════════════════════════════════════════════════════
"promoteur": {
"reference": "PROMO-001",
"nom": "Mon Promoteur",
"logo": "https://cdn.promoteur.com/mon-promoteur-logo.png",
"labels_qualite": ["NF Habitat", "HQE", "ISO 9001"],
"garanties": "Garantie décennale, garantie de parfait achèvement, assurance dommages-ouvrage",
"engagements_rse": "Objectif neutralité carbone 2030, matériaux biosourcés, biodiversité préservée",
"accompagnement": "Conseiller dédié, suivi personnalisé, visites de chantier régulières",
"dispositif_financement": "Partenariat avec 15 banques, simulation de prêt gratuite, accompagnement PTZ"
},
// ══════════════════════════════════════════════════════════════════════
// COPROMOTION (si applicable)
// ══════════════════════════════════════════════════════════════════════
"copromotion": {
"nom": "Partenaire Immo",
"logo": "https://cdn.promoteur.com/partenaire-immo-logo.png"
},
// ══════════════════════════════════════════════════════════════════════
// IDENTIFICATION DU PROGRAMME
// ══════════════════════════════════════════════════════════════════════
"reference": {
"interne": "PRG-2024-LYON-001",
"api_key": "abc123xyz789"
},
// ══════════════════════════════════════════════════════════════════════
// CONTACT
// ══════════════════════════════════════════════════════════════════════
"contact": {
"nom": "Marie Dupont",
"email": "contact.lyon@promoteur.fr",
"telephone": "04 72 00 00 00",
"info": "Bureau de vente : 12 rue de la République, 69002 Lyon. Ouvert du lundi au samedi 10h-19h, dimanche sur RDV."
},
// ══════════════════════════════════════════════════════════════════════
// CONTENU MARKETING
// ══════════════════════════════════════════════════════════════════════
"nom": "Les Jardins de Confluence",
"description": "Au cœur du quartier de la Confluence, découvrez une résidence d'exception qui conjugue architecture contemporaine et art de vivre. Les Jardins de Confluence vous proposent des appartements du studio au 5 pièces, baignés de lumière grâce à leurs larges ouvertures sur les espaces verts privatifs.\n\nChaque logement bénéficie de prestations haut de gamme : parquet chêne massif, cuisine équipée Siemens, domotique intégrée, et performances énergétiques exemplaires certifiées RE2020.\n\nLa résidence dispose d'un jardin paysager de 2000m², d'une salle de fitness, d'un espace de coworking et d'un local vélos sécurisé avec bornes de recharge.",
"points_cles": [
"Vue panoramique sur le parc de Confluence",
"À 300m du métro ligne B - Station Perrache",
"Résidence certifiée RE2020 et NF Habitat HQE",
"Éligible PTZ et TVA réduite 5.5%",
"Livraison 4ème trimestre 2026"
],
"plaquette": "https://cdn.promoteur.com/jardins-confluence-plaquette.pdf",
"website": "https://www.jardins-confluence.fr",
// ══════════════════════════════════════════════════════════════════════
// LOCALISATION
// ══════════════════════════════════════════════════════════════════════
"adresse": "45 quai Rambaud",
"code_postal": "69002",
"ville": "Lyon",
"latitude": "45.7402",
"longitude": "4.8180",
// ══════════════════════════════════════════════════════════════════════
// LIVRAISON ET AVANCEMENT
// ══════════════════════════════════════════════════════════════════════
"livraison": {
"date": "2026-12-15"
},
"progress_state": "travaux_en_cours",
// ══════════════════════════════════════════════════════════════════════
// ENVIRONNEMENT
// ══════════════════════════════════════════════════════════════════════
"environnement": {
"transports": {
"metro": "Ligne B - Perrache à 300m, Ligne A - Ampère à 600m",
"bus": "Lignes C7, C10, C14 à 100m",
"tram": "T1 Debourg à 400m",
"train": "Gare de Perrache à 5 min à pied, Part-Dieu à 10 min en métro",
"autoroute": "A7 Perrache à 3 min en voiture"
},
"commerces": "Centre commercial Confluence (120 boutiques) à 200m, marché dominical quai Perrache, supermarchés Carrefour et Monoprix",
"ecoles": {
"creche": "Crèche municipale Les Petits Confluents à 150m, micro-crèche Babilou à 300m",
"maternelle": "École maternelle Confluence à 200m",
"primaire": "École élémentaire Michel Servet à 350m",
"college": "Collège Jean de Verrazane à 800m",
"lycee": "Lycée Ampère à 1.2km, Lycée La Martinière à 1.5km",
"universite": "Université Catholique de Lyon à 10 min, Campus Lyon 2 Berges du Rhône à 15 min"
},
"loisirs": "Parc de Confluence 15ha à 100m, Musée des Confluences à 500m, cinéma UGC Confluence, piscine de Gerland à 10 min",
"sante": "Maison médicale Confluence à 200m, pharmacies à 100m, Hôpital Lyon Sud à 15 min, clinique du Parc à 10 min"
},
// ══════════════════════════════════════════════════════════════════════
// DESCRIPTION VILLE / QUARTIER
// ══════════════════════════════════════════════════════════════════════
"ville_description": {
"presentation": "La Confluence est l'un des projets urbains les plus ambitieux d'Europe. Ce nouveau quartier de Lyon, situé entre Rhône et Saône, allie architecture audacieuse, innovation environnementale et qualité de vie exceptionnelle.",
"economie": "Pôle économique majeur avec 25 000 emplois à terme, siège de grandes entreprises (Euronews, GL Events), incubateurs et espaces de coworking.",
"projets_urbains": "Extension du quartier vers le sud (Confluence 2), nouvelle ligne de métro E prévue pour 2030, création d'un parc de 6 hectares.",
"qualite_vie": "Premier quartier durable WWF en France, espaces verts omniprésents, berges aménagées pour piétons et cyclistes, vie culturelle riche."
},
// ══════════════════════════════════════════════════════════════════════
// INFORMATIONS SUR LA RÉSIDENCE
// ══════════════════════════════════════════════════════════════════════
"residence": {
"services": ["Salle de fitness", "Espace de coworking", "Local poussettes", "Conciergerie connectée"],
"gardien": "oui",
"local_velos": "oui",
"bornes_recharge": "oui",
"espaces_verts": "Jardin paysager privatif de 2000m² avec aires de jeux pour enfants et potager partagé",
"accessibilite_pmr": "100% des logements et parties communes accessibles PMR, ascenseurs aux normes"
},
// ══════════════════════════════════════════════════════════════════════
// DISPOSITIFS FISCAUX ET NORMES
// ══════════════════════════════════════════════════════════════════════
"ptz": true,
"pinel": false,
"pinel_plus": true,
"tva_5_5": true,
"brs": true,
"psla": false,
"lmnp": false,
"lmnp_gere": false,
"nue_propriete": false,
"pls": false,
"lli": false,
"prix_maitrises": true,
"re2020": true,
"bbc": true,
"nf": true,
"hqe": true,
"nfhqe": true,
"biosource": true,
"senior": false,
"etudiant": false,
// ══════════════════════════════════════════════════════════════════════
// LOTS / TYPOLOGIES
// ══════════════════════════════════════════════════════════════════════
"lots": {
"lot": [
{
"reference": {
"interne": "LOT-A-101",
"api_key": "lot-a101-xyz"
},
"propriete": "appartement",
"nb_pieces": "3",
"prix_min": "385000",
"prix_tva_reduite_min": "352000",
"surface_min": "68.5",
"description": "Magnifique T3 traversant avec double exposition Est-Ouest. Séjour lumineux de 32m² ouvrant sur une terrasse de 12m², cuisine équipée, 2 chambres avec placards intégrés, salle de bain avec douche à l'italienne.",
"plan": "https://cdn.promoteur.com/plans/lot-a101.pdf",
"duplex": false,
"triplex": false,
"etage_min": "4",
"etage_max": "4",
"nb_chambres_min": "2",
"nb_chambres_max": "2",
"parking": "1",
"balcon": false,
"terrasse": true,
"surface_terrasse": "12",
"jardin": false,
"loggia": false,
"cave": true,
"surface_cave": "5",
"orientations": {
"orientation": ["est", "ouest"]
},
"brs": true,
"stock_dur": false,
"photos": {
"photo": [
{
"url": "https://cdn.promoteur.com/photos/lot-a101-sejour.jpg",
"position": "1",
"legende": "Séjour avec vue sur le parc"
},
{
"url": "https://cdn.promoteur.com/photos/lot-a101-terrasse.jpg",
"position": "2",
"legende": "Terrasse de 12m²"
}
]
}
},
{
"reference": {
"interne": "LOT-B-201"
},
"propriete": "appartement",
"nb_pieces": "2",
"prix_min": "265000",
"prix_tva_reduite_min": "242000",
"surface_min": "45.2",
"etage_min": "2",
"nb_chambres_min": "1",
"parking": "1",
"balcon": true,
"surface_balcon": "6.5",
"cave": true,
"orientations": {
"orientation": ["sud"]
}
},
{
"reference": {
"interne": "LOT-C-001"
},
"propriete": "maison",
"nb_pieces": "5",
"prix_min": "580000",
"surface_min": "125",
"surface_terrain_min": "250",
"nb_chambres_min": "4",
"parking": "2",
"terrasse": true,
"surface_terrasse": "25",
"jardin": true,
"surface_jardin": "180"
},
{
"reference": {
"interne": "LOT-P-001"
},
"propriete": "parking",
"nb_pieces": "0",
"prix_min": "25000",
"description": "Place de parking en sous-sol niveau -1, accès sécurisé par badge"
}
]
},
// ══════════════════════════════════════════════════════════════════════
// PHOTOS DU PROGRAMME
// ══════════════════════════════════════════════════════════════════════
"photos": {
"photo": [
{
"url": "https://cdn.promoteur.com/photos/facade-principale.jpg",
"position": "1",
"legende": "Vue de la façade principale"
},
{
"url": "https://cdn.promoteur.com/photos/jardin-paysager.jpg",
"position": "2",
"legende": "Jardin paysager privatif"
},
{
"url": "https://cdn.promoteur.com/photos/hall-entree.jpg",
"position": "3",
"legende": "Hall d'entrée avec conciergerie"
},
{
"url": "https://cdn.promoteur.com/photos/vue-aerienne.jpg",
"position": "4",
"legende": "Vue aérienne du quartier"
},
{
"url": "https://cdn.promoteur.com/photos/salle-fitness.jpg",
"position": "5",
"legende": "Salle de fitness résidents"
}
]
},
// ══════════════════════════════════════════════════════════════════════
// DOCUMENTS ET VISITES VIRTUELLES
// ══════════════════════════════════════════════════════════════════════
"documents": {
"document": [
{
"code": "https://www.youtube.com/watch?v=abc123xyz",
"type": "video"
},
{
"code": "https://visitevirtuelle.habiteo.com/confluence-lyon",
"type": "visite_3d"
},
{
"code": "https://vimeo.com/987654321",
"type": "video"
}
]
},
// ══════════════════════════════════════════════════════════════════════
// OFFRES SPÉCIALES
// ══════════════════════════════════════════════════════════════════════
"offres": {
"offre": [
{
"reference": "OFF-2024-NOTAIRE",
"nom": "Frais de notaire offerts",
"accroche": "Profitez de cette offre exceptionnelle !",
"description": "Pour toute réservation d'un T3 ou plus avant le 30 juin 2024, les frais de notaire sont intégralement pris en charge par le promoteur. Une économie pouvant aller jusqu'à 8000€.",
"mentions_legales": "Offre valable pour toute signature d'un contrat de réservation entre le 01/03/2024 et le 30/06/2024. Non cumulable avec d'autres offres promotionnelles. Voir conditions en bureau de vente.",
"date_debut": "2024-03-01",
"date_fin": "2024-06-30"
},
{
"reference": "OFF-2024-CUISINE",
"nom": "Cuisine équipée offerte",
"accroche": "Votre cuisine Siemens offerte",
"description": "Une cuisine entièrement équipée (four, plaque induction, hotte, réfrigérateur, lave-vaisselle) de marque Siemens d'une valeur de 5000€ offerte pour toute réservation.",
"mentions_legales": "Offre valable dans la limite des stocks disponibles. Modèles et coloris selon disponibilité.",
"date_debut": "2024-01-01",
"date_fin": "2024-12-31"
}
]
}
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<programmes>
<programme>
<!-- ══════════════════════════════════════════════════════════════════════
PROMOTEUR
══════════════════════════════════════════════════════════════════════ -->
<promoteur>
<reference>PROMO-001</reference>
<nom>Mon Promoteur</nom>
<logo>https://cdn.promoteur.com/mon-promoteur-logo.png</logo>
<labels_qualite>
<label>NF Habitat</label>
<label>HQE</label>
<label>ISO 9001</label>
</labels_qualite>
<garanties>Garantie décennale, garantie de parfait achèvement, assurance dommages-ouvrage</garanties>
<engagements_rse>Objectif neutralité carbone 2030, matériaux biosourcés, biodiversité préservée</engagements_rse>
<accompagnement>Conseiller dédié, suivi personnalisé, visites de chantier régulières</accompagnement>
<dispositif_financement>Partenariat avec 15 banques, simulation de prêt gratuite, accompagnement PTZ</dispositif_financement>
</promoteur>
<!-- ══════════════════════════════════════════════════════════════════════
COPROMOTION (si applicable)
══════════════════════════════════════════════════════════════════════ -->
<copromotion>
<nom>Partenaire Immo</nom>
<logo>https://cdn.promoteur.com/partenaire-immo-logo.png</logo>
</copromotion>
<!-- ══════════════════════════════════════════════════════════════════════
IDENTIFICATION DU PROGRAMME
══════════════════════════════════════════════════════════════════════ -->
<reference>
<interne>PRG-2024-LYON-001</interne>
<api_key>abc123xyz789</api_key>
</reference>
<!-- ══════════════════════════════════════════════════════════════════════
CONTACT
══════════════════════════════════════════════════════════════════════ -->
<contact>
<nom>Marie Dupont</nom>
<email>contact.lyon@promoteur.fr</email>
<telephone>04 72 00 00 00</telephone>
<info>Bureau de vente : 12 rue de la République, 69002 Lyon. Ouvert du lundi au samedi 10h-19h, dimanche sur RDV.</info>
</contact>
<!-- ══════════════════════════════════════════════════════════════════════
CONTENU MARKETING
══════════════════════════════════════════════════════════════════════ -->
<nom>Les Jardins de Confluence</nom>
<description>Au cœur du quartier de la Confluence, découvrez une résidence d'exception qui conjugue architecture contemporaine et art de vivre. Les Jardins de Confluence vous proposent des appartements du studio au 5 pièces, baignés de lumière grâce à leurs larges ouvertures sur les espaces verts privatifs.
Chaque logement bénéficie de prestations haut de gamme : parquet chêne massif, cuisine équipée Siemens, domotique intégrée, et performances énergétiques exemplaires certifiées RE2020.
La résidence dispose d'un jardin paysager de 2000m², d'une salle de fitness, d'un espace de coworking et d'un local vélos sécurisé avec bornes de recharge.</description>
<points_cles>
<point>Vue panoramique sur le parc de Confluence</point>
<point>À 300m du métro ligne B - Station Perrache</point>
<point>Résidence certifiée RE2020 et NF Habitat HQE</point>
<point>Éligible PTZ et TVA réduite 5.5%</point>
<point>Livraison 4ème trimestre 2026</point>
</points_cles>
<plaquette>https://cdn.promoteur.com/jardins-confluence-plaquette.pdf</plaquette>
<website>https://www.jardins-confluence.fr</website>
<!-- ══════════════════════════════════════════════════════════════════════
LOCALISATION
══════════════════════════════════════════════════════════════════════ -->
<adresse>45 quai Rambaud</adresse>
<code_postal>69002</code_postal>
<ville>Lyon</ville>
<latitude>45.7402</latitude>
<longitude>4.8180</longitude>
<!-- ══════════════════════════════════════════════════════════════════════
LIVRAISON ET AVANCEMENT
══════════════════════════════════════════════════════════════════════ -->
<!-- Option 1 : Date complète (recommandée) -->
<livraison>
<date>2026-12-15</date>
</livraison>
<!-- Option 2 : Année + trimestre
<livraison>
<annee>2026</annee>
<trimestre>4</trimestre>
</livraison>
-->
<progress_state>travaux_en_cours</progress_state>
<!-- ══════════════════════════════════════════════════════════════════════
ENVIRONNEMENT
══════════════════════════════════════════════════════════════════════ -->
<environnement>
<transports>
<metro>Ligne B - Perrache à 300m, Ligne A - Ampère à 600m</metro>
<bus>Lignes C7, C10, C14 à 100m</bus>
<tram>T1 Debourg à 400m</tram>
<train>Gare de Perrache à 5 min à pied, Part-Dieu à 10 min en métro</train>
<autoroute>A7 Perrache à 3 min en voiture</autoroute>
</transports>
<commerces>Centre commercial Confluence (120 boutiques) à 200m, marché dominical quai Perrache, supermarchés Carrefour et Monoprix</commerces>
<ecoles>
<creche>Crèche municipale Les Petits Confluents à 150m, micro-crèche Babilou à 300m</creche>
<maternelle>École maternelle Confluence à 200m</maternelle>
<primaire>École élémentaire Michel Servet à 350m</primaire>
<college>Collège Jean de Verrazane à 800m</college>
<lycee>Lycée Ampère à 1.2km, Lycée La Martinière à 1.5km</lycee>
<universite>Université Catholique de Lyon à 10 min, Campus Lyon 2 Berges du Rhône à 15 min</universite>
</ecoles>
<loisirs>Parc de Confluence 15ha à 100m, Musée des Confluences à 500m, cinéma UGC Confluence, piscine de Gerland à 10 min</loisirs>
<sante>Maison médicale Confluence à 200m, pharmacies à 100m, Hôpital Lyon Sud à 15 min, clinique du Parc à 10 min</sante>
</environnement>
<!-- ══════════════════════════════════════════════════════════════════════
DESCRIPTION VILLE / QUARTIER
══════════════════════════════════════════════════════════════════════ -->
<ville_description>
<presentation>La Confluence est l'un des projets urbains les plus ambitieux d'Europe. Ce nouveau quartier de Lyon, situé entre Rhône et Saône, allie architecture audacieuse, innovation environnementale et qualité de vie exceptionnelle.</presentation>
<economie>Pôle économique majeur avec 25 000 emplois à terme, siège de grandes entreprises (Euronews, GL Events), incubateurs et espaces de coworking.</economie>
<projets_urbains>Extension du quartier vers le sud (Confluence 2), nouvelle ligne de métro E prévue pour 2030, création d'un parc de 6 hectares.</projets_urbains>
<qualite_vie>Premier quartier durable WWF en France, espaces verts omniprésents, berges aménagées pour piétons et cyclistes, vie culturelle riche.</qualite_vie>
</ville_description>
<!-- ══════════════════════════════════════════════════════════════════════
INFORMATIONS SUR LA RÉSIDENCE
══════════════════════════════════════════════════════════════════════ -->
<residence>
<services>
<service>Salle de fitness</service>
<service>Espace de coworking</service>
<service>Local poussettes</service>
<service>Conciergerie connectée</service>
</services>
<gardien>oui</gardien>
<local_velos>oui</local_velos>
<bornes_recharge>oui</bornes_recharge>
<espaces_verts>Jardin paysager privatif de 2000m² avec aires de jeux pour enfants et potager partagé</espaces_verts>
<accessibilite_pmr>100% des logements et parties communes accessibles PMR, ascenseurs aux normes</accessibilite_pmr>
</residence>
<!-- ══════════════════════════════════════════════════════════════════════
DISPOSITIFS FISCAUX ET NORMES
══════════════════════════════════════════════════════════════════════ -->
<ptz>true</ptz>
<pinel>false</pinel>
<pinel_plus>true</pinel_plus>
<tva_5_5>true</tva_5_5>
<brs>true</brs>
<psla>false</psla>
<lmnp>false</lmnp>
<lmnp_gere>false</lmnp_gere>
<nue_propriete>false</nue_propriete>
<pls>false</pls>
<lli>false</lli>
<prix_maitrises>true</prix_maitrises>
<re2020>true</re2020>
<bbc>true</bbc>
<nf>true</nf>
<hqe>true</hqe>
<nfhqe>true</nfhqe>
<biosource>true</biosource>
<senior>false</senior>
<etudiant>false</etudiant>
<!-- ══════════════════════════════════════════════════════════════════════
LOTS / TYPOLOGIES
══════════════════════════════════════════════════════════════════════ -->
<lots>
<!-- Lot 1 : T3 complet avec toutes les options -->
<lot>
<reference>
<interne>LOT-A-101</interne>
<api_key>lot-a101-xyz</api_key>
</reference>
<propriete>appartement</propriete>
<nb_pieces>3</nb_pieces>
<prix_min>385000</prix_min>
<prix_tva_reduite_min>352000</prix_tva_reduite_min>
<surface_min>68.5</surface_min>
<description>Magnifique T3 traversant avec double exposition Est-Ouest. Séjour lumineux de 32m² ouvrant sur une terrasse de 12m², cuisine équipée, 2 chambres avec placards intégrés, salle de bain avec douche à l'italienne.</description>
<plan>https://cdn.promoteur.com/plans/lot-a101.pdf</plan>
<duplex>false</duplex>
<triplex>false</triplex>
<etage_min>4</etage_min>
<etage_max>4</etage_max>
<nb_chambres_min>2</nb_chambres_min>
<nb_chambres_max>2</nb_chambres_max>
<parking>1</parking>
<balcon>false</balcon>
<terrasse>true</terrasse>
<surface_terrasse>12</surface_terrasse>
<jardin>false</jardin>
<loggia>false</loggia>
<cave>true</cave>
<surface_cave>5</surface_cave>
<orientations>
<orientation>est</orientation>
<orientation>ouest</orientation>
</orientations>
<brs>true</brs>
<stock_dur>false</stock_dur>
<photos>
<photo>
<url>https://cdn.promoteur.com/photos/lot-a101-sejour.jpg</url>
<position>1</position>
<legende>Séjour avec vue sur le parc</legende>
</photo>
<photo>
<url>https://cdn.promoteur.com/photos/lot-a101-terrasse.jpg</url>
<position>2</position>
<legende>Terrasse de 12m²</legende>
</photo>
</photos>
</lot>
<!-- Lot 2 : T2 simplifié -->
<lot>
<reference>
<interne>LOT-B-201</interne>
</reference>
<propriete>appartement</propriete>
<nb_pieces>2</nb_pieces>
<prix_min>265000</prix_min>
<prix_tva_reduite_min>242000</prix_tva_reduite_min>
<surface_min>45.2</surface_min>
<etage_min>2</etage_min>
<nb_chambres_min>1</nb_chambres_min>
<parking>1</parking>
<balcon>true</balcon>
<surface_balcon>6.5</surface_balcon>
<cave>true</cave>
<orientations>
<orientation>sud</orientation>
</orientations>
</lot>
<!-- Lot 3 : Maison -->
<lot>
<reference>
<interne>LOT-C-001</interne>
</reference>
<propriete>maison</propriete>
<nb_pieces>5</nb_pieces>
<prix_min>580000</prix_min>
<surface_min>125</surface_min>
<surface_terrain_min>250</surface_terrain_min>
<nb_chambres_min>4</nb_chambres_min>
<parking>2</parking>
<terrasse>true</terrasse>
<surface_terrasse>25</surface_terrasse>
<jardin>true</jardin>
<surface_jardin>180</surface_jardin>
</lot>
<!-- Lot 4 : Parking seul -->
<lot>
<reference>
<interne>LOT-P-001</interne>
</reference>
<propriete>parking</propriete>
<nb_pieces>0</nb_pieces>
<prix_min>25000</prix_min>
<description>Place de parking en sous-sol niveau -1, accès sécurisé par badge</description>
</lot>
</lots>
<!-- ══════════════════════════════════════════════════════════════════════
PHOTOS DU PROGRAMME
══════════════════════════════════════════════════════════════════════ -->
<photos>
<photo>
<url>https://cdn.promoteur.com/photos/facade-principale.jpg</url>
<position>1</position>
<legende>Vue de la façade principale</legende>
</photo>
<photo>
<url>https://cdn.promoteur.com/photos/jardin-paysager.jpg</url>
<position>2</position>
<legende>Jardin paysager privatif</legende>
</photo>
<photo>
<url>https://cdn.promoteur.com/photos/hall-entree.jpg</url>
<position>3</position>
<legende>Hall d'entrée avec conciergerie</legende>
</photo>
<photo>
<url>https://cdn.promoteur.com/photos/vue-aerienne.jpg</url>
<position>4</position>
<legende>Vue aérienne du quartier</legende>
</photo>
<photo>
<url>https://cdn.promoteur.com/photos/salle-fitness.jpg</url>
<position>5</position>
<legende>Salle de fitness résidents</legende>
</photo>
</photos>
<!-- ══════════════════════════════════════════════════════════════════════
DOCUMENTS ET VISITES VIRTUELLES
══════════════════════════════════════════════════════════════════════ -->
<documents>
<document>
<code>https://www.youtube.com/watch?v=abc123xyz</code>
<type>video</type>
</document>
<document>
<code>https://visitevirtuelle.habiteo.com/confluence-lyon</code>
<type>visite_3d</type>
</document>
<document>
<code>https://vimeo.com/987654321</code>
<type>video</type>
</document>
</documents>
<!-- ══════════════════════════════════════════════════════════════════════
OFFRES SPÉCIALES
══════════════════════════════════════════════════════════════════════ -->
<offres>
<offre>
<reference>OFF-2024-NOTAIRE</reference>
<nom>Frais de notaire offerts</nom>
<accroche>Profitez de cette offre exceptionnelle !</accroche>
<description>Pour toute réservation d'un T3 ou plus avant le 30 juin 2024, les frais de notaire sont intégralement pris en charge par le promoteur. Une économie pouvant aller jusqu'à 8000€.</description>
<mentions_legales>Offre valable pour toute signature d'un contrat de réservation entre le 01/03/2024 et le 30/06/2024. Non cumulable avec d'autres offres promotionnelles. Voir conditions en bureau de vente.</mentions_legales>
<date_debut>2024-03-01</date_debut>
<date_fin>2024-06-30</date_fin>
</offre>
<offre>
<reference>OFF-2024-CUISINE</reference>
<nom>Cuisine équipée offerte</nom>
<accroche>Votre cuisine Siemens offerte</accroche>
<description>Une cuisine entièrement équipée (four, plaque induction, hotte, réfrigérateur, lave-vaisselle) de marque Siemens d'une valeur de 5000€ offerte pour toute réservation.</description>
<mentions_legales>Offre valable dans la limite des stocks disponibles. Modèles et coloris selon disponibilité.</mentions_legales>
<date_debut>2024-01-01</date_debut>
<date_fin>2024-12-31</date_fin>
</offre>
</offres>
</programme>
</programmes>
Cet exemple n'est qu'une possibilité parmi tant d'autres. Nous nous adaptons à votre format existant, quelle que soit sa structure.
Envoyez-nous votre flux actuel et notre équipe technique configurera l'import pour correspondre exactement à vos données.