Flux PolirisRéférence d'intégration
Sommaire de la documentation

Vue d'ensemble

Fiche technique du flux Poliris entrant, démarrage rapide et cycle de vie d'un envoi.

Référence d'intégration du flux Poliris entrant, pour les éditeurs de logiciels de transaction qui diffusent déjà vers des portails. Seuls les écarts et les règles propres au site sont décrits : le format Poliris lui-même est supposé connu.

Fiche technique

Format
Poliris, CSV à séparateur !#, positions de colonnes fixes (4.08 et suivantes)
Transport
SFTP (SSH-2), en push, port 22. Ni FTP, ni FTPS
Compte
Un par éditeur de logiciel : poliris-<slug>
Sémantique
Flux complet par agence : chaque envoi porte tout le stock en cours
Identité d'un bien
Triplet (compte émetteur, code agence, référence)
Lecture
Toutes les 15 minutes
Transactions publiées
Vente uniquement ; les autres sont ignorées sans erreur
Zone
Métropole lilloise : codes postaux 59xxx, adresse géocodée dans la métropole
Encodage
UTF-8 ou Windows-1252 (ISO-8859-1), détecté
Mise en service
Chaque nouvel émetteur démarre en simulation : envois lus et comptés, rien n'est publié

Démarrage rapide

  1. Demander un accès via la page de contact. Hôte, identifiant, mot de passe et empreinte de la clé d'hôte sont transmis en privé.
  2. Recevoir un code agence par agence diffusée. Il va en colonne 1 et ne vaut que pour votre compte.
  3. Déposer un zip dans /incoming, en écriture atomique (voir Dépôt SFTP).
  4. Relire avec nous le compte rendu du premier envoi, lu en simulation.
  5. Passage en production : les envois suivants publient.

Cycle de vie d'un zip

Arborescence du compte
/incoming/export.zip
 │
 ├─ modifié il y a moins de 2 min ......... laissé pour le passage suivant
 ├─ illisible, sans annonces.csv,
 │  ou aucune ligne d'une agence rattachée ... → /rejected/AAAA-MM-JJ/export.zip
 └─ traité ................................. → /processed/AAAA-MM-JJ/export.zip

Note

Un zip interrompu par la limite de durée d'un passage reste dans /incoming et reprend au passage suivant. Les annonces déjà écrites sont reconnues à leur empreinte et ne sont pas retraitées.

Sommaire

Dépôt SFTPConnexion, arborescence, dépôt atomique, cadence de lecture et archivage.Format du fichierStructure du zip, grammaire du CSV, encodage et lecture des valeurs.Colonnes luesPositions Poliris lues, types, obligations et correspondance avec le site.Règles de traitementIdentité, flux complet, garde-fou, statut de publication, géolocalisation et photos.Rejets et avertissementsMessages exacts du compte rendu et leur effet sur l'annonce.Limites et recettePlafonds du traitement et scénarios à dérouler avant la mise en production.
Suivant Dépôt SFTP

Dernière mise à jour : 29 septembre 2026