Une opportunité passe à « gagnée » dans Oracle CX Sales. Le support reçoit ensuite deux questions. La bonne filiale a-t-elle été retenue pour facturer la vente ? Une commande existe-t-elle déjà dans la gestion après le délai dépassé du connecteur ?
Le risque est de prendre le statut CRM pour une confirmation ERP. Pour suivre la vente, gardez le lien entre le compte, le devis accepté, l’opération de transfert et le document retourné par la gestion. Le rapprochement doit pouvoir expliquer chacun de ces choix après une coupure.
Pour préparer l’intégration Oracle CX Sales, partez d’une vente existante. Vérifiez les ressources REST de l’instance, l’identité du client et les conditions qui autorisent une écriture. Vous pourrez alors tester une reprise sur les mêmes références.
Pour qui cadrer le flux Oracle CX Sales et ERP
Le commerce décide de la qualification, du responsable et de la progression de l’opportunité. La gestion confirme par exemple le client de facturation et les conditions appliquées à la commande. Le marketing peut renseigner la campagne d’origine ou le canal d’acquisition selon les champs qui lui sont réservés.
Réunissez les responsables de ces trois étapes lorsqu’un même compte groupe couvre plusieurs filiales. Un responsable commercial peut rattacher une opportunité au groupe pour son suivi. Si la facturation doit partir à une filiale précise, alors la gestion confirme cette identité pour le transfert.
Vérifiez les logiciels installés. Oracle Fusion Cloud Sales, Oracle CPQ et Oracle Fusion Cloud Order Management ont chacun leurs propres opérations. Un dossier peut aussi être exécuté dans un ERP tiers. Dans ce cas, la disponibilité de la recherche et de l’écriture se vérifie sur cette cible.
Rapprocher les comptes, contacts et opportunités
Dans le catalogue REST de Fusion Cloud Customer Experience, la lecture d’un compte ou d’un contact prend un PartyNumber dans son chemin. La lecture d’une opportunité par son numéro prend un OptyNumber. Oracle expose aussi OptyId dans la ressource d’opportunité. Conservez séparément l’identifiant interne et la référence utilisée par l’opération choisie. Compte, contact et opportunité.
Pour le compte, la ressource enfant SourceSystemReference expose notamment le système source et la valeur de référence. Contrôlez les deux pour retrouver la fiche. Par exemple, la référence 004471 issue d’ERP-FR peut désigner un autre tiers que 004471 issue d’ERP-BE. Références de systèmes sources pour les comptes.
Vérifier une référence avant la première écriture
Pour un lead web, relevez d’abord son identifiant dans le système d’origine. Le domaine ou le courriel peuvent fournir des candidats, puis la correspondance validée et le contexte commercial déterminent le compte à utiliser. Si plusieurs filiales sont plausibles, gardez le lead en attente et demandez un arbitrage.
Pour lire l’opportunité fictive CX-804, voici le chemin à appeler sur l’origine autorisée du tenant. Vérifiez le périmètre du compte technique et les champs réellement retournés sur votre instance. Utilisez la référence du CRM pour la lecture et conservez la référence ERP à part.
GET /crmRestApi/resources/11.13.18.05/opportunities/CX-804
Accept: application/json
Conservez par exemple le couple OptyNumber et OptyId avec l’origine du tenant. En migration, les identifiants peuvent changer. Faites correspondre les références historiques à celles du nouveau tenant avant d’activer un flux d’écriture. Si le dossier reste visible à deux endroits, notez où les modifications commerciales sont autorisées et à partir de quelle date.
Distinguer l’opportunité, le devis et la commande
L’opportunité porte l’état de la vente et son estimation. Le devis accepté donne les lignes, quantités et conditions qui engagent le client. La gestion attribue ensuite la référence de la commande qu’elle prend en charge. Si Oracle CPQ est utilisé, vérifiez avec le commerce comment l’intégration identifie le devis retenu et sa version. Parcours de devis Oracle CPQ.
Dans le cas fictif CX-804, l’opportunité vaut 42 000 € HT dans le prévisionnel. Le client approuve la révision 2 du devis Q-62. Après une remise de 2 500 € sur cette base, le montant net attendu est de 39 500 € HT. Gardez l’estimation avec son origine et comparez le montant de la commande aux lignes du devis approuvé.
Si une nouvelle révision est approuvée après l’envoi, alors la gestion décide de la suite en fonction de l’état de la commande. Le flux peut préparer une modification, ou demander un arbitrage si la préparation a déjà commencé. La nouvelle révision garde son identité dans le journal et pointe vers la demande initiale.
Quand une vente est répartie sur deux livraisons, elle peut conduire à deux opérations de transfert selon les règles de gestion. Attribuez à chaque opération une référence stable. Le tableau du CRM peut afficher deux commandes sous la même opportunité et indiquer laquelle reste en attente. Le support sait ainsi quelle opération rechercher après une coupure.
Retrouver une commande dans Oracle Order Management
Pour une cible Oracle Fusion Cloud Order Management, le catalogue REST documente une lecture par clé formée du système de commande source et de l’identifiant de transaction source. Cette combinaison se configure avec l’équipe qui administre la cible. Vérifiez le comportement de l’instance pour une commande en cours de traitement et pour une commande déjà révisée. Lire une commande dans Oracle Order Management.
Relire après une réponse perdue
Paradoxalement, une commande urgente peut demander de suspendre le retry. Si l’appel expire après l’envoi du dossier, l’écriture a peut-être été reçue par Oracle. Dans ce cas, cherchez la référence de transaction attendue et comparez le tiers, la devise et les lignes avant de marquer la vente comme transmise.
Une recherche qui ne trouve rien peut refléter un traitement encore en cours ou des droits insuffisants. Si l’écriture reste incertaine, conservez le dossier à vérifier et suivez la procédure convenue avec la gestion. L’idempotence dépend du mécanisme de déduplication ou de recherche réellement disponible sur la cible.
Dans l’exemple, CXFR est le système source configuré et Q62-R2-FR l’identifiant de transaction attribué au premier envoi. Le chemin ci-dessous illustre la lecture de cette combinaison. Les deux valeurs sont fictives. Sur la cible réelle, confirmez la règle qui lie la clé de lecture à l’identifiant fourni lors de la création.
GET /fscmRestApi/resources/11.13.18.05/salesOrdersForOrderHub/CXFR:Q62-R2-FR
Accept: application/json
Configurer les accès et les traces de reprise
Définissez un accès technique par environnement. Testez une lecture d’opportunité avec son compte lié, puis un objet hors périmètre. Si l’API utilise OAuth, vérifiez l’émetteur du token, les paramètres d’authentification et les droits de la ressource. Conservez le statut, le chemin logique et la corrélation dans les traces.
À l’entrée de la file, capturez le numéro du dossier, l’opération, la version du contrat et la référence source. En sortie, la journalisation doit permettre de retrouver le mapping utilisé, la décision métier et la référence de commande. Le runbook indique qui peut confirmer un tiers, corriger une ligne ou autoriser la reprise.
Sur une lecture de collection, vérifiez la pagination avec limit, offset et le signal hasMore du contrat Oracle. Pour une réconciliation par lots, définissez un ordre et testez le comportement si les opportunités changent pendant la lecture. La synchronisation doit pouvoir reprendre au dernier lot confirmé ou refaire un rapprochement borné. Contrat de la collection d’opportunités.
Pour chaque opération d’écriture, gardez un exemple de payload de recette, un rejet attendu et la réponse qui confirme l’effet métier. Si le connecteur reçoit un accusé avant la fin du traitement, laissez l’état « en attente de confirmation ». Les équipes peuvent comparer ce statut à la dernière réponse de la cible et savoir si le document est consultable.
Décider quoi faire sur quatre événements
| Événement | Décision attendue |
|---|---|
| Le lead propose deux filiales | Conserver les deux candidats et faire confirmer le client de facturation. |
| Le client approuve Q-62, révision 2 | Conserver le montant net de 39 500 € HT et préparer le transfert. |
| La réponse ERP se perd | Rechercher la transaction source et rapprocher le document avant de reprendre. |
| Un ancien export change le responsable | Conserver le responsable validé dans le CRM et tracer le conflit. |
Pour le support, la sortie doit préciser le résultat de chacun de ces événements. Si le document ERP est retrouvé et qu’il concorde, rattachez sa référence à l’opportunité. S’il diffère, joignez l’écart à la demande de vérification. La personne qui tranche doit pouvoir lire l’état de la vente depuis le CRM.
Pour comparer les montants, utilisez la même devise et la même base de calcul. Dans CX-804, la référence est le montant net hors taxes de Q-62. Faites remonter au support le total du devis, le total de la commande et la ligne qui explique l’écart. Un frais ajouté ou un arrondi en gestion suit la validation prévue avec la finance.
Plan d’action pour le premier flux
- Commencer avec une vente existante. Vérifier le compte, les références source, le devis et la commande dans chaque système.
- Documenter le parcours de création avec les droits, les champs requis et les responsabilités par étape.
- Tester le doublon de lead, l’événement ancien et la perte de réponse, puis contrôler la décision visible par le support.
- Ouvrir le périmètre suivant après une reprise réussie et un rapprochement des documents attendus.
Le premier tableau de suivi peut afficher l’âge de la plus ancienne demande à vérifier, les ventes approuvées qui attendent un client et les documents ERP encore sans rapprochement. Définissez le seuil d’intervention selon le délai de prise en charge que les équipes se sont engagé à tenir.
Erreurs fréquentes sur Oracle CX Sales
- Utiliser une référence ERP dans le chemin de l’opportunité. Identifier le champ que l’endpoint attend et vérifier le lien avec la cible.
- Réouvrir une création sur un délai dépassé. Vérifier d’abord la transaction et son état dans la gestion.
- Écraser le prévisionnel avec le premier prix retourné. Rapprocher le prix des lignes et de la version approuvée.
Approfondir le SDK et le transfert de commande
Le SDK Oracle CX Sales sous Symfony détaille la configuration des appels, des accès et du traitement des erreurs.
Le passage d’une opportunité Oracle CX Sales à une commande approfondit le devis retenu et la reprise après un envoi incertain.
Conclusion sur le premier dossier à intégrer
Suivez une opportunité connue jusqu’au document de gestion. Relevez le client, le devis et sa version, puis vérifiez le montant et la référence de commande.
Rejouez ensuite le cas avec une réponse manquante. Le support doit retrouver la dernière décision et expliquer le résultat à l’équipe commerciale.
L’accompagnement Oracle CX Sales permet de cadrer ce parcours et de recetter ensemble les interfaces CRM et ERP, le transfert et la reprise.