{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Catégorie de documents et flux d'enveloppe","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"catégorie-de-documents-et-flux-denveloppe","__idx":0},"children":["Catégorie de documents et flux d'enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ce guide décrit le flux complet pour classifier un document à l'aide d'une catégorie de documents et envoyer une enveloppe via l'API d'intégration NSE. À la fin, vous aurez créé une catégorie de documents, créé une enveloppe, téléversé un fichier, classifié ce fichier avec des métadonnées, vérifié et appliqué les politiques associées, puis envoyé l'enveloppe."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une catégorie de documents est utile lorsque des documents doivent être catégorisés (par exemple « Contrat » ou « Facture ») et automatiquement acheminés selon un flux de signature prédéfini, basé sur les politiques associées à cette catégorie."]},{"$$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":["Le feature flag ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DocumentClasses"]}," doit être activé pour l'organisation"]},{"$$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-catégorie-de-documents","__idx":2},"children":["Étape 1 — Créer une catégorie de documents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["catégorie de documents"]}," regroupe les documents d'un même type (p. ex. « Contrat ») et leur associe un ensemble de champs de métadonnées typés. Une fois créée, elle peut être réutilisée dans plusieurs enveloppes et associée à des politiques."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dans la requête suivante, une catégorie de documents est ajoutée avec une métadonnée de type String. Il est possible d'ajouter plusieurs champs de métadonnées à une catégorie de documents ; les types Number et Date sont également disponibles."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/document-classes\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Contracts\",\n  \"description\": \"Document class for contracts\",\n  \"metadata\": [\n    {\n      \"id\": 1,\n      \"name\": \"Name\",\n      \"type\": \"StringType\",\n      \"required\": true\n    }\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\": \"d4e5f6a7-1234-1234-1234-1234567890ab\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegardez le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit de votre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentClassId"]},", utilisé à l'étape 4."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-2--créer-une-enveloppe","__idx":3},"children":["Étape 2 — Créer une enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pour une configuration simple, il suffit de créer une enveloppe avec un nom et une date d'expiration."]},{"$$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\": \"Name\",\n  \"expiration\": {\n    \"expiresAt\": \"2026-05-30T18:30:00.000Z\",\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\": \"a1b2c3d4-1234-1234-1234-ef1234567890\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegardez le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit de votre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}," pour toutes les étapes suivantes."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-3--téléverser-un-fichier","__idx":4},"children":["Étape 3 — Téléverser un fichier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Téléversez un PDF (ou un autre format pris en charge) dans l'enveloppe. Ce point de terminaison 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}/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":"Requis"},"children":["Requis"]},{"$$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":["Oui"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Le fichier document"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentClassId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optionnel — assigner la catégorie de documents au moment du téléversement"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exemple curl :"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  \"https://demo-eu-ie1-api.namirialsign.com/api/organizations/{organizationId}/envelopes/{envelopeId}/files\" \\\n  -H \"Authorization: Bearer <token>\" \\\n  -F \"file=@/path/to/document.pdf\"\n","lang":"bash"},"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\": \"3fa85f64-1234-1234-1234-2c963f66afa6\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sauvegardez le champ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," retourné — il s'agit de votre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]},", utilisé dans les étapes suivantes."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-4--ajouter-la-catégorie-de-documents-avec-les-métadonnées-au-fichier","__idx":5},"children":["Étape 4 — Ajouter la catégorie de documents avec les métadonnées au fichier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Associez la catégorie de documents créée à l'étape 1 au fichier téléversé, et renseignez les valeurs pour chaque champ de métadonnées."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"documentClass\": {\n    \"id\": \"6a1231231231233f5\",\n    \"metadata\": [\n      {\n        \"type\": \"StringType\",\n        \"value\": \"TEST\",\n        \"id\": 1\n      }\n    ]\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":["204 No Content"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Après cette étape, le fichier est classifié et ses métadonnées sont enregistrées. Le système peut désormais évaluer quelles politiques s'appliquent en fonction de la catégorie de documents."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-5--vérifier-les-politiques","__idx":6},"children":["Étape 5 — Vérifier les politiques"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avant d'appliquer la politique, appelez le point de terminaison ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["verify"]}," pour vérifier si l'enveloppe et ses documents classifiés satisfont déjà les exigences des politiques associées. Aucune modification n'est apportée à l'enveloppe."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/verify-policies\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{}\n","lang":"json"},"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  \"compliant\": false\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-6--appliquer-les-politiques","__idx":7},"children":["Étape 6 — Appliquer les politiques"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Appelez ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apply-policies"]}," pour remplir l'enveloppe avec le flux de travail défini par les politiques associées. Cette action ajoute automatiquement les destinataires configurés dans la politique."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/apply-policies\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{}\n","lang":"json"},"children":[]},{"$$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":"p","attributes":{},"children":["Après cet appel, le flux de signature de l'enveloppe est entièrement configuré par la politique. Les destinataires et les étapes sont désormais présents dans l'enveloppe — vérifiez cela en appelant à nouveau le point de terminaison verify (étape 7)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-7--vérifier-de-nouveau-les-politiques","__idx":8},"children":["Étape 7 — Vérifier de nouveau les politiques"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Réexécutez l'appel verify après avoir appliqué la politique pour confirmer que l'enveloppe est complète et cohérente."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/verify-policies\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{}\n","lang":"json"},"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  \"compliant\": true\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["compliant"]}," est ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", les conditions configurées pour les politiques sont satisfaites."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"étape-8--envoyer-lenveloppe","__idx":9},"children":["Étape 8 — Envoyer l'enveloppe"]},{"$$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":["200 OK"]}]}]},{"$$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":["Les destinataires recevront désormais des notifications par e-mail avec des liens vers leurs tâches de signature."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pour la documentation de référence expliquant l'interface de cette rubrique, voir :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/organization-document-classes"},"children":["Catégorie de documents"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/organization-policies"},"children":["Politiques"]}]}]}]},"headings":[{"value":"Catégorie de documents et flux d'enveloppe","id":"catégorie-de-documents-et-flux-denveloppe","depth":1},{"value":"Prérequis","id":"prérequis","depth":2},{"value":"Étape 1 — Créer une catégorie de documents","id":"étape-1--créer-une-catégorie-de-documents","depth":2},{"value":"Étape 2 — Créer une enveloppe","id":"étape-2--créer-une-enveloppe","depth":2},{"value":"Étape 3 — Téléverser un fichier","id":"étape-3--téléverser-un-fichier","depth":2},{"value":"Étape 4 — Ajouter la catégorie de documents avec les métadonnées au fichier","id":"étape-4--ajouter-la-catégorie-de-documents-avec-les-métadonnées-au-fichier","depth":2},{"value":"Étape 5 — Vérifier les politiques","id":"étape-5--vérifier-les-politiques","depth":2},{"value":"Étape 6 — Appliquer les politiques","id":"étape-6--appliquer-les-politiques","depth":2},{"value":"Étape 7 — Vérifier de nouveau les politiques","id":"étape-7--vérifier-de-nouveau-les-politiques","depth":2},{"value":"Étape 8 — Envoyer l'enveloppe","id":"étape-8--envoyer-lenveloppe","depth":2}],"frontmatter":{"seo":{"title":"Catégorie de documents et flux d'enveloppe"}},"lastModified":"2026-09-23T07:23:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/document-classes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}