Crea firmas electrónicas incrustadas y experiencias con documentos

Aprende a utilizar las API de Acrobat Sign para insertar firmas electrónicas y experiencias de documentos en tus plataformas web y sistemas de gestión de contenidos y documentos. Este tutorial práctico consta de cuatro partes.

Parte 1: Lo que necesitas

En la parte 1, aprenda a empezar con todo lo que necesita para las partes 2-4. Vamos a empezar a obtener credenciales de API.

Ver detalles sobre cómo obtener credenciales de API

Parte 2: Código bajo/sin: el poder de los formularios web

En la parte 2, explore la opción de usar o no usar código para usar formularios web. Siempre es una buena idea ver si puedes evitar escribir código al principio.

Ver detalles sobre cómo crear un formulario web
  1. Accede a Acrobat Sign con tu cuenta de desarrollador.

  2. Seleccione Publish en un formulario web en la página principal.

    Captura de pantalla de la página principal de Acrobat Sign

  3. Cree su acuerdo.

    Captura de pantalla de cómo crear un formulario web

  4. Incruste el acuerdo en una página plana del HTML.

  5. Experimente con la adición dinámica de parámetros de consulta.

    Captura de pantalla de adición de parámetros de consulta

Parte 3: Enviar un acuerdo con un formulario y combinar datos

En la parte 3, cree acuerdos dinámicamente.

Ver detalles sobre cómo crear acuerdos dinámicamente

En primer lugar, debe establecer el acceso. Con Acrobat Sign, hay dos formas de conectarse mediante API. Tokens de OAuth y claves de integración. A menos que tenga una razón muy específica para utilizar OAuth con la aplicación, debe explorar primero las claves de integración.

  1. Seleccione Clave de integración en el menú Información de API de la pestaña Cuenta en Acrobat Sign.

    Captura de pantalla de dónde se encuentra la clave de integración

Ahora que tiene acceso a la API y puede interactuar con ella, consulte lo que puede hacer con ella.

  1. Vaya a los Métodos de la versión 6 de la API REST de Acrobat Sign.

    Captura de pantalla de cómo navegar por los métodos de la versión 6 de la API REST de Acrobat Sign

  2. Utilice el distintivo como valor "al portador".

    Captura de pantalla del valor al portador

Para enviar su primer acuerdo, lo mejor es saber cómo utilizar la API.

  1. Cree un documento transitorio y envíelo.
note note
NOTE
Las llamadas de solicitud basadas en JSON tienen las opciones "Modelo" y "Esquema de modelo mínimo". Esto proporciona especificaciones y un conjunto mínimo de carga útil.

Captura de pantalla de la creación de un documento transitorio

Después de enviar un acuerdo por primera vez, ya puede añadir la lógica. Siempre es una buena idea establecer algunos ayudantes para minimizar la repetición. A continuación se muestran algunos ejemplos:

Validación

Captura de pantalla de la lógica de validación

Encabezados/Autenticación

Captura de pantalla de la lógica de encabezados/autenticación

URI base

Captura de pantalla de la lógica del URI base

Tenga en cuenta dónde se incluyen los documentos transitorios en el esquema general del ecosistema de Sign.
Transitorio -> Acuerdo
Transient -> Template -> Agreement
Transient -> Widget -> Agreement

En este ejemplo se utiliza una plantilla como origen de documento. Esta suele ser la mejor opción, a menos que tenga una razón sólida para generar dinámicamente documentos para su firma (por ejemplo, código heredado o generación de documentos).

El código es bastante sencillo; utiliza un documento de biblioteca (plantilla) para el origen del documento. El primer y el segundo firmante se asignan dinámicamente. El estado IN_PROCESS significa que el documento se envía inmediatamente. Además, mergeFieldInfo se aprovecha para rellenar campos de forma dinámica.

Captura de pantalla de código para agregar firmas dinámicamente

Parte 4: Incorpora la experiencia de firma, las redirecciones y mucho más

En muchos casos, es posible que desee permitir que el participante que realiza la activación firme inmediatamente un acuerdo. Esto resulta útil para aplicaciones y quioscos orientados al cliente.

Ver detalles sobre cómo incrustar la experiencia de firma

Si no desea que se active el primer envío de correo electrónico, una forma sencilla es administrar el comportamiento mediante una modificación de la llamada de la API.

Captura de pantalla de código para no desencadenar el envío de correo electrónico

A continuación se indica cómo controlar la redirección posterior a la firma:

Captura de pantalla de código para controlar la redirección posterior a la firma

Después de actualizar el proceso de creación del acuerdo, el paso final es generar la URL de firma. Esta llamada también es bastante sencilla y genera una dirección URL que un firmante puede utilizar para acceder a su parte del proceso de firma.

Captura de pantalla de código para generar una URL de firmante

note note
NOTE
Tenga en cuenta que la llamada de creación del acuerdo es técnicamente asincrónica. Esto significa que se puede realizar una llamada al acuerdo "POST", pero el acuerdo aún no está listo. La práctica recomendada es establecer un bucle de reintento. Utilice un reintento o lo que sea la práctica recomendada para su entorno.

Captura de pantalla que indica que es recomendable establecer un bucle de reintento

Cuando todo se junta, la solución es bastante sencilla. Está realizando un acuerdo y, a continuación, generando una URL de firma para que el firmante haga clic en él y comience el ritual de firma.

Temas adicionales

recommendation-more-help
ac8d3f8e-a625-4146-84f3-0eb730a583a3