{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Envoyer votre première enveloppe","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"envoyer-votre-première-enveloppe","__idx":0},"children":["Envoyer votre première enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ce guide décrit étape par étape l'envoi d'une demande de signature via l'API NSE v1. À la fin, une enveloppe aura été créée, un document téléversé, un signataire ajouté, un champ de signature placé et l'enveloppe envoyée — le tout via l'API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prérequis","__idx":1},"children":["Prérequis"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["jeton Bearer JWT"]}," valide ou un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["jeton d'accès personnel"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Votre ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ID d'organisation"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un document prêt à être téléversé"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-1--créer-une-enveloppe","__idx":2},"children":["Étape 1 — Créer une enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Commencer par créer une enveloppe. Il s'agit du conteneur pour les documents et les destinataires. Elle est créée en statut ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}," et reste modifiable jusqu'à l'envoi."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dans la plupart des intégrations, il suffit au minimum de lui donner un nom et de définir une expiration. Ici, une expiration relative est utilisée — 14 jours après l'envoi (exprimée en secondes)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Lease Agreement\",\n  \"expiration\": {\n    \"mode\": \"relative\",\n    \"afterSendInSeconds\": 1209600\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"a1b2c3d4-1234-1234-1234-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegarder le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit de l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}," pour tous les appels suivants."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-2--téléverser-un-document","__idx":3},"children":["Étape 2 — Téléverser un document"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Téléverser le PDF que le destinataire devra signer. Cet endpoint utilise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]},", et non JSON."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remarque : La taille maximale d'un fichier est de 10 Mo et une enveloppe peut contenir au maximum 10 documents."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files\nContent-Type: multipart/form-data\n","lang":"http"},"children":[]},{"$$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":"Champ"},"children":["Champ"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["binary"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Le fichier PDF à joindre"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"3fa85f64-1234-1234-1234-2c963f66afa6\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegarder le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit du ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]},", utilisé lors du placement du champ de signature."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-3--ajouter-une-étape-de-signature","__idx":4},"children":["Étape 3 — Ajouter une étape de signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une étape représente une phase du flux de signature. Les destinataires dans la même étape signent en parallèle ; les étapes s'exécutent dans l'ordre. Pour cet exemple, une étape avec un seul signataire est suffisante."]},{"$$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\": \"Signers\",\n  \"requiredRecipientCompletions\": 1,\n  \"type\": \"signer\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"5c367bac-1234-1234-1234-08f3025e28ab\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegarder le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit du ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stageId"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-4--ajouter-un-destinataire","__idx":5},"children":["Étape 4 — Ajouter un destinataire"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ajouter la personne qui signera le document à l'étape créée précédemment."]},{"$$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\": \"John\",\n  \"surname\": \"Doe\",\n  \"email\": \"john.doe@example.com\",\n  \"notificationChannels\": [\n    \"email\"\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"4e861e0f-1234-1234-1234-58bd9928b4a8\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegarder le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit du ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]},", utilisé lors du placement du champ de signature."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-5--placer-un-champ-de-signature","__idx":6},"children":["Étape 5 — Placer un champ de signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ajouter tous les champs qui doivent apparaître sur le document et indiquer qui doit les signer. Cet appel remplace intégralement toutes les tâches du fichier ; envoyer donc la liste complète à chaque fois."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Chaque tâche encapsule une définition de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field"]}," avec le ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]}," et un ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tasks\": [\n    {\n      \"field\": {\n        \"fieldType\": \"Signature\",\n        \"id\": \"field-001\",\n        \"page\": 1,\n        \"positionX\": 100,\n        \"positionY\": 650,\n        \"width\": 200,\n        \"height\": 60,\n        \"allowedSignatureTypes\": [\n          { \"signatureType\": \"ClickToSignSignature\" },\n          { \"signatureType\": \"DrawToSignSignature\" }\n        ]\n      },\n      \"recipientId\": \"4e861e0f-1234-1234-1234-58bd9928b4a8\",\n      \"sortOrder\": 1\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quelques points à noter :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["positionX"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["positionY"]}," sont les coordonnées du coin supérieur gauche du champ sur la page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," contrôle les méthodes de signature que le destinataire peut choisir. Si la valeur est ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},", les paramètres par défaut de l'organisation s'appliquent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]}," définit l'ordre dans lequel les champs sont présentés au signataire."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-6--envoyer-lenveloppe","__idx":7},"children":["Étape 6 — Envoyer l'enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une fois tout configuré, envoyer l'enveloppe. Cette action fait passer l'enveloppe de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}," à ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sent"]}," et déclenche l'e-mail d'invitation au destinataire."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/send\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aucun corps de requête requis."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-7--vérifier-le-statut-de-lenveloppe","__idx":8},"children":["Étape 7 — Vérifier le statut de l'enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interroger cet endpoint pour suivre l'avancement."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"a1b2c3d4-1234-1234-1234-ef1234567890\",\n  \"name\": \"Lease Agreement\",\n  \"status\": \"completed\",\n  \"sentAt\": \"2026-04-20T10:05:00Z\"\n  ...\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-8--télécharger-le-document-signé","__idx":9},"children":["Étape 8 — Télécharger le document signé"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une fois l'enveloppe en statut ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", récupérer le fichier signé et la piste d'audit."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lister les éléments disponibles :"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"artifacts\": [\n    {\n      \"id\": \"0a9e87c0-1234-1234-1234-99c8c87a9a33\",\n      \"name\": \"LeaseAgreement.pdf\",\n      \"type\": \"CompletedFile\"\n    },\n    {\n      \"id\": \"1b8f76b1-1234-1234-1234-aada9b8bab44\",\n      \"name\": \"Audit Trail.pdf\",\n      \"type\": \"AuditTrail\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Télécharger un artefact spécifique :"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retourne le fichier sous forme de flux binaire (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/pdf"]},")."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prochaines-étapes","__idx":10},"children":["Prochaines étapes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ce guide couvre le flux essentiel. La référence API complète décrit les options supplémentaires disponibles à chaque étape, notamment :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enveloppe :"]}," rappels automatiques, dates d'expiration absolues"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Étapes :"]}," signature en parallèle, étapes d'approbation uniquement (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Approver"]},"), copie carbone (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CarbonCopy"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Destinataires :"]}," authentification SMS/OTP, codes d'accès, configuration de certificat QES"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Champs :"]}," zones de texte, cases à cocher, listes déroulantes, confirmations de lecture, et plus encore"]}]}]},"headings":[{"value":"Envoyer votre première enveloppe","id":"envoyer-votre-première-enveloppe","depth":1},{"value":"Prérequis","id":"prérequis","depth":2},{"value":"Étape 1 — Créer une enveloppe","id":"étape-1--créer-une-enveloppe","depth":2},{"value":"Étape 2 — Téléverser un document","id":"étape-2--téléverser-un-document","depth":2},{"value":"Étape 3 — Ajouter une étape de signature","id":"étape-3--ajouter-une-étape-de-signature","depth":2},{"value":"Étape 4 — Ajouter un destinataire","id":"étape-4--ajouter-un-destinataire","depth":2},{"value":"Étape 5 — Placer un champ de signature","id":"étape-5--placer-un-champ-de-signature","depth":2},{"value":"Étape 6 — Envoyer l'enveloppe","id":"étape-6--envoyer-lenveloppe","depth":2},{"value":"Étape 7 — Vérifier le statut de l'enveloppe","id":"étape-7--vérifier-le-statut-de-lenveloppe","depth":2},{"value":"Étape 8 — Télécharger le document signé","id":"étape-8--télécharger-le-document-signé","depth":2},{"value":"Prochaines étapes","id":"prochaines-étapes","depth":2}],"frontmatter":{"seo":{"title":"Envoyer votre première enveloppe"}},"lastModified":"2026-10-20T12:01:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-envelope-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}