Connecter un PIM : Akeneo, Pimcore, Salsify et Plytix
Alimentez les passeports avec les attributs de votre PIM : les réglages de chaque PIM pris en charge et le mappage des attributs vers les champs du passeport.
Équipe éditoriale DPP Shield · Mis à jour:
Partez du modèle de votre PIM dans Integration hub, connectez-le à l'API ou au flux de canal du PIM, mappez chaque attribut vers un champ produit ou un chemin de données du passeport, puis prévisualisez, appliquez et planifiez. Le PIM reste la source des attributs, et chaque champ du passeport indique l'exécution qui l'a écrit.
Pourquoi connecter le PIM
Un PIM contient généralement le contenu descriptif du passeport - matières, composition, entretien, dimensions, certifications - que l'ERP n'a pas. Mapper ces attributs vers les chemins du passeport aligne les passeports sur le catalogue que vos équipes tiennent déjà, sans ressaisie.
Akeneo
Modèle : Akeneo products (API REST). URL https://<your-pim>/api/rest/v1/products?limit=100, chemin _embedded.items, clé identifier, avec values.name.data, values.ean.data et values.description.data.
Créez une connexion dans Akeneo (Connect, Connection settings) pour obtenir un client ID, un secret, un utilisateur et un mot de passe, et choisissez OAuth 2.0 avec le grant password ; le point de jeton est /api/oauth/v1/token. Les codes d'attributs comme name, ean et description sont ceux de votre catalogue, et values.<code>.data lit la première valeur de locale et de canal. Une requête de flux lit une page de 100 produits au plus : poussez les exports plus volumineux vers le point d'entrée push du mappage.
Pimcore Datahub
Modèle : Pimcore Datahub (GraphQL). Le flux envoie la requête { getProductListing { edges { node { sku name ean } } } } à https://<your-pimcore>/pimcore-graphql-webservices/<endpoint> avec la clé API du Datahub dans l'en-tête X-API-Key ; chemin data.getProductListing.edges, clé node.sku.
Les noms de classes et de champs suivent votre modèle de données : modifiez ensemble la requête et les champs source, et testez le flux avant d'enregistrer.
Salsify
Modèle : Salsify product export (JSON), clé salsify:id, avec Product Name et GTIN. Les noms de propriétés sont ceux de votre organisation, et salsify:id est l'identifiant propre de Salsify : utilisez votre propriété SKU comme clé si c'est elle que portent vos produits. Importez l'export ou poussez-le vers le point d'entrée push.
Plytix
Modèle : Plytix product feed (CSV). Utilisez l'URL du flux du canal, sans authentification ; clé sku, avec label et gtin. Les attributs personnalisés arrivent en colonnes supplémentaires : mappez chacun vers un chemin de données du passeport.
Mapper les attributs vers les champs du passeport
Les champs du passeport sont des chemins de données - data.materials.0.name, data.textile.care_instructions, etc. ; l'aide de chaque champ de l'éditeur indique le sien. Mappez un attribut par règle, et utilisez une table de correspondance lorsque les vocabulaires diffèrent, par exemple 100% Coton=cotton ou Li-ion=lithium-ion.
Utilisez les transformations pour les nombres à virgule décimale ou dans une autre unité (un facteur de 0,001 convertit des grammes en kilogrammes), pour les attributs oui/non et pour les noms de pays à convertir en codes à deux lettres. Un mappage écrit une valeur par champ ; les traductions des textes du passeport se relisent dans Localization.
Mise en place
- Ouvrez Integration hub, choisissez New mapping et partez du modèle de votre PIM.
- Saisissez l'URL du flux et les identifiants, puis utilisez Test feed pour voir les premiers enregistrements.
- Ajoutez une règle pour chaque attribut qui a sa place dans le passeport.
- Lancez un aperçu, vérifiez quelques produits champ par champ, puis appliquez.
- Planifiez le flux toutes les heures ou chaque jour, ou faites pousser les exports par le PIM.