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.
Quand prendre un groupe
Section intitulée « Quand prendre un groupe »| 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.
Créer une demande avec un groupe
Section intitulée « Créer une demande avec un groupe »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-requestsIdempotency-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: "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");}# Avec le client `tano()` de l'exemple complet.demande = tano("POST", "/v1/signature-requests", { "name": "Bail — appartement Cocody", "reference": "BAIL-2026-120", "documents": [{"filename": "bail.pdf", "content": pdf_en_base64}], "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 s in demande["signers"]: print(s["id"], s["status"], (s["group"] or {}).get("name", "seul"))Le client tano(), qui signe les requêtes, est celui de
l’exemple complet.
Ce que rend l’API
Section intitulée « Ce que rend l’API »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.
Le déroulé
Section intitulée « Le déroulé »Chaque membre a son lien et son code
Section intitulée « Chaque membre a son lien et son code »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.
Le premier qui signe tient la place
Section intitulée « Le premier qui signe tient la place »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.releasedpour 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.
Un membre qui refuse refuse la demande
Section intitulée « Un membre qui refuse refuse la demande »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}/remindPOST /v1/signature-requests/{id}/signers/{signer_id}/linkPATCH /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).
Dans le fichier de preuve
Section intitulée « Dans le fichier de preuve »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.
Un groupe depuis un modèle
Section intitulée « Un groupe depuis un modèle »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ègles et limites
Section intitulée « Règles et limites »| 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. |
Étapes suivantes
Section intitulée « Étapes suivantes »- Faire signer un document, pas à pas.
- Gérer une demande en cours : relancer, corriger un signataire.
- Les événements de la signature, dont
signer.released.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]