Intégration API Docusign
Nous développons votre connecteur Docusign
Nous branchons Docusign à votre dossier métier : l'enveloppe part de votre outil, le statut signé y revient, au bon niveau eIDAS.
- Équipe produit senior
- connecteurs de signature en production
- du cadrage au monitoring
À quoi sert l'intégration Docusign et que devient le contrat une fois connecté ?
Docusign est la plateforme de signature électronique la plus répandue en entreprise. Une fois intégré à votre logiciel, Docusign permet d'envoyer un document à signer directement depuis votre application, de choisir le niveau de signature requis (simple, avancé ou qualifié selon les exigences légales), et de rapatrier automatiquement la preuve de signature dans le dossier. Le contrat cesse d'être une pièce jointe envoyée par email pour devenir un objet métier avec un statut, une date et une valeur probante rattachés à la transaction dans votre système.
Ce que nos clients branchent sur Docusign
Devis et contrats depuis le CRM
L'envelope part du deal. Sur completed, les champs reviennent dans la fiche et le dossier passe à gagné, sans copier-coller du PDF.
Onboarding salarié, deux niveaux
Contrat de travail en signature avancée ou qualifiée, annexes en simple, dans le même dossier ordonné. Le SIRH avance dès la signature, pas à l'ouverture de la boîte Docusign.
Acte réglementé en QES
Crédit, immobilier, santé : le signataire passe par un QTSP (exemple IdNow). Le reste du dossier reste en SES. Le niveau est un paramètre, pas un second projet.
Archivage automatique dans la GED
À envelope-completed, le pack signé est téléchargé une fois et déposé dans votre GED. Plus d'export manuel le vendredi soir.
Ce que ça change dans votre parcours
La technique au service d'un résultat mesurable : un statut dans le dossier, le bon niveau eIDAS, zéro chasse au PDF.
Le commercial voit si c'est signé
Envoyé, vu, signé, refusé, expiré : le statut vit dans votre outil. On arrête de chasser le contrat dans une boîte mail éditeur.
Le niveau eIDAS est un paramètre
Simple, avancée ou qualifiée se choisit par type de document. Vous n'ouvrez pas un projet juridique parallèle à chaque nouveau modèle.
La donnée du signataire revient
Adresse, IBAN, mentions : les champs remplis sont écrits dans votre logiciel. Ils ne restent pas prisonniers du PDF.
Le dossier avance sans surveillance manuelle
Les notifications sont vérifiées, avec une reprise de contrôle régulière. Vous n'attendez pas qu'un commercial ouvre Docusign pour savoir.
Comment nous livrons votre connecteur Docusign
Cadrage
Quels documents, quel niveau eIDAS, JWT ou Authorization Code, SBS et QES déjà activés ou non. On liste les cas limites avant d'écrire une ligne de code.
Développement
Création d'envelopes, Connect avec HMAC sur le corps brut, file d'attente, déduplication sur envelope et type d'événement. JWT renouvelé sans refresh token.
Recette
Sandbox pour le flux, puis un compte avec SBS si AES ou QES sont exigés. Les certificats de démo ne se vérifient pas comme en production.
Monitoring
Lecture de X-RateLimit-Limit, alerte avant les 3 000 appels / h, retries Connect suivis 15 jours. Vous savez qu'un flux est cassé avant vos clients.
Ce que permet l'API Docusign
- Envelopes et destinataires
- Création, envoi, suivi du GUID d'envelope, jusqu'à 100 destinataires, onglets et ancres. L'objet métier de tout connecteur Docusign.
- Niveaux eIDAS (SBS)
- SES sans certificat (UniversalSignaturePen_ImageOnly), AES eIDAS Docusign, QES via un QTSP (exemple docusign_eu_qualified_idnow_tsp). Un champ, trois niveaux.
- Connect (webhooks)
- POST JSON ou XML vers un listener HTTPS. Les messages Connect ne comptent pas dans le quota d'API. HMAC-SHA256 du corps brut, retries jusqu'à 15 jours.
- Documents et champs remplis
- Téléchargement du pack signé, lecture des form_data. Write-back vers le CRM ou l'ERP, archivage unique à completed, pas un re-fetch à chaque affichage.
Le vocabulaire de l'API Docusign
- Envelope
- Le conteneur de la transaction : documents, expéditeur, destinataires, onglets, statut. Identifiant = GUID. C'est l'objet que votre logiciel doit connaître, pas le PDF.
- signatureProviderName
- Le champ SBS qui fixe le niveau. UniversalSignaturePen_ImageOnly = SES sans certificat (défaut). AES eIDAS Docusign. docusign_eu_qualified_idnow_tsp = QES via IdNow.
- JWT Grant
- Flux OAuth pour un service : impersonation d'un utilisateur, paire RSA, consentement préalable, token 1 heure, pas de refresh. Sans consentement, le Grant échoue même avec une clé valide.
- Connect
- Les webhooks Docusign. Listener HTTPS, POST JSON ou XML. Les messages ne consomment pas le quota API. C'est le canal de production ; le polling est une règle d'admission.
- X-Docusign-Signature-1
- Header HMAC-SHA256 du corps brut (fins de ligne incluses). Jusqu'à 100 clés (Signature-1 … Signature-N). Un handler qui parse le JSON avant de hasher échoue en silence.
- Hourly_Envelope_Polling_Limit_Exceeded
- Erreur nommée quand on interroge trop souvent le statut d'une envelope. Le pas documenté est 15 minutes (20 recommandées). Une appli hors pas ne passe pas le go-live.
Les contraintes réelles de l'API Docusign
Le polling est une règle d'admission
Pour une envelope donnée, le statut ne peut être interrogé qu'une fois toutes les 15 minutes. Une application qui poll plus souvent ne sera pas approuvée pour la production.
3 000 appels par heure, partagés
Quota par compte, lu dans X-RateLimit-Limit, rafraîchi à l'heure pile. Burst 200 / 30 s en développeur, 500 / 30 s en production. Toutes les intégrations du compte puisent dans le même seau.
SBS et QES ne sont pas des flags
Sans activation de compte, recipientSignatureProviders est ignoré ou rejeté. Le sandbox numérique n'est pas un sandbox eIDAS : les certificats de démo ne se vérifient pas comme en production.
JWT sans refresh token
À l'expiration (1 h) il faut reconstruire un JWT et le rééchanger. Le consentement d'impersonation est un prérequis. La clé privée RSA se stocke chiffrée, avec rotation documentée.
API Docusign ou API Yousign ?
Deux APIs de signature eIDAS. Le bon choix dépend de votre parc et de la façon dont SES, AES et QES s'expriment dans le produit.
| Critère | DocusignCette page | YousignÉditeur français |
|---|---|---|
| Objet central | Envelope (GUID) | Signature Request |
| eIDAS SES / AES / QES | SBS, options de compte à activer | Enum signature_level par signataire |
| Authentification | OAuth 2.0, JWT Grant (token 1 h) | Bearer, clé API |
| Webhooks | Connect, HMAC X-Docusign-Signature-1 | x-yousign-signature-256, timeout 1 s |
| QES dans le parcours | QTSP, exemple IdNow, hors iframe | Vidéo + humain, pas d'iframe, 30 min |
| Quota API | 3 000 / h par compte, burst 500 / 30 s | 60 / min et 1 200 / h en production |
| Le bon cas | Parc Docusign déjà en place | Produit français, eIDAS natif dans l'API |
Les trois (Docusign, Yousign, Universign) couvrent SES, AES et QES. Aucune ne rend la QES gratuite ni iframe par défaut. C'est un arbitrage de cadrage, pas un choix définitif.
Ce que nous mesurons sur une intégration Docusign
Les autres API de signature
Si Docusign n'est pas le bon socle, ces options se discutent au cadrage.
DocusignNous développons votre connecteur DocusignCette page
YousignAPI v3 française, SES AES QES en enum, iframe interdite en QES.
UniversignCinq niveaux, cachet et horodatage qualifiés, webhooks JWS PS256.On combine Docusign avec
La stack qui entoure Docusign sur nos projets.
Intégration Docusign : vos questions
Trois étapes. D'abord choisir le flux OAuth : JWT Grant pour un service qui envoie des envelopes sans session utilisateur, Authorization Code si un humain doit se connecter. Ensuite créer l'envelope depuis votre objet métier (devis, contrat, avenant) avec le bon signatureProviderName, SES, AES ou QES. Enfin brancher Connect : vérifier X-Docusign-Signature-1 sur le corps brut, pousser en file, répondre 2xx, dédupliquer sur l'identifiant d'envelope et le type d'événement. La partie sensible n'est pas le POST envelope, c'est le refus du polling et le go-live Docusign.
Ce sont les trois niveaux du règlement eIDAS (UE) n° 910/2014. SES : signature électronique simple, chez Docusign le défaut UniversalSignaturePen_ImageOnly, sans certificat. AES : signature avancée, art. 26, via Standards-Based Signatures, certificat Docusign ou du signataire. QES : signature qualifiée, seul niveau à équivalence manuscrite dans toute l'Union (art. 25 § 2), via un QTSP, par exemple docusign_eu_qualified_idnow_tsp. SBS n'est pas inclus dans les comptes développeur par défaut : il faut le faire activer. Le niveau se choisit par type de document, pas par un booléen « signature électronique ».
Pour une envelope donnée, le statut ne peut être interrogé qu'une fois toutes les 15 minutes (20 recommandées). Une application hors pas déclenche Hourly_Envelope_Polling_Limit_Exceeded ou Burst_Envelope_Polling_Limit_Exceeded, et elle n'est pas approuvée en production. Connect existe précisément pour ça : les webhooks ne comptent pas dans le quota, et ils voient les transitions y compris entre deux signataires. Le GET envelope reste un filet de réconciliation, pas le moteur.
Un premier flux utile, typiquement l'envoi d'un devis en SES et le write-back sur completed, se livre en deux à trois semaines. Une chaîne avec AES ou QES, JWT impersonation, archivage GED et relances Connect demande plutôt six à huit semaines : l'activation SBS et le parcours QES hors iframe pèsent autant que le code. Nous cadrons le périmètre en amont et vous donnons une estimation ferme avant de commencer.
Si vos équipes signent déjà dans Docusign, on intègre Docusign. Yousign expose SES, AES et QES comme un enum par signataire, avec un éditeur français et des hosts yousign.app. Universign ajoute cachet et horodatage qualifiés, et cinq niveaux dont level3 (AES + certificat qualifié) qui n'est pas une QES. Les trois exigent une activation commerciale pour la QES. Le choix est un arbitrage de parc et de politique de preuve, pas de « meilleure API ».
Un projet d'intégration Docusign ?
Parlons-en. 30 minutes pour cadrer vos envelopes, le niveau eIDAS réellement requis et vous dire franchement ce qui est faisable.
Parler de mon projet Docusign