Guide des exigences pour l'envoi de données par l'API Fairly Made®

Tout ce qui concerne la gestion de projet autour de l’implémentation actuelle et comment nous pouvons vous aider se trouve ici et ici. Gardez à l’esprit que tout ce qui est lié à l’API se trouve sur sa page de documentation.

Ces 2 diapositives résument la plupart des informations dont vous avez besoin:

Quelques points clés à retenir 

• Authentification : vous avez besoin d’un Bearer token pour chaque environnement (Sandbox et Production) afin d’accéder à vos données produit. Pour l’obtenir, connectez-vous à la plateforme, allez dans My Account, puis dans l’onglet Token API, ou adressez-vous à votre référent IT.

• Propriétés de la Sandbox : par défaut, la Sandbox est vide et se remplit au fur et à mesure que vous effectuez vos tests. Elle sera nettoyée à votre demande avant de réaliser les prochains tests.
• Ordre de création : respectez toujours l'ordre de création des objets : SUPPLIER→ (éventuellement PACKAGING)→ PRODUCTS → COMPONENTS .
• Unicité des attributs :
  • Une étude Fairly Made est identifiée de manière unique par trois attributs : productRef, productCollectionRef et productColorCode.
  • Actuellement, un composant est considéré comme unique uniquement sur la base de son ComponentRef. Si le même composant est utilisé dans différentes catégories ou existe chez plusieurs fournisseurs, nous recommandons de concaténer d'autres champs au sein du ComponentRef pour garantir son unicité si nécessaire.
• Limitations :
  • Ne soumettez pas plus de 500 requêtes par seconde, notre infrastructure les bloquera et certaines informations pourraient ne pas passer.
  • Attendez 2 à 5 secondes entre la création de différents objets pour que les relations appropriées entre eux se mettent en place : ne pas envoyer un supplier, component, product dans le même lot. Envoyez d’abord tous les suppliers en une fois, attendez 4 secondes, envoyez tous les products en une fois, attendez 4 secondes, puis envoyez tous les components.
• BatchImport : respectez la nomenclature du BatchImport pour un stockage plus facile et pour éviter les problèmes. Exemple : NomMarque-Collection-NuméroDeVague-DateD'Envoi
• Historique d'erreurs : conservez les réponses d’erreur.
  
  

Exigences

Pour chaque famille de données, voici les exigences, les données nécessaires pour l'analyse (cf. la documentation) :

Suppliers

4 attributs de données requis et 8 champs optionnels :

• category
• supplierRef
• contact_email
• address_country

Packaging

L'envoi des données Packaging est optionnel, mais si vous souhaitez les transmettre, alors 9 attributs de données sont requis :

• packagingRef
• type
• channel (STORE / E-COMMERCE)
• percentageRecycled
• compostability
• ecoModulation
• possibilityReUse
• hazardousSubstances

Products

7 attributs de données requis et 10 champs optionnels :

• productRef
• productCollectionRef
• category
• supplierRef
• warehouseRef
• reachCompliance (réponse par défaut : “1”)
• ecoModulation
• productColorCode : optionnel mais sera rempli par “DEFAULT” s'il est vide, car c'est l'un des 3 attributs d'unicité d'une étude.
• weight : optionnel mais fortement recommandé, il contribuera au score.

Components

4 attributs de données requis et 13 champs optionnels :

• componentRef
• type
• category
• composition
• componentWeight : optionnel mais fortement recommandé, il contribuera au score.