Article publié le · Mis à jour le · Par DAWAP, éditeur de CIAMA
Retrouver un produit dans une gamme qui grandit
Une référence commerciale ne suffit pas toujours à retrouver le bon produit. Quand les gammes s’élargissent, vos équipes ont besoin d’un catalogue organisé pour identifier les articles, comprendre leur classement et accéder à leurs informations.
Après le socle commun présenté dans R001, cette édition est consacrée au référentiel produit. Nous réunissons la recherche, les fiches produits et les axes de classement dans le PIM CIAMA. Votre catalogue devient un point de départ partagé pour lire votre activité.
Ce que cela change au quotidien
- Retrouvez les produits de votre compte depuis une recherche commune.
- Organisez vos gammes avec les marques, catégories et tags.
- Partagez les mêmes repères produit entre vos équipes.
Les fonctionnalités en détail
PIM · Catalogue
Retrouver les références de votre compte
La recherche produit donne accès au catalogue de votre entreprise. Vous pouvez combiner la recherche avec des filtres de marque, catégorie ou tag pour cibler une gamme et ouvrir la fiche du produit recherché.
Des marques et catégories pour structurer vos gammes
Nous distinguons les marques des catégories : la marque identifie une gamme commerciale, tandis que les catégories et leurs parents organisent le classement du catalogue. Vous disposez de plusieurs points d’entrée pour parcourir vos références.
Des tags pour croiser les lectures
Un produit peut être associé à plusieurs tags. Ces regroupements complètent la marque et la catégorie pour retrouver un ensemble de produits selon l’organisation choisie par votre entreprise.
Une fiche produit comme point de repère
Depuis la recherche, vous accédez au détail du produit. Le PIM pose ainsi une identité commune sur laquelle les autres modules peuvent s’appuyer. Cette édition présente le référentiel et son alimentation par API ; les traitements de qualité feront l’objet d’une édition dédiée.
Alimenter le catalogue depuis votre ERP par API
Votre système source peut transmettre les produits, marques, catégories et tags à CIAMA par API REST. Les identifiants externes permettent de retrouver les ressources dans le contexte du compte et du client technique qui les alimente. Un produit peut ainsi référencer sa marque, sa catégorie et ses tags sans ressaisir leur classement dans chaque outil.
PUT /api/pim/products/by-external-id/{externalId}: créer ou remplacer la représentation complète d’un produit depuis votre système source.GET /api/pim/products/by-external-id/{externalId}: retrouver la liaison de cette source et la dernière représentation appliquée.GET /api/pim/products/receipts/{receiptId}: consulter l’état du traitement d’une écriture acceptée.
L’écriture exige le droit catalog.write et les métadonnées de synchronisation attendues. La réponse 202 Accepted confirme l’acceptation pour un traitement asynchrone ; le reçu permet d’en suivre le résultat. Les stocks passent par leurs propres ressources : ils ne sont pas écrits dans la fiche produit.
Par exemple, votre ERP transmet d’abord une marque et une catégorie, puis un produit qui les référence. Votre intégration suit le reçu avant de considérer la mise à jour comme appliquée. Retrouvez les familles de ressources et le fonctionnement des échanges dans la documentation de l’API REST CIAMA.
Préparer une revue de catalogue
Vous distribuez plusieurs marques d’accessoires et préparez une revue de gamme. Votre équipe sélectionne une marque, affine la recherche par catégorie et retrouve les produits concernés. Les tags permettent de repérer un regroupement transversal sans modifier leur classement principal.
Un collègue ouvre ensuite la fiche du même produit pour consulter ses informations. Vous échangez à partir de la même référence et du même classement, sans reconstruire une liste différente pour chaque équipe.
Cette édition retrace l’évolution de CIAMA. Le mois constitue un repère éditorial dans l’histoire du produit, et non une date de mise en production.