{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Guida ai workflow","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"guida-ai-workflow","__idx":0},"children":["Guida ai workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questa guida spiega come è strutturata l'API di NSE e come è possibile combinarne i componenti di base per modellare un'ampia gamma di scenari di firma reali. Anziché illustrare le singole chiamate API, si concentra sui concetti alla base dell'API e sui diversi modelli di workflow che è possibile realizzare."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"i-componenti-di-base","__idx":1},"children":["I componenti di base"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ogni workflow di firma in NSE è costruito a partire da quattro oggetti annidati l'uno nell'altro:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Envelope\n  └── Stage 1\n  │     ├── Recipient A\n  │     └── Recipient B\n  └── Stage 2\n        └── Recipient C\n  └── File (Document)\n        └── Field Tasks  (linked to specific recipients)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Envelope"]}," — il contenitore di primo livello. Racchiude tutto: documenti, fasi e relativi destinatari. Una pratica attraversa un ciclo di vita (draft → sent → completed) ed è l'oggetto che viene monitorato e da cui si effettuano i download."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stage"]}," — un passaggio del workflow di firma. Le fasi vengono eseguite in sequenza: la fase 2 non inizia finché la fase 1 non è completata integralmente. All'interno di una singola fase, tutti i destinatari assegnati vengono notificati e agiscono in parallelo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recipient"]}," — una persona assegnata a una fase (può trattarsi anche di una fase automatica che non richiede alcuna interazione). Il destinatario riceve un invito (tramite e-mail, SMS o WhatsApp), apre il documento ed esegue l'azione richiesta dalla propria fase."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File e Field Task"]}," — documenti allegati alla pratica con campi interattivi (firme, caselle di controllo, campi di testo) posizionati su pagine specifiche. Ogni campo è collegato a un destinatario specifico, così ciascuna persona vede e utilizza soltanto i campi a lei assegnati."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"documenti","__idx":2},"children":["Documenti"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una pratica può contenere uno o più documenti. Ogni documento viene caricato nella pratica come file PDF separato tramite una richiesta multipart/form-data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"caricamento-dei-file","__idx":3},"children":["Caricamento dei file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il caricamento di un file non lo rende ancora interattivo: lo allega semplicemente alla pratica e restituisce un ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]},". Gli elementi interattivi vengono aggiunti separatamente tramite i field task."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In un workflow con più documenti, i destinatari possono avere campi su alcuni documenti e non su altri, e lo stesso documento può avere campi assegnati a destinatari diversi."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"approfondimento-sulle-fasi","__idx":4},"children":["Approfondimento sulle fasi"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le fasi sono il meccanismo principale per controllare il flusso e l'ordine di un processo di firma."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"esecuzione-sequenziale","__idx":5},"children":["Esecuzione sequenziale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le fasi sono numerate e vengono eseguite nell'ordine in cui sono state create. La seconda fase non viene attivata finché tutte le azioni obbligatorie della prima fase non sono completate. Questo rende immediato modellare catene di approvazione, controfirme e altri processi articolati in più passaggi."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tipi-di-fase","__idx":6},"children":["Tipi di fase"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ogni fase ha un tipo che definisce ciò che i destinatari di quella fase sono tenuti a fare:"]},{"$$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":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cosa fanno i destinatari"},"children":["Cosa fanno i destinatari"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Signer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Firmano o interagiscono con i campi firma nel documento"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Approver"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approvano o respingono la pratica prima che passi alla fase successiva"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CarbonCopy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ricevono una copia della pratica per conoscenza: non è richiesta alcuna azione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Viewer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Visualizzano il documento: non è richiesta alcuna azione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Automatic"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Passaggio gestito dal sistema, senza destinatari umani"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una pratica inizia tipicamente con una o più fasi ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Signer"]},", ma è possibile disporre qualsiasi combinazione in qualsiasi ordine. Un modello ricorrente prevede una fase ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Approver"]}," prima di una fase ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Signer"]},", così che una persona interna riesamini il documento prima che venga inviato al firmatario esterno."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"controllare-quanti-destinatari-devono-completare-una-fase","__idx":7},"children":["Controllare quanti destinatari devono completare una fase"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per impostazione predefinita, tutti i destinatari di una fase devono completare la propria azione prima che la fase avanzi. È possibile modificare questo comportamento tramite ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questo campo accetta un numero intero: il numero minimo di destinatari che devono completare la fase perché sia considerata conclusa. Se una fase contiene tre destinatari ma ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," è impostato su 1, la fase si completa appena uno di essi firma. Questo è utile in scenari come:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firma di un comitato"]},": invio a cinque membri del consiglio, con la firma di due di essi come requisito."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pool di firmatari autorizzati"]},": invio a tre firmatari autorizzati, uno qualsiasi dei quali può firmare a nome del gruppo."," ","Se ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," non è impostato, assume come valore predefinito il numero totale di destinatari della fase (tutti devono completare)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configurazione-del-destinatario","__idx":8},"children":["Configurazione del destinatario"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ogni destinatario viene configurato a livello di fase e può essere configurato prima che vengano predisposti documenti o campi. Il record del destinatario controlla identità, comunicazione, sicurezza di accesso e, ove necessario, i dati di preconfigurazione richiesti per le firme basate su certificato."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identità-e-dati-di-contatto","__idx":9},"children":["Identità e dati di contatto"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un destinatario è identificato da nome, cognome, indirizzo email e, facoltativamente, da un numero di telefono. Il numero di telefono è obbligatorio quando si utilizza l'autenticazione tramite SMS o la firma con OTP."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"canali-di-notifica","__idx":10},"children":["Canali di notifica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È possibile controllare la modalità con cui il destinatario riceve l'invito ed eventuali promemoria tramite ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notificationChannels"]},". Le opzioni disponibili sono ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sms"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WhatsApp"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lingua","__idx":11},"children":["Lingua"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["languageCode"]}," imposta la lingua utilizzata per tutte le e-mail, i messaggi SMS e gli elementi dell'interfaccia mostrati a questo destinatario. Utile quando il workflow coinvolge destinatari in Paesi differenti."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"autenticazione","__idx":12},"children":["Autenticazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["L'autenticazione aggiunge un controllo di identità che il destinatario deve superare prima di poter accedere al documento. Sono disponibili tre meccanismi, che possono anche essere combinati:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Codice di accesso"]}," — un codice segreto statico definito dal mittente. Il destinatario deve inserire il codice corretto per aprire la pratica. Il codice viene condiviso con il destinatario attraverso un canale proprio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OTP via SMS"]}," — una password temporanea inviata a un numero di telefono nel momento in cui il destinatario tenta di aprire il documento. Il numero di telefono va specificato durante la configurazione del destinatario."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth"]}," — il destinatario si autentica tramite un provider di identità esterno. Occorre fornire il nome del provider e l'identificativo esterno del destinatario per collegare gli account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configurazione-della-firma","__idx":13},"children":["Configurazione della firma"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La configurazione della firma sul destinatario è necessaria soltanto per i metodi di firma che richiedono dati predisposti in anticipo, in particolare:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificato usa e getta"]}," — un certificato qualificato monouso emesso al momento della firma. Occorre fornire i dati del documento di identificazione del destinatario (tipo, numero, nazione di emissione, scadenza e così via) e un numero di telefono di verifica. La piattaforma utilizza queste informazioni per emettere il certificato durante la sessione di firma."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificato remoto"]}," — il destinatario firma utilizzando un certificato conservato in un servizio di firma remota. Occorre fornire l'ID utente e l'ID dispositivo che identificano il certificato in tale servizio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firma con OTP"]}," — una password temporanea via SMS che funge da firma stessa (da non confondere con l'OTP come metodo di autenticazione di accesso). Occorre fornire il numero di telefono al quale l'OTP viene inviato nel momento della firma."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Plugin di firma"]}," — integrazioni di firma di terze parti. Occorre specificare l'ID del plugin e le eventuali impostazioni chiave/valore richieste dal plugin."," ","Per tutti gli altri metodi di firma — click-to-sign, draw-to-sign, type-to-sign, biometrico, certificato locale — non è necessaria alcuna preconfigurazione sul destinatario. I metodi consentiti sono invece controllati da ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," sul campo firma stesso, che viene impostato durante il posizionamento del campo sul documento."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"messaggio-personale","__idx":14},"children":["Messaggio personale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un messaggio in testo libero mostrato al destinatario insieme all'invito standard. È possibile utilizzarlo per fornire contesto, per esempio spiegando quale documento si sta firmando o indicando istruzioni specifiche per questa pratica."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scenari-di-workflow","__idx":15},"children":["Scenari di workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gli scenari seguenti illustrano come fasi e destinatari si combinano per gestire i casi reali più comuni."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-1--firmatario-unico","__idx":16},"children":["Scenario 1 — Firmatario unico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il workflow più semplice: un documento, una persona che firma."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Signer)\n  └── Alice\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alice riceve un invito, apre il documento, appone la propria firma e la pratica si completa."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-2--due-firmatari-in-sequenza","__idx":17},"children":["Scenario 2 — Due firmatari in sequenza"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entrambe le parti devono firmare e l'ordine è rilevante. Il contratto viene inviato prima alla prima parte; solo dopo la sua firma la seconda parte riceve il proprio invito."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Signer)   →   Stage 2 (Signer)\n  └── Alice                └── Bob\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È una configurazione frequente nei contratti bilaterali, in cui una parte avvia il processo e l'altra controfirma."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-3--più-firmatari-in-parallelo","__idx":18},"children":["Scenario 3 — Più firmatari in parallelo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Due o più persone devono firmare, ma l'ordine non è rilevante. Ricevono tutte l'invito nello stesso momento e possono firmare in modo indipendente."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Signer)\n  ├── Alice\n  └── Bob\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alice e Bob ricevono l'invito contemporaneamente. La pratica non si completa finché entrambi non hanno firmato (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," = 2, che è anche il valore predefinito in presenza di due destinatari)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-4--firma-di-gruppo-n-di-m","__idx":19},"children":["Scenario 4 — Firma di gruppo (N di M)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nell'elenco sono presenti tre firmatari autorizzati, ma la firma di uno qualsiasi di essi è sufficiente per perfezionare l'accordo."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Signer) — requiredRecipientCompletions: 1\n  ├── Alice\n  ├── Bob\n  └── Carol\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tutti e tre ricevono l'invito nello stesso momento. La pratica avanza appena uno di essi firma. Per gli altri due non è più richiesta alcuna azione."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questo modello si utilizza anche per scenari a voto di maggioranza, per esempio richiedendo la firma di 3 membri del consiglio su 5."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-5--approvazione-interna-prima-della-firma-esterna","__idx":20},"children":["Scenario 5 — Approvazione interna prima della firma esterna"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un documento deve essere approvato da un revisore interno prima di essere inviato al cliente per la firma."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Approver)   →   Stage 2 (Signer)\n  └── Internal Manager       └── Customer\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il responsabile riceve il documento per primo e lo approva oppure lo respinge. Se lo approva, viene attivata la fase 2 e il cliente riceve il proprio invito alla firma. Se lo respinge, la pratica si arresta e il mittente riceve una notifica."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-6--firma-seguita-da-notifica-in-copia","__idx":21},"children":["Scenario 6 — Firma seguita da notifica in copia"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dopo che tutte le parti hanno firmato, un soggetto terzo (per esempio l'ufficio legale o un sistema di archiviazione) deve ricevere automaticamente una copia del documento completato."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Signer)   →   Stage 2 (CarbonCopy)\n  ├── Alice                └── Legal Team\n  └── Bob\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il destinatario della fase CarbonCopy non compie alcuna azione: riceve semplicemente la pratica come notifica una volta completate le fasi precedenti. È un modo pulito per garantire che le persone interessate siano informate senza obbligarle ad accedere o a interagire con il documento."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-7--più-fasi-con-tipi-differenti","__idx":22},"children":["Scenario 7 — Più fasi con tipi differenti"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un workflow complesso che combina approvazione, firma in parallelo e notifica:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Stage 1 (Approver)   →   Stage 2 (Signer)        →   Stage 3 (CarbonCopy)\n  └── Legal Reviewer       ├── Party A                  └── Archive System\n                           └── Party B\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il revisore legale approva per primo il documento. Entrambe le parti ricevono quindi il proprio invito contemporaneamente e devono firmare entrambe. Successivamente il sistema di archiviazione riceve automaticamente il documento completato."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"field-task","__idx":23},"children":["Field task"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I field task rappresentano il collegamento tra una posizione su un documento e un destinatario. Un task definisce:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quale tipo di interazione"]}," è prevista (una firma, una casella di controllo, un campo di testo e così via)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In quale punto del documento"]}," compare il campo (quale pagina e le coordinate x/y dell'angolo superiore sinistro del campo, espresse in unità di pagina PDF)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quanto è grande il campo"]}," (larghezza e altezza)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chi è responsabile"]}," del suo completamento (il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In quale ordine"]}," i campi vengono presentati al firmatario (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]},")"," ","I field task vengono impostati per ciascun file tramite una richiesta PUT. Questa chiamata è una sostituzione completa: definisce l'elenco integrale dei task per quel documento. Se viene richiamata una seconda volta con un elenco modificato, i task precedenti vengono interamente scartati e diventa effettivo il nuovo elenco."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tipi-di-campo","__idx":24},"children":["Tipi di campo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La proprietà ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldType"]}," di un field task determina ciò che il destinatario vede e ciò che è tenuto a fare:"]},{"$$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":"Tipo di campo"},"children":["Tipo di campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cosa fa"},"children":["Cosa fa"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario appone una firma. I metodi di firma consentiti sono controllati da ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," sul campo stesso."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TextInput"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario inserisce del testo (il mittente può impostare formati specifici, ad esempio data o numero)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Checkbox"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario seleziona o deseleziona una casella."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Radiobutton"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario seleziona uno dei pulsanti di opzione proposti."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DropDown"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario seleziona un valore da un menu a discesa predefinito."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ListBox"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario seleziona uno o più valori da un elenco visibile."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Attachment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario carica un file come parte della propria risposta."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AreaReadConfirmation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario deve confermare esplicitamente di avere letto un'area specifica all'interno di una pagina."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PageReadConfirmation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario deve confermare di avere letto un'intera pagina prima di procedere."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FileReadConfirmation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario deve confermare di avere letto l'intero documento."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Link"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra un collegamento cliccabile all'interno del documento, che tipicamente rimanda a una risorsa esterna che il destinatario deve consultare."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Approval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario approva facendo clic sul campo (meccanismo analogo a quello della firma ClickToSign)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campo-firma-e-metodi-di-firma-consentiti","__idx":25},"children":["Campo firma e metodi di firma consentiti"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specificamente per i campi ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Signature"]},", è possibile limitare i metodi di firma tra cui il destinatario può scegliere impostando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," sul campo. Se questo valore viene lasciato vuoto o null, viene applicata la configurazione predefinita dell'organizzazione."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I tipi di firma confermati sono:"]},{"$$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":"Tipo di firma"},"children":["Tipo di firma"]},{"$$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":["ClickToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario fa clic su un pulsante per confermare la propria firma: non è richiesto alcun tracciato né certificato."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DrawToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario traccia la propria firma con il mouse o su uno schermo touch."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TypeToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario digita il proprio nome, che viene reso come firma."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BiometricSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acquisisce dati biometrici (pressione, velocità, ritmo) durante il gesto di firma."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LocalCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario firma utilizzando un certificato conservato sul proprio dispositivo locale (ad esempio una smart card o un token USB)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DisposableCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Al momento della firma viene emesso un certificato qualificato monouso. Richiede una preconfigurazione sul destinatario."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RemoteCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il destinatario firma utilizzando un certificato conservato in un servizio di firma remota. Richiede una preconfigurazione sul destinatario."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OneTimePasswordSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un OTP inviato via SMS funge da firma. Richiede una preconfigurazione sul destinatario."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AutomaticSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La firma viene apposta senza alcuna interazione umana."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PluginSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La firma è gestita dall'integrazione di un plugin di terze parti. Richiede la configurazione del plugin sul destinatario."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questo aspetto è distinto da ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureConfiguration"]}," sul destinatario. L'attributo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," del campo controlla quali metodi vengono proposti nell'interfaccia. L'attributo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureConfiguration"]}," del destinatario fornisce i dati predisposti in anticipo richiesti dai metodi che ne hanno bisogno (certificato usa e getta, certificato remoto, firma con OTP, plugin di firma). Per tutti gli altri metodi è sufficiente la configurazione del campo: non è necessario impostare dati aggiuntivi sul destinatario."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"annotazioni","__idx":26},"children":["Annotazioni"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È possibile aggiungere le seguenti annotazioni:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Text",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Definisce un testo visibile al destinatario sul documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge la data al documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["FullName",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge il nome e cognome del destinatario al documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["FirstName",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge il nome del destinatario al documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["LastName",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge il cognome del destinatario al documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Initials",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge le iniziali del destinatario al documento"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Aggiunge l'indirizzo email del destinatario al documento"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"posizionamento-dei-campi","__idx":27},"children":["Posizionamento dei campi"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La posizione e la dimensione dei campi sono definite in unità di coordinate di pagina PDF:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["positionX"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["positionY"]}," sono le coordinate dell'angolo superiore sinistro del campo sulla pagina"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["width"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["height"]}," definiscono la dimensione del campo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," specifica su quale pagina del documento compare il campo (con indice a partire da 1)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"assegnazione-di-più-campi-allo-stesso-destinatario","__idx":28},"children":["Assegnazione di più campi allo stesso destinatario"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un singolo destinatario può avere più field task su uno o più documenti. La proprietà ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]}," controlla la sequenza con cui i campi gli vengono presentati durante la sessione di firma. I campi con valore di ordinamento più basso vengono mostrati per primi. Questo permette di guidare il firmatario attraverso il documento secondo un ordine logico, indipendentemente da dove i campi siano fisicamente posizionati sulla pagina."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"il-ciclo-di-vita-della-pratica","__idx":29},"children":["Il ciclo di vita della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una volta inviata, una pratica attraversa un insieme definito di stati:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"draft → sent → completed\n                ↘ rejected\n                ↘ expired\n                ↘ cancelled\n"},"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":"Stato"},"children":["Stato"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Significato"},"children":["Significato"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata creata ma non ancora inviata. Può ancora essere modificata."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["I destinatari sono stati notificati e il workflow è attivo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tutte le fasi obbligatorie sono state completate correttamente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un destinatario ha respinto il documento."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il termine è scaduto prima del completamento del workflow."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Il mittente ha interrotto manualmente il processo."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Una volta che una pratica raggiunge uno stato terminale (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]},") non può più essere modificata né fatta avanzare. I documenti firmati e l'audit trail diventano disponibili per il download dall'endpoint artifacts."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"utilizzo-dei-modelli-per-i-workflow-ricorrenti","__idx":30},"children":["Utilizzo dei modelli per i workflow ricorrenti"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se si invia ripetutamente la stessa struttura di documenti — le stesse fasi, la stessa disposizione dei campi, lo stesso ordine di firma — è possibile definire tutto questo una sola volta come modello. Quando serve una nuova pratica, la si crea dal modello con una sola chiamata API. La pratica risultante è una copia indipendente e, se necessario, può essere modificata prima dell'invio."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I modelli sono particolarmente utili quando:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il documento cambia ogni volta, ma la struttura del workflow è sempre la stessa."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["È necessario creare a livello programmatico molte pratiche in blocco."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si vuole imporre un processo di firma standard in tutta l'organizzazione."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"principi-di-progettazione-fondamentali","__idx":31},"children":["Principi di progettazione fondamentali"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alcuni aspetti da tenere presenti durante la progettazione dell'integrazione:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tutto è delimitato dall'organizzazione."]}," Tutte le chiamate API includono l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}," nel percorso. È l'identificatore del tenant e determina quali configurazioni, modelli e pratiche completate sono accessibili."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["I campi vengono assegnati ai destinatari, non alle fasi."]}," Il posizionamento di un campo firma richiede il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]}," specifico. Ciò significa che occorre prima aggiungere fasi e destinatari e solo dopo posizionare i field task."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["La chiamata di invio è il punto di non ritorno."]}," Fino a quando non si richiama l'endpoint di invio, la pratica resta in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}," e può essere modificata liberamente. Una volta inviata, il workflow è attivo e i destinatari vengono notificati."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Il completamento di una fase attiva automaticamente la fase successiva."]}," Non è necessario effettuare polling né far avanzare manualmente il workflow. Appena una fase raggiunge il numero richiesto di completamenti, l'API attiva la fase successiva e invia gli inviti al gruppo di destinatari successivo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per un workflow completo di una pratica, consultare la guida seguente: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-envelope-workflow"},"children":["Envelope-Workflow"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per un workflow completo di un modello, consultare la guida seguente:"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-template-workflow"},"children":["Template-Workflow"]}]}]},"headings":[{"value":"Guida ai workflow","id":"guida-ai-workflow","depth":1},{"value":"I componenti di base","id":"i-componenti-di-base","depth":2},{"value":"Documenti","id":"documenti","depth":2},{"value":"Caricamento dei file","id":"caricamento-dei-file","depth":3},{"value":"Approfondimento sulle fasi","id":"approfondimento-sulle-fasi","depth":2},{"value":"Esecuzione sequenziale","id":"esecuzione-sequenziale","depth":3},{"value":"Tipi di fase","id":"tipi-di-fase","depth":3},{"value":"Controllare quanti destinatari devono completare una fase","id":"controllare-quanti-destinatari-devono-completare-una-fase","depth":3},{"value":"Configurazione del destinatario","id":"configurazione-del-destinatario","depth":2},{"value":"Identità e dati di contatto","id":"identità-e-dati-di-contatto","depth":3},{"value":"Canali di notifica","id":"canali-di-notifica","depth":3},{"value":"Lingua","id":"lingua","depth":3},{"value":"Autenticazione","id":"autenticazione","depth":3},{"value":"Configurazione della firma","id":"configurazione-della-firma","depth":3},{"value":"Messaggio personale","id":"messaggio-personale","depth":3},{"value":"Scenari di workflow","id":"scenari-di-workflow","depth":2},{"value":"Scenario 1 — Firmatario unico","id":"scenario-1--firmatario-unico","depth":3},{"value":"Scenario 2 — Due firmatari in sequenza","id":"scenario-2--due-firmatari-in-sequenza","depth":3},{"value":"Scenario 3 — Più firmatari in parallelo","id":"scenario-3--più-firmatari-in-parallelo","depth":3},{"value":"Scenario 4 — Firma di gruppo (N di M)","id":"scenario-4--firma-di-gruppo-n-di-m","depth":3},{"value":"Scenario 5 — Approvazione interna prima della firma esterna","id":"scenario-5--approvazione-interna-prima-della-firma-esterna","depth":3},{"value":"Scenario 6 — Firma seguita da notifica in copia","id":"scenario-6--firma-seguita-da-notifica-in-copia","depth":3},{"value":"Scenario 7 — Più fasi con tipi differenti","id":"scenario-7--più-fasi-con-tipi-differenti","depth":3},{"value":"Field task","id":"field-task","depth":2},{"value":"Tipi di campo","id":"tipi-di-campo","depth":3},{"value":"Campo firma e metodi di firma consentiti","id":"campo-firma-e-metodi-di-firma-consentiti","depth":3},{"value":"Annotazioni","id":"annotazioni","depth":3},{"value":"Posizionamento dei campi","id":"posizionamento-dei-campi","depth":3},{"value":"Assegnazione di più campi allo stesso destinatario","id":"assegnazione-di-più-campi-allo-stesso-destinatario","depth":3},{"value":"Il ciclo di vita della pratica","id":"il-ciclo-di-vita-della-pratica","depth":2},{"value":"Utilizzo dei modelli per i workflow ricorrenti","id":"utilizzo-dei-modelli-per-i-workflow-ricorrenti","depth":2},{"value":"Principi di progettazione fondamentali","id":"principi-di-progettazione-fondamentali","depth":2}],"frontmatter":{"seo":{"title":"Guida ai workflow"}},"lastModified":"2026-10-13T11:28:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/workflow-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}