Retour d’expérience · Scout
Scout : actualiser prix et stocks fournisseurs sans écraser les fiches enrichies
Sur Scout, les organisations immobilières commandent auprès de fournisseurs dont les catalogues changent au fil de leurs exports. Chaque nouveau fichier doit mettre à jour les prix et les disponibilités sans effacer ce qui a été complété sur la plateforme. Nous avons construit, sur une base Medusa et Mercur, un parcours de mise à jour qui compare les données reçues aux fiches existantes. Il laisse choisir les changements à retenir et limite ce que chaque flux fournisseur peut modifier.
Scout est une plateforme d’approvisionnement B2B destinée aux organisations immobilières qui gèrent des propriétés composées d’appartements et d’unités. Ces organisations y trouvent des fournisseurs de produits et des prestataires, et commandent auprès d’eux depuis un même espace. De leur côté, les fournisseurs disposent d’un espace vendeur où ils tiennent leur catalogue, leurs prix et leurs stocks. Ces données viennent rarement d’une saisie fiche par fiche. Elles proviennent des exports de chaque fournisseur, et ces exports diffèrent dans leurs colonnes, leurs formats et leurs habitudes de nommage. Une fiche publiée sur Scout n’est pas non plus une simple copie de la ligne du fournisseur : une description, des images ou une catégorie ont pu y être complétées. Appliquer un nouveau fichier sans discernement aurait écrasé ce travail. Il fallait donc pouvoir intégrer ce que le fichier apporte de nouveau tout en conservant ce qui devait rester.
Une correspondance enregistrée une fois pour chaque format fournisseur
L’import guide l’équipe du fournisseur à travers des étapes successives. Elle dépose d’abord son fichier, puis fait correspondre ses colonnes aux informations attendues par Scout et convertit les valeurs qui doivent l’être. Viennent ensuite la validation des lignes, une étape de catégorisation des produits, puis le rapprochement avec le catalogue déjà présent. Ce découpage permet de comprendre ce qui est lu, ce qui est transformé et ce qui sera rapproché, au lieu de découvrir le résultat une fois le fichier entièrement appliqué.
Un fournisseur renvoie généralement des exports construits sur le même modèle. Il serait fastidieux de refaire toute la correspondance des colonnes à chaque livraison. Le fournisseur peut donc enregistrer cette configuration dans son compte et la retrouver lors de l’import suivant. Si son propre export évolue, par exemple après l’ajout ou le renommage d’une colonne, il corrige la configuration existante sans repartir de zéro. Lorsqu’une configuration ne correspond plus à aucun fichier réel, il peut la supprimer pour qu’elle ne soit pas réutilisée par erreur.
Recevoir des exports irréguliers et les remettre en forme
Certains fichiers ne se prêtent pas directement à un import. Lorsqu’une pièce jointe reçue d’un fournisseur est mal formée, l’administration de Scout peut la nettoyer pour la rendre exploitable. Le fichier corrigé conserve la trace de son origine : on sait de quel envoi il provient.
La documentation du projet décrit aussi des dispositifs mis au point pour des fournisseurs particuliers. Dans l’un d’eux, les exports de catalogue, de stock et de prix envoyés par email étaient dirigés vers l’import de Scout. Un autre convertissait le format irrégulier d’un fournisseur avant sa lecture, afin que ses références produits ne soient pas altérées. Un troisième transformait le fichier texte d’un autre fournisseur en tableau, puis l’envoyait vers le bon circuit d’import. Ces dispositifs sont documentés avec les résultats obtenus lors de leur mise au point. Ils montrent comment un format récalcitrant peut être absorbé en amont. Ils ne garantissent pas pour autant qu’un tel branchement soit actif aujourd’hui pour chaque fournisseur.
Voir ce que le fichier changerait avant de l’accepter
Avant de confirmer une mise à jour, le fournisseur peut confronter une ligne importée à la fiche existante. La comparaison porte sur les informations du produit, sur son prix et sur ses images. Il n’a donc pas à valider un fichier dans son ensemble sans savoir ce qu’il contient : il peut voir, produit par produit, ce qui serait remplacé.
Cette comparaison permet de repérer les différences attendues et celles qui ne le sont pas. Une hausse de prix prévue est attendue. Une description raccourcie par l’export, ou une image remplacée par celle d’un autre catalogue, l’est moins. La décision intervient à ce moment-là, avant publication, plutôt qu’après coup, quand il faudrait retrouver l’ancienne version d’une fiche.
Retenir certains changements et conserver le reste
Le fournisseur peut ensuite confirmer la mise à jour pour toutes les lignes ou pour une sélection d’entre elles. Les différences qu’il ne retient pas ne sont pas appliquées : la donnée en place sur Scout est conservée. Un même fichier peut ainsi servir à actualiser des prix tout en laissant intactes les fiches que l’on ne souhaite pas modifier.
À titre d’illustration, imaginons un exemple fictif. Un fournisseur de robinetterie transmet son nouvel export. Les tarifs ont évolué sur une partie de la gamme, mais certaines lignes du fichier portent des descriptions plus sommaires que celles déjà rédigées sur la plateforme. Après comparaison, il confirme les lignes dont il valide les changements et écarte les autres, dont les fiches restent en l’état. Si l’administration a limité les mises à jour de ce fournisseur aux prix, les descriptions du fichier ne sont de toute façon pas reprises.
Une fois les choix faits, le fournisseur clôture la revue et obtient des compteurs définitifs sur ce qui a été traité. Le fichier est alors identifié comme terminé et ne reste pas dans un état intermédiaire.
Fixer, fournisseur par fournisseur, les informations qu’un flux peut modifier
Le choix ligne par ligne répond à un fichier précis. Une règle plus durable s’y ajoute. L’administration de Scout peut définir, pour chaque fournisseur, les informations que ses mises à jour sont autorisées à modifier. Lors de la confirmation, seules ces informations sont reprises depuis le fichier. Un flux prévu pour actualiser des prix ne peut donc pas réécrire le reste de la fiche.
Les deux niveaux se complètent. La règle définie pour le fournisseur s’applique d’un import à l’autre : les informations qu’elle n’ouvre pas au flux ne sont pas reprises depuis le fichier, même si celui-ci contient des colonnes inattendues. La revue de chaque import laisse ensuite décider, à l’intérieur de ce cadre, quels changements publier. La plateforme garde ainsi la maîtrise des fiches présentées aux organisations immobilières, et les fournisseurs peuvent mettre à jour ce qui leur revient.
Les nouveaux produits et les bons comptes
Un fichier de mise à jour peut contenir des références que Scout ne connaît pas encore. Ces nouveaux produits apparaissent en attente d’import, et l’administration peut les consulter pour contrôler l’arrivée de références inconnues.
D’autres contrôles portent sur le rattachement des données. Un import est refusé si le fournisseur ne dispose pas de son propre lieu de stock : les quantités importées ne peuvent pas alimenter celui d’un autre compte. Le fichier déposé doit aussi appartenir au fournisseur qui lance le traitement. Sur une plateforme qui réunit de nombreux vendeurs, ces vérifications évitent qu’une livraison modifie le catalogue ou les disponibilités d’un autre fournisseur.
Des imports volumineux que l’on suit et que l’on reprend
Un catalogue complet peut compter beaucoup de lignes. Le traitement se déroule donc en arrière-plan, sans que le fournisseur ait à garder une page ouverte jusqu’à la fin. Il retrouve ses lots classés par type et par état, avec leur progression. Les traitements longs, dont ceux qui font appel à l’IA, restent ainsi visibles.
Si un import est interrompu, le fournisseur le reprend à partir de ce qui a déjà été chargé, au lieu de tout recommencer. Il peut aussi annuler un lot de création lancé par erreur tant que celui-ci est encore annulable. Lorsque certaines lignes échouent, il récupère uniquement les produits concernés pour les corriger et les relancer, sans renvoyer l’ensemble du fichier.
Sur Scout, un nouvel export fournisseur ne se traite pas en tout ou rien. Le fournisseur réutilise la configuration de son format, compare ce que le fichier changerait et ne confirme que ce qu’il retient. L’administration fixe, fournisseur par fournisseur, les informations qu’un flux peut modifier. Les prix et les disponibilités peuvent ainsi être actualisés sans effacer le travail fait sur les fiches de la plateforme.