Article publié le · Mis à jour le · Par DAWAP, éditeur de CIAMA
Comprendre pourquoi une commande manque
Votre ERP a envoyé une commande, mais votre équipe commerciale ne la retrouve pas dans CIAMA. Pour avancer, le développeur doit retrouver l’échange et déterminer si le traitement est terminé, en attente d’une référence ou en erreur.
Après le parcours des commandes, expéditions et stocks présenté dans R021, nous montrons comment suivre ces opérations. Journaux d’exécution et reçus API donnent aux équipes métier et techniques des repères pour examiner le même incident.
Ce que cela change au quotidien
- Retrouvez les exécutions par fonctionnalité et par statut.
- Suivez les écritures API avec leur reçu et leur code d’erreur.
- Préparez les reprises à partir de l’état réel du traitement.
Les fonctionnalités en détail
Core · Socle commun
Retrouver une exécution dans son contexte
Le journal d’exécution permet de rechercher et filtrer par mode, univers, statut et fonctionnalité dans le compte. Le détail relie une exécution à ses traitements enfants pour suivre le déroulement d’une opération.
API : suivre le résultat, pas seulement l’acceptation
GET /api/pim/products/receipts/{receiptId} et GET /api/b2b/orders/receipts/{receiptId} donnent accès aux reçus dans le périmètre de la source authentifiée. Ils exposent notamment l’état du traitement, la référence externe et un code d’erreur lorsqu’il existe.
Votre intégration peut conserver ce reçu avec la référence de l’opération. Une réponse initiale 202 Accepted reste une étape du parcours ; le reçu permet d’en suivre l’issue.
Préparer des reprises ciblées
Le dispositif d’exploitation comprend une remise en file des événements d’intégration restés en attente, selon un âge minimal et une limite de traitement. Les clés d’idempotence et les révisions source encadrent les écritures : elles doivent être conservées et utilisées selon le contrat, pas remplacées au hasard lors d’un nouvel essai.
Ce socle ne signifie pas que toute erreur se corrige automatiquement. Il donne aux équipes les repères nécessaires pour diagnostiquer, corriger la cause et contrôler le résultat. La documentation API CIAMA et la présentation des connexions au système d’information prolongent ce parcours.
Diagnostiquer une dépendance produit manquante
Une commerciale signale une commande B2B absente du cockpit et transmet sa référence à l’équipe technique. Le développeur retrouve le reçu conservé lors de l’envoi : la commande attend encore un produit référencé dans ses lignes.
Il contrôle d’abord l’écriture du produit et son propre reçu, puis suit la reprise de la commande selon la procédure du flux. L’équipe vérifie le résultat appliqué avant de clôturer l’incident. Elle dispose ainsi d’un diagnostic précis, sans renvoyer toutes les commandes ni changer arbitrairement leurs identifiants.
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.