Errors i avisos de DocuSign / Yousign Bridge a Odoo: un cas de principi a fi

Un cas inventat per recórrer els avisos

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Gestoria Marlet és una assessoria inventada que vol signar els seus contractes de servei des d'Odoo: amb Yousign en el dia a dia i amb DocuSign per a un client que ho demana. La Laura, responsable d'administració, és manager de Signature Bridge; en Pau, del seu equip, prepara les sol·licituds. A la seva empresa s'aplica la política EU-only que comprova el mòdul. Seguim què els passa i quin missatge surt en cada punt. Els textos van tal com els mostra el mòdul, en anglès.

Quan en Pau toca alguna cosa reservada als managers

En Pau obre la fitxa del proveïdor de DocuSign per canviar un ajust i rep Only a Signature Bridge manager can do this on a provider. No és cap error: aquesta acció està reservada als managers de Signature Bridge, així que la fa la Laura.

Amb l'estat del pont passa el mateix: Only Signature Bridge managers can read its health. I amb els indicadors: Only Signature Bridge managers can refresh the KPIs. Si algú de l'equip necessita aquestes tasques, cal donar-li el rol de manager; si no, que les faci qui ja el té.

Si el tipus de proveïdor no és un dels que admet el mòdul, l'avís és Unsupported provider type: %s, amb el tipus al lloc de %s.

El compte de DocuSign: regió, proveïdor de signatura i DPA

En Pau prova d'enviar la primera sol·licitud per DocuSign i el mòdul l'atura amb 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. El mateix missatge diu què cal fer: la Laura executa Test Connection al proveïdor perquè DocuSign informi de la regió del compte.

Si la regió que arriba és fora de la UE, l'avís passa a ser EU-only policy: the %(provider)s account is hosted in region "%(region)s", outside the EU. Amb la política EU-only, el mòdul no deixa continuar amb aquest compte: cal revisar amb el proveïdor en quina regió està allotjat.

Un altre bloqueig de la fitxa: Choose the DocuSign %s signature provider of the account on the provider form (Test Connection lists them). La Laura tria a la fitxa del proveïdor el proveïdor de signatura de DocuSign del seu compte; Test Connection li mostra quins n'hi ha.

Abans d'enviar en producció apareix Confirm the Data Processing Agreement with %s before sending in production. El mòdul demana confirmar l'acord de tractament de dades amb aquest proveïdor i, mentre no es confirmi, no envia en producció.

Webhooks i la clau HMAC de DocuSign

Amb DocuSign, un dels avisos que veu la Laura és DocuSign webhooks are declared on every envelope (eventNotification); paste the Connect HMAC key in "Webhook Secret". És a dir: amb DocuSign els webhooks es declaren a cada sobre i el que ha de fer ella és enganxar la clau HMAC de Connect al camp Webhook Secret.

L'altre avís sobre la clau aclareix on es crea: DocuSign Connect HMAC keys are generated in DocuSign (Settings > Connect > HMAC Keys): create a new key there and paste it in "Webhook Secret". La clau es genera a DocuSign, a Settings > Connect > HMAC Keys, i s'enganxa a Webhook Secret.

En un altre moment el mòdul pot demanar Register the webhook first. Registra el webhook i repeteix l'acció. I si arriba un webhook amb un contingut que no és JSON vàlid, el mòdul el rebutja amb Invalid webhook JSON payload; revisa al proveïdor com està configurat aquest webhook.

En Pau prepara la sol·licitud

En Pau crea una sol·licitud per a un contracte de servei. En desar-la sense signants surt At least one signer is required. i, sense document, At least one document attachment is required. Afegeix el signant i adjunta el contracte.

El contracte és en Word i la sol·licitud va per Yousign: Yousign signs PDF documents: %s is not a PDF. Yousign signa documents PDF, així que en Pau el converteix i el torna a adjuntar.

Després tria un nivell que aquest proveïdor no té permès: Level %(level)s is not allowed on provider %(provider)s. Canvia el nivell o el proveïdor. Per al client que demana QES apareix QES is not available on %s: run "Test QES Capability" on the provider. La Laura executa Test QES Capability al proveïdor.

L'enviament i el que ve després

En Pau prem Send. Aquests són els avisos d'aquesta part:

• Only draft requests can be sent. Només s'envien sol·licituds en esborrany.
• DocuSign answered without an envelopeId. i Yousign answered without a signature request id. La resposta del proveïdor no portava l'identificador del sobre o de la sol·licitud de signatura. Mira al compte del proveïdor què ha passat amb aquest enviament abans de repetir-lo.
• The level and the provider of a signature request are fixed once it is sent. El nivell i el proveïdor queden fixos en enviar: decideix-los abans de prémer Send.
• Only Send links a signature request to an envelope of the provider. El vincle amb el sobre del proveïdor només el crea Send.
• A signature request starts as a draft: only the provider moves its state. i Only the provider and the buttons of the request move its state. L'estat no es canvia a mà: el mouen el proveïdor i els botons de la sol·licitud.

Uns dies després, en Pau vol recordar la signatura. Si la sol·licitud no està activa: Only active requests can be reminded. Si tots els signants ja han signat o rebutjat: Every signer has already signed or declined. Amb Yousign pot sortir Yousign signer ids are unknown for: %s, que indica els signants dels quals el mòdul no coneix l'identificador de Yousign; revisa aquesta sol·licitud a Yousign. I si la sol·licitud ja està tancada: %s is already closed.

Un client rebutja el contracte i en Pau el vol repetir amb una altra versió. Clonar només serveix per a sol·licituds caducades o rebutjades: Only expired or declined requests can be cloned.

L'evidència i el registre d'auditoria

Si en Pau busca l'evidència abans d'hora, el mòdul respon Evidence exists once %s is completed. L'evidència existeix un cop completada la sol·licitud.

Un cop completada, l'evidència no s'edita: Completed signature evidence cannot be modified. Esborrar-la és cosa dels managers i deixa rastre: Only Sign Bridge Managers can delete completed evidence, and deletion is audited.

Els esdeveniments d'auditoria només admeten afegir registres. Si algú intenta tocar-los, el missatge és Audit events are append-only.

Què n'aprenem del cas de Marlet

• Llegeix el missatge sencer: molts anomenen el botó (Test Connection, Test QES Capability) o el camp (Webhook Secret) que resol el bloqueig.
• Reparteix bé els rols: proveïdor, estat del pont, KPI i esborrat d'evidència són cosa dels managers de Signature Bridge.
• Abans de Send, repassa signant, adjunt, PDF si és Yousign, nivell permès i DPA confirmat.
• Després d'enviar, el nivell i el proveïdor són fixos i l'estat el mouen el proveïdor i els botons.
• L'evidència completada i els esdeveniments d'auditoria no s'editen.

Si estàs en plena posada en marxa, la guia d'ajustos i primera setmana cobreix els camps que cal omplir.

Com t'ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, també al voltant de la signatura electrònica. El mòdul està publicat a Odoo Apps per a 17, 18, 19 i 20 i costa 9 € per versió d'Odoo, pagament únic, sense IVA. Tens els detalls a la pàgina del mòdul i a la fitxa d'Odoo Apps; per entendre què recorre cada registre per dins, llegeix com funciona el mòdul.

Continua llegint