Article publié le · Mis à jour le · Par DAWAP, éditeur de CIAMA
Retrouver le parcours d’une vente B2B dans CIAMA
Une commande professionnelle suit plusieurs étapes : le client et les articles doivent être reconnus, la vente enregistrée, puis l’expédition rattachée au bon dossier. Votre ERP connaît ces événements ; vos équipes ont besoin de les retrouver dans CIAMA avec les mêmes références.
Cette édition assemble les identités clients B2B et les échanges logistiques pour connecter vos opérations au système source. Chaque écriture garde son propre résultat de traitement.
Ce que cela change au quotidien
- Conservez les références de votre ERP dans les échanges B2B.
- Reliez chaque expédition à sa commande et à ses produits.
- Vérifiez séparément les commandes, les expéditions et le stock appliqués.
Les fonctionnalités en détail
B2B
Transmettre les commandes dans le bon contexte
PUT /api/b2b/orders/by-external-id/{externalId} crée ou remplace une commande détenue par la source. Le client et les produits nécessaires doivent pouvoir être résolus ; une dépendance manquante peut laisser le traitement en attente.
Rattacher les expéditions à la commande
PUT /api/b2b/fulfillments/by-external-id/{externalId} transmet une expédition B2B avec ses références métier. Le traitement recherche la commande et les produits associés avant d’appliquer les données.
Les reçus propres à chaque ressource permettent de distinguer acceptation, attente et résultat. L’intégration utilise les droits B2B et les métadonnées de synchronisation ; elle ne transforme pas un simple appel reçu en opération terminée.
Les fonctionnalités en détail
Logistique
Alimenter le stock diffusable de Default
PUT /api/inventory/default-warehouse/stocks/by-product-external-id/{externalId} reçoit notamment quantity et calculatedAt. La quantité transmise représente le stock immédiatement diffusable ; rtlQuantity, lorsqu’il est fourni, reste une donnée de diagnostic.
Ce contrat porte sur l’entrepôt Default. Il ne doit pas être présenté comme une écriture générique sur tous les entrepôts externes ou 3PL. Le produit source, les droits stock et les reçus de traitement cadrent l’échange. Retrouvez le parcours d’intégration dans la documentation API CIAMA.
Suivre une commande de l’ERP à l’expédition
Un distributeur enregistre une vente professionnelle dans son ERP. Son intégration vérifie les références client et produit, transmet la commande à CIAMA puis consulte le reçu pour connaître son résultat.
Lorsque l’entrepôt confirme l’expédition dans le système source, l’intégration transmet celle-ci avec la référence de commande et les produits concernés. Elle met également à jour le stock diffusable de Default par le flux prévu à cet effet.
Le développeur contrôle ces trois traitements séparément. L’équipe commerciale peut ainsi examiner la commande et son expédition, tandis que la logistique suit le stock transmis. La diffusion vers les marketplaces constitue ensuite une étape distincte, portée par les connecteurs configurés.
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.