Passerelle programmes neufs et lots pour WordPress
Dans le neuf, l’unité de vente n’est pas le bien mais le lot, rattaché à un programme. Un site qui présente des programmes reçoit donc deux niveaux d’information : la fiche du programme et la liste de ses lots, avec leur disponibilité.
ImmoWP lit le flux neuf du logiciel où vous saisissez vos programmes (Hektor, Ubiflow, Unlatch, SweepBright, Whise et d’autres) et le publie sur votre site WordPress. Vous saisissez une fois, dans votre logiciel ; le site suit à chaque synchronisation.
Ce que transporte un flux de programme neuf
Un flux neuf décrit deux objets : le programme et ses lots. Chaque logiciel en transmet une partie, et la passerelle reprend ce que le flux contient sans inventer de valeur absente.
La fiche programme
Elle porte le nom de la résidence, son adresse et ses coordonnées GPS, le texte de présentation, les photos et perspectives, la visite virtuelle, la plaquette PDF, le contact commercial, le nombre de lots et de lots disponibles, les fourchettes de prix et de surfaces, la date de livraison et la phase commerciale ou l’état d’avancement.
Selon le logiciel : le nombre de lots disponibles vient de l’export neuf et du flux XML de Hektor, du flux neuf d’Ubiflow et d’Unlatch ; les fourchettes de prix et de surfaces viennent du flux neuf d’Ubiflow, et de Whise où elles sont calculées à partir des lots ; la date de livraison vient d’Unlatch, du flux XML Hektor et de MLS Connect ; la plaquette PDF, de l’export neuf de Hektor.
Le lot
Un lot se décrit par son numéro, sa typologie (appartement, maison, terrain, parking, cave, local), sa surface, son nombre de pièces, son étage, son exposition, son prix et sa disponibilité. Le détail lu varie selon le logiciel :
- Unlatch : type, surface, pièces, étage, exposition, prix TTC (calculé à partir du prix et de la TVA transmis) et disponibilité des lots principaux ;
- SweepBright : type, surface, prix, étage et statut de chaque unité ;
- Whise : pièces, surface, prix et statut de chaque lot ;
- export neuf de Hektor : chaque lot arrive aussi comme une annonce, avec prix, surfaces, pièces, étage, exposition, classe DPE et PDF ;
- flux neuf d’Ubiflow : référence, numéro, type, titre, texte, prix et un document par lot.
Les données propres au neuf
Le dispositif fiscal ou le type d’investissement est lu chez Hektor et chez Agence Plus, qui transmet les lois de défiscalisation (Pinel, Censi-Bouvard, Malraux, LMNP et d’autres). Les labels BBC, THPE et RT2012 arrivent par le flux XML Hektor. La TVA réduite, les plans de vente et les lots annexes (parking, cave) avec leur prix ne figurent que dans un flux promoteur qui les contient.
La règle est la même pour chaque logiciel : la passerelle reprend ce que le flux transmet et n’invente aucune valeur absente.
Les logiciels du neuf que la passerelle lit
Chaque logiciel ci-dessous a son connecteur dans l’API ImmoWP et se raccorde avec l’offre standard. Le tableau résume ce que chacun transmet ; le détail suit.
| Logiciel | Transport | Fiche programme | Liste des lots | Statut de chaque lot | Date de livraison |
|---|---|---|---|---|---|
| Hektor, export neuf | Export ZIP (programmes et lots) | Oui | Oui, chaque lot aussi en annonce | Non, nombre de lots disponibles | Date de disponibilité |
| Hektor, flux XML | XML | Bloc programme neuf sur l’annonce | Annonces rattachées à leur programme | Oui | Oui |
| Ubiflow, flux neuf | XML | Oui | Oui | Non, nombre de lots disponibles | Non |
| Unlatch | API | Oui | Oui, lots principaux | Disponible ou non | Oui |
| SweepBright | API | Projet | Oui, unités | Oui | Non |
| Whise | API | Projet | Oui | Oui | Non |
| MLS Connect (API v3) | API | Mention programme neuf | Non | Non | Oui |
Hektor (La Boîte Immo) : export neuf et flux XML
Deux canaux sont lus. L’export neuf en ZIP contient un fichier des programmes et un fichier des lots : chaque programme arrive avec sa liste de lots, et chaque lot est aussi publié comme une annonce. Le programme y porte le nombre de lots et de lots disponibles, l’état d’avancement, la date de disponibilité, le type d’investissement et la plaquette PDF.
Le flux XML Hektor porte un bloc programme neuf sur l’annonce : date de livraison, dispositif fiscal, labels BBC, THPE et RT2012, nombre de lots et de lots libres. Chaque annonce de lot y indique son statut et la référence de son programme. Le reste du raccordement est décrit sur la fiche de la passerelle Hektor.
Ubiflow : le flux neuf
Le flux neuf d’Ubiflow est distinct de son flux classique : il porte les programmes, leurs lots et des annonces. Le programme arrive avec son adresse et ses coordonnées GPS, ses photos, son texte de présentation, son contact, sa visite virtuelle, le nombre de biens et de biens disponibles, et ses fourchettes de prix et de surfaces.
Ubiflow permet de rattacher les annonces de lots à un programme et de dupliquer un modèle de lot à la saisie (article Ubiflow). Si votre logiciel de promotion diffuse déjà par Ubiflow, c’est ce flux que la passerelle lit. Voir la passerelle Ubiflow.
Unlatch
Unlatch, anciennement LegaLife Immobilier, a pris son nom actuel en octobre 2019 (Le Monde du Droit). C’est un logiciel de vente dans le neuf pour promoteurs et commercialisateurs.
La passerelle interroge son API avec l’accès de votre espace Unlatch, que nous paramétrons dans le connecteur à la mise en service. Chaque programme arrive avec sa date de livraison, sa phase commerciale, son adresse, son architecte et ses visuels ; chaque lot principal avec son type, sa surface, ses pièces, son étage, son exposition, son prix TTC et sa disponibilité. Les compteurs de lots du programme incluent aussi les parkings et les caves. Voir la passerelle Unlatch.
SweepBright et Whise : projets et unités
SweepBright définit un projet comme un ensemble de biens, appelés unités (documentation de sa Website API). La passerelle publie le projet et enregistre ses unités avec leur type, leur surface, leur prix, leur étage et leur statut.
Chez Whise, le projet est un bien parent et ses lots des biens enfants. La passerelle reprend chaque lot avec ses pièces, sa surface, son prix et son statut, et calcule les fourchettes de surfaces, de prix et de pièces du projet. Ces deux logiciels équipent des agences en Belgique et en France ; les données propres aux annonces belges sont traitées sur la page immobilier en Belgique et WordPress. Voir les passerelles SweepBright et Whise.
Les autres flux qui portent des biens neufs
Ces logiciels transmettent le neuf sous forme d’annonces, sans grille de lots : chaque bien neuf est publié comme une annonce, avec les données propres au neuf que le flux contient.
- ImmoFacile (format AC3) : type programme neuf, lu de la même façon chez ICS et Rodacom ;
- Apimo : statut programme et sous-catégorie programme neuf ;
- MLS Connect (API v3) : mention programme neuf et date de livraison ;
- Agence Plus : lois de défiscalisation ;
- Synermi, pour les constructeurs de maisons : offres maison et terrain, avec prix et surfaces à partir de ;
- Ubiflow, flux classique : offre vente de neuf, codes programme et lot ;
- Adapt Immo : son module neuf gère des programmes par lots (site Adapt Immo) ; la passerelle publie les biens transmis par son API comme des annonces.
Un flux promoteur sur mesure
Un promoteur qui exporte un XML structuré par programmes et par lots peut être relié par un connecteur sur mesure. Ce type de flux peut porter plus que les logiciels du marché : TVA réduite, fiscalité et zone fiscale, plan de vente de chaque lot, lots annexes (parking, cave) avec leur prix, statut de chaque lot et date de livraison. Le connecteur reprend les champs que le fichier contient.
Poliris et portails du neuf : pourquoi partir du flux de votre logiciel
Poliris est le format d’export le plus répandu vers les portails : selon un article de Facileimmo de février 2021, il est utilisé par 85 % des portails gratuits ou payants.
Sa spécification 4.09 du 31 mai 2021 exprime le neuf par le type d’annonce « produit d’investissement » ou par le sous-type « Programme ». Son champ « Nombre de lots » désigne les lots de la copropriété (loi ALUR), pas ceux d’un programme. Rien n’y rattache un lot à son programme et aucune date de livraison n’est prévue : un export Poliris donne une liste de lots à plat.
Les portails spécialisés ont leurs propres offres pour le neuf. Ubiflow cite comme portails du neuf SeLoger Neuf, Leboncoin immobilier neuf, Immoneuf, Logic-Immo et Trouver un logement neuf (article Ubiflow) ; Bien’ici diffuse les lots, les visuels, les plans et les catalogues des promoteurs dans son offre Diffusion’neuf.
ImmoWP n’alimente pas ces portails : il alimente votre site. Pour un site, le flux neuf natif de votre logiciel conserve la fiche programme et sa grille de lots ; c’est lui que la passerelle lit en priorité.
Ce que vous obtenez sur votre site WordPress
Chaque programme transmis par votre logiciel devient une annonce de votre site WordPress, mise à jour à chaque synchronisation. Toutes les données du flux sont enregistrées avec lui, y compris celles que votre thème n’affiche pas : lots, date de livraison, dispositif fiscal, nombre de lots.
Un lot retiré du flux est effacé des données de son programme à la synchronisation suivante. Un programme ou une annonce retirés du flux sont supprimés, mis à la corbeille ou marqués vendus selon votre réglage, et l’opération est bloquée si le flux arrive anormalement vide ou tronqué.
Ce qui s’affiche sur l’annonce d’un programme dépend de votre thème. L’extension de gestion immobilière ImmoWP présente le programme comme une annonce, sans la liste de ses lots ; avec l’export neuf de Hektor, chaque lot est en plus publié comme une annonce.
Mise en service
Ce qu’il faut fournir
- l’adresse de votre site WordPress ;
- l’adresse du flux XML (flux neuf d’Ubiflow, flux XML Hektor) ou de l’export ZIP neuf de Hektor ;
- ou un accès API (Unlatch, SweepBright, Whise).
Si l’export neuf n’est pas encore ouvert, demandez à votre éditeur de l’activer vers votre site : il vous remet l’adresse du flux ou l’accès API à nous transmettre.
Les étapes
- Vous nous transmettez l’accès au flux.
- Nous lisons un premier programme et contrôlons la correspondance des champs avec votre site.
- Nous contrôlons sur votre site l’annonce créée pour ce programme et les données enregistrées de ses lots.
- Nous activons la synchronisation : vos programmes et vos lots suivent votre logiciel.
L’offre pour vos programmes neufs
Installation et configuration incluses, sous 5 jours ouvrés. Paiement unique, essai gratuit 10 jours.
- Import illimité de biens
- Mises à jour automatiques
- Support prioritaire
Votre logiciel n’est pas dans la liste
Un logiciel de promotion ou de commercialisation qui exporte ses programmes et ses lots en XML, en CSV ou par API peut être relié par un connecteur sur mesure : envoyez-nous un exemple de son export avec le nom du logiciel. Si ce logiciel diffuse déjà par Ubiflow, la passerelle Ubiflow et son flux neuf s’appliquent directement.
Nous écrireQuestions fréquentes sur les programmes neufs et WordPress
Sources
- Le Monde du Droit, « LegaLife Immobilier devient Unlatch et se lance à l’international », 23 octobre 2019
- Ubiflow, « Promoteurs immobiliers, comment bien diffuser vos annonces de programmes neufs ? », 30 mars 2021, mis à jour le 26 décembre 2022
- SeLoger, Spécifications techniques d’exportation, version 4.09 du 31 mai 2021 (copie publique, PDF)
- Facileimmo, « Le flux Poliris - AC3, c’est quoi ? », 26 février 2021
- Bien’ici, offre Diffusion’neuf pour les promoteurs
- SweepBright, documentation de la Website API
- Adapt Immo, logiciel de multidiffusion et module neuf
Les données attribuées à chaque logiciel sont celles que lit son connecteur dans l’API ImmoWP. Les marques citées appartiennent à leurs propriétaires ; aucun partenariat ni aucune validation technique n’est revendiqué avec leurs éditeurs.