Signer plusieurs parcours en une fois

Un utilisateur qui signe beaucoup — un dirigeant, un gestionnaire — peut signer en une fois les parcours qui l'attendent, depuis votre logiciel, jusqu'à mille et à tout niveau de signature : un seul code de sécurité pour le lot quand le niveau en demande un, et pour chaque parcours sa propre signature. Chaque parcours la reçoit comme s'il avait été signé depuis son invitation, et son fichier de preuve dit qu'il l'a été dans une signature groupée.

Le déroulé

Un lot de mille parcours ne tient pas dans une requête : chaque étape qui coûte par parcours se fait par paquets, que votre logiciel enchaîne. Le lot garde son état d'un paquet au suivant.

1. Vérifier les parcours : QUERY https://staging-api.docage.com/Transactions/Signabilities dit, pour chaque parcours, s'il peut entrer dans un lot, à quel niveau, et dans quel groupe.
2. Ouvrir le lot et envoyer le code : POST https://staging-api.docage.com/Transactions/ConsentBatches ouvre le lot et rend la formule de consentement à montrer. Quand le niveau demande un code, les parcours se relèvent par vingt-cinq (POST https://staging-api.docage.com/Transactions/ConsentBatches/{batchId}/Manifest), puis le code part (POST https://staging-api.docage.com/Transactions/ConsentBatches/{batchId}/SendCode).
3. Signer le lot : POST https://staging-api.docage.com/Transactions/ConsentBatches/{batchId}/Authorize reçoit l'attestation, le code et ce avec quoi le signataire signe ; les parcours se préparent par dix (POST https://staging-api.docage.com/Transactions/ConsentBatches/{batchId}/Prepare) et se terminent par dix (POST https://staging-api.docage.com/Transactions/ConsentBatches/{batchId}/Complete).

Les règles

• Le signataire est l'utilisateur authentifié, participant du parcours par son compte : un participant désigné par une fiche de contact ne signe pas par cette voie.
• La session de son compte est exigée : un jeton (Bearer, voir S'authentifier). Une clé API (Basic) est refusée pour ouvrir le lot, envoyer le code, autoriser, préparer et signer (403, « Une signature se fait depuis la session de votre compte, jamais avec une clé d'API ni par l'assistant »).
• Tout niveau de signature entre dans un lot. En signature avancée, chaque parcours a sa propre clé, qui naît chez le signataire — dans son navigateur, sur son appareil ou dans le logiciel qu'il emploie —, ne sert qu'à ce parcours et ne quitte jamais son poste. En signature qualifiée et en signature avancée avec certificat qualifié, c'est le certificat qualifié du signataire, sur sa carte ou sa clé, qui signe chaque parcours ; son dispositif peut lui demander son code PIN.
• Ce qui demande plus qu'une attestation se signe depuis l'invitation : la lecture complète des documents exigée par l'auteur du parcours, une identité à vérifier, une autre étape avant la signature. La vérification le dit.
• Un lot ne réunit qu'un groupe : des parcours de la même organisation, au même niveau de signature, dont le code part par le même canal à la même coordonnée.
• Mille parcours au plus par lot ; deux cents par vérification, vingt-cinq par relevé, dix par préparation et par terminaison.
• Le signataire atteste avoir pris connaissance du contenu de chacun des documents : la formule lui est montrée, et sa preuve la recopie. Il peut ouvrir chaque parcours avant de signer.

Ce que dit le fichier de preuve

La signature est celle du niveau du parcours, comme depuis une invitation. La carte du signataire ajoute son accès — la session de son compte, dans une signature groupée —, et la chronologie de chaque parcours porte l'événement « Signature groupée » : avec un code, l'empreinte du lot et de quoi prouver que ce parcours en faisait partie, sans rien dire des autres.

La version précédente

POST Transactions/SignTransactionsWithSignatureCode/{code}, qui signait en un temps, et POST Transactions/SendSignatureCodeForTransactions n'existent plus : une signature avancée exige une clé née chez le signataire, qu'un code seul ne remplace pas, et un lot se traite par paquets.