Format d'annonces
Le fichier XML contient une ou plusieurs agences immobilières (ou constructeur, promoteur, ...).
Il doit valider le schéma suivant : gedeon.xsd.
Nous fournissons également un
validateur en ligne.
Structure
La structure globale est simple : des agences (<agencies>) contenant des annonces (<ads>).
<?xml version="1.0" encoding="utf-8"?> <agencies xmlns="http://www.gedeon.im/xmlns/agencies/v1" version="1.0" generator="mon-logiciel/3.1"> <!-- Première agence --> <agency id="..."> <!-- Coordonnées de l'agence --> <contact> ... </contact> <!-- Annonces (biens immobiliers) de l'agence --> <ads> <!-- Première annonce --> <ad reference="..."> ... </ad> <!-- Deuxième annonce --> <ad reference="..."> ... </ad> </ads> </agency> </agencies>
Agences
La balise <agencies> doit faire
référence au namespace suivant : http://www.gedeon.im/xmlns/agencies/v1
.
Elle doit contenir les attributs suivants :
-
version:
la version du document, à ce jour,
1.0
-
generator:
le logiciel qui a généré ce document, sous la forme
nom-du-logiciel/version
.
Suivent ensuite la liste des agences, via les balises <agency>.
Si vous n'avez qu'une agence, alors c'est simple, une seule balise <agency> devra être présente dans le fichier.
Si vous avez plusieurs agences, vous pouvez au choix :
- Utiliser un fichier XML contenant autant de balises <agency> qu'il n'y a d'agences,
- ou utiliser un fichier XML par agence avec une seule balise <agency>.
Agence
La balise <agency> doit contenir l'attribut suivant :-
id:
un identifiant unique de l'agence, dans votre base.
- <contact>: Les coordonnées de l'agence (nom, adresse, email, ‥)
- <ads>: Les biens immobiliers de cette agence.
Coordonnées de l'agence
La balise <contact> doit contenir les élements suivants :
<contact> <name>Mon Agence Immobilière</name> <localization> <address>18 Rue Jean Jaurès</address> <postCode>01234</postCode> <city>Saint Paul</city> <country>FR</country> </localization> <fax>0123456789</fax> <phone>0123456789</phone> <emails> <email>mon.agence@example.com</email> <email>mon.agence@example.com</email> </emails> <web>https://www.monagence.example.com</web> <logo>https://www.monagence.example.com/logo-large.png</logo> </contact>
Les noms sont assez explicites, quelques remarques cependant :
-
<country>:
code pays au format
ISO 3166-1 alpha-2,
exemple:
FR
-
<phone>:
- format français : 0123456789 ou 01 23 45 67 89 ou 01.23.45.67.89 ou 01-23-45-67-89
-
format international :
1-800-1234567 (country-area-subscriber)
1-800-1234567-89 (country-area-subscriber-extension)
34-912345678 (country-subscriber)
34-912345678-9 (country-subscriber-extension)
- <fax>: optionnel, même format que pour <phone>.
- <web>: optionnel mais recommandé, le site internet de l'agence.
- <logo>: optionnel, format png/jpg/gif
- <emails>: au moins un <email> doit être renseigné, et valide.
- warning Tous les autres champs sont obligatoires.
Agents
Vous avez des informations concernant les agents, qu'ils soient négociateurs ou agents commerciaux (mandataires) ? Vous pouvez facilement les ajouter en utilisant le format suivant :
<subagencies [...]> <agency [...]> <contact> <!-- // --> </contact> <agents> <agent type="negociator" email="j.dupond@gmail.com"> <civility>M</civility> <firstname>Jean</firstname> <name>Dupond</name> <phone>0605040302</phone> </agent> </agents> </agency> </subagencies>
Vous avez encore plus d'informations à fournir ? Ce n'est pas un problème. Voici la liste de tous les champs supportés :
-
type: Type d'agent
negociator négociateur commercial agent commercial/mandataire - email: Email de l'agent
-
civility: Civilité
M Monsieur MME Madame - firstname: optionnel Prénom de l'agent
- name: Nom ou nom complet (si firstname n'est pas renseigné) de l'agent
- cellphone: optionnel Téléphone portable
- phone: Téléphone
- photo: optionnel Photo (URL)
- website: optionnel Site web (URL)
- facebook: optionnel Facebook (URL complète)
- youtube: optionnel Youtube (URL complète)
- twitter: optionnel Twitter (URL complète)
- linkedin: optionnel Linkedin (URL complète)
- instagram: optionnel Instagram (URL complète)
- legal_status: optionnel Forme juridique
- siret: optionnel Numéro SIRET
- rcs: optionnel Identifiant RCS
- tva_number: optionnel Identifiant TVA
- professional_card_no: optionnel Numéro de carte professionnelle
- professional_prefecture_card_no: optionnel Précture - Numéro de carte professionnelle
- guarantee_fund: optionnel Caisse de garantie
- guarantee_amount: optionnel Montant de garantie
-
billing: optionnel Coordonnées de facturation (si différent de l'agent)
- firstname: optionnel Prénom
- name: optionnel Nom
- phone: optionnel Téléphone
- email: optionnel Adresse e-mail
- coordinates: optionnel Adresse, ville, code postal, pays
- commercial_coordinates: optionnel Coordonnées commerciales : adresse, ville, code postal, pays
Annonces
Voici le cœur du sujet, les biens immobiliers.
Les annonces sont listées dans la balise <ads>, une <ad> à la suite des autres :
<ads> <ad reference="A1"> ‥ </ad> <ad reference="A2"> ‥ </ad> ‥ </ads>
Une annonce <ad> doit posséder l'attribut suivant, non vide :
-
reference:
référence unique de l'annonce, dans votre base.
C'est elle qui permet le relevé de statistiques, le suivi des demandes, et la multi-diffusion correcte.
Voici un aperçu d'une annnonce :
<ad reference="A1"> <transaction>S</transaction> <type sub="Studio">flat</type> <localization> <address>Rue Centrale</address> <postCode>01234</postCode> <city>Saint-Paul</city> <country>FR</country> </localization> <price currency="euro">250000</price> <rooms>20</rooms> <surface>100</surface> <mandate> <type>simple</type> <number>1234</number> </mandate> <texts> <text target="internet" lang="fr">Description du bien immobilier</text> <text target="press" lang="fr">Description du bien pour la presse</text> </texts> <titles> <title lang="fr">Titre de l'annonce</title> </titles> <contact> <phone>0123456789</phone> <email>agent1@example.com</email> </contact> <medias> <media type="photo"> <url>https://example.com/photo-A1-1.jpg</url> </media> <media type="photo"> <url>https://example.com/photo-A1-2.jpg</url> </media> <media type="virtualvisit"> <url>https://example.org/visite/A1.html</url> </media> </medias> <extras> ‥ </extras> <diffusions> <diffusion>lesiteimmo</diffusion> <diffusion>seloger</diffusion> </diffusions> </ad>
Ce sont les seuls champs obligatoires pour permettre à votre annonce d'être valide ! Bien sûr il sera possible de la compléter de façon exhaustive, ce que nous verrons plus loin.
Contenu d'une annonce
Voici la description des balises :
-
<transaction>:
La transaction est codée sur une lettre (majuscule) :
S Sell vente / achat R Rent location H Holidays location saisonnière O sOld vendu L Life annuity sale viager détails... P Program programme neuf détails... -
<type>:
Le type de bien est à choisir parmi :
Type : correspond à : <type>house</type> maison, villa, ferme, etc. <type>flat</type> appartement, studio, loft, etc. <type>garage</type> garage, parking <type>terrain</type> terrain, terre agricole <type>industrial</type> local industriel <type>office</type> bureau <type>shop</type> commerce <type>other</type> autre Ce <type> sert à s'assurer que votre bien soit associé à la bonne catégorie.
Il est cependant conseillé d'ajouter l'attribut <sub> afin de décrire plus précisément le "sous-type" de bien.
Ce sous-type est à décrire en français ou en anglais, par exemple :
<type sub="villa">house</type>
L'attribut <new> peut être fixé à "true" pour identifier un produit neuf (projet de construction).
Par exemple :<type new="true">house</type> (Maison neuve) <type new="true">flat</type> (Appartement neuf) <type new="true">terrain</type> (Terrain à bâtir) Note : un programme neuf n'a pas besoin de spécifier <new>, la valeur <transaction>P</transaction> suffit. -
<localization>:
Contient les informations de localisation.
- <address>: adresse du bien, optionnelle.
- <postCode>: code postal du bien
- <city>: ville du bien
- <country>: pays du bien, doit correspondre à un ISO 3166-1 alpha-2
- <longitude>: longitude, en degrés (optionnelle)
- <latitude>: latitude, en degrés (optionnelle)
- <accuracy>: précision(optionnelle)
-
<price>:
Le prix.
Il doit être de type numérique, sans espaces.
Les décimales sont acceptées, ex350.50
(mais non prises en compte).Correspondance Pour les transactions : Le prix S
,O
(ventes)(obligatoirement HAI)
Pensez à la loi ALUR.Le loyer R
,H
(locations)(obligatoirement CC)
Pensez à la loi ALUR.Le bouquet L
(viagers)Pensez à ajouter la Rente mensuelle. Le prix minimum P
(programmes neufs)L'attribut obligatoire currency doit être défini à
euro
, seule devise supportée.Pour les locations saisonnières, l'attribut period peut être fixé à l'une des valeurs suivantes :
- night
- weekend
- week
- fortnight
- month (valeur par défaut)
- year
-
<rooms>:
Le nombre de pièces.
optionnel, mais recommandé.
(type entier positif) -
<surface>:
La surface habitable du bien
optionnelle, mais recommandée.
Représente la superficie dans le cas des terrains.
(type decimal positif) -
<mandate>:
Informations sur le mandat (optionnel, mais recommandé).
- <number>: Numéro de mandat.
-
<type>:
Type de mandat, à choisir parmi :
- simple
- semi-exclusive
- exclusive
-
<texts>:
Liste des textes décrivant cette annonce.
- Chaque texte est lié à une cible (target) et une langue (lang).
- L'HTML n'est pas autorisé.
- Les sauts de lignes sont autorisés (<cr><lf>). Il faut noter cependant que rien ne garanti leur affichage sur les différents médias.
Chaque balise <text> doit posséder les deux attributs suivants :
-
target:
La cible concernée par le texte.
Les cibles possibles sont :
internet
: texte utilisé pour la diffusion sur les médias internet/webpress
: texte utilisé pour la presse écrite (magazines)
-
lang:
La langue du texte, suivant la RFC 1766. Par exemple,
fr
ouen
.
warningIl doit y avoir au moins un <text> avec les attributs target="internet" et lang="fr" .
-
<titles>:
Une liste de titre (ou "accroche") pour l'annonce.
Peut contenir un ou plusieurs <title> associés à un langage via l'attribut obligatoire lang au format RFC 1766.
Note : Il est automatiquement généré à partir des caractéristiques de l'annonce si non renseigné.
-
<contact>:
Informations de contact pour cette annonce
(optionnel)
- <name>: Nom du contact (optionnel).
- <phone>: Téléphone du contact (format identique à celui de agency/contact/phone) (optionnel).
- <email>: Adresse email du contact (valide) (optionnel).
Notes :
- Un seul email, téléphone ou nom est autorisé.
- Lors des demandes d'informations, cette adresse email est notifiée, en plus de celle(s) renseignée(s) dans l'agence.
- Lorsqu'un numéro de téléphone doit être affiché pour l'annonce, le numéro renseigné ici surcharge celui renseigné dans l'agence.
-
<medias>:
Une liste de
<media>
pour cette annonce.
Il existe deux type de médias :
<media type="photo"> → les photos du bien <media type="virtualvisit"> → la visite virtuelle du bien (maximum 1 visite virtuelle par bien) Chaque <media> doit posséder l'attribut type.
<media> contient les éléments suivants :
- <url>: URL du média / photo.
- <description>: Description textuelle associée au média / à la photo (optionnel).
-
<updated>:
Date/Heure de dernière mise à jour de la photo
(optionnel).
Le format doit suivre le format xsd:dateTime, par exemple2023-06-08T06:03:03+02:00
(vous pouvez utiliserdate('c')
en PHP).
Notes sur les médias :
- Plusieurs formats sont supportés, mais le JPG est fortement recommandé.
- L'ordre des balises <media> fait foi.
- La taille des photos n'est pas limitée !
- Le nombre de photos n'est pas limité ! Cependant concernant la multi-diffusion, chaque portail a son propre quota (entre 10 et 30 généralement).
- La description n'est à ce jour que peu utilisée, mais apporte une forte valeur ajoutée.
- Notre robot est le plus économique possible lors de la
récupération des photos.
Il ne re-télécharge les photos que :- si l' <url> a changé
- ou si l'élement <updated> est renseigné, et supérieur à notre dernier téléchargement.
- Dans le cas de la visite virtuelle, seule une URL par bien est utilisée.
Il doit s'agir simplement d'une page web hébergeant la visite.
Concernant la multi-diffusion, chaque portail gère (ou non) cette URL comme il l'entend (ouverture de fenête, iframe, etc.).
-
<diffusions>:
Une liste de
<diffusion>
pour cette annonce (optionnel).
Note : cette fonctionnalité nécessite un accord préalable entre nos services. Dans le doute, ignorez simplement cette balise.Chaque tag <diffusion> doit contenir l'id de la diffusion souhaitée. Exemple :
<diffusions> <diffusion>lesiteimmo</diffusion> <diffusion>seloger</diffusion> </diffusions>
La liste des diffusions est disponible sur demande à passerelles@gedeon.im
Voilà ! L'annonce est maintenant remplie à minima et peut être validée.
Maintenant, afin de lui donner le plus d'informations complémentaires possibles, les champs appelés <extras> vous donnent la possibilité d'enrichir l'annonce.
Il est vivement conseillé, également, de valider votre fichier : Validation XML
Champs Extras
Les champs extras sont à renseigner dans la balise <extras>, un <extra> à la suite des autres :
‥ <ads> <ad reference="A1"> ‥ <extras> <extra key="charges">75</extra> <extra key="cuisine">équipée</extra> ‥ </extras> </ad> <ad> ‥ </ad> </ads> ‥
Chaque élément <extra> doit un attribut key (clé) et une valeur.
La clé
key
ne doit contenir que les caractère a
à z
et l'underscore _
.
Les champs extras ont pour concept une extensibilité large des informations complémentaires d'une annonce.
Une liste officielle vous est donnée ci-dessous, n'hésitez pas à nous contacter pour l'ajout de données qui vous importent !
Types
Les champs extras sont typés.
Seuls les valeurs non vides sont prises en compte. Ainsi
les valeurs false
, 0
, 0.00
, etc. sont ignorées.
Type | Description |
---|---|
bool | Booléan : true ou false Les champs à false sont en fait ignorés. |
text | Texte libre (court) |
int | Nombre entier. Ex: 132 |
float | Nombre décimal. Ex: 132.45 |
money | Nombre décimal, valeur en euros. Ex: 132.45 Un suffixe € sera rajouté lors de l'affichage |
surface | Nombre décimal, valeur en m². Ex: 132.45 Un suffixe m² sera rajouté lors de l'affichage |
date | Date, format yyyy-mm-dd |
year | Année, format yyyy |
Énumérations
Certains champs extras ont une liste de valeurs possibles.
Dans ce cas, il faut si possible s'y conformer ou nous contacter si aucune de ces valeurs ne semble correspondre à vos besoins.
S'il est possible de renseigner plusieurs valeurs, il
faut alors les séparer par les caractères ", "
(virgule,
espace).
Liste des champs
- Descriptif
-
Adresse -
Arrondissement -
appartement bureaunb_etages int
Nbre. d'étages -
appartement bureauetage specific
Étage du bien -
Type de construction -
maisonnb_murs_mitoyens int
Nb. de murs mitoyens -
alur alur2017 alurloc maison appartementmeuble bool
Meublé -
appartementascenseur bool
Ascenseur -
Nbre. de chambres -
Nb. de pièces -
maison appartementnb_sdb int
Nb. de salles de bain -
appartement maisonnb_sde int
Nb. de salles d'eau -
maison appartementnb_wc int
Nb. de WC -
maison appartementwc_separes bool
WC séparés -
maison appartementnb_wc_separes int
Nb. de WC séparés -
maisonsous_sol bool
Sous-sol -
loc_saisonniere maisonveranda bool
Véranda -
loc_saisonniere maison appartementsalle_a_manger bool
Salle à manger -
loc_saisonniere maison appartementsalon bool
Salon -
loc_saisonnieresauna bool
Sauna -
maisongrenier bool
Grenier -
loc_saisonniere maison appartementbalcon bool
Balcon -
loc_saisonniere maison appartementterrasse bool
Terrasse -
loc_saisonniere maison appartementgarage bool
Garage -
loc_saisonniere maison appartementplaces_de_garage int
Places de garage -
Parking -
loc_saisonniere maison appartementnb_parkings int
Nb. Parking -
maison appartementbox bool
Box -
loc_saisonniere maison appartementstationnement text
Stationnement -
loc_saisonniere maison appartementtype_parking text
Type parkingPlusieurs choix possibles parmi :- Intérieur
- Extérieur
- Box
- Sous-sol
- Visiteurs
-
loc_saisonniere maison appartementcave bool
Cave -
loc_saisonniere maison appartementcour bool
Cour -
Escalier -
Façade -
appartementgardien bool
Gardien -
loc_saisonnierehandicapes bool
Accès handicapés -
Hauteur Sous Plafond -
Sous compromis -
Duplex -
Triplex -
Souplex -
Loft -
Style -
Label - Etat
-
maison appartement commerce bureauetat_general text
État generalUn choix possible parmi :- Neuf
- Entièrement rénové
- Excellent
- Très Bon
- Bon
- Habitable
- A rafraîchir
- A rénover
-
État extérieur -
Travaux -
Travaux à prévoir -
Refait à neuf -
maison appartement commerce bureauannee_construction year
Année de construction -
maison appartement commerce bureauannee_renovation year
Année de rénovation -
maisonannee_chaudiere year
Année chaudière - Superficies
-
Surface habitable -
S.H.O.N. -
C.O.S. -
Surface carrez -
Surface aménageable -
Surface totale -
Surface constructible -
Superficie terrain -
Surface du jardin -
maison appartementsurface_terrasse surface
Surface terrasse -
maison appartementsurface_balcon surface
Surface du balcon -
maison appartementsurface_loggia surface
Surface de la loggia -
maison appartementsurface_sejour surface
Surface du séjour -
maison appartementsurface_cuisine surface
Surface cuisine -
Surface du bureau -
maison appartementsurface_annexes surface
Surface des annexes -
bureausurface_divisible bool
Surface Divisible -
bureauinfo_surface text
Information surface - Loi ALUR
-
general alur alurventestatut_nego text
Statut du négociateurUn choix possible parmi :- Agent immobilier
- Salarié
- VRP
- Agent commercial
-
vente alur alurventecopropriete bool
Copropriété -
vente alur alurventecopropriete_nb_lots int
Nombre de lots de la copropriété -
vente alur alurventequote_part_annuelle money
Moyenne de la quote part(an) -
vente alur alurventesyndic_procedure_alerte bool
Syndic sous procédure d'alerte -
vente alur alurventesyndic_sous_admin bool
Syndic sous administration provisoire -
vente alur alurventesyndic_detail_procedure text
Détail de la procédure - Equipement
-
Porte blindée -
maison appartement bureauchauffage text
ChauffagePlusieurs choix possibles parmi :- Gaz
- Electrique
- Fuel
- Solaire
- Individuel
- Collectif
-
loc_saisonniere maison appartementcheminee bool
Cheminée -
loc_saisonniere maison appartementpoele_bois bool
Poêle à bois -
Climatisation -
Visiophone -
appartementdigicode bool
Digicode -
appartement maisondouble_vitrage bool
Double vitrage -
maisonfosse_septique bool
Fosse septique -
maisontout_a_l_egout bool
Tout-à-l'égout -
Videophone -
Alarme -
Câble TV -
loc_saisonnieretelevision bool
Télévision -
loc_saisonniereconnexion_internet bool
Connexion internet -
loc_saisonnieretelephone bool
Téléphone -
Placards -
appartementinterphone bool
Interphone -
Eau chaude -
loc_saisonniere maison appartementcuisine text
CuisineUn choix possible parmi :- Aménagée
- Américaine
- Américaine équipée
- Coin cuisine
- Equipée
- Indépendante
- Kitchenette
- Vide
-
loc_saisonnierelave_vaisselle bool
Lave vaisselle -
loc_saisonnierelave_linge bool
Lave linge -
loc_saisonniereseche_linge bool
Sèche linge -
loc_saisonnierecongelateur bool
Congélateur -
loc_saisonnieremicro_ondes bool
Micro-ondes -
loc_saisonnierefour bool
Four -
loc_saisonnierechaise_bebe bool
Chaise bébé -
loc_saisonnierelit_bebe bool
Lit bébé - Extérieur
-
loc_saisonniere appartementjardin_privatif bool
Jardin privatif -
loc_saisonniere appartementjardin_non_privatif bool
Jardin non privatif -
maisonterrain text
TerrainPlusieurs choix possibles parmi :- Arboré
- Clos
- En pente
- Plat
- Paysagé
-
Parc arboré -
loc_saisonniere maisonjardin bool
Jardin -
loc_saisonniere maisonpiscine bool
Piscine -
Piscinable -
loc_saisonniere maisonpiscine_chauffee bool
Piscine chauffée -
loc_saisonniere maisonpiscine_hors_sol bool
Piscine hors sol -
loc_saisonnierebarbecue bool
Barbecue -
loc_saisonnieresalon_jardin bool
Salon de jardin -
loc_saisonniereportique bool
Portique pour enfants -
loc_saisonnieretobogan bool
Tobogan -
loc_saisonnierejeux_enfants bool
Jeux pour enfants -
loc_saisonnierevelos bool
Vélos - Environnement
-
loc_saisonniere maison appartement generalorientation specific
OrientationPlusieurs choix possibles parmi :- Nord
- Sud
- Est
- Ouest
- Nord/Est
- Nord/Ouest
- Sud/Est
- Sud/Ouest
-
Environnement -
loc_saisonniere maison appartement generalcalme bool
Calme -
loc_saisonniere maison appartementvue text
VueUn choix possible parmi :- Campagne
- Citadine
- Dégagée
- Jardin
- Mer
- Montagne
- Panoramique
- Parc
- Verdure
- Village
-
maison appartementsans_vis_a_vis bool
Sans vis-à-vis -
maison terrainlotissement bool
Lotissement -
Arrêt métro proche -
Plan Local d'Urbanisme -
maison appartement generaldist_transports int
Distance transports en commun -
maison appartement generaldist_commerces int
Distance commerces -
maison appartement generaldist_creche int
Distance creche -
maison appartement generaldist_ecoles int
Distance écoles -
maison appartement generaldist_autoroute int
Distance autoroute -
Transport -
Ville proche -
loc_saisonniereproche_mer bool
Proche mer -
loc_saisonnieredist_mer int
Distance mer (mètres) -
loc_saisonniereproche_lac bool
Proche lac -
loc_saisonnieredist_lac int
Distance lac (mètres) -
loc_saisonniereproche_ski bool
Proche ski -
loc_saisonnieredist_ski int
Distance piste (mètres) -
loc_saisonniereproche_tennis bool
Proche tennis -
loc_saisonniereproche_foret bool
Proche forêt -
loc_saisonniereproche_restaurant bool
Proche restaurant -
Proximité -
Proximité transports -
Quartier -
Rue piétonne -
generalsecteur text
Secteur -
Situation -
maison appartementstanding bool
Standing - Activités à Proximité
-
loc_saisonniereaccrobranche bool
Accrobranche -
loc_saisonniereactivite_nautique bool
Activités nautiques -
loc_saisonnierebaignade bool
Baignade -
loc_saisonnierebalneo bool
Balnéo thalasso -
loc_saisonnierecanoe bool
Canoé kayak -
loc_saisonnierecasino bool
Casino -
loc_saisonnierecinema bool
Cinéma -
loc_saisonnierediscotheque bool
Discothèque -
loc_saisonniereescalade bool
Escalade -
loc_saisonniereequitation bool
Equitation -
loc_saisonnieregolf bool
Golf -
loc_saisonnieremusee bool
Musée -
loc_saisonniereparc_loisir bool
Parc de loisirs -
loc_saisonnierepatinoire bool
Patinoire -
loc_saisonnierepetanque bool
Terrain de pétanque -
loc_saisonnierepiscine_municipale bool
Piscine Municipale -
loc_saisonniererandonnee bool
Randonnée -
loc_saisonniereski_alpin bool
Ski alpin -
loc_saisonniereski_fond bool
Ski de fond -
loc_saisonnieresite_touristique bool
Sites touristiques -
loc_saisonnieretennis bool
Tennis -
loc_saisonnierevia_ferrata bool
Via ferrata -
loc_saisonnierevelo bool
Vélo route -
loc_saisonnierevoile bool
Voile -
loc_saisonnierevtt bool
VTT - Spécifiques Commerce
-
commerceca_annee_1 money
C.A. (Année N-1) -
commerceca_annee_2 money
C.A. (Année N-2) -
commerceca_annee_3 money
C.A. (Année N-3) -
commercemurs_occupes bool
Murs Occupés -
commerceprix_murs money
Prix des Murs -
commerceprix_fdc money
Prix du Fond de commerce -
commerceactivite_actuelle text
Activité actuelle -
commerceactivites_autorisees text
Activités autorisees -
commerceactivites_refusees text
Activités refusées -
commercelongueur_vitrine int
Longueur vitrine -
commercehauteur_vitrine int
Hauteur vitrine -
commercecapital_societe money
Capital Société -
commercedroit_au_bail money
Droit au bail - Neuf
-
programmebureau_vente_addr text
Adresse bureau de vente -
programmebureau_vente_cp text
CP bureau de vente -
programmebureau_vente_ville text
Ville bureau de vente -
programmebureau_vente_horaires text
Horaires bureau de vente -
programmebureau_vente_tel2 text
Tél. bureau de vente -
programmebureau_vente_tel text
Tél2. bureau de vente -
programmebureau_vente_fax text
Fax bureau de vente -
programmeconstructeur text
Constructeur -
programmelivraison text
Livraison -
programmenb_lots int
Nb Lots -
programmenb_lots_total int
Nb Lots Total -
programmenom_programme text
Nom du programme -
programmeslogan_programme text
Slogan du programme -
programmenom_vendeur text
Nom Vendeur -
programmeprix_m2 money
Prix au m² -
programmeprix_min money
Prix minimum -
programmeprix_moyen money
Prix moyen -
programmeprix_max money
Prix maximum -
programmesurface_min surface
Surface minimum -
programmesurface_moyenne surface
Surface moyenne -
programmesurface_max surface
Surface maximum -
programmenb_pieces_min int
Nb. de pièces minimum -
programmenb_pieces_max int
Nb. de pièces maximum -
programmeurl_programme text
Url Programme -
programmeetat_avancement text
État d'avancementUn choix possible parmi :- Avant-première
- Nouvelle réalisation
- Commercialisation
- Lancement
- Travaux en cours
- Livraison immédiate
- Dernières opportunités
- Conditions
-
Prix de la maison -
Prix du terrain -
Taxe foncière -
Taxe habitation -
alur alur2017 alurloccharges money
Charges -
Dépôt de garantie -
alur alur2017 alurlochonoraires money
Honoraires -
alur alur2017 alurventeprix_hors_honoraires money
Prix hors honoraires acquéreur -
alur alurventepourcentage_honoraires specific
Pourcentage des honoraires acquéreur -
alur alur2017 alurventehonoraires_a_charge_de text
Honoraires à charge deUn choix possible parmi :- acquéreur
- vendeur
- acquéreur et vendeur
-
alur alur2017 alurlocreglement_charges text
Règlement des chargesUn choix possible parmi :- provisionnel
- forfaitaire
- remboursement
-
alur alur2017 alurlochonoraires_etat_des_lieux money
Honoraires état des lieux -
alur alur2017 alurloccomplement_loyer money
Complément de loyer -
alur alur2017 alurlocbase_loyer money
Loyer de base -
alur alur2017 alurlocloyer_reference money
Loyer de référence majoré -
alur alur2017 alurloc alurventeurl_bareme text
URL du barême des honoraires -
Frais divers -
Prix du mobilier -
Zone ANRU -
Nombre de personnes -
loc_saisonniereduree_min int
Durée minimale du séjour (en jours) -
loc_saisonnierechauffage_inclus bool
Chauffage inclus -
loc_saisonniereanimaux bool
Animaux acceptés -
loc_saisonnierenon_fumeur bool
Non fumeur -
loc_saisonniereloc_draps bool
Location draps -
loc_saisonniereloc_serviettes bool
Location serviettes -
loc_saisonnieremenage_fin_sejour bool
Possibilité ménage -
Date de fin du bail -
Date de parution -
Date de début de mandat -
Date de fin de mandat -
Date disponibilité -
Libre le -
viagerlibre bool
Libre -
viageroccupe bool
Occupé -
viagertype_occupation text
Type d'occupation -
viagerrente_mensuelle money
Rente mensuelle -
viagervaleur_venale money
Valeur vénale -
viagera_terme bool
À terme -
viagerduree_terme int
Durée du terme (années) -
viagernb_tetes int
Nombre de têtes -
viagersexe_tete_1 text
Sexe tête 1Un choix possible parmi :- Femme
- Homme
-
viagerage_tete_1 int
Âge tête 1 -
viagersexe_tete_2 text
Sexe tête 2Un choix possible parmi :- Femme
- Homme
-
viagerage_tete_2 int
Âge tête 2 -
Pour investissement -
programme ventemesures_fiscales text
Mesures fiscalesPlusieurs choix possibles parmi :- PLS
- LMNP
- Censi-Bouvard
- Duflot
- Pinel
- ANRU
- PTZ+
- TVA réduite
- TVA 5.5%
- TVA 7%
- Démembrement
- Malraux
- Nue-propriété
- Monuments Historiques
- Résidence Principale
- Informations Energétiques
-
programmedpe_conso_en float
Valeur DPE -
Classe DPE -
programmedpe_date date
Date du DPE -
Version du DPE -
programmedpe_ges float
Valeur GES -
Classe GES -
DPE coût min conso -
DPE coût max conso -
DPE Année de référence conso -
DPE coût conso annuelle -
programme ventecertifications text
CertificationsPlusieurs choix possibles parmi :- BBC
- HQE
- HPE
- THPE
- H&E
- NF Logement
- RT2005
- RT2012
- FPC
- VIVRELEC
- FPI
- EDF Bleu Ciel
- PROMOTELEC
- QUALIGAZ
- DOLCE VITA
- Informations Négociateur
-
Neg Tel Pro -
Neg Secteur -
Neg Prenom -
Neg Num -
Neg Nom -
Neg Mail -
Neg Photo -
Neg Short Text -
Neg Long Text - Particularité de l'annonce
-
Coup de coeur -
Type mandat - Liens externes
-
Url - Tarifs
-
Prix Semaine Basse Saison -
Prix Quinzaine Basse Saison -
Prix Mois Basse Saison -
Prix Semaine Haute Saison -
Prix Quinzaine Haute Saison -
Prix Mois Haute Saison -
Periodes Disponibilites -
Periodes Basse Saison -
Periodes Haute Saison -
Nb Couverts -
Nb Lits Doubles -
Nb Lits Simples
Programmes Neufs (lots)
Si l'annonce
<ad>
est un Programme Neuf, donc si et seulement si elle a comme valeur de
<transaction>
P
, alors vous devriez spécifier les lots du programme.
Exemple :
<ad reference="A1"> <!-- Transaction "P" pour "Programme Neuf" --> <transaction>P</transaction> <!-- Type général du programme, s'il n'a pas de lot --> <type sub="Studio">flat</type> <localization> <address>Rue Centrale</address> <postCode>01234</postCode> <city>Saint-Paul</city> <country>FR</country> </localization> <!-- Prix minimum du programme, s'il n'a pas de lot --> <price currency="euro">239000</price> <!-- Nb. pièces minimum du programme, s'il n'a pas de lot --> <rooms>2</rooms> <!-- surface minimum du programme, s'il n'a pas de lot --> <surface>60</surface> <mandate> <type>simple</type> <number>1234</number> </mandate> <texts> <text target="internet" lang="fr">Description du programme</text> <text target="press" lang="fr">Description du programme pour la presse</text> </texts> <titles> <title lang="fr">Titre/accroche du programme</title> </titles> <contact> <phone>0123456789</phone> <email>contact@example.com</email> </contact> <medias> <media type="photo"> <url>http://example.com/photo-A1-1.jpg</url> </media> </medias> <!-- Champs extras dédiés au neuf --> <extras> <extra key="nom_programme">Les Nouvelles Demeures</extra> <extra key="livraison">1er trimestre 2025</extra> <extra key="etat_avancement">Travaux en cours</extra> <extra key="certifications">BBC, NF Logement</extra> <extra key="mesures_fiscales">Pinel, Duflot, TVA réduite</extra> </extras> <!-- Lots --> <lots> <lot reference="1"> <type>flat</type> <price currency="euro">239000</price> <rooms>2</rooms> <floor>2</floor> <surface>60</surface> </lot> <lot reference="2"> <type>flat</type> <price currency="euro">277000</price> <rooms>3</rooms> <floor>rdc</floor> <surface>69</surface> <garden>true</garden> <parking>true</parking> </lot> <lot reference="3"> <type>house</type> <price currency="euro">370000</price> <rooms>4</rooms> <floor>1</floor> <surface>84</surface> <balcony>true</balcony> </lot> <lot reference="4"> <type>house</type> <price currency="euro">369000</price> <rooms>4</rooms> <floor>4</floor> <surface>84</surface> <balcony>true</balcony> <patio>true</patio> </lot> </lots> </ad>
Les informations de prix, surface et pièces de l'annonces seront déduites des lots, avec leur valeur minimum ("prix à partir de", "surface minimum", etc.).
Les informations de prix, surface et pièces contenues dans <ad> sont alors considérées comme secondaires, et ne sont utilisées que :
- s'il n'y a pas de lot (programme en avant première, ou information indisponible)
- ou si les lots manquent d'information.
Chaque <lot> peut avoir un attribut reference.
Voici la description des balises contenues dans <lot> :
-
<type>:
Le type de lot est à choisir parmi :
house maison flat appartement, studio, loft, etc. garage garage, parking office bureau shop commerce -
<price>:
Le prix du lot.
Il doit être de type numérique, sans espaces.
Les décimales sont acceptées, ex350.50
(mais non prises en compte).L'attribut obligatoire currency doit être défini à
euro
, seule devise supportée. -
<rooms>:
Le nombre de pièces.
optionnel, mais recommandé.
(type entier positif) -
<floor>:
L'étage du lot
optionnel
("rdc", ou type entier positif) -
<surface>:
La surface habitable du bien
optionnelle, mais recommandée.
(type decimal positif) -
Les lots peuvent spécifier leurs avantages.
Chaque avantage est un boolean
true
oufalse
). Les avantages marquésfalse
seront ignorés.- <garden>true</garden> : le lot donne accès à un jardin.
- <balcony>true</balcony> : le lot donne accès à un balcon.
- <patio>true</patio> : le lot donne accès à une terrasse.
- <parking>true</parking> : le lot donne accès à un parking.
Viagers
Un viager est quasiment identique à une vente normale, si ce n'est que le prix indique le bouquet, et qu'il est possible de spécifier la rente mensuelle ainsi que des informations complémentaires.
Si l'annonce
<ad>
est un Viager, donc si et seulement si elle a comme valeur de
<transaction>
L
, alors voici les spécificités :
-
<price>:
Correspond au bouquet.
-
<extras>
<extra key="rente_mensuelle">750</extra>
</extras>
Correspond à la rente mensuelle du viager (en €).
-
Voici la liste des champs <extra> concernant le viager :
Loi ALUR (et décret 2017)
Afin de respecter la loi ALUR et son décret de janvier 2017, voici quelques informations complémentaires :
Pour les vente
Concernant les ventes (<transaction>S</transaction>) :
- le champ <price> comprend les tous les honoraires.
- les champs extras suivants sont nécessaires pour être en confirmité :
-
general alur alurventestatut_nego text
Statut du négociateurUn choix possible parmi :- Agent immobilier
- Salarié
- VRP
- Agent commercial
-
vente alur alurventecopropriete bool
Copropriété -
vente alur alurventecopropriete_nb_lots int
Nombre de lots de la copropriété -
vente alur alurventequote_part_annuelle money
Moyenne de la quote part(an) -
vente alur alurventesyndic_procedure_alerte bool
Syndic sous procédure d'alerte -
vente alur alurventesyndic_sous_admin bool
Syndic sous administration provisoire -
vente alur alurventesyndic_detail_procedure text
Détail de la procédure -
alur alur2017 alurventeprix_hors_honoraires money
Prix hors honoraires acquéreur -
alur alurventepourcentage_honoraires specific
Pourcentage des honoraires acquéreur -
alur alur2017 alurventehonoraires_a_charge_de text
Honoraires à charge deUn choix possible parmi :- acquéreur
- vendeur
- acquéreur et vendeur
-
alur alur2017 alurloc alurventeurl_bareme text
URL du barême des honoraires
Pour les locations
Concernant les locations (<transaction>R</transaction>) :
- le champ <price> est le loyer charges comprises.
- les champs extras suivants sont nécessaires pour être en confirmité :
-
alur alur2017 alurloc maison appartementmeuble bool
Meublé -
alur alur2017 alurloccharges money
Charges -
alur alur2017 alurlochonoraires money
Honoraires -
alur alur2017 alurlocreglement_charges text
Règlement des chargesUn choix possible parmi :- provisionnel
- forfaitaire
- remboursement
-
alur alur2017 alurlochonoraires_etat_des_lieux money
Honoraires état des lieux -
alur alur2017 alurloccomplement_loyer money
Complément de loyer -
alur alur2017 alurlocbase_loyer money
Loyer de base -
alur alur2017 alurlocloyer_reference money
Loyer de référence majoré -
alur alur2017 alurloc alurventeurl_bareme text
URL du barême des honoraires