Un export CSV d'opportunités doit transmettre plus qu'un produit et une marge affichée. Conservez des identifiants stables, les références fournisseur et marketplace, chaque coût, la devise, la base fiscale, les hypothèses, les formules versionnées, les URLs de source, les horodatages et l'état de validation. Définissez l'ordre des colonnes, l'encodage, le séparateur et les règles de citation dans un contrat versionné. Joignez un manifeste indiquant version, date, nombre de lignes et contrôles réalisés. L'export reste une photographie : il ne remplace pas la donnée source et ne garantit pas que prix ou stock sont encore valables. Avant partage, expurgez secrets et données personnelles, puis testez l'import avec des virgules, guillemets et retours à la ligne.
Le CSV doit transporter le raisonnement
Une ligne « EAN, achat, vente, marge » ne permet pas à un collègue de vérifier l'opportunité. Il ignore d'où viennent les valeurs, à quelle date elles ont été observées, si les taxes sont incluses, quel conditionnement est comparé et quelle formule a été appliquée. Le fichier devient vite une liste de conclusions détachées de leurs preuves.
L'objectif est de transmettre un état reproductible. Chaque ligne doit permettre de retrouver les observations d'origine et la décision humaine. L'alerte de prix traçable fournit les identifiants et horodatages utiles ; la file de données exportées en reprend les références au lieu de dupliquer des preuves sans lien.
RFC 4180 décrit un format commun pour les fichiers CSV et l'usage du type média text/csv. Il prévoit notamment des enregistrements séparés par des fins de ligne, un éventuel en-tête, et la citation des champs contenant séparateur, guillemet ou retour à la ligne. Le document reconnaît aussi que les pratiques varient. Un contrat d'export doit donc préciser les choix concrets au lieu de supposer que « CSV » suffit.
Les groupes de colonnes à prévoir
| Groupe | Exemples de champs | Preuve conservée |
|---|---|---|
| identité | opportunity_id, source, référence fournisseur, marketplace, ASIN, GTIN | clés stables des objets comparés |
| offre fournisseur | prix brut, devise, taxe, quantité, conditionnement, stock | observation et URL source |
| offre marketplace | prix observé, état, frais utilisés, marché | observation et date |
| calcul | coût rendu, résultat, formule et version | entrées et hypothèses explicites |
| qualité | fraîcheur, état de source, champs manquants | exécution de collecte concernée |
| matching | méthode, preuves, contradictions, décision de revue | dossier de correspondance |
| gouvernance | statut, auteur de décision, date, commentaire | traçabilité humaine |
| provenance | URL, observed_at, identifiant d'exécution | retour aux données sources |
Les colonnes numériques doivent indiquer leur unité ou leur devise. Les dates doivent suivre un format explicite ; RFC 3339 fournit une représentation adaptée aux échanges Internet. Un champ vide doit être distingué d'une valeur nulle, de zéro ou de « non applicable » dans le dictionnaire de données.
Procédure de création reproductible
1. Fixer le périmètre. Définissez les états d'opportunité inclus et la date de coupe. 2. Versionner le schéma. Donnez un nom et une version au jeu de colonnes et à leur ordre. 3. Écrire le dictionnaire. Pour chaque colonne, décrivez type, unité, valeur vide et source. 4. Sélectionner les observations. Conservez leurs identifiants et horodatages, sans recalcul silencieux. 5. Exporter les entrées du calcul. Incluez coûts et hypothèses, pas seulement le résultat final. 6. Exporter les décisions. Ajoutez état de revue, motif, auteur et date lorsque ces informations existent. 7. Appliquer les règles CSV. Citez correctement les séparateurs, guillemets et retours à la ligne. 8. Expurger. Retirez secrets, jetons, données personnelles et champs internes non nécessaires. 9. Produire un manifeste. Notez version, heure d'export, nombre de lignes et résultat des contrôles. 10. Tester le trajet retour. Réimportez dans un environnement de contrôle et réconciliez identifiants, colonnes et lignes.
Le tableau de santé des sources doit fournir l'état de la collecte utilisée. Si la source était en anomalie, le CSV ne doit pas transformer cette donnée en valeur validée par le simple fait de l'exporter.
Exemple hypothétique de ligne vérifiable
Supposons une opportunité fictive OPP-001, observée à un instant au format RFC 3339. Le prix fournisseur pédagogique est 20,00, un coût de transport hypothétique de 3,00 et un prix de sortie hypothétique de 35,00, tous dans la même devise. Ces valeurs sont inventées et ne décrivent aucune offre réelle.
Un résultat simplifié pourrait être calculé comme 35,00 - 20,00 - 3,00 = 12,00, avant tous les autres coûts qui seraient explicitement marqués hors périmètre. Le CSV devrait contenir les trois entrées, la formule versionnée, le résultat, la devise et la mention des coûts absents. Une colonne « marge = 12 » sans ces éléments serait trompeuse.
Ajoutons un commentaire fictif contenant une virgule et des guillemets : il doit être cité et les guillemets internes échappés selon la convention décrite par RFC 4180. Le test de réimport vérifie que le commentaire redevient une seule cellule et qu'aucune ligne supplémentaire n'est créée.
Un manifeste pour vérifier le fichier
Le manifeste accompagne l'export sans se substituer aux lignes. Il peut inclure l'identifiant et la version du schéma, la date de création, la période couverte, le nombre de lignes déclaré, le nom logique de l'export et le résultat des validations. Si une empreinte cryptographique est retenue, l'algorithme et la procédure de vérification doivent être documentés ; aucun choix universel n'est supposé ici.
Le nombre de lignes du manifeste doit être réconcilié avec le fichier effectivement lu. Les identifiants doivent être uniques selon la règle annoncée. Les colonnes obligatoires ne doivent pas disparaître. Toute modification manuelle après export invalide les contrôles associés et doit produire une nouvelle version.
Le modèle PROV-O du W3C distingue les entités, les activités et les agents. Cette grille aide à représenter le fichier comme une entité générée par une activité d'export, elle-même associée à un système ou à une personne. Elle soutient une provenance explicite sans imposer un format unique dans le CSV.

Cette capture est une vue publique expurgée de la route. Elle ne contient aucune donnée de compte et ne prouve pas l'existence de la fonction authentifiée proposée.
Sécurité, tableurs et limites du format
Un CSV est du texte, mais il peut être ouvert dans des tableurs qui interprètent certaines cellules. Définissez une politique de neutralisation des contenus non fiables adaptée aux outils cibles et testez-la sans détruire la valeur source. Ne laissez jamais une donnée fournisseur piloter une formule ou un lien actif sans contrôle.
Évitez aussi d'intégrer des secrets sous prétexte de faciliter le diagnostic : clé API, jeton, cookie, identifiant de session et adresse personnelle n'ont pas leur place dans l'export d'opportunités. Une URL de preuve peut être conservée si elle est publique ou si le destinataire est autorisé ; une URL signée temporaire exige une gestion séparée.
Enfin, le fichier est une photographie à une date donnée. Le stock peut disparaître et le prix évoluer après l'export. Conservez observed_at, l'état de validation et une date éventuelle d'expiration. L'équipe doit rafraîchir les données avant commande.
Ce qu'ArbitragePro+ peut automatiser / ce que le vendeur doit vérifier
La fonction specification:export-csv-opportunites est une proposition, pas une fonction confirmée de l'application.
| Automatisation proposée pour ArbitragePro+ | Vérification qui reste au vendeur |
|---|---|
| générer un fichier selon un schéma versionné | choisir le périmètre et les colonnes autorisées |
| inclure identifiants, entrées, preuves et horodatages | vérifier la pertinence des hypothèses et des sources |
| appliquer citation CSV et contrôles de structure | tester les outils réellement utilisés par l'équipe |
| produire un manifeste et réconcilier les lignes | conserver et partager les fichiers selon les droits |
| expurger des catégories de champs configurées | confirmer qu'aucune donnée sensible ne subsiste |
Cette automatisation proposée faciliterait l'échange et l'audit. Elle ne figerait ni le prix ni le stock et ne remplacerait pas la décision du vendeur.
Checklist avant partage
- Le schéma et le dictionnaire de données sont versionnés.
- L'ordre, le séparateur, l'encodage et les fins de ligne sont documentés.
- Les identifiants permettent de retrouver chaque observation.
- Les entrées du calcul et les hypothèses accompagnent le résultat.
- Devise, taxe, unité et conditionnement sont explicites.
- Les dates distinguent observation, export et décision.
- La revue des faux positifs est exportée avec son motif.
- Les champs sensibles sont absents.
- Le manifeste se réconcilie avec le fichier.
- Un réimport de contrôle traite correctement guillemets et retours à la ligne.
Sources officielles
Sources consultées le 17 août 2026 :
- IETF — RFC 4180, format commun et type média des fichiers CSV
- IETF — RFC 3339, représentation des dates et heures
- W3C — PROV-O, ontologie officielle de provenance
Exporter des opportunités vérifiables
Examiner les opportunités fournisseur–Amazon dans ArbitragePro+
