Avec un contact existant
Faire signer votre document à un contact déjà enregistré, en une requête.
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-F 'Transaction={"Name":"Contrat avec Atelier Lumière","TransactionFiles":[{"FriendlyName":"Contrat","Name":"Contrat de prestation"}],"TransactionMembers":[{"FriendlyName":"Client","MemberRole":0,"SignMode":1}]}' \
-F "Client=00000000-0000-4000-8000-000000000201" \
-F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
-F 'Client,Contrat={"Pages":"1","Coordinates":"320,90,180,100"}'Transactiondéclare un document « Contrat » et un participant « Client » qui signe (MemberRole0), son code de signature par email (SignMode1).Clientdésigne la personne : l'identifiant d'un contact — ou d'un utilisateur — de Docage. Le participant prend ses coordonnées sur sa fiche.Contratporte le fichier.Client,Contratpose l'encart de sa signature : page 1, à 320 points du bord gauche et 90 du bas, 180 de large et 100 de haut. Voir Poser une signature visuelle.
La réponse est le parcours créé et envoyé : le client reçoit son invitation à signer.
Les refus
- « Aucun contact ou utilisateur trouvé pour le participant Client » : l'identifiant ne désigne aucune fiche.
- Un message dit que vous n'avez pas le droit de voir le contact ou l'utilisateur lié à « Client » : la fiche existe, mais vous ne la voyez pas.
- Le contact sans email, sans prénom ou sans nom — ou sans mobile pour un code par SMS — fait refuser l'envoi : le parcours reste en brouillon.
Les pièges
- Oublier
MemberRolelaisse le participant sans action : voir Créer un parcours sans modèle. - Sans emplacement de signature, la signature est valide, mais aucun encart ne la montre sur le document.
- La clé
Client,Contrats'écrit comme les identifiants conviviaux, majuscules comprises.