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.
-
Python 3.x
- Mac: Homebrew
- Linux: instalador incorporado
- Windows: Chocolatey
- Todos: https://www.python.org/downloads/
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.
-
Accede a Acrobat Sign con tu cuenta de desarrollador.
-
Seleccione Publish en un formulario web en la página principal.
-
Cree su acuerdo.
-
Incruste el acuerdo en una página plana del HTML.
-
Experimente con la adición dinámica de parámetros de consulta.
Parte 3: Enviar un acuerdo con un formulario y combinar datos
En la parte 3, cree 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.
-
Seleccione Clave de integración en el menú Información de API de la pestaña Cuenta en Acrobat Sign.
Ahora que tiene acceso a la API y puede interactuar con ella, consulte lo que puede hacer con ella.
-
Vaya a los Métodos de la versión 6 de la API REST de Acrobat Sign.
-
Utilice el distintivo como valor "al portador".
Para enviar su primer acuerdo, lo mejor es saber cómo utilizar la API.
- 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. |
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
Encabezados/Autenticación
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.
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.
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.
A continuación se indica cómo 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.
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. |
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
-
Eventos de webhook
-
Recordatorios personalizados
-
Con la creación inicial
-
O agrega un vuelo
-