Aller au contenu

Les groupes de signataires

Le bail doit être signé par « la direction » : la directrice générale ou son adjointe, peu importe laquelle, pourvu que l’une des deux signe. Un groupe met plusieurs personnes à une même place. Toutes sont invitées ; la première qui signe tient la place, et les autres n’ont plus rien à faire.

Situation Ce qu’il faut
L’un ou l’autre des deux gérants signe pour la société. Un groupe de deux membres.
« La direction », dont un seul membre suffit. Un groupe, avec un nom : Direction.
Les deux gérants doivent signer. Pas de groupe : deux signataires.
Quelqu’un doit seulement recevoir une copie. Pas de groupe : un viewer, seul.

Un groupe ne réunit pas des signatures : il en attend une, de n’importe lequel de ses membres.

Une place de signers[] devient un groupe en donnant group_name et members à la place de la personne : ni given_name, ni family_name, ni email, ni phone, ni auth_method sur la place elle-même. Chaque membre les porte.

POST /v1/signature-requests
Idempotency-Key: 8d3a…
X-Tano-Timestamp: …
X-Tano-Signature: v2=…
{
"name": "Bail — appartement Cocody",
"reference": "BAIL-2026-120",
"documents": [{"filename": "bail.pdf", "content": "JVBERi0xLjcK…"}],
"signers": [
{
"group_name": "Direction",
"members": [
{"given_name": "Aya", "family_name": "Koné", "email": "[email protected]", "auth_method": "otp_email"},
{"given_name": "Awa", "family_name": "Traoré", "phone": "+2250707080910", "auth_method": "otp_sms"}
],
"position": 1,
"fields": [{"document": 0, "kind": "signature", "page": 1, "x": 60, "y": 80, "width": 180, "height": 50}]
},
{
"given_name": "Koffi",
"family_name": "Yao",
"phone": "+2250701021234",
"auth_method": "otp_sms",
"position": 2,
"fields": [{"document": 0, "kind": "signature", "page": 1, "x": 300, "y": 80, "width": 180, "height": 50}]
}
],
"activate": true
}
Champ de la place Obligatoire Description
group_name oui Le nom du groupe, de 1 à 60 caractères. Il figure dans le fichier de preuve.
members oui Au moins deux membres (voir ci-dessous).
role non signer (par défaut) ou approver. Pas viewer : une copie n’a pas de groupe.
position non Le rang du groupe en ordre séquentiel.
fields, hidden_documents non Comme pour un signataire seul. Les champs sont copiés pour chaque membre.
delivery, custom_text, redirect_urls, locale, time_zone non Comme pour un signataire seul, et valables pour chaque membre.

Chaque membre :

Champ Obligatoire Description
given_name, family_name oui Son nom.
auth_method oui otp_email ou otp_sms.
email ou phone selon la méthode Sa coordonnée, comme pour un signataire seul.

Un membre ne porte rien d’autre : ni champs, ni rôle, ni rang. Ils sont ceux de la place.

// Avec le client `tano()` de l'exemple complet.
const demande = await tano("POST", "/v1/signature-requests", {
name: "Bail — appartement Cocody",
reference: "BAIL-2026-120",
documents: [{ filename: "bail.pdf", content: pdfEnBase64 }],
signers: [
{
group_name: "Direction",
members: [
{ given_name: "Aya", family_name: "Koné", email: "[email protected]", auth_method: "otp_email" },
{ given_name: "Awa", family_name: "Traoré", phone: "+2250707080910", auth_method: "otp_sms" },
],
position: 1,
fields: [{ document: 0, kind: "signature", page: 1, x: 60, y: 80, width: 180, height: 50 }],
},
{
given_name: "Koffi", family_name: "Yao", phone: "+2250701021234", auth_method: "otp_sms",
position: 2,
fields: [{ document: 0, kind: "signature", page: 1, x: 300, y: 80, width: 180, height: 50 }],
},
],
activate: true,
});
// Trois entrées dans signers[] : Aya et Awa (le groupe), puis Koffi.
for (const s of demande.signers) {
console.log(s.id, s.status, s.group?.name ?? "seul");
}

Le client tano(), qui signe les requêtes, est celui de l’exemple complet.

Chaque membre est une entrée de signers[], avec son propre id, son status et son contact, et group qui désigne son groupe. Pour un signataire seul, group vaut null.

{
"id": "sr_01J9ZK7B2M4Q8R6T0V3W5X7Y9Z",
"status": "ongoing",
"signers": [
{"id": "ss_…aya", "position": 1, "role": "signer", "status": "notified", "auth_method": "otp_email", "contact": "a••••@exemple.ci", "group": {"id": "sgrp_01J8ZQ4M7X…", "name": "Direction"}},
{"id": "ss_…awa", "position": 1, "role": "signer", "status": "notified", "auth_method": "otp_sms", "contact": "+225 07 •• •• 09 10", "group": {"id": "sgrp_01J8ZQ4M7X…", "name": "Direction"}},
{"id": "ss_…koffi", "position": 2, "role": "signer", "status": "pending", "auth_method": "otp_sms", "contact": "+225 07 •• •• 12 34", "group": null}
]
}

Les autres propriétés d’un signataire (name, notified_at, signed_at, fields…) sont omises ci-dessus. Les membres d’un même groupe partagent le même group.id (sgrp_…) : c’est par lui que vous les reconnaissez.

Quand vient le tour du groupe, chaque membre est invité, avec son propre lien, et reçoit son propre code à usage unique sur sa propre coordonnée : Aya par courriel, Awa par SMS. Aucun ne signe avec le code de l’autre. Vous recevez un signer.notified par membre.

Dès qu’un membre signe, la place est tenue. Les autres membres passent au statut released (« libéré : un autre membre a signé ») :

  • leurs liens cessent de valoir : la page de signature ne leur permet plus de signer ;
  • ils ne sont plus relancés, et ne se modifient plus ;
  • vous recevez signer.released pour chacun.

released est un état final, comme signed ou declined. À la fin, le membre qui a signé pour le groupe est en signed, les autres en released.

En ordre séquentiel, le rang suivant attend le groupe

Section intitulée « En ordre séquentiel, le rang suivant attend le groupe »

Le signataire suivant est invité dès que le groupe a signé, c’est-à-dire dès que l’un de ses membres a signé — pas quand tous l’ont fait. Dans l’exemple, Koffi est invité aussitôt qu’Aya ou Awa a signé.

En ordre parallèle, rien ne change : les membres sont invités avec tous les autres.

Si un membre ne veut pas signer, il lui suffit de ne rien faire : un autre membre signera pour le groupe.

Relances, liens et corrections : membre par membre

Section intitulée « Relances, liens et corrections : membre par membre »

Chaque membre est un signataire, avec son id. Les gestes de Gérer une demande et du parcours se font donc un membre à la fois :

POST /v1/signature-requests/{id}/signers/{signer_id}/remind
POST /v1/signature-requests/{id}/signers/{signer_id}/link
PATCH /v1/signature-requests/{id}/signers/{signer_id}

Relancer Aya ne relance pas Awa ; corriger l’adresse d’Aya ne touche pas celle d’Awa. Les relances automatiques (reminder_days) partent vers chaque membre qui n’a pas encore répondu.

Un membre libéré a répondu, au sens de l’API : il ne se relance plus et n’a plus de nouveau lien (signer_not_invited), et ne se corrige plus (signer_not_editable).

Le fichier de preuve retrace chaque membre comme un signataire, avec une ligne de plus :

Membre Ce que dit le fichier de preuve
Chaque membre « Membre du groupe « Direction » ».
Un membre libéré En outre : « N’a pas signé : un autre membre du groupe l’a fait. »

Celui qui a signé porte, comme tout signataire, son authentification, son consentement et sa signature.

Dans une demande créée depuis un modèle, une personne peut être remplacée par un groupe de la même façon : group_name et members à la place de la personne, au rang du rôle qu’il occupe.

POST /v1/signature-requests
{
"template_id": "stpl_01JA2C4E6G8J0K2M4N6P8Q0R2S",
"reference": "BAIL-2026-121",
"signers": [
{
"group_name": "Direction",
"members": [
{"given_name": "Aya", "family_name": "Koné", "email": "[email protected]", "auth_method": "otp_email"},
{"given_name": "Awa", "family_name": "Traoré", "phone": "+2250707080910", "auth_method": "otp_sms"}
]
},
{"given_name": "Koffi", "family_name": "Yao", "phone": "+2250701021234", "auth_method": "otp_sms"}
],
"activate": true
}

Le groupe prend le rôle « Bailleur » du modèle, avec ses champs, son rang et ses documents cachés ; chaque membre en reçoit une copie. Le modèle, lui, ne change pas : il ne connaît que des rôles, et c’est la demande qui décide qu’un rôle est tenu par un groupe.

Règle Sinon
Une place est une personne ou un groupe : group_name avec members, sans given_name, family_name, email, phone ni auth_method à côté. 400, invalid_request.
Un groupe a un nom (group_name, de 1 à 60 caractères) et au moins deux membres. 400, invalid_request.
Un membre ne porte que given_name, family_name, email, phone et auth_method. 400, invalid_request.
Une même personne (même adresse ou même numéro) ne figure pas deux fois dans un groupe. 400, invalid_request sur signers[i].members.
Un groupe signe ou approuve : une copie (viewer) n’a pas de groupe. 400, invalid_request.
Chaque membre compte dans la limite de 20 signataires par demande : un groupe de trois en prend trois. signer_limit_exceeded.
Un champ signer_email demande l’adresse de chaque membre. invalid_field.

© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]