Version 14 du 31 mars 2000

1. Plan 

1. Plan *

2. Structure du fichier bien *

2.1. Les champs de catégorie 1 *

Les champs de catégorie 2 *

3. Structure des fichiers images associés *

3.1. Fichiers images proprement dits *

3.2. Un fichier texte associé *

4. Protocole de transfert *

5. Cas du transfert de serveur à serveur *

2. Structure du fichier bien

Le nom du fichier bien est " bien.txt "

Ce fichier est de type texte et comprend un enregistrement par bien. Chaque enregistrement est délimité par le code ascii 13. Les champs d’un enregistrement sont séparés par un code ascii 9. La fin de fichier est marquée par l’envoi de 2 caractères ascii 13.

Ces champs sont regroupés en 4 catégories (et seules les deux premières catégories sont normalisées) :

1^ère catégorie : Les champs indispensables : ces champs doivent être valorisés pour permettre au serveur une exploitation minimum satisfaisante.

2^ème catégorie : Les champs souhaitables. Ces champs sont facultatifs, ils permettent au serveur d’améliorer la qualité de l’information. Ces champs respectent une syntaxe du type : G_(caractère de soulignement)[titre du champ] : [contenu du champ] (par exemple : G_SurfaceSejour:125[code ascii 9]...).

3^ème catégorie : Les champs SSII ou serveurs d’annonces. En fonction de leurs besoins, les SSII/serveurs pourront ajouter d’autres champs. Ces champs seront présentés en respectant une syntaxe du type : XX_(caractère de soulignement)[titre du champ] : [contenu du champ]. XX étant égal au numéro de la SSII.

A chaque transfert, il est nécessaire d’envoyer la totalité du fichier (les biens non envoyés étant considérés comme étant à supprimer).

1. Les champs de catégorie 1

Rubrique	Type	Obligatoire	Long maxi	Précisions
Référence cabinet	Alphanum	X	8	Numéro identifiant national
Référence affaire	Alphanum	X	10	Le code doit être unique pour un cabinet
Code transaction	Entier	X	1	0 = vente et location – 1 = vente – 2=location-3=saisonnier
Code type de bien	Entier	X	1	1 = appartement 2 = maison 3 = terrain 4 = château 5 = commerce 6 = droit au bail 7 = parking 8 = immeuble 9 = location de vacances 10 = immobilier d’entreprise 11 = bien rural
Code monnaie	Entier	X	1	1=franc - 2 =euro
Code secteur géographique	Alphanum.	X	4	Est défini par les fédérations professionnelles (soit un code secteur, soit un code station).
Code postal	Alphanum.	X	5	5 chiffres
Ville	Alpha	X	30
Prix	Numérique	X	11	Limité à 8 chiffres si nombre entier. Extensible si terminé par une virgule et deux chiffres décimaux.
Loyer	Numérique	X	10	Limité à 7 chiffres si nombre entier. Extensible si terminé par une virgule et deux chiffres décimaux.
Charges mensuelles	Numérique	X	10	Idem loyer.
Frais d'agence	Numérique	X	10	Idem.
Surface habitable	Entier	X	5	Surface en m².
Nombre de pièces	Entier	X	2
Date de 1ère parution	Date	X	10	Format jj/mm/aaaa. Il s’agit de la date de 1ère publication de l’annonce.
Date de disponibilité	Date		10	Format jj/mm/aaaa. Ne pas alimenter si le bien est libre.
Titre de l'annonce	Alpha		40	Ou situation. Il s’agit de la phrase d’accroche. Ex : Centre ville ou Magnifique Duplex ensoleillé …
Description de l'annonce	Alpha		200	Zone de texte.
Titre de l'annonce en anglais	Alpha		40	Pour consultation du serveur internet en anglais.
Description de l'annonce en anglais	Alpha		200	Idem.
Nombre de personnes maxi	Entier		2	Prévu pour le type de bien "locations de vacances"
Information sur les prix	Alphanum.		800	Texte libre prévu pour le type de bien "locations de vacances"
Information sur les prix en anglais	Alphanum.		800
Mettre à jour les images	Entier		1	0 = non - 1 = oui (voir explications dans la gestion des images))

Les champs de catégorie 2

Les champs de catégorie 2 peuvent être gérés partiellement et il est possible d’envoyer un champ sans envoyer les champs précédents.

Par exemple un logiciel peut se contenter d’envoyer tous les champs de catégorie 1 et uniquement le champ G_Etage.

Rubrique de 2ème catégorie	Titre (devant précéder le contenu des rubriques)	Type	Long maxi	Précisions
Surface séjour	G_SurfaceSejour	Entier	3
Surface terrain	G_SurfaceTerrain	Entier	7
Nombre de chambres	G_NbreChambres	Entier	2
Etage	G_Etage	Entier	2	Situation du bien : Entier compris entre -9 et 99.
Nombre de niveaux	G_NbreNiveaux	Entier	1
Ascenseur	G_Ascenseur	Alpha	1	o=oui n=non
Cuisine	G_Cuisine	Alpha	1	o=oui n=non e=équipée
Salles de bain	G_SallesDeBain	Entier	1	Nombre de salles de bain
Salles d'eau	G_SalleEau	Entier	1	Nombre de …
Chauffage	G_Chauffage	Alphanum	1	S=sans, i=individuel, c=collectif 4=climatisation, 5 =sans climat. Table différente pour les maisons/location : 1=gaz, 2=électrique, 3=fuel, 4=autre.
Balcon	G_Balcon	Entier	1	Nombre de…
Terrasse	G_Terrasse	Entier	1	Nombre de…
Garage	G_Garage	Entier	1	Nombre de…
Parking	G_Parking	Entier	1	Nombre de…
Cave	G_Cave	Entier	1	Nombre de…
Année de construction	G_AnneeConstruction	Entier	4
Quartier	G_Quartier	Alphanum.	10	Il s'agit du code quartier (défini par les fédérations professionnelles)
Proximité	G_Proximité	Alphanum	40	Description de la proximité du bien (Ex : Ecoles, Commerces, …)
Numéro adhérent	G_Adherent	Entier	5	Numéro de l’adhérent dans sa fédération professionnelle. Ce numéro est indispensable sur certains serveurs.

 

 

3. Structure des fichiers images associés
1. Fichiers images proprement dits

1. Un fichier texte associé

L’objectif de ce fichier (facultatif) est de donner des précisions sur les fichiers images. Ce fichier se nomme " image.txt ". et répond aux mêmes normes que le fichier " bien.txt ". (enregistrements séparés par code ascii 13, champs séparés par code ascii 9, fin de fichier par 2 codes ascii 13).