{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Créer un modèle et envoyer une enveloppe à partir de celui-ci","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"créer-un-modèle-et-envoyer-une-enveloppe-à-partir-de-celui-ci","__idx":0},"children":["Créer un modèle et envoyer une enveloppe à partir de celui-ci"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les modèles permettent de définir un flux de signature réutilisable — document, étapes, destinataires et placement des champs — puis de créer des enveloppes à la demande. Ce guide décrit la configuration complète d'un modèle et explique comment créer une enveloppe à partir de celui-ci."]},{"$$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":"partie-1--créer-le-modèle","__idx":2},"children":["Partie 1 — Créer le modèle"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-1--créer-un-modèle","__idx":3},"children":["Étape 1 — Créer un modèle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Créer le conteneur du modèle. Lui donner un nom pour pouvoir l'identifier ultérieurement. Il est également possible de définir optionnellement une expiration."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/templates\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Standard Lease Agreement\",\n  \"expiration\": {\n    \"expiresAt\": \"2026-04-25T09:16:24.350Z\",\n    \"mode\": \"absolute\"\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\": \"f7e6d5c4-1234-1234-1234-ba9876543210\"\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":["templateId"]}," pour tous les appels suivants de cette section."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-2--téléverser-un-document-dans-le-modèle","__idx":4},"children":["Étape 2 — Téléverser un document dans le modèle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Joindre le PDF que les signataires recevront. Cet endpoint utilise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]},", et non JSON."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/templates/{templateId}/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\": \"9c8b7a69-1234-1234-1234-987654321000\"\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 des champs de signature."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-3--ajouter-une-étape-de-signature-au-modèle","__idx":5},"children":["Étape 3 — Ajouter une étape de signature au modèle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une étape représente une phase du flux de travail. Les destinataires dans la même étape signent en parallèle ; les étapes s'exécutent dans l'ordre."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/templates/{templateId}/stages\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"First\",\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\": \"b2a1f0e9-1234-1234-1234-726150403020\"\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":3,"id":"étape-4--ajouter-un-destinataire-à-létape","__idx":6},"children":["Étape 4 — Ajouter un destinataire à l'étape"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ajouter un destinataire à l'étape. Dans un modèle, le destinataire représente généralement un rôle — les coordonnées réelles peuvent être remplacées lors de la création d'une enveloppe à partir du modèle."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/templates/{templateId}/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@sample.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\": \"1a2b3c4d-1234-1234-1234-ef0123456789\"\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":3,"id":"étape-5--placer-un-champ-de-signature","__idx":7},"children":["Étape 5 — Placer un champ de signature"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Définir l'emplacement de la signature et l'assigner au destinataire. Cet appel remplace intégralement toutes les tâches du fichier ; envoyer donc la liste complète à chaque fois."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /api/v1/organizations/{organizationId}/templates/{templateId}/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\": \"1a2b3c4d-1234-1234-1234-ef0123456789\",\n      \"sortOrder\": 1\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$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":"strong","attributes":{},"children":["Réponse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le modèle est maintenant entièrement configuré."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"partie-2--créer-une-enveloppe-à-partir-du-modèle","__idx":8},"children":["Partie 2 — Créer une enveloppe à partir du modèle"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-6--créer-une-enveloppe","__idx":9},"children":["Étape 6 — Créer une enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instancier une nouvelle enveloppe à partir du modèle en un seul appel. Le document, les étapes, les destinataires et le placement des champs du modèle sont tous copiés automatiquement dans la nouvelle enveloppe. Aucun corps de requête n'est requis."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/templates/{templateId}/create-envelope\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  \"createdEnvelopeId\": \"a1b2c3d4-1234-1234-1234-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdEnvelopeId"]}," retourné est un identifiant d'enveloppe standard. À partir de ce point, travailler avec l'enveloppe exactement comme avec n'importe quelle autre — il est possible de la modifier avant l'envoi ou de l'envoyer immédiatement."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-7--envoyer-lenveloppe","__idx":10},"children":["Étape 7 — Envoyer l'enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Faire passer l'enveloppe de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}," à ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sent"]},". Cette action 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. Utiliser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdEnvelopeId"]}," comme ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]},"."]},{"$$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}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape-8--vérifier-le-statut-de-lenveloppe","__idx":11},"children":["Étape 8 — 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\": \"Standard 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":3,"id":"étape-9--télécharger-le-document-signé","__idx":12},"children":["Étape 9 — 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 artefacts 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_signed.pdf\",\n      \"type\": \"CompletedFile\"\n    },\n    {\n      \"id\": \"1b8f76b1-1234-1234-1234-aada9b8bab44\",\n      \"name\": \"AuditTrail.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":[]}]},"headings":[{"value":"Créer un modèle et envoyer une enveloppe à partir de celui-ci","id":"créer-un-modèle-et-envoyer-une-enveloppe-à-partir-de-celui-ci","depth":1},{"value":"Prérequis","id":"prérequis","depth":2},{"value":"Partie 1 — Créer le modèle","id":"partie-1--créer-le-modèle","depth":2},{"value":"Étape 1 — Créer un modèle","id":"étape-1--créer-un-modèle","depth":3},{"value":"Étape 2 — Téléverser un document dans le modèle","id":"étape-2--téléverser-un-document-dans-le-modèle","depth":3},{"value":"Étape 3 — Ajouter une étape de signature au modèle","id":"étape-3--ajouter-une-étape-de-signature-au-modèle","depth":3},{"value":"Étape 4 — Ajouter un destinataire à l'étape","id":"étape-4--ajouter-un-destinataire-à-létape","depth":3},{"value":"Étape 5 — Placer un champ de signature","id":"étape-5--placer-un-champ-de-signature","depth":3},{"value":"Partie 2 — Créer une enveloppe à partir du modèle","id":"partie-2--créer-une-enveloppe-à-partir-du-modèle","depth":2},{"value":"Étape 6 — Créer une enveloppe","id":"étape-6--créer-une-enveloppe","depth":3},{"value":"Étape 7 — Envoyer l'enveloppe","id":"étape-7--envoyer-lenveloppe","depth":3},{"value":"Étape 8 — Vérifier le statut de l'enveloppe","id":"étape-8--vérifier-le-statut-de-lenveloppe","depth":3},{"value":"Étape 9 — Télécharger le document signé","id":"étape-9--télécharger-le-document-signé","depth":3}],"frontmatter":{"seo":{"title":"Créer un modèle et envoyer une enveloppe à partir de celui-ci"}},"lastModified":"2026-08-06T06:58:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-template-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}