{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Classe documentale e workflow della pratica","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"classe-documentale-e-workflow-della-pratica","__idx":0},"children":["Classe documentale e workflow della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questa guida illustra il workflow completo per classificare un documento tramite una Classe documentale e inviare una pratica utilizzando l'Integration API di NSE. Al termine si sarà creata una classe documentale, creata una pratica, caricato un file, classificato il file con i metadati, verificate e applicate le policy collegate e inviata la pratica."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una Classe documentale è utile quando i documenti devono essere categorizzati (per esempio \"Contratto\" o \"Fattura\") e instradati automaticamente attraverso un workflow di firma predefinito in base alle policy collegate a tale categoria."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisiti","__idx":1},"children":["Prerequisiti"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il feature flag ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DocumentClasses"]}," deve essere abilitato per l'organizzazione"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token JWT Bearer"]}," oppure un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal Access Token"]}," valido"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il proprio ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ID organizzazione"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un documento pronto per il caricamento"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-1--creare-una-classe-documentale","__idx":2},"children":["Passaggio 1 — Creare una classe documentale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Classe documentale"]}," definisce una categoria di documenti (ad esempio \"Contratto\") con un insieme di campi metadati tipizzati. Una volta creata, può essere riutilizzata in più pratiche e collegata alle policy."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nella richiesta seguente viene aggiunta una classe documentale contenente un campo metadato di tipo String. Si noti che è possibile aggiungere più campi metadati a una classe documentale e che sono disponibili anche i tipi di metadato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Number"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Date"]},"."]},{"$$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":["Risposta ",{"$$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":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito: è il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentClassId"]},", utilizzato nel Passaggio 4."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-2--creare-una-pratica","__idx":3},"children":["Passaggio 2 — Creare una pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per una configurazione semplice viene creata una pratica con un nome e una data di scadenza."]},{"$$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":["Risposta ",{"$$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":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito: è l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}," da utilizzare in tutti i passaggi successivi."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-3--caricare-un-file","__idx":4},"children":["Passaggio 3 — Caricare un file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Caricare un PDF (o un altro formato supportato) nella pratica. Questo endpoint utilizza ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]},", 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":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$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":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il file del documento"]}]},{"$$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":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opzionale: assegna la classe documentale al momento del caricamento"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Esempio 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":["Risposta ",{"$$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":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito: è il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]},", utilizzato nei passaggi successivi."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-4--aggiungere-al-file-la-classe-documentale-con-i-metadati","__idx":5},"children":["Passaggio 4 — Aggiungere al file la classe documentale con i metadati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Associare al file caricato la classe documentale creata nel Passaggio 1 e fornire i valori per ciascun campo metadato."]},{"$$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":["Risposta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dopo questo passaggio il file è classificato e i relativi metadati sono memorizzati. Il sistema può ora valutare quali policy risultano applicabili in base alla classe documentale."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-5--verificare-le-policy","__idx":6},"children":["Passaggio 5 — Verificare le policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prima di applicare la policy, richiamare l'endpoint ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["verify"]}," per controllare se la pratica e i relativi documenti classificati soddisfano già i requisiti delle policy associate. Non viene apportata alcuna modifica alla pratica."]},{"$$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":["Risposta ",{"$$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":"passaggio-6--applicare-le-policy","__idx":7},"children":["Passaggio 6 — Applicare le policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Richiamare ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apply-policies"]}," per popolare la pratica con il workflow definito dalle policy collegate. In questo modo i destinatari vengono aggiunti automaticamente secondo quanto configurato nella policy."]},{"$$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":["Risposta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dopo questa chiamata il workflow di firma della pratica è interamente configurato dalla policy. I destinatari e le fasi sono ora presenti nella pratica: è possibile verificarlo richiamando di nuovo l'endpoint verify (Passaggio 7)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-7--verificare-di-nuovo-le-policy","__idx":8},"children":["Passaggio 7 — Verificare di nuovo le policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Eseguire nuovamente la chiamata di verifica dopo aver applicato la policy, per confermare che la pratica sia completa e coerente."]},{"$$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":["Risposta ",{"$$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":["Se ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["compliant"]}," è ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", le condizioni configurate per le policy sono soddisfatte."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-8--inviare-la-pratica","__idx":9},"children":["Passaggio 8 — Inviare la pratica"]},{"$$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":["Non è richiesto alcun corpo della richiesta."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta ",{"$$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":["I destinatari riceveranno ora le notifiche e-mail con i collegamenti alle rispettive attività di firma."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per la documentazione di riferimento che illustra il lato interfaccia utente di questo argomento, consultare:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/organization-document-classes"},"children":["Classe documentale"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/organization-policies"},"children":["Policy"]}]}]}]},"headings":[{"value":"Classe documentale e workflow della pratica","id":"classe-documentale-e-workflow-della-pratica","depth":1},{"value":"Prerequisiti","id":"prerequisiti","depth":2},{"value":"Passaggio 1 — Creare una classe documentale","id":"passaggio-1--creare-una-classe-documentale","depth":2},{"value":"Passaggio 2 — Creare una pratica","id":"passaggio-2--creare-una-pratica","depth":2},{"value":"Passaggio 3 — Caricare un file","id":"passaggio-3--caricare-un-file","depth":2},{"value":"Passaggio 4 — Aggiungere al file la classe documentale con i metadati","id":"passaggio-4--aggiungere-al-file-la-classe-documentale-con-i-metadati","depth":2},{"value":"Passaggio 5 — Verificare le policy","id":"passaggio-5--verificare-le-policy","depth":2},{"value":"Passaggio 6 — Applicare le policy","id":"passaggio-6--applicare-le-policy","depth":2},{"value":"Passaggio 7 — Verificare di nuovo le policy","id":"passaggio-7--verificare-di-nuovo-le-policy","depth":2},{"value":"Passaggio 8 — Inviare la pratica","id":"passaggio-8--inviare-la-pratica","depth":2}],"frontmatter":{"seo":{"title":"Classe documentale e workflow della pratica"}},"lastModified":"2026-09-21T14:47:50.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/document-classes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}