Sommaire de la documentation
Règles de traitement
Identité, flux complet, garde-fou, statut de publication, géolocalisation et photos.
Identité et idempotence
(compte émetteur, code agence, référence) unique- Un même envoi rejoué ne crée aucun doublon.
- Chaque annonce porte une empreinte SHA-256 de ses valeurs lues et des octets de ses photos du zip. Empreinte identique au précédent envoi : l'annonce n'est pas retraitée.
- Changer la référence d'un bien revient à le retirer puis en créer un nouveau : il perd son URL, ses vues et ce que l'agence a complété sur le site.
- Une référence présente deux fois dans un envoi : la dernière ligne l'emporte.
Flux complet
Pour chaque code agence présent dans l'envoi :
- référence inconnue : création ;
- référence connue, empreinte changée : mise à jour ;
- référence connue, empreinte identique : rien, sauf un changement de statut (voir plus bas) ;
- bien en base absent de l'envoi, ou devenu non-vente : retrait.
Une ligne rejetée ne retire pas le bien : la version déjà en ligne reste en place. Un code agence absent de l'envoi n'est pas touché. Les retraits d'une agence n'ont lieu qu'une fois toutes ses lignes traitées.
Garde-fou
Si un envoi retirerait plus de 50 % du stock en cours d'une agence qui compte au moins 4 biens, aucun retrait n'est appliqué pour cette agence ; créations et mises à jour passent. Le compte rendu le signale. Un export tronqué ne vide donc jamais une vitrine ; en contrepartie, un vrai déstockage massif doit nous être annoncé.
Statut de publication
| Situation | Statut sur le site |
|---|---|
| Agence validée et au moins une photo reprise | active |
| Agence non validée, ou aucune photo reprise | draft |
| Absent de l'envoi, ou transaction non-vente | sold |
Le statut est recalculé à chaque envoi, même pour un bien inchangé : un bien revenu dans le stock, ou une agence validée entre deux envois, est publié sans action de votre part.
Note
Une annonce reçue par flux est en lecture seule dans l'espace de l'agence, qui ne peut compléter que ce que Poliris ne porte pas (potentiel de travaux, lieux affichés autour du bien). Toute correction passe par le logiciel.Géolocalisation
adresse + CP + villeest géocodé par la Base Adresse Nationale. Adresse inchangée : la position précédente est reprise sans nouvel appel.- Position hors de la métropole lilloise : ligne rejetée.
- Adresse absente ou introuvable : bien publié sans position (absent de la carte et de la recherche par temps de trajet).
- La position publique est décalée d'environ 200 m ; l'adresse n'est jamais exposée.
Photos
| Règle | Valeur |
|---|---|
| Source | Fichier du zip (par nom) ou URL http(s) |
| Téléchargement d'une URL | 15 s au plus, statut 2xx |
| Taille | 10 Mo au plus, fichier non vide |
| Formats | JPEG, PNG, WebP, GIF, reconnus à leurs premiers octets (l'extension et le type annoncé ne comptent pas) |
| Hébergement | Recopiées sur notre CDN ; l'URL d'origine n'est jamais servie |
| Échec | Photo écartée avec avertissement ; les autres sont gardées |
Attention
Une photo désignée par URL n'est téléchargée qu'une fois : l'URL sert de clé. Pour remplacer une image, publiez-la sous une nouvelle URL. Une photo du zip est identifiée par ses octets : la remplacer sous le même nom de fichier suffit.Champs dérivés
| Champ | Valeur |
|---|---|
region | hauts-de-france |
slug | Tiré du libellé à la création, puis figé : l'URL publique ne change pas |
price | Formaté, par exemple 425 000 € |
dpeStatus | renseigne dès qu'une classe énergie est fournie |
agency | Nom, téléphone, logo et interlocuteur du compte agence sur le site, jamais ceux du fichier |
state | Non renseigné : Poliris ne le porte pas |
Dernière mise à jour : 29 septembre 2026