Intégration API

Odoo CRM API : rattacher une opportunité au bon client

Jérémy Chomel Dawap
  • Publié le : 25 septembre 2024
  • Mis à jour le : 12 novembre 2026
  • Temps de lecture : 10 minutes
  1. Séparer la demande, le partenaire et l’affaire
  2. Choisir la société qui porte le devis
  3. Répartir les droits d’écriture
  4. Convertir le lead et préparer le devis
  5. Dans quels cas cadrer le flux avec l’installateur
  6. Retrouver le devis du dossier ODO-418
  7. Erreurs fréquentes au passage vers les ventes
  8. Faire une recette sur deux sociétés
  9. Transmettre une commande confirmée à la gestion
  10. Mettre en œuvre le connecteur et le rapprochement
  11. Conclusion
Portrait de Jérémy Chomel

Une demande arrive d’une adresse achats partagée par deux établissements. Le commercial retrouve un compte Odoo et qualifie l’affaire. Quand le connecteur prépare le devis, il reprend la société active de son compte technique. Le document est alors émis par la mauvaise entité, alors que le client et l’opportunité semblaient corrects à l’écran.

Le risque vient de trois décisions distinctes. Il faut retrouver l’origine de la demande, valider le client destinataire et choisir l’entité qui émet le devis. Une adresse connue aide à identifier les candidats. La décision sur la société émettrice appartient au processus de vente.

Le dossier fictif ODO-418 montre comment conserver ces décisions de la qualification à la reprise d’un devis dont la réponse s’est perdue. La recette vérifie ce que le commercial voit dans son pipeline et ce que l’équipe de gestion retrouve côté Ventes.

Si un portail ou un autre CRM alimente votre installation, le cadrage d’une intégration Odoo CRM permet de définir les règles avec vos équipes et l’installateur Odoo.

Séparer la demande, le partenaire et l’affaire

Le formulaire attribue une référence stable à la demande WEB-418. Le partenaire Odoo représente la personne ou la société qui intervient dans la relation commerciale. Une opportunité suit une affaire. Un partenaire peut donc avoir plusieurs affaires en cours, y compris deux demandes envoyées par la même adresse. Documentation Odoo sur les personnes et les sociétés dans Contacts.

Quand WEB-418 est reçue deux fois, le connecteur doit retrouver la décision prise pour cette demande. Quand une nouvelle demande WEB-419 arrive, la qualification peut la rattacher au même partenaire et décider si elle concerne une autre affaire. Conservez le lien entre l’identifiant de la demande, le partenaire confirmé et l’identifiant de l’opportunité. Une correction de l’adresse d’un contact peut alors rester une correction de contact.

Traiter une adresse qui correspond à plusieurs fiches

Deux fiches remontent sur achats@example.org. Présentez leur raison sociale, leur adresse et leur éventuel lien avec une société parente. Si le référentiel client fournit une clé confirmée, utilisez-la pour retrouver la fiche retenue. Si la clé est absente et que les deux fiches restent plausibles, gardez la demande visible et faites choisir le commercial.

La décision doit être retrouvée lors d’une reprise. Si une fusion Odoo intervient entre la qualification et le devis, le support vérifie le partenaire et l’opportunité conservés avant de mettre à jour leur correspondance. Il doit retrouver la référence WEB-418 même si l’identifiant de la fiche d’origine a changé.

Choisir la société qui porte le devis

Le partenaire client peut être partagé entre plusieurs sociétés Odoo, alors que le devis appartient à une entité précise. Dans une base multisociété, Odoo utilise la société active comme valeur par défaut pour les documents commerciaux. Un utilisateur technique autorisé à travailler pour deux sociétés peut donc réussir une lecture dans un contexte et préparer ensuite le devis sous l’autre entité. Fonctionnement des sociétés et des contacts partagés dans Odoo.

Dans ODO-418, le partenaire est validé pour la relation commerciale et l’équipe désigne FR02 comme société émettrice. Le connecteur sélectionne le contexte autorisé pour FR02 et vérifie les références requises pour le devis. Si un produit ou une adresse attendue reste indisponible dans ce contexte, le dossier repart en revue avec les deux références. Modifier la société pour que le produit apparaisse changerait l’émetteur du document.

Paradoxalement, une recette avec un compte administrateur peut masquer un défaut qui touche précisément les ventes. Faites les lectures avec le compte technique prévu, puis demandez à une personne de FR02 d’ouvrir le devis en recette. Si elle ne le voit pas, alors comparez la société enregistrée au contexte utilisé par l’API. Le succès de la requête prouve seulement que le compte technique avait le droit d’effectuer l’appel.

Répartir les droits d’écriture

Le formulaire fournit la demande et ses coordonnées déclarées. L’équipe commerciale tient l’étape et le responsable de l’affaire. Le référentiel client fournit l’identité validée. L’équipe Ventes vérifie les adresses et les conditions du devis dans Odoo. L’intégration porte ces responsabilités champ par champ.

Le contrat d’entrée du passage au devis doit contenir la référence de l’affaire, le partenaire et la société validés. La sortie attendue est la référence d’un document retrouvé ou créé. Donnez à Ventes la responsabilité de toute correction qui change le client ou la société et conservez dans la journalisation la source de cette décision.

Par exemple, un enrichissement reçu après la qualification peut compléter la provenance de WEB-418. Il doit conserver le responsable choisi par le commercial et l’adresse de facturation approuvée. Si le portail reçoit une demande de changement d’adresse, créez une demande de correction avec un propriétaire et vérifiez quels devis sont encore modifiables. Le guide d’intégration du CRM au SI détaille la répartition de ces droits entre plusieurs outils.

Convertir le lead et préparer le devis

Quand la qualification des leads est activée, le parcours Odoo permet de convertir une demande qualifiée et de l’associer à un client existant. Odoo propose aussi une fusion avec une opportunité similaire. Testez ce parcours avec l’équipe concernée, car les étapes de qualification et les modules peuvent différer selon les équipes et l’installation. Conversion et fusion dans Odoo CRM.

Depuis une opportunité, le bouton de création d’un devis est disponible lorsque l’application Ventes est installée. Avant de créer un document, l’équipe vérifie le client, la société émettrice et les devis déjà associés. La validation d’une étape commerciale et la confirmation du devis restent deux gestes à vérifier dans la recette. Création et suivi d’un devis depuis une opportunité Odoo.

Passer la demande à Ventes avec les références attendues

Transmettez l’opportunité, le partenaire et la société confirmés avec la référence de création demandée. Une nouvelle version proposée au client doit avoir sa propre intention de création si votre processus prévoit un autre devis. Un renvoi du même message pour la première version conserve sa référence.

Le rapprochement de cette référence se conçoit avec l’installateur. L’identifiant d’opportunité seul permet de retrouver ses devis, mais plusieurs devis peuvent appartenir à la même affaire. Dans ce cas, le support doit pouvoir reconnaître celui qui correspond précisément à la demande à reprendre.

Dans quels cas cadrer le flux avec l’installateur

Le cadrage concerne surtout les équipes qui ont déjà des partenaires et un pipeline dans Odoo, puis branchent une nouvelle source de demandes ou automatisent le passage au devis. Avec l’installateur, relevez la version, l’hébergement, les modules CRM et Ventes, les droits du compte d’intégration et les méthodes exposées. Reproduisez les mêmes règles d’accès dans la base de recette.

Sur Odoo 19, la documentation JSON-2 décrit une transaction par appel. Si le connecteur appelle séparément la mise à jour du partenaire et la création du devis, il doit gérer le cas où la première écriture est validée et la seconde échoue. Pour obtenir une transaction commune, qualifiez une méthode serveur réalisant l’ensemble avec l’installateur, selon les possibilités de déploiement. Transactions et droits de l’API JSON-2 d’Odoo.

Retrouver le devis du dossier ODO-418

À 10 h 12, le flux envoie la demande de premier devis pour FR02. Odoo valide la création, puis le connecteur perd la réponse. Le journal conserve une tentative indéterminée sur ODO-418-Q1. Une contrainte locale sur cette référence empêche deux traitements concurrents de renvoyer ensemble la demande.

Le support ouvre les devis de l’opportunité et relève le document candidat. Il vérifie que la référence d’intégration, la société, le partenaire et l’affaire correspondent. Si la correspondance est certaine, alors il rattache le devis retrouvé au journal et la reprise s’arrête. Si le résultat est ambigu ou invisible avec les droits du compte, le dossier attend une vérification avec l’installateur.

Le journal fictif ci-dessous donne au support les repères pour vérifier le dossier. Ses clés appartiennent à l’intégration.

{
  "request": "ODO-418-Q1",
  "opportunity_id": 2641,
  "partner_id": 480,
  "seller_company": "FR02",
  "state": "to_reconcile"
}

Vérifier l’intention avant de renvoyer une création

Un deuxième devis peut avoir été préparé manuellement pour la même affaire. La recherche par opportunité seule produit alors deux candidats. Un résultat vide peut aussi indiquer que le compte technique ne voit pas FR02. Le support doit obtenir une preuve d’échec avant de relancer une écriture dont le résultat reste indéterminé.

Si l’installation permet d’ajouter une méthode idempotente côté serveur, faites vérifier l’unicité de la référence de création dans le périmètre convenu avec l’installateur. Une deuxième tentative doit restituer le devis associé à la même demande, sous réserve que la société et les autres références concordent. Conservez la référence d’intention lors d’une reprise et créez-en une autre pour un second devis volontaire.

Erreurs fréquentes au passage vers les ventes

  • Société déduite du partenaire. Le client peut être partagé. Faites valider l’émetteur par le circuit commercial et comparez-le au document produit.
  • Devis introuvable en lecture. Vérifiez les sociétés autorisées, la société active, le périmètre de recherche et les droits avant d’ouvrir une nouvelle création.
  • Identifiant local recyclé en recette. Conservez le nom de la base ou une clé d’installation avec l’identifiant Odoo. Une correspondance récupérée d’une autre base peut désigner un autre partenaire.
  • Adresse corrigée trop tard. Faites traiter la demande avec l’équipe Ventes si un document a déjà été adressé au client.

Faire une recette sur deux sociétés

Commencez avec deux sociétés actives, un client partagé, deux fiches qui portent la même adresse et deux opportunités pour le client retenu. Le commercial valide la fiche et FR02. Le test doit retrouver un seul devis pour ODO-418-Q1 dans le bon dossier, même si le compte d’intégration peut aussi agir pour FR01.

Coupez ensuite la réponse après création et faites réceptionner le même message par deux traitements. Le support doit retrouver le numéro de devis sans en créer un autre. Retirez le droit de lecture sur FR02 et rejouez le dossier. Le message doit rester en vérification et mentionner le contexte utilisé.

Ajoutez une deuxième intention de devis après correction de l’adresse. Les ventes valident le traitement du document déjà créé. La recette passe si chaque intention reste traçable et si la demande WEB-418 mène toujours au bon partenaire et à la bonne affaire.

Surveillez le nombre de devis dans la file de rapprochement par société. Plusieurs cas indéterminés sur FR02 avec un délai réseau habituel justifient une vérification du contexte et des droits. Fixez le seuil du pilote à zéro devis créé sous la mauvaise société. Si un devis ressort sous FR01, alors suspendez les créations de ce flux et faites valider son traitement par Ventes avant de rouvrir le pilote.

Transmettre une commande confirmée à la gestion

Si un système aval attend une commande, déclenchez l’échange à partir du document confirmé dans Ventes et conservez sa référence ainsi que celle de l’opportunité. Les ventes peuvent encore corriger un devis brouillon pendant que le client négocie. Un changement d’étape sur l’affaire ne suffit pas pour décider quels articles et quantités la gestion doit reprendre.

Pour le dossier ODO-418, rapprochez la société émettrice, le partenaire et la version effectivement retenue avant le transfert. Une notification répétée doit retrouver la même commande dans le journal du flux. Les échanges de commandes, de stocks et de facturation relèvent ensuite du périmètre intégration Odoo ERP.

Mettre en œuvre le connecteur et le rapprochement

Le SDK Odoo CRM sous Symfony approfondit l’implémentation du client et les contrôles de synchronisation. Vérifiez l’interface disponible pour la version et l’offre de votre installation avant de reprendre les exemples.

Le guide de réconciliation entre la source et la cible aide à distinguer les dossiers absents, les correspondances erronées et les écritures à vérifier avant une reprise.

Conclusion

Commencez par une demande déjà reliée à un compte Odoo. Faites confirmer le partenaire, l’opportunité et la société qui signe le devis.

Faites jouer au support la perte de réponse, le mauvais contexte et l’existence de deux devis sur la même affaire. Il doit retrouver le bon document à partir de la référence d’intention.

Ouvrez les autres canaux quand cette vérification est reproductible dans les mêmes conditions d’accès que le compte d’intégration.

Notre équipe peut vous aider à cadrer cette recette avec votre installateur et à relier les étapes à vos outils lors d’une intégration Odoo CRM sur mesure.

Portrait de Jérémy Chomel

Reliez vos demandes au bon partenaire Odoo

Définissez les règles de qualification et la société qui porte chaque devis.

Articles recommandés

Lecture JSON-2 d’une opportunité Odoo dans Symfony Intégration API SDK Odoo CRM sous Symfony : relire une opportunité avec JSON-2 Lire l'article
  • 16 novembre 2024
  • Lecture ~11 min

Avant de préparer un devis, le worker Symfony relit l’opportunité dans la bonne base Odoo. L’exemple JSON-2 vérifie le partenaire et la société, puis distingue une affaire invisible, un rattachement corrigé et un refus d’accès. Une recette permet de comparer cette lecture avec un ancien client RPC avant la bascule.

Intégration API CRM : fiabiliser pipeline, ventes et marketing Intégration API Pipeline CRM : fiabiliser leads, comptes et opportunités Lire l'article
  • 17 août 2024
  • Lecture ~16 min

Une opportunité gagnée ne suffit pas à créer une commande ERP fiable. Identifiants, responsables, statuts et effets déjà produits doivent rester vérifiables quand un formulaire, le marketing et les ventes modifient le dossier. Ce guide propose des règles de décision, une recette de reprise et des parcours adaptés aux principaux CRM.

Réconciliation API : corriger les écarts entre systèmes Intégration API Réconciliation API : détecter et corriger les écarts Lire l'article
  • 27 mai 2025
  • Lecture ~32 min

La réconciliation API devient utile quand chaque écart est relié à une source de vérité, à une preuve d’exécution et à une action bornée. Elle évite les resync massifs et transforme un doute sur la donnée en décision lisible. Le dispositif conserve la fenêtre, le watermark, la clé métier et le droit de correction avant tout replay ou compensation.

Vérifiez le passage de l’opportunité au devis

Testez les sociétés autorisées, les correspondances et la reprise avec votre équipe Ventes.