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> <media type="youtube"> <url>https://www.youtube.com/watch?v=example</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"> → URL de la visite virtuelle du bien (maximum 1 visite virtuelle par bien) <media type="youtube"> → URL de visite virtuelle sur youtube (maximum 1 vidéo 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 exemple2024-10-09T07:45:44+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 (seulement une vidéo youtube peut être ajouté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
- Rénové
- Moyen
- Ancien
-
maison appartement commerce bureauetat_interieur text
État intérieurUn choix possible parmi :- Neuf
- Entièrement rénové
- Excellent
- Très Bon
- Bon
- Habitable
- A rafraîchir
- A rénover
- Rénové
- Moyen
- Ancien
-
É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
- 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 -
Prix du terrain hors frais -
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é -
Encadrement des loyers -
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
- RE2020
- 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