{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Signature de groupe","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"signature-de-groupe","__idx":0},"children":["Signature de groupe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ce guide explique comment configurer la signature de groupe via l'API NSE v1. La signature de groupe contrôle le nombre de destinataires d'une étape devant finaliser leur action avant que l'enveloppe n'avance. Il existe deux variantes :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signature de groupe x sur x"]}," — chaque destinataire de l'étape doit signer (également appelée signature en parallèle)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signature de groupe x sur y"]}," — seul un sous-ensemble doit signer (p. ex. 2 sur 5)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le reste du flux d'enveloppe — création de l'enveloppe, téléversement des documents, ajout des destinataires, placement des champs et envoi — suit les mêmes étapes décrites dans le guide ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-envelope-workflow"},"children":["Flux d'enveloppe de base"]},". Ce guide se concentre sur le seul champ qui modifie le comportement : ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fonctionnement","__idx":1},"children":["Fonctionnement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lors de la création d'une étape, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," définit le nombre de destinataires devant finaliser leur action avant que l'étape ne se clôture et que l'enveloppe n'avance. Tous les destinataires de l'étape reçoivent leur invitation en même temps."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Variante"},"children":["Variante"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"requiredRecipientCompletions"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effet"},"children":["Effet"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["x sur x"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Égal au nombre total de destinataires"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chaque destinataire doit signer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["x sur y"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inférieur au nombre total de destinataires"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Les x premiers à signer clôturent l'étape ; les autres ne peuvent plus agir"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signature-de-groupe-x-sur-x","__idx":2},"children":["Signature de groupe x sur x"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les 3 destinataires doivent signer avant que l'enveloppe n'avance."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Étape : requiredRecipientCompletions = 3  (nombre total de destinataires = 3)\n  ├── Alice  →  doit signer\n  ├── Bob    →  doit signer\n  └── Carol  →  doit signer\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Créer l'étape :"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Board Members\",\n  \"requiredRecipientCompletions\": 3,\n  \"type\": \"signer\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ajouter les destinataires"]}," — appeler cet endpoint une fois par destinataire en sauvegardant chaque ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"givenName\": \"Alice\",\n \"surname\": \"Smith\",\n \"email\": \"alice.smith@example.com\",\n \"notificationChannels\":\n [\n  \"email\"\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Répéter pour Bob et Carol. Assigner un champ de signature à chaque destinataire via l'endpoint des tâches, puis envoyer. Le statut de l'enveloppe reste ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inProgress"]}," jusqu'à ce que les 3 aient signé."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signature-de-groupe-x-sur-y","__idx":3},"children":["Signature de groupe x sur y"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seuls 2 des 5 destinataires doivent signer. Dès que la deuxième signature est collectée, l'étape se clôture et les 3 destinataires restants ne peuvent plus agir."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Étape : requiredRecipientCompletions = 2  (nombre total de destinataires = 5)\n  ├── Alice  →  signe ✓\n  ├── Bob    →  signe ✓  ← seuil atteint, l'étape se clôture\n  ├── Carol  →  n'est plus requise\n  ├── David  →  n'est plus requis\n  └── Eva    →  n'est plus requise\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Créer l'étape :"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Investment Committee\",\n  \"requiredRecipientCompletions\": 2,\n  \"type\": \"signer\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ajouter les destinataires"]}," — appeler cet endpoint une fois par destinataire en sauvegardant chaque ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \n \"givenName\": \"Alice\",\n \"surname\": \"Smith\",\n \"email\": \"alice.smith@example.com\",\n \"notificationChannels\": \n  [\n   \"email\"\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Répéter pour Bob, Carol, David et Eva — 5 appels au total. Un champ de signature doit être assigné à chaque destinataire via l'endpoint des tâches, même si seules 2 finalisations sont requises, afin que n'importe lequel d'entre eux puisse être parmi les premiers à signer. Envoyer ensuite l'enveloppe normalement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"règles-importantes","__idx":4},"children":["Règles importantes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," doit être supérieur à ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," et ne peut pas dépasser le nombre total de destinataires dans l'étape."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le définir égal au nombre total de destinataires signifie que tout le monde doit signer (x sur x)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le définir à une valeur inférieure signifie que seuls les x premiers à signer sont requis (x sur y)."]}]}]},"headings":[{"value":"Signature de groupe","id":"signature-de-groupe","depth":1},{"value":"Fonctionnement","id":"fonctionnement","depth":2},{"value":"Signature de groupe x sur x","id":"signature-de-groupe-x-sur-x","depth":2},{"value":"Signature de groupe x sur y","id":"signature-de-groupe-x-sur-y","depth":2},{"value":"Règles importantes","id":"règles-importantes","depth":2}],"frontmatter":{"seo":{"title":"Signature de groupe"}},"lastModified":"2026-07-01T08:50:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/group-signing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}