Article publié le · Mis à jour le · Par DAWAP, éditeur de CIAMA
Éviter de clôturer un catalogue incomplet
Votre ERP doit transmettre l’ensemble d’une gamme à CIAMA. Si le transfert s’interrompt, certains produits n’ont pas encore été reçus : faut-il les considérer comme supprimés de la source ? Sans un contrôle de fin d’import, vos équipes risquent de prendre une liste incomplète pour le catalogue attendu.
Nous complétons l’alimentation du catalogue présentée dans R002 avec les snapshots. L’intégration déclare un ensemble complet, transmet ses produits puis demande sa clôture. Le PIM CIAMA vérifie cet ensemble avant d’appliquer les effets de la réconciliation.
Ce que cela change au quotidien
- Distinguez une mise à jour ponctuelle d’un état complet de source.
- Contrôlez le nombre et l’intégrité des éléments reçus.
- Évitez de clôturer un ensemble encore incomplet ou en erreur.
Les fonctionnalités en détail
PIM · Catalogue
Déclarer l’ensemble attendu
PUT /api/pim/products/snapshots/{snapshotId} ouvre un snapshot avec un repère de synchronisation, un nombre attendu et une empreinte de contrôle. Les écritures produit concernées sont associées à cet ensemble.
Vérifier avant de clôturer
PATCH /api/pim/products/snapshots/{snapshotId}, avec l’état completed, demande la clôture. CIAMA vérifie que les traitements ne sont plus en attente, qu’aucun événement n’est en échec et que le nombre et l’empreinte correspondent au contrat attendu.
Comprendre l’effet des références absentes
Une clôture validée désactive les ressources actives absentes du snapshot dans le périmètre du compte, de la source et du type de ressource. Un snapshot n’est donc pas un simple lot partiel ni une sauvegarde : il représente un état complet déclaré.
Suivre les écritures pendant la reprise
GET /api/pim/products/receipts/{receiptId} permet de contrôler les écritures individuelles avant de clôturer. Ce protocole prolonge les identités externes et les reçus présentés dans les premières éditions. Les développeurs peuvent préparer son usage avec la documentation API CIAMA.
Reprendre un transfert catalogue interrompu
Une équipe catalogue prépare une reprise complète depuis son ERP. Le développeur ouvre un snapshot pour le périmètre convenu et transmet les produits. Une interruption laisse des traitements en attente : la clôture ne peut pas aboutir tant que les contrôles de traitement et d’intégrité ne sont pas satisfaits.
Après reprise des écritures et vérification de leurs reçus, l’intégration demande à nouveau la clôture. Les ressources actives absentes de cet état complet sont alors désactivées dans le périmètre du compte, de la source et du type de ressource. L’équipe vérifie donc le périmètre déclaré avant cette étape : un import limité à quelques produits doit rester une mise à jour partielle.
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.