Un export BI consomme la capacité réservée aux ventes. Une opportunité gagnée attend sa transmission à l’ERP. Le support voit un appel expiré, mais ignore si la commande a été enregistrée. La reprise devient risquée dès qu’il faut choisir entre une vente bloquée et une double création.
En pratique, l’intégration Salesforce doit attribuer une autorité à chaque donnée, réserver la capacité aux flux prioritaires et conserver une preuve pour chaque écriture. Le canal dépend ensuite du délai dont le métier a besoin et du type de reprise que l’équipe peut exploiter.
Les choix ci-dessous couvrent la lecture, l’écriture et les événements, avec un exemple d’upsert et des scénarios de recette. Pour cadrer un projet sur vos systèmes et vos règles de gestion, retrouvez l’offre d’intégration Salesforce API.
Quand mobiliser un intégrateur Salesforce
Mobilisez l’administration Salesforce, le responsable du système cible et l’équipe d’intégration quand une même opération traverse plusieurs systèmes. Une opportunité gagnée qui déclenche une commande, par exemple, implique des droits Salesforce, une clé connue de l’ERP et une règle de reprise partagée.
Pour estimer le périmètre, rassemblez les objets et champs concernés, les volumes en pointe, le délai métier et trois cas d’échec. Une lecture ponctuelle pour la BI se cadre différemment d’une création de commande qui engage une livraison.
Pour qui industrialiser les flux Salesforce
Les équipes commerce, finance et DSI y gagnent lorsque les mêmes échanges reviennent chaque jour et que les reprises mobilisent plusieurs services. Commencez par un parcours dont le résultat est vérifiable, par exemple la transmission d’une opportunité approuvée et le retour du numéro de commande.
Limitez le pilote à un type d’opportunité, une entité juridique et un ERP. Si deux systèmes modifient le même champ sans règle de priorité, commencez en lecture et faites arbitrer la propriété de la donnée. Un cadrage Salesforce avec la DSI et les métiers permet de consigner ces responsabilités avant d’autoriser les écritures.
Vérifier les capacités de votre organisation
Avec le compte technique prévu pour l’intégration, listez les versions REST disponibles, puis utilisez Describe sur chaque objet retenu. Confirmez la lecture et l’écriture des champs de liaison, y compris les objets personnalisés. Testez ensuite une écriture contrôlée en sandbox pour exercer les règles de validation, Flows et déclencheurs en place. Référence Salesforce sur sObject Describe.
Pour chaque flux, notez la version, l’identité technique, le canal, les objets exposés et le résultat attendu côté cible. Gardez ce relevé avec la recette. Une règle peut changer après une installation de package, une actualisation de sandbox ou un changement de profil. Rejouez les tests d’accès avant de promouvoir une nouvelle configuration.
Tester un upsert Salesforce avec curl et Symfony
L’endpoint REST par identifiant externe crée un enregistrement quand la clé est absente et met à jour l’enregistrement correspondant quand elle est présente. Configurez ERP_Id__c comme External ID et Unique si la relation entre le compte Salesforce et le tiers ERP doit être unique. Un champ qui admet des doublons peut produire un statut HTTP 300 si plusieurs lignes correspondent. Référence Salesforce sur l’upsert REST.
Avec l’API 46.0 ou ultérieure, la création renvoie HTTP 201 et la mise à jour HTTP 200, avec l’identifiant et le champ created. Une version antérieure peut renvoyer 204 sans corps sur la mise à jour. L’exemple utilise une version maintenue à partir de 46.0, configurée sous la forme vXX.X. Le compte fictif ERP-42 sert à vérifier une création puis une mise à jour contrôlées. Exemples d’upsert Salesforce par version.
Observer la réponse brute avec curl
Renseignez l’URL d’instance issue de l’authentification, sans barre oblique finale, la version et un jeton de sandbox. Le bloc JSON ne contient que le nom illustratif du compte. La valeur du champ de correspondance vient de l’URL. Exécutez la commande avec une clé réservée à la recette et contrôlez le statut et l’identifiant renvoyés.
accountUrl="${SALESFORCE_INSTANCE_URL}/services/data/${SALESFORCE_API_VERSION}"
curl --silent --show-error --include --request PATCH \
"$accountUrl/sobjects/Account/ERP_Id__c/ERP-42" \
--header "Authorization: Bearer ${SALESFORCE_ACCESS_TOKEN}" \
--header 'Content-Type: application/json' \
--data '{"Name":"Compte exemple"}'
Lire l’identifiant retourné dans le client Symfony
Le client vérifie le statut et la présence d’une preuve exploitable. Les variables $instanceUrl, $apiVersion, $externalId et $accessToken viennent de la configuration et de l’opération en cours. Dans le service d’intégration, classez les erreurs avant de décider si l’opération peut être relancée. Un délai de réponse expiré remonte comme un résultat inconnu.
$url = sprintf(
'%s/services/data/%s/sobjects/Account/ERP_Id__c/%s',
rtrim($instanceUrl, '/'),
$apiVersion,
rawurlencode($externalId)
);
$response = $httpClient->request('PATCH', $url, [
'auth_bearer' => $accessToken,
'json' => ['Name' => $accountName],
]);
$status = $response->getStatusCode();
if (!in_array($status, [200, 201], true)) {
throw new RuntimeException("Upsert Salesforce en échec (HTTP $status).");
}
$result = $response->toArray();
if (($result['success'] ?? false) !== true || empty($result['id'])) {
throw new RuntimeException('Écriture Salesforce à rapprocher.');
}
$salesforceId = $result['id'];
En réalité, l’upsert protège l’identité de la fiche et peut encore déclencher plusieurs fois un Flow qui transmet des données à l’ERP. Pour une écriture répétée, vérifiez séparément le nombre de fiches, le nombre de déclenchements et le nombre d’effets métier. Ajoutez les réponses 300, les droits insuffisants et les refus de validation à la recette.
Attribuer l’autorité sur les données
Attribuez un responsable et une source par champ sensible. Salesforce peut faire foi pour la phase de l’opportunité. L’ERP décide du numéro de tiers, du statut de commande et du montant facturé. Si la finance révise une échéance, l’équipe commerciale voit la valeur actualisée et le système d’origine reste identifiable.
Écrire la règle avant le mapping
Pour le compte facturé, le mapping de sortie exige l’identifiant ERP, l’entité juridique et la version du contrat. Si l’identifiant manque, la file d’exceptions précise quel service doit le retrouver. Le support doit pouvoir expliquer l’attente avec ces références et le statut de la tentative.
La conversion d’un Lead est un bon test. Elle peut créer ou relier plusieurs objets Salesforce dans une transaction. Vérifiez que le compte d’arrivée possède la bonne relation ERP, même lorsque plusieurs Leads désignent le même client. Le cas des Leads convertis vers un même client ERP décrit le contrôle.
Choisir REST, Bulk, Pub/Sub ou GraphQL
Choisissez le canal d’après le résultat que le consommateur doit pouvoir vérifier. Une écriture commerciale attend un identifiant et une décision rapide. Un chargement de plusieurs milliers de comptes attend une preuve par ligne. Un consommateur d’événements doit pouvoir se repositionner après une coupure.
| Canal | Usage et contrôle |
|---|---|
| REST | Lire ou écrire une fiche. Conserver l’identifiant, le statut et la corrélation de la réponse. |
| Composite | Enchaîner des opérations Salesforce liées. Contrôler les résultats de chaque sous-requête et la règle d’annulation. |
| Bulk API 2.0 | Charger ou extraire un historique de façon asynchrone. Suivre le job et vérifier les résultats du périmètre demandé. |
| Pub/Sub API | Consommer CDC ou Platform Events. Enregistrer la position et prévoir le rattrapage si elle devient inutilisable. |
| GraphQL | Lire des objets liés avec les champs utiles. Vérifier le schéma, les objets pris en charge et les permissions pour les mutations. |
Vérifier les limites de Composite et de GraphQL
Dans une requête Composite, regardez le résultat de chaque sous-requête et les résultats par objet si vous utilisez une collection. Avec allOrNone, une erreur peut annuler une création Salesforce qui paraissait réussie dans un résultat intermédiaire. Le cas d’un compte annulé après un résultat Composite positif montre les indices à examiner. Référence Salesforce sur allOrNone.
GraphQL peut convenir à une lecture ciblée de comptes et contacts. Pour les écritures, les mutations Salesforce dépendent des objets pris en charge par UI API, de la version et des permissions. Validez ces trois éléments avant de prévoir le même canal pour la lecture et l’écriture. Schéma Salesforce des mutations GraphQL.
Configurer OAuth et les accès de l’application
Pour les nouvelles intégrations, Salesforce recommande External Client Apps. La création de Connected Apps est restreinte depuis Spring ’26, tandis que les applications déjà configurées restent utilisables. Inventoriez les clients existants et planifiez les migrations avec leur administrateur, en vérifiant les consommateurs de chaque application. Référence Salesforce sur les applications et OAuth.
Vérifier l’identité et la rotation en recette
En OAuth 2.0, consignez l’utilisateur au nom duquel les opérations sont exécutées. Vérifiez les droits à l’objet, au champ et à l’enregistrement avec cette identité. Séparez les configurations de sandbox et de production, stockez les secrets dans le coffre prévu par l’équipe et retirez les jetons des journaux.
Exercez une expiration de jeton, puis une révocation, avant la mise en service. Le flux doit reprendre après le renouvellement autorisé. Quand l’accès est retiré, le support doit identifier le client et la permission en cause avant de relancer le trafic.
Stabiliser le modèle Salesforce et les identifiants externes
Lead, Account, Contact, Opportunity et Case ont des cycles différents. Pour chaque objet transmis, choisissez une clé stable, documentez son périmètre et définissez ce qu’il faut faire lors d’une fusion, d’un changement d’entité ou d’un effacement explicite.
Si le même code ERP existe dans deux sociétés, incluez l’entité dans la relation de correspondance. Conservez également l’identifiant Salesforce et la provenance du code. Une adresse e-mail peut aider le support à retrouver une fiche, mais le rapprochement automatique d’un compte doit reposer sur une référence confirmée.
Encadrer la création et la mise à jour
Si le flux doit seulement enrichir des fiches connues, alors la création reste bloquée. Écrivez sur leur identifiant Salesforce ou vérifiez la disponibilité de updateOnly dans la version de la ressource d’upsert retenue. Les consommateurs doivent aussi distinguer un champ absent d’une valeur effacée.
Le SDK Salesforce sous Symfony prolonge cette séparation entre l’authentification, les ressources REST et le traitement des erreurs du client.
Relier Salesforce à l’ERP, au marketing, à la BI et à l’e-commerce
Transmettre à l’ERP une version autorisée
Le statut gagné déclenche la qualification du dossier. L’ERP reçoit le compte confirmé, la devise, les lignes et la version autorisée. Son acceptation produit une référence qui remonte au CRM. Pour suivre cette référence jusqu’aux factures partielles et aux avoirs, retrouvez les contrôles sur les contrats, commandes et factures Salesforce–ERP.
Définissez dès le pilote qui peut corriger une référence après acceptation. Une correction de prix peut relever d’une modification de commande, puis d’une pièce financière distincte après facturation. Le journal garde les références précédentes et le motif de la correction.
Donner à chaque consommateur le délai dont il a besoin
Pour la BI, consolidez les données à une cadence compatible avec l’usage du rapport et datez la dernière extraction complète. Pour le marketing, faites remonter les changements de consentement selon le délai prévu avec l’équipe responsable. Pour l’e-commerce, utilisez le référentiel de stock et de prix de l’ERP ou du service qui les expose au panier.
Un export BI peut repartir sur la dernière période confirmée. Une mise à jour de consentement exige de retrouver la personne et la source du changement. Évaluez ces parcours séparément, car les conséquences d’une donnée absente ou retardée diffèrent pour chaque consommateur.
Répartir les automatismes entre Salesforce et le middleware
Inventoriez les Flows et déclencheurs Apex qui se lancent quand l’intégration change un champ. Gardez dans Salesforce les contrôles qui doivent s’exécuter avec l’objet. Confiez au middleware l’attente d’un accusé ERP, la file de reprise et le journal de corrélation quand le flux traverse plusieurs systèmes.
Pour éviter les boucles, définissez les champs écrits par chaque sens du flux et vérifiez les conditions de déclenchement. En recette, la même opération reçue deux fois doit laisser une seule demande métier en aval. Vérifiez aussi qu’un retour ERP dans Salesforce n’émet pas une nouvelle demande pour la même version.
Consommer et reprendre les événements Salesforce
CDC signale un changement d’enregistrement. Platform Events permet de publier un événement métier explicite, comme une demande de traitement approuvée. Pour un consommateur Pub/Sub, décodez les indications de champs modifiés et mis à null dans un événement CDC. Un champ vide dans le message peut correspondre à une valeur qui n’a pas changé. Décodage des changements CDC dans Pub/Sub.
Conserver une position et une preuve de traitement
Après confirmation du traitement ou enregistrement durable dans une file qui en prend la responsabilité, conservez le Replay ID fourni par Salesforce. Il est opaque. Salesforce conserve les Platform Events et les événements CDC pendant 72 heures. Si la position est hors de la fenêtre garantie ou si le flux a été réinitialisé, resynchronisez l’état depuis la source avant de reprendre l’abonnement. Rétention des événements et Replay ID.
La déduplication métier utilise sa propre identité. Un Platform Event dispose d’un identifiant de message. Pour CDC, conservez une preuve par objet et modification appliquée ou vérifiez l’état cible avant de renouveler un effet métier. Les scénarios de reprise Salesforce sous charge avec Bulk, CDC et Pub/Sub détaillent les coupures, les rediffusions et le rattrapage par lecture.
Gérer les quotas, la pagination et les lots
Réserver des appels aux flux prioritaires
Surveillez Sforce-Limit-Info sur les réponses REST et consultez la ressource /limits avec les droits requis. Mesurez séparément la consommation de l’organisation et celle de vos propres clients. Les jobs Bulk et les livraisons d’événements ont des allocations à suivre selon le canal. Fixez la marge qui protège commandes et corrections avant de programmer les exports. En-tête de consommation REST et ressource Salesforce Limits.
Pour un exemple de recette fictif, supposez qu’il reste 4 000 appels REST et que les ventes et les reprises doivent pouvoir en utiliser 1 500. Un export estimé à 3 000 appels ferait descendre la réserve à 1 000. Différez-le ou réduisez son périmètre, puis mesurez la consommation des autres clients avant de le reprendre.
Distinguer le statut du job et celui des enregistrements
Pour une requête REST, suivez nextRecordsUrl tant que la réponse indique d’autres pages. Rapprochez les identifiants effectivement reçus avec la sortie livrée. Le cas de l’export Salesforce qui confond le total annoncé avec les pages reçues détaille les preuves de fin d’extraction. Continuation d’une requête REST Salesforce.
Pour un chargement Bulk API 2.0, gardez l’identifiant du job et la correspondance entre les lignes d’entrée et leurs clés métier. Consultez les résultats de succès, d’échec et les lignes non traitées selon l’état du job. Après correction, reprenez les lignes concernées en conservant leurs clés. Résultats des lignes en échec d’un chargement Bulk.
Erreurs fréquentes après une coupure ou une saturation du quota
Retrouver une écriture après une réponse perdue
Si le délai expire après l’envoi, cherchez la clé externe dans Salesforce et comparez la fiche avec la version envoyée. Une fiche correspondante et une preuve de l’effet attendu permettent de fermer l’opération. Si le résultat reste incertain, alors le dossier reste en attente. Autorisez une relance quand l’effet est dédupliqué par contrat ou quand vous savez que la tentative initiale n’a pas abouti et ne peut plus aboutir. RFC 9110 sur les conditions de relance HTTP.
Sur un champ mal formé ou une permission absente, corrigez la configuration ou le dossier. Sur une indisponibilité transitoire, espacez les tentatives autorisées et bornez leur durée. Inscrivez la décision dans le journal afin que la reprise manuelle suive les mêmes règles.
Préserver les commandes sous pression
Lorsque Salesforce signale une limite d’appels, identifiez le consommateur et l’allocation concernés. Suspendez en priorité les tâches différables. Une file durable garde les commandes qui attendent, leur âge et la clé de chaque opération. Reprenez les flux de manière progressive lorsque la capacité revient.
En recette, lancez en concurrence un export et un transfert de commandes, puis simulez l’épuisement de la réserve. Le support doit retrouver le lot suspendu, sa position de reprise et les commandes toujours en attente. Vérifiez que le rattrapage respecte l’ordre dont dépend chaque opération.
Donner au support les preuves de reprise
Pour chaque flux, journalisez la clé métier, la tentative, le canal, la version du mapping, le statut et l’identifiant reçu du système cible. Préservez la traçabilité tout en limitant les données personnelles. Gardez le détail utile dans un espace restreint et fixez une durée de conservation.
Le tableau d’exploitation distingue les opérations confirmées, rejetées et au résultat inconnu. Mesurez l’âge de la plus ancienne opération et identifiez le responsable de la correction. Une extraction apparemment réussie peut cacher un fichier incomplet si le contrôle se limite au statut HTTP ou au nombre de lignes annoncé.
Plan d’action avant la mise en service
Cadrer un flux et ses limites
Choisissez un parcours mesurable et suivez plusieurs dossiers jusqu’à leur résultat métier. Écrivez le contrat d’entrée, le format de sortie, les responsabilités et la preuve qui confirme l’acceptation. Pour une commande, mesurez le délai entre l’accord commercial, l’acceptation ERP et le retour de la référence dans Salesforce.
Fixez avec l’équipe support l’âge maximal d’une opération en attente et la part du budget d’appels réservée aux flux critiques. Si les pics d’export consomment cette marge, alors l’export change de créneau ou de taille avant l’ouverture du flux. Vérifiez aussi qui dispose des droits pour suspendre un consommateur et comment le réactiver sans reprendre les écritures déjà confirmées.
Tester une coupure et une reprise partielle
Préparez une création, une mise à jour, un refus de validation, un jeton expiré et une réponse perdue après écriture. Ajoutez un job partiellement réussi et un consommateur CDC qui reprend avec une position devenue inutilisable. Pour chaque test, comparez les identifiants reçus, l’état réel en aval et les instructions affichées au support.
Acceptez la mise en service si les reprises laissent une seule opération métier par clé, si le support sait traiter les exceptions et si les commandes passent pendant la simulation d’un pic d’appels. À défaut, limitez le périmètre du pilote et corrigez le scénario qui empêche la validation. Conservez les références des dossiers de recette et le résultat de chaque reprise pour pouvoir rejouer les mêmes contrôles lors d’un changement de version.
- Documenter les accès de la sandbox et confirmer ceux du compte de production avant toute écriture.
- Tester une reprise avec le support et conserver les identifiants des pièces effectivement créées.
- Rapprocher les opérations du pilote avec l’ERP et décider avec les métiers quand élargir le flux.
Approfondir les flux Salesforce par scénario
Si plusieurs CRM partagent les mêmes données, le pilier Intégration API et CRM aide à définir la propriété des champs entre outils. Pour le passage d’une vente en gestion, le parcours du devis accepté jusqu’au règlement ERP détaille les responsabilités de l’ADV et de la finance.
Lorsque des écarts reviennent après chaque import ou synchronisation, le contrôle de réconciliation entre source et cible aide à classer les pièces manquantes et à choisir un point de reprise.
Conclusion — valider la reprise avant d’élargir le flux
Le pilote est exploitable lorsque le support peut partir d’une opportunité, retrouver la clé de l’écriture et expliquer l’état de la commande dans l’ERP. Un export doit prouver que toutes ses pages ou lignes attendues sont livrées. Un événement doit pouvoir être repris dans la fenêtre disponible ou compensé par une lecture de la source.
Avant d’augmenter la cadence, vérifiez la rotation OAuth, la capacité réservée et les tests de reprise avec les personnes qui les exploiteront. Une correction au niveau de la clé ou de la preuve d’écriture évite des heures de rapprochement lorsque plusieurs flux se remettent en route ensemble.
Dawap peut vous accompagner dans l’intégration de Salesforce à votre système d’information, de l’attribution des droits jusqu’à la recette et à la reprise des flux CRM, ERP et BI.