Notre Feuille de route type
Voici la feuille de route type pour implémenter l’API en 4 mois, répartis équitablement entre Préparation et Tests. Cette durée peut varier en fonction des ressources disponibles au sein de votre entreprise. Vous pouvez compléter le data & IT diagnostic Fairly Made ici afin d'identifier vos besoins.
Nous planifions généralement 2 mois de Préparation, qui comprennent les phases de :
- Présentation du process et revue de la documentation API
- Data Mapping & Gap Analysis
- Transcodification
S'en suivent 1 à 2 mois de développement de la connexion API, puis d’au moins un mois de tests :
- Définition de l’approche de test
- Préparation des systèmes et des applications
- Tests unitaires
- Tests système
Après toutes ces étapes, nous passons enfin en production !
Une matrice RACI, qui clarifie les rôles et responsabilités, ainsi qu'une feuille de route plus détaillée, peuvent être fournies pour plus de précisions.
Revue de la Documentation API
Cette étape consiste à examiner ensemble la documentation API pour vous permettre de vous y familiariser et d’effectuer vos tests en toute autonomie.
Nous l’avons conçue pour que vous puissiez gérer vos importations et récupérations de données sans assistance.
Data Mapping & Transcodification
La Transcodification est le processus de conversion ou d’adaptation d’un système (juridique, linguistique ou technique) en une autre forme tout en préservant son sens.
L'étape de Data Mapping consiste à vérifier que vous détenez les informations nécessaires à la réalisation d'une étude Fairly Made : données fournisseurs, composants, produits et éventuellement emballages (généralement dans votre PLM et/ou ERP).
Nous identifions ensuite si des informations sont manquantes, où les trouver, comment transformer vos informations pour qu’elles respectent les règles de notre modèle de données, etc.
L'étape de Transcodification vient ensuite faire correspondre vos taxonomies, vos nomenclatures et celles attendues par notre Data Model.
Si vous avez déjà effectué une collecte de vos données de manière traditionnelle (via notre tableur Brand Data Collection, "BDC".csv) avec l’un de nos Analystes, une grande partie de ce travail est déjà fait.
Les règles de formatage des données sont strictement identiques pour le tableur et pour l’API.
Environnements de Tests & Types de Requêtes
Nous avons 2 environnements distincts pour utiliser l’API, avec des Bearer Tokens séparés :
- L'environnement Sandbox est utilisé pour les tests et ne constitue pas un répliqué de la production. Il sera rempli avec les tests définis ensemble au préalable.
- Celui de Production est l’endroit où vous allez envoyer et obtenir vos données réelles.
Pour chaque environnement, vous pouvez accéder à vos données via app.sandbox et/ou app.fairlymade.
Nous avons seulement 2 types de requêtes possibles : POST et GET.
- Les requêtes POST sont utilisées pour envoyer des données provenant de votre ERP/PLM/Data Hub.
- Les requêtes GET sont utilisées pour extraire les données : les résultats de nos études vers votre ERP/PLM/PIM/Data Hub.
L’envoi de données est donc définitif, les mises à jour ne sont possibles qu’exceptionnellement.
Toute modification de produit nécessite des ajustements de la chaîne d'approvisionnement, ce qui modifie fondamentalement l'analyse. Cela affecterait la traçabilité, les évaluations environnementales et la distribution des impacts, augmentant la charge de travail des analystes et pouvant retarder les délais.
De la Phase de Tests à la Production
Nous sélectionnons généralement quelques produits test à utiliser dans notre environnement sandbox, car nous privilégions l’apprentissage par la pratique. Si besoin, nous pouvons fournir des jeux de tests pour éviter d’anticiper chaque cas.
C’est maintenant à votre équipe (ou à votre intégrateur) de développer la connexion, mettre en place les routines et stocker les résultats.
Tous les détails sur les données à envoyer et leur transmission sont disponibles ici et dans la documentation API.
Viendront ensuite les tests unitaires et la validation… et nous serons prêts pour votre première importation de collecte via API !
Nous restons bien entendu à votre disposition pendant cette période pour aider vos développeurs si besoin.
Si vous avez d'autres questions, suggestions ou besoins de clarification, veuillez envoyer un e-mail à guillaume.babule@fairlymade.com ou clotilde.bazin@fairlymade.com. Vous pouvez également prendre directement rendez-vous avec nous sur ce lien.