Automatizzare i flussi di lavoro legali

In uno scenario ideale, i termini dell’accordo vengono accettati senza alcuna modifica. Spesso, tuttavia, gli accordi devono essere personalizzati, per essere poi sottoposti a revisione legale. Le revisioni legali creano costi significativi e rallentano il processo di consegna dei termini degli accordi. L’utilizzo di modelli predefiniti che cambiano in base al linguaggio approvato aiuta i team legali a gestire ed eseguire in modo più sicuro i termini degli accordi.

Questo tutorial utilizza un accordo legale che varia da stato a stato. Per risolvere queste variazioni, viene creato un modello di accordo con sezioni condizionali, che vengono incluse solo quando vengono soddisfatti determinati criteri. Il documento generato può essere un documento Word o PDF. È inoltre possibile apprendere alcuni dei modi per proteggere il documento utilizzando l’API di Adobe PDF Services o Acrobat Sign.

Ottieni credenziali

Per iniziare, registra le credenziali gratuite dei servizi Adobe PDF:

I tuoi dati

In questo scenario, vengono passate informazioni per facilitare la generazione del documento e per informare se determinate sezioni devono essere incluse o meno:

{
    "customer": {
        "name": "Home Services Company",
        "street": "123 Any Street",
        "city": "Anywhere",
        "state": "CA",
        "zip": "12345",
        "country":"USA",
        "signer": {
            "email": "johnnyechostone@gmail.com",
            "firstName": "John",
            "lastName": "Echostone"
        }
    },
    "company": {
        "name": "Projected Consultants",
        "signer": {
            "email": "maryburostone@gmail.com",
            "firstName": "Mary",
            "lastName": "Burostone"
        }
    },
    "conditions": {
        "includeGeneralTerms": true,
        "includeConsumerDiscloure": true
    }
}

Nei dati sono presenti informazioni sul cliente, sul suo nome, su chi firma, sullo stato in cui si trova e così via. Inoltre, sono disponibili sezioni per le informazioni sulla società che genera l’accordo e flag di condizioni utilizzati per includere determinate sezioni dell’accordo.

Aggiungere tag di base al documento

In questo scenario viene utilizzato un documento Termini e condizioni che può essere scaricato qui.

Passate al pannello Document Generation Tagger per inserire i tag nel documento.

Inserire il nome dell'azienda

In questo modo viene inserito un tag denominato {{company.name}} perché il tag si trova sotto quel percorso nel file JSON.

{
    "company": {
        "name": "Projected Consultants",
        ...
    }
    ...
}

Ripetere quindi questo passaggio nella sezione di apertura per il testo CUSTOMER. Ripeti i passaggi 1-4, sostituendo CUSTOMER con "name" in Customer. L'output deve essere {{customer.name}}, a indicare che il testo proviene da sotto l'oggetto cliente.

L’API di Document Generation di Adobe consente inoltre di includere i tag nelle intestazioni e nei piè di pagina e alla fine della pagina, dove devono essere inseriti i titoli delle firme.

Ripetere nuovamente questa procedura con passaggi 1-4 per il testo AZIENDA e CLIENTE nel piè di pagina.

Infine, è necessario ripetere i passaggi 1-4 per sostituire FIRST NAME e LAST NAME nella sezione Customer della pagina della firma rispettivamente con i tag per {{customer.signer.firstName}} e {{customer.signer.lastName}}. Non preoccuparti se il tag è lungo e torna alla riga successiva perché il tag viene sostituito quando viene generato il documento.

L’inizio del documento e il piè di pagina dovrebbero essere simili al seguente:

Ora che i tag sono stati inseriti nel documento, puoi visualizzare in anteprima l’accordo generato.

Visualizzare in anteprima il documento generato

Direttamente in Microsoft Word, puoi visualizzare in anteprima il documento generato in base ai dati JSON di esempio.

Aggiungere termini condizionali per ciascuno stato

In questa sezione seguente vengono impostate solo determinate sezioni da includere in base a determinati criteri dei dati di input. Nel documento di esempio, le sezioni 4 e 5 riguardano solo uno stato specifico. Per questo scenario, quando un cliente risiede in quello stato, devono essere incluse solo le condizioni specifiche dello stato. Inoltre, la numerazione in Microsoft Word non deve includere quella sezione se viene rimossa. Utilizza la funzione Condizionale del contenuto dell’API di Document Generation per aggiungere tag.

La sezione è ora completata con alcuni tag denominati tag di sezione condizionale. Quando li avete aggiunti, è possibile che il tag di sezione condizionale sia stato aggiunto come riga numerata. Puoi rimuoverla spostando la barra rovesciata prima del tag, altrimenti numererà gli elementi come se il tag non fosse presente quando viene generato il documento. La sezione condizionale termina con il tag {% end-section %}.

Ripetere i passaggi 1-7 per la sezione Informativa di Washington, sostituendo il valore CA con WA per indicare che la sezione viene visualizzata solo se lo stato del cliente è Washington.

Test con sezioni condizionali

Una volta posizionate le sezioni condizionali, potete visualizzare in anteprima il documento selezionando Genera documento.

Quando si genera il documento, si noti che la sezione inclusa è solo quella che soddisfa i criteri relativi ai dati. Nell'esempio seguente, poiché lo stato è uguale a CA, viene inclusa solo la sezione California.

Un’altra modifica rilevante è che la numerazione della sezione successiva, Uso dei Servizi e del Software, ha il numero 5. Ciò significa che quando la sezione Washington viene omessa, la numerazione continua.

Per verificare se il modello funziona correttamente quando il cliente si trova nello stato di Washington anziché in California, modificare i dati di esempio per il modello:

Notate che il documento include solo la sezione Stato di Washington.

Aggiunta di una frase condizionale

Come le sezioni condizionali, potete anche avere frasi specifiche che vengono incluse quando vengono soddisfatte determinate condizioni. In questo esempio, la politica di restituzione è diversa tra California e Washington.

Anche se il nome del tag è lo stesso, la differenza principale tra Frase e Sezione è che una frase ha la sezione che non include nuove righe. Il tag di sezione della condizione e il tag di sezione finale devono trovarsi nello stesso paragrafo.

Aggiungere tag per Acrobat Sign

Acrobat Sign consente di inviare accordi da firmare o incorporarli nell’esperienza web in modo che altri utenti possano visualizzarli e firmarli facilmente. Adobe di Document Generation Tagger in Microsoft Word consente di applicare facilmente i pre-tag ai documenti prima che vengano inviati con Acrobat Sign, in modo da posizionare sempre le firme nella posizione corretta. In questo scenario, due firmatari devono disporre di un luogo in cui firmare e datare il documento.

In questo modo viene inserito un campo firma che deve essere firmato dal primo firmatario.

Quindi, inserisci un campo dati per il firmatario che verrà compilato automaticamente quando firma.

Il tag Date posizionato è piuttosto lungo: {{Date 3_es_:signer1:date:format(mm/dd/yyyy):font(size=Auto)}}. Il tag di testo di Acrobat Sign deve rimanere sulla stessa riga, il che è diverso dai tag di Document Generation. I parametri :format() e font() sono facoltativi, pertanto per questo scenario è possibile ridurre il tag a {{Date 3_es_:signer1:date}}.

Ripeti i passaggi precedenti la sezione Firma aziendale. In questo caso, è necessario modificare il campo Destinatari in Firmatario-2, altrimenti tutti i campi firma vengono assegnati alla stessa persona.

Generare l’accordo

Ora hai aggiunto i tag al documento e sei pronto per iniziare. In questa sezione successiva, scoprite come generare un documento utilizzando gli esempi di API di Document Generation per Node.js. Questi esempi funzionano in qualsiasi lingua.

Aprire il file master pdfservices-node-sdk-samples scaricato durante la registrazione delle credenziali. Questi file includono i file pdfservices-api-credentials.json e private.key.

Il file di output si trova nella cartella /output con il documento generato correttamente.

È possibile modificare il formato cambiando la riga seguente. Il formato DOCX è utile se il documento verrà inviato per la modifica in Word o per la revisione del contratto.

PDF:

options = new documentMergeOptions.DocumentMergeOptions(jsonDataForMerge,
documentMergeOptions.OutputFormat.PDF);

Parola:

options = new documentMergeOptions.DocumentMergeOptions(jsonDataForMerge, documentMergeOptions.OutputFormat.DOCX);

È inoltre necessario modificare il nome del file di output in formato .pdf o .docx rispettivamente per il formato di output PDF o DOCX:

var outputFileName = path.join('output', 'salesOrder_'+Date.now()+".docx");

Inviare un accordo per la firma

Adobe Acrobat Sign consente di inviare gli accordi a uno o più destinatari che potranno così visualizzare e firmare i documenti. Oltre a un’esperienza utente di facile utilizzo per inviare un documento per la firma, sono disponibili API REST che consentono di accettare Word, PDF, HTML e altri formati e di inviarli per la firma.

L’esempio seguente spiega come utilizzare la pagina della documentazione API REST per acquisire il documento generato in precedenza e inviarlo per la firma. Scopri innanzitutto come farlo tramite l’interfaccia web di Acrobat Sign e quindi come farlo con l’API REST.

Ottieni un account Acrobat Sign

Se non disponi di un account Acrobat Sign, registrati per un account sviluppatore e consulta la documentazione qui, quindi seleziona Registrazione account sviluppatore. Ti verrà richiesto di compilare un modulo e di ricevere un’e-mail di verifica. Una volta effettuata questa operazione, verrai reindirizzato a un sito Web per impostare la password e l’account, da cui potrai quindi accedere ad Acrobat Sign.

Inviare un accordo da un’interfaccia web

Viene inviato un messaggio e-mail al firmatario successivo. Ripeti i passaggi 9-16 per visualizzare e firmare per il secondo firmatario.

Una volta completato l’accordo, una copia firmata dell’accordo viene inviata tramite e-mail a ciascuna delle parti. Inoltre, è possibile recuperare un accordo firmato dall’interfaccia Web di Acrobat Sign nella pagina Gestisci.

Scopri quindi come eseguire lo stesso scenario tramite la documentazione delle API REST.

Ottieni credenziali

Viene quindi aggiunto un token di connessione al campo Autorizzazione.

Per ulteriori informazioni sulla creazione di un token di autorizzazione per Acrobat Sign, segui il passaggio descritto qui.

Caricare un documento transitorio

Poiché il token di autorizzazione viene aggiunto dai passaggi precedenti, è necessario caricare un documento per effettuare la chiamata API:

transientDocumentId viene utilizzato per fare riferimento a un documento archiviato temporaneamente in Acrobat Sign in modo che possa essere utilizzato nelle chiamate API successive.

Inviare per la firma

Una volta caricato un documento, è necessario inviare l’accordo per la firma.

L’API POST agreements restituisce un ID per l’accordo. Per ottenere un modello per lo schema del modello JSON, selezionare Schema modello minimo. Nella sezione Schema modello completo è disponibile un elenco completo dei parametri.

Verifica lo stato dell’accordo

Una volta ottenuto l’ID di un accordo, puoi inviare lo stato dell’accordo.

Ora hai informazioni su quell’accordo.

{
    "id": "CBJCHBCAABAAc6LyP4SVuKXP_pNstzIzyripanRdz4IB",
    "name": "Terms and Conditions",
    "groupId": "CBJCHBCAABAAoyMb1yIgczAGhBuJeHf99mglPtM7ElEu",
    "type": "AGREEMENT",
    "participantSetsInfo": [
      {
        "id": "CBJCHBCAABAAzZE-IcHHkt05-AVbxas4Jz7DUl3oEBO6",
        "memberInfos": [
          {
            "email": "adobesigndemo+customer@outlook.com",
            "id": "CBJCHBCAABAAyWgMMReqbxUFM7ctI5xz16c2kOmEy-IQ",
            "securityOption": {
              "authenticationMethod": "NONE"
            }
          }
        ],
        "role": "SIGNER",
        "order": 1
      },
      {
        "id": "CBJCHBCAABAAaRHz3gY2W0w5n_6pj1GMMuZAfhBihc1j",
        "memberInfos": [
          {
            "email": "adobesigndemo+company@outlook.com",
            "id": "CBJCHBCAABAAOZQwjPwJXFiX8YDKPYtzMpftsmxYrIo9",
            "securityOption": {
              "authenticationMethod": "NONE"
            }
          }
        ],
        "role": "SIGNER",
        "order": 1
      }
    ],
    "senderEmail": "adobesigndemo+new@outlook.com",
    "createdDate": "2022-03-22T02:59:36Z",
    "lastEventDate": "2022-03-22T02:59:41Z",
    "signatureType": "ESIGN",
    "locale": "en_US",
    "status": "OUT_FOR_SIGNATURE",
    "documentVisibilityEnabled": true,
    "hasFormFieldData": false,
    "hasSignerIdentityReport": false,
    "documentRetentionApplied": false
  }

Il metodo più efficiente per ricevere notifiche quando gli aggiornamenti vengono modificati è tramite i webhook, che puoi scoprire di più su [qui] (https://opensource.adobe.com/acrobat-sign/developer_guide/webhookapis.html.

Memorizzare un documento firmato

Una volta firmato, il documento può essere recuperato utilizzando il file GET /agreements/combinedDocument.

È possibile impostare parametri aggiuntivi per allegare un report di audit o documenti di supporto utilizzando i parametri attachSupportingDocuments e attachAuditReport.

Nel corpo della risposta, può quindi essere scaricato nel computer e archiviato dove preferisci.

Altre opzioni

Oltre a generare un documento e inviarlo per la firma, sono disponibili azioni aggiuntive.

Ad esempio, se il documento non ha una firma, l’API di Adobe PDF Services offre numerosi modi per trasformare i documenti dopo la generazione dell’accordo, come:

Inoltre, Acrobat Sign offre diverse funzioni aggiuntive, quali:

Ulteriori informazioni

Vuoi saperne di più? Scopri altri modi per utilizzare Adobe Acrobat Services: