Lancement du parapheur

Démarrer le parapheur

Une fois les documents à signer téléversés, l’application métier passe le statut du parapheur à started, en transmettant l’identifiant du parapheur dans l’URL :

PATCH /api/workflows/wfl_FPt9JLHCzFTvCRNviHBNE3Hg HTTP/1.1
Authorization: Bearer act_KsV6FLek9qjbxmHUPjuaBWus.4csaGSdsKCCMAoKhVhQQTUJsFaRygHyYNveeBmXiU4SfpSsdVkRxumjZGFbnKE4x
Content-Type: application/json
Content-Length: 34
{
  "workflowStatus" : "started"
}

Signature et approbation

Dès que le parapheur démarre, les destinataires de la première étape du parapheur reçoivent des invitations par e-mail pour signer ou approuver les documents via la page de consentement.

Créer l’invitation

Si vous préférez envoyer les e-mails d’invitation depuis votre application métier, vous pouvez empêcher le Workflow Manager d’envoyer les e-mails d’invitation en positionnant le champ maxInvites de l’étape à 0. Vous pouvez alors utiliser l’API de parapheur pour créer les liens d’invitation de façon programmatique, pour chaque destinataire :

POST /api/workflows/wfl_5rXexBmb7RAqWSu5CsJvV4XU/invite HTTP/1.1
Authorization: Bearer act_KsV6FLek9qjbxmHUPjuaBWus.4csaGSdsKCCMAoKhVhQQTUJsFaRygHyYNveeBmXiU4SfpSsdVkRxumjZGFbnKE4x
Content-Type: application/json
Content-Length: 59
{
  "recipientEmail" : "kenny.windler2729@my-company.com"
}

Un lien d’invitation est renvoyé :

{
  "inviteUrl" : "https://kovacek.org/invite?token=eyJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJpbnZpdGUiLCJjb25zZW50VmVyc2lvbiI6IlYyIiwic3RlcElkIjoic3RwX0VpRDJYdWlBRlZ3MlgxVnFyU..."
}

Notez que le lien généré reste valide tant que le parapheur est accessible au destinataire. Il devient invalide dès que le destinataire n’est plus requis, ou une fois l’étape expirée.