{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Workflow con destinatario automatico","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"workflow-con-destinatario-automatico","__idx":0},"children":["Workflow con destinatario automatico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["destinatario automatico"]}," consente a NSE di applicare una firma o un sigillo a un documento senza alcuna interazione umana. Anziché inviare un link di firma a una persona, il passaggio di firma viene eseguito automaticamente lato server utilizzando un certificato di sigillo preconfigurato."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$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":["Un certificato di sigillo è configurato in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impostazioni dell'organizzazione → Certificati di sigillo"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il valore ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureProfile"]}," deve corrispondere esattamente al ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["friendly name"]}," del certificato di eSealing configurato"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il feature flag ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"AutomaticRemoteSignature\""]}," è abilitato sull'organizzazione"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JWT Bearer token"]}," valido oppure un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal Access Token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["L'",{"$$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":"panoramica-delle-api","__idx":2},"children":["Panoramica delle API"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-1--creare-la-pratica","__idx":3},"children":["Passaggio 1 — Creare la pratica"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Automatic Signing Envelope\",\n  \"expiration\": {\n    \"expiresAt\": \"2026-12-31T23:59:59.000Z\",\n    \"mode\": \"absolute\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito nella risposta come ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-2--caricare-il-documento","__idx":4},"children":["Passaggio 2 — Caricare il documento"]},{"$$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":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"file=@document.pdf\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito nella risposta come ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-3--creare-lo-stage","__idx":5},"children":["Passaggio 3 — Creare lo stage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Automatic Seal\",\n  \"requiredRecipientCompletions\": 1,\n  \"type\": \"automatic\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito nella risposta come ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stageId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-4--aggiungere-il-destinatario-automatico","__idx":6},"children":["Passaggio 4 — Aggiungere il destinatario automatico"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"languageCode\": \"en\",\n    \"signatureProfile\": \"<profile-name>\",\n    \"type\": \"Automatic\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Salvare l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," restituito nella risposta come ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-5--aggiungere-il-task-di-firma","__idx":7},"children":["Passaggio 5 — Aggiungere il task di firma"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tasks\": [\n    {\n      \"field\": {\n        \"fieldType\": \"AutomaticSignature\",\n        \"id\": \"1234\",\n        \"page\": 1,\n        \"positionX\": 50,\n        \"positionY\": 200,\n        \"width\": 200,\n        \"height\": 60\n      },\n      \"recipientId\":\"7117de33-1234-1234-1234-51809e7a3e20\",\n      \"sortOrder\":1\n    }\n  ]  \n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passaggio-6--inviare-la-pratica","__idx":8},"children":["Passaggio 6 — 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":["Lo stage viene eseguito immediatamente dopo l'invio. Il sigillo viene applicato automaticamente e la pratica si completa senza alcuna interazione umana."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"download-dei-documenti-firmati","__idx":9},"children":["Download dei documenti firmati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una volta completata la pratica, è possibile recuperare gli artifact tramite:"]},{"$$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":"p","attributes":{},"children":["Successivamente si può scaricare un artifact specifico (documento firmato o audit trail) utilizzando il relativo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["artifactId"]},":"]},{"$$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":[]}]},"headings":[{"value":"Workflow con destinatario automatico","id":"workflow-con-destinatario-automatico","depth":1},{"value":"Prerequisiti","id":"prerequisiti","depth":2},{"value":"Panoramica delle API","id":"panoramica-delle-api","depth":2},{"value":"Passaggio 1 — Creare la pratica","id":"passaggio-1--creare-la-pratica","depth":3},{"value":"Passaggio 2 — Caricare il documento","id":"passaggio-2--caricare-il-documento","depth":3},{"value":"Passaggio 3 — Creare lo stage","id":"passaggio-3--creare-lo-stage","depth":3},{"value":"Passaggio 4 — Aggiungere il destinatario automatico","id":"passaggio-4--aggiungere-il-destinatario-automatico","depth":3},{"value":"Passaggio 5 — Aggiungere il task di firma","id":"passaggio-5--aggiungere-il-task-di-firma","depth":3},{"value":"Passaggio 6 — Inviare la pratica","id":"passaggio-6--inviare-la-pratica","depth":3},{"value":"Download dei documenti firmati","id":"download-dei-documenti-firmati","depth":2}],"frontmatter":{"seo":{"title":"Workflow con destinatario automatico"}},"lastModified":"2026-10-13T11:28:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/automatic-recipient-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}