Erreurs et avertissements de DocuSign / Yousign Bridge dans Odoo : un cas de bout en bout

Un cas fictif pour parcourir les avertissements

Exemple Cas illustratif : l'entreprise et ses chiffres sont inventés pour expliquer le flux.

Gestoría Marlet est un cabinet de conseil fictif qui veut signer ses contrats de service depuis Odoo : avec Yousign au quotidien et avec DocuSign pour un client qui le demande. Laura, responsable administrative, est manager de Signature Bridge ; Pau, dans son équipe, prépare les demandes. Son entreprise applique la politique EU-only que vérifie le module. Nous suivons ce qui leur arrive et le message qui s'affiche à chaque étape. Les textes sont reproduits tels que le module les affiche, en anglais.

Quand Pau touche à une action réservée aux managers

Pau ouvre la fiche du fournisseur DocuSign pour modifier un réglage et reçoit Only a Signature Bridge manager can do this on a provider. Ce n'est pas un bug : cette action est réservée aux managers de Signature Bridge, c'est donc Laura qui s'en charge.

Même chose pour l'état du pont : Only Signature Bridge managers can read its health. Et pour les indicateurs : Only Signature Bridge managers can refresh the KPIs. Si quelqu'un de l'équipe a besoin de ces tâches, attribuez-lui le rôle de manager ; sinon, laissez-les à la personne qui l'a déjà.

Si le type de fournisseur n'est pas pris en charge par le module, l'avertissement est Unsupported provider type: %s, avec le type à la place de %s.

Le compte DocuSign : région, fournisseur de signature et DPA

Pau essaie d'envoyer la première demande via DocuSign et le module la bloque avec EU-only policy: the data center of %s is not known yet. Run "Test Connection" on the provider so DocuSign reports the region of the account. Le message indique lui-même la marche à suivre : Laura lance Test Connection sur le fournisseur pour que DocuSign communique la région du compte.

Si la région renvoyée est hors de l'UE, l'avertissement devient EU-only policy: the %(provider)s account is hosted in region "%(region)s", outside the EU. Avec la politique EU-only, le module ne vous laisse pas continuer avec ce compte : vérifiez auprès du fournisseur dans quelle région il est hébergé.

Autre blocage sur la fiche : Choose the DocuSign %s signature provider of the account on the provider form (Test Connection lists them). Laura choisit sur la fiche du fournisseur le fournisseur de signature DocuSign de son compte ; Test Connection lui affiche ceux qui sont disponibles.

Avant l'envoi en production apparaît Confirm the Data Processing Agreement with %s before sending in production. Le module demande de confirmer l'accord de traitement des données avec ce fournisseur et, tant qu'il n'est pas confirmé, il n'envoie rien en production.

Webhooks et clé HMAC de DocuSign

Avec DocuSign, l'un des avertissements que voit Laura est DocuSign webhooks are declared on every envelope (eventNotification); paste the Connect HMAC key in "Webhook Secret". Autrement dit : avec DocuSign, les webhooks sont déclarés sur chaque enveloppe et elle doit coller la clé HMAC de Connect dans le champ Webhook Secret.

L'autre avertissement sur la clé précise où la créer : DocuSign Connect HMAC keys are generated in DocuSign (Settings > Connect > HMAC Keys): create a new key there and paste it in "Webhook Secret". La clé se génère dans DocuSign, sous Settings > Connect > HMAC Keys, et se colle dans Webhook Secret.

À un autre moment, le module peut demander Register the webhook first. Enregistrez le webhook et relancez l'action. Et si un webhook arrive avec un contenu qui n'est pas du JSON valide, le module le rejette avec Invalid webhook JSON payload ; vérifiez chez le fournisseur comment ce webhook est configuré.

Pau prépare la demande

Pau crée une demande pour un contrat de service. En l'enregistrant sans signataire, il obtient At least one signer is required. et, sans document, At least one document attachment is required. Il ajoute le signataire et joint le contrat.

Le contrat est au format Word et la demande passe par Yousign : Yousign signs PDF documents: %s is not a PDF. Yousign signe des documents PDF, Pau le convertit donc et le joint à nouveau.

Il choisit ensuite un niveau que ce fournisseur n'autorise pas : Level %(level)s is not allowed on provider %(provider)s. Il change le niveau ou le fournisseur. Pour le client qui demande une QES apparaît QES is not available on %s: run "Test QES Capability" on the provider. Laura lance Test QES Capability sur le fournisseur.

L'envoi et la suite

Pau clique sur Send. Voici les avertissements de cette étape :

• Only draft requests can be sent. Seules les demandes en brouillon peuvent être envoyées.
• DocuSign answered without an envelopeId. et Yousign answered without a signature request id. La réponse du fournisseur ne contenait pas l'identifiant de l'enveloppe ou de la demande de signature. Vérifiez dans le compte du fournisseur ce qu'est devenu cet envoi avant de le relancer.
• The level and the provider of a signature request are fixed once it is sent. Le niveau et le fournisseur sont figés à l'envoi : décidez-les avant de cliquer sur Send.
• Only Send links a signature request to an envelope of the provider. Seul Send crée le lien avec l'enveloppe du fournisseur.
• A signature request starts as a draft: only the provider moves its state. et Only the provider and the buttons of the request move its state. L'état ne se modifie pas à la main : ce sont le fournisseur et les boutons de la demande qui le font évoluer.

Quelques jours plus tard, Pau veut relancer la signature. Si la demande n'est pas active : Only active requests can be reminded. Si tous les signataires ont déjà signé ou refusé : Every signer has already signed or declined. Avec Yousign peut apparaître Yousign signer ids are unknown for: %s, qui indique les signataires dont le module ne connaît pas l'identifiant Yousign ; vérifiez cette demande dans Yousign. Et si la demande est déjà clôturée : %s is already closed.

Un client refuse le contrat et Pau veut le renvoyer avec une autre version. La duplication ne fonctionne que pour les demandes expirées ou refusées : Only expired or declined requests can be cloned.

La preuve et le journal d'audit

Si Pau cherche la preuve trop tôt, le module répond Evidence exists once %s is completed. La preuve existe une fois la demande terminée.

Une fois terminée, la preuve ne se modifie pas : Completed signature evidence cannot be modified. Sa suppression est réservée aux managers et laisse une trace : Only Sign Bridge Managers can delete completed evidence, and deletion is audited.

Les événements d'audit n'acceptent que l'ajout d'enregistrements. Si quelqu'un tente de les modifier, le message est Audit events are append-only.

Ce qu'il faut retenir du cas Marlet

• Lisez le message en entier : beaucoup nomment le bouton (Test Connection, Test QES Capability) ou le champ (Webhook Secret) qui lève le blocage.
• Répartissez bien les rôles : fournisseur, état du pont, KPIs et suppression des preuves relèvent des managers de Signature Bridge.
• Avant Send, vérifiez le signataire, la pièce jointe, le PDF si c'est Yousign, un niveau autorisé et le DPA confirmé.
• Après l'envoi, niveau et fournisseur sont figés et l'état évolue via le fournisseur et les boutons.
• La preuve terminée et les événements d'audit ne se modifient pas.

Si vous êtes en pleine mise en place, le guide des réglages et de la première semaine couvre les champs à renseigner.

Comment FlexigoTech vous aide

FlexigoTech déploie Odoo 17, 18, 19 et 20 et développe des connecteurs et intégrations sur mesure, y compris autour de la signature électronique. Le module est publié sur Odoo Apps pour les versions 17, 18, 19 et 20 et coûte 9 € HT par version d'Odoo, en paiement unique. Vous trouverez les détails sur la page du module et sur la fiche Odoo Apps ; pour comprendre ce que traverse chaque enregistrement en interne, lisez comment fonctionne le module.

À lire aussi