Intégration API

Intégrer SAP Sales Cloud Version 2 à un ERP

Jérémy Chomel Dawap
  • Publié le : 27 septembre 2024
  • Mis à jour le : 12 novembre 2026
  • Temps de lecture : 12 minutes
  1. Attribuer les comptes, les prix et les statuts
  2. Identifier la version et les API du tenant
  3. Choisir le scénario S/4HANA ou SAP ERP
  4. Rapprocher le compte et les référentiels
  5. Décider quand créer la commande ERP
  6. Configurer et tester les droits techniques
  7. Reprendre après un délai dépassé
  8. Donner au support une preuve par dossier
  9. Préparer le flux avant la première écriture
  10. Plan d’action pour valider le pilote
  11. Erreurs fréquentes entre le CRM et l’ERP
  12. Approfondir le SDK et le rapprochement client
  13. Conclusion sur le premier dossier à intégrer
Portrait de Jérémy Chomel

Une opportunité vient de passer à « gagnée » dans SAP Sales Cloud. Avant de créer une commande, l’ERP doit reconnaître le client de facturation, le prix accepté et la version du devis. Si la réponse de l’ERP se perd, le commercial doit pouvoir retrouver le document créé et suivre son traitement.

Le risque est de confirmer une vente alors que la commande correspond à un brouillon ou à un mauvais payeur. Pour éviter cette correction manuelle, il faut pouvoir expliquer quelle décision a déclenché l’écriture, quels champs l’ERP a confirmés et comment retrouver le résultat après une coupure.

Pour SAP Sales Cloud Version 2, commencez par identifier les interfaces du tenant, puis suivez une opportunité jusqu’à la gestion. L’intégration SAP Sales Cloud peut partir d’un seul circuit de vente, avec un client ERP déjà connu et un devis dont la version est approuvée.

Attribuer les comptes, les prix et les statuts

Définissez les écritures champ par champ avec le commerce et la finance. Le commercial peut corriger le contact et la date de signature dans le CRM. L’ERP reste par exemple responsable du compte de facturation, des conditions de paiement et du statut de la commande. Une adresse corrigée pour un rendez-vous doit rester sur la fiche commerciale si le métier utilise une adresse de facturation distincte.

Dans un premier circuit, Sales Cloud porte l’opportunité, le propriétaire et la référence du devis approuvé. L’ERP confirme les conditions qu’il applique et le numéro de commande. La campagne d’origine peut être conservée pour l’attribution marketing si le reporting l’exige. Une correction de cette campagne laisse la commande à son étape courante.

Distinguer le prix simulé du prix accepté

Décidez à quelle étape un prix peut être recalculé. Le commercial peut consulter une simulation avant l’envoi du devis. Si le client a déjà accepté une version, le flux conserve la devise, le prix net, la quantité et la remise de cette version. Une différence dans le prix retourné par l’ERP appelle une validation avant de confirmer la commande au client.

Si le montant total paraît identique, comparez quand même les lignes. Deux remises peuvent s’annuler sur le total tout en déplaçant la marge d’un produit à l’autre. Dans ce cas, vérifiez avec la finance quelle différence peut être acceptée, par exemple un arrondi à l’échelle de la ligne dans la devise du devis, puis rendez cette règle visible dans la décision.

Identifier la version et les API du tenant

Relevez le produit exact dans l’administration et identifiez l’origine appelée par les interfaces existantes. SAP publie une référence OData V2 pour SAP Cloud for Customer. Pour Sales Cloud Version 2, partez du service publié pour l’objet concerné et de la configuration de communication de l’environnement. Les règles SAP pour les services personnalisés décrivent notamment REST JSON et OData V4. Leur portée concerne les services personnalisés. Vérifiez à part l’interface standard sélectionnée pour chaque opération.

Pour chaque opération, notez le nom du service, l’objet, la méthode, le type d’authentification, les champs attendus et le format de retour. Une lecture de compte qui fonctionne prouve les droits de lecture sur ce compte. Testez séparément la mise à jour d’une opportunité et la lecture du document ERP retourné.

Vérifier les écarts avant une migration depuis C4C

Prenez un compte, une opportunité et un devis représentatifs. Comparez les identifiants techniques, les références affichées, les codes de statut et la manière dont le service retourne les relations. Rejouez ensuite l’appel qui échouait le plus souvent dans l’ancien flux. Un statut personnalisé ou un type de document absent du tenant cible doit produire une erreur explicite dès la recette.

Versionnez le contrat de chaque appel avec l’URL du service, un exemple de payload fictif et le résultat d’un refus. Si le nouvel endpoint renvoie une relation sous une forme différente, adaptez le mapping puis testez les cas où la relation est absente. Faites valider le résultat visible dans le CRM par l’équipe qui utilisera l’information.

Choisir le scénario S/4HANA ou SAP ERP

SAP documente le parcours opportunité vers commande avec S/4HANA Cloud Public Edition. La procédure de création d’un devis dans SAP ERP depuis une opportunité décrit un autre scénario et ses prérequis, dont les correspondances de codes et la configuration des services ERP. Relevez l’édition, le mode d’hébergement et les interfaces actives avant de chiffrer le flux.

Si le scénario SAP couvre le parcours attendu, faites circuler un dossier de bout en bout avec la configuration prévue. Si une règle supplémentaire concerne la qualification ou un ERP tiers, placez-la à l’étape qui en a besoin. Une règle de finance qui bloque une commande peut être évaluée juste avant la demande de création, avec le motif restitué dans le dossier CRM.

Rapprocher le compte et les référentiels

Dans External ID Mapping, SAP permet à un administrateur de rechercher la correspondance d’une donnée de référence pour un système de communication donné. Conservez cette origine dans vos traces. Le numéro 4711 peut désigner deux entreprises si deux ERP émettent chacun leurs propres numéros.

Vérifiez le rôle du partenaire et le contexte de vente avant le transfert. Un compte commercial peut correspondre à un donneur d’ordre, avec un autre destinataire de livraison et un autre payeur. Si la correspondance du payeur manque, mettez le dossier en attente avec le rôle manquant. L’équipe qui gère les tiers peut établir le lien, puis reprendre le même dossier.

Faites le même contrôle pour les codes de devise, d’unité, d’organisation commerciale et de type de document. Si le code de l’unité est reconnu mais que le conditionnement est différent, bloquez la ligne avant que l’ERP interprète une boîte comme une pièce. Conservez le code d’origine et le résultat de la conversion pour faciliter la correction.

Décider quand créer la commande ERP

Dans cet exemple fictif, le client accepte la révision 3 du devis Q-781, lié à l’opportunité O-214. Elle contient 4 unités à 250 € HT, avec 10 % de remise sur la ligne. La révision 4 porte la quantité à 5. Les deux peuvent circuler dans le CRM. Seule la révision approuvée autorise la création dans ce scénario.

Résultat attendu pour le dossier fictif O-214
ÉvénementContrôleRésultat attendu
Révision 3 approuvée4 × 250 € avec 10 % de remise900 € HT et référence Q-781/3 enregistrés pour le transfert.
Révision 4 au brouillon5 × 250 € avec 10 % de remise1 125 € HT en simulation. La demande de commande garde 900 € HT.
Réponse ERP perdueRecherche de la référence de l’opération dans le périmètre ERPSi la commande est retrouvée et concorde, rattacher son numéro au dossier CRM.
Retour ancien reçu après confirmationComparer la révision et le statut déjà confirmésConserver le numéro ERP et tracer le retour écarté.

Conservez dans le journal la clé métier de l’opération, composée ici du système cible, du devis, de la révision et de l’action demandée. Une clé de journal aide à retrouver la tentative. Elle empêche les doublons seulement si le flux fait respecter son unicité et si l’ERP permet de reconnaître l’écriture correspondante.

Si la révision 4 est approuvée après la création ERP, alors la prochaine action dépend du statut de la commande. Sur une commande encore modifiable, faites contrôler la modification par la gestion. Si la préparation a commencé, soumettez une demande de modification ou d’annulation dans le circuit prévu pour ce statut.

Configurer et tester les droits techniques

Créez l’accès de communication pour les services nécessaires et testez-le dans le tenant prévu. Vérifiez aussi une opération qui doit rester refusée, comme la suppression d’un compte lorsque le flux se limite à la lecture. Les règles d’accès des commerciaux et celles du connecteur peuvent évoluer à des rythmes différents.

Faites tourner le secret ou le certificat en préproduction, selon l’authentification du scénario. Le journal conserve le nom du système de communication, la date, la référence de la demande et le type d’erreur. Stockez les identifiants techniques dans le gestionnaire de secrets. Le support peut diagnostiquer un refus en comparant la portée, le service et le tenant, sans copier de jeton dans un ticket.

Quand l’interface utilise OAuth, identifiez séparément un échec d’obtention du token et un refus émis par le service métier. Le premier concerne la configuration d’authentification ou sa disponibilité. Le second peut se produire avec un jeton valide si le service ou l’opération manque dans les droits du connecteur.

Reprendre après un délai dépassé

Après un délai dépassé sur une création, le résultat reste à établir. Enregistrez cet état et recherchez la référence métier dans l’ERP avant de soumettre une autre création. Si un document correspond, comparez le client, la révision et le montant puis rattachez-le au CRM. Si plusieurs documents apparaissent, laissez le dossier en attente d’arbitrage.

Une recherche vide peut précéder l’indexation du document. Rejouez automatiquement la création seulement quand l’interface cible garantit l’unicité pour cette opération, ou quand le processus ERP permet d’établir que la tentative précédente a échoué. Sinon, le support doit examiner la trace de traitement avant de relancer. Gardez la demande d’origine et sa version disponibles pour cette décision.

Paradoxalement, le dossier le plus urgent peut exiger de suspendre le retry. Si l’ERP a peut-être créé la commande, la priorité devient d’en établir l’existence. L’exploitation peut alors rechercher la référence dans le journal des échanges ou faire consulter le document directement dans la gestion avant d’autoriser une nouvelle écriture.

Suspendre les écritures en conservant les demandes

Si une mauvaise correspondance commence à se propager, suspendez les créations concernées. Préservez les demandes reçues, isolez celles déjà envoyées et retrouvez leurs documents ERP. La finance décide ensuite des corrections, selon l’état de chaque commande. Relisez les demandes encore en attente avec la version du mapping corrigée avant de les libérer.

Pour les messages qui attendent déjà dans la file, distinguez ceux dont l’envoi est confirmé de ceux dont l’état est incertain. Chaque demande incertaine garde le même identifiant pendant le rapprochement. Dans ce cas, une restauration du connecteur remet le traitement en service, tandis que la correction des commandes suit le circuit validé par la finance.

Donner au support une preuve par dossier

Sur O-214, le support doit retrouver dans le même dossier le compte CRM, le payeur ERP, Q-781/3, les 900 € HT, le statut de transmission et le numéro de commande dès sa confirmation. À défaut, l’état indique la prochaine action et le responsable attendu. Une demande envoyée peut ainsi rester « résultat à vérifier » jusqu’à la lecture du document cible.

Mesurez l’âge de la plus ancienne demande à vérifier, les devis approuvés encore sans document cible et les dossiers stoppés faute de correspondance. Choisissez les délais d’alerte selon les heures de traitement convenues avec la gestion. Un dossier bloqué juste avant la préparation d’une livraison mérite un circuit plus court qu’un enrichissement de compte.

Préparer le flux avant la première écriture

Faites d’abord tourner la décision en lecture seule sur des dossiers représentatifs. Comparez le client, les rôles partenaires, la devise, la révision du devis et l’action calculée avec la décision de la gestion. Consignez chaque écart et attribuez sa résolution à la personne qui connaît la règle.

À l’entrée, si la synchronisation est déclenchée par webhook, enregistrez la demande et son identifiant métier dans la file avant l’appel réseau. Le contrat conserve l’origine du dossier, la version du mapping et la référence cible connue. Un import par lot applique les mêmes contrôles à chaque ligne, afin que la reprise d’une seule ligne ne répète pas les créations déjà confirmées.

À la sortie, la journalisation porte le résultat d’idempotence et la référence du document ERP, ou l’état « résultat à vérifier ». Le runbook indique qui peut relire le document et autoriser un retry. Si l’ERP expose un retour par lot, conservez le détail par demande pour distinguer les écritures acceptées des rejets à corriger.

Plan d’action pour valider le pilote

  1. Le commerce confirme les transitions et les versions du devis qui autorisent le transfert.
  2. La finance valide les rôles partenaires, les montants et le rapprochement avec le document ERP.
  3. L’exploitation simule la perte de réponse, une demande dupliquée et un accès révoqué. Elle vérifie que les dossiers restent compréhensibles et que la reprise conserve leur historique.
  4. L’équipe élargit ensuite le flux au prochain scénario couvert par les mêmes règles, ou ouvre une recette spécifique si le type de document ou l’ERP diffère.

Prenez aussi un cas où une recherche ERP répond avec le bon nom et le mauvais identifiant de facturation. La sortie attendue indique le compte candidat et le motif du rejet, puis envoie le dossier à la personne responsable des tiers. Une fois l’association corrigée, refaites passer le dossier avec la même référence métier et vérifiez que la commande correspond au payeur attendu.

Erreurs fréquentes entre le CRM et l’ERP

  • Le devis vise le bon compte CRM, avec le mauvais payeur ERP. Relire le rôle partenaire et la correspondance pour l’organisation de vente.
  • La commande apparaît deux fois après une coupure. Vérifier si la deuxième tentative a été envoyée avant la recherche de la première, puis faire arbitrer les documents par la finance.
  • Le montant du CRM change après l’approbation. Identifier la révision et la date du calcul retourné avant de changer la valeur visible par le commercial.

Approfondir le SDK et le rapprochement client

Le SDK Symfony pour SAP Sales Cloud approfondit le transport lorsque le connecteur doit classer les réponses et relire son journal après une coupure.

Le rapprochement des comptes SAP Sales Cloud et ERP détaille les décisions à prendre lorsque plusieurs clients sont plausibles avant le transfert.

Conclusion sur le premier dossier à intégrer

Partez d’un devis approuvé dont la gestion connaît le payeur, le montant attendu et le type de commande. Faites-le circuler une première fois, coupez la réponse ERP pendant la recette et vérifiez que le support retrouve le même document.

Avant d’élargir le périmètre, reproduisez ce résultat pour un dossier mis en attente, puis corrigé par la gestion. Vérifiez que la correction et la commande finale restent attachées à l’opportunité que le commercial a traitée.

L’accompagnement à l’intégration SAP Sales Cloud commence par cadrer ces deux parcours avec votre équipe CRM, votre équipe ERP et le support qui prendra les reprises en charge.

Portrait de Jérémy Chomel

Transformez ce besoin en flux API fiable.

Dawap clarifie les systèmes concernés, les risques, le premier lot livrable et les conditions d’exploitation avant de construire le flux.

Vous préférez échanger ? Planifier un rendez-vous

Articles recommandés

SDK SAP Sales Cloud sous Symfony et lecture OData C4C Intégration API SDK SAP Sales Cloud sous Symfony et lecture OData C4C Lire l'article
  • 19 novembre 2024
  • Lecture ~12 min

Lisez un échantillon d’opportunités C4C avec Symfony HttpClient. Repérez une continuation OData, un format inattendu ou un refus d’accès avant de modifier le flux. Si vous migrez vers Sales Cloud Version 2, comparez les services et la structure des résultats sur une opportunité que le support connaît.

SAP Sales Cloud : retrouver le bon client ERP avant de transmettre la vente Intégration API SAP Sales Cloud : retrouver le bon client ERP avant de transmettre la vente Lire l'article
  • 15 avril 2026
  • Lecture ~11 min

Le client passe commande, sa filiale reçoit la facture et le siège la règle. Retrouvez dans l’ERP les références attendues pour chaque rôle dans SAP Sales Cloud. Un dossier fictif montre quoi contrôler avant l’envoi, qui solliciter quand le payeur manque et comment reprendre après correction du référentiel.