Dinaup DocsDocumentos para firmar
El metadato email_sign que envía un documento dinámico a Dinaup Sign, los firmantes que propone la plantilla y los límites que el servicio comprueba.
Un documento dinámico sale a firmar con el metadato email_sign. El visor cambia Enviar por email por Enviar a firmar, genera el PDF y abre el diálogo de firma con los firmantes que propone la plantilla.
Antes de empezar
- Licencia con Dinaup Sign. El diálogo y el seguimiento están en Firmas y en Firmar documentos.
- Un documento dinámico que ya imprime bien en PDF. Ver Mostrar e imprimir.
El metadato
F.MetaData_Set('titulo', F.Concat('Acuerdo de confidencialidad - ', v.ClienteNombre))
F.MetaData_Set('email_subject', F.Concat('Acuerdo de confidencialidad - ', v.EmpresaNombre))
F.MetaData_Set('email_to', v.ClienteEmail)
F.MetaData_Set('email_to_name', v.ClienteNombre)
F.MetaData_Set('email_sign', '1')email_sign acepta 1, s, si, sí, true o yes. Cualquier otro valor lo deja desactivado. Es el bloque de metadatos de la plantilla RGPD de DemoUp; NDA y Firma Prueba llevan el mismo.
Firmar y enviar por email se excluyen
Con email_sign el visor no ofrece el botón de correo. El aviso al firmante lo envía Dinaup Sign con su enlace personal; un segundo correo con el PDF adjunto solo serviría para firmar el adjunto equivocado. Tras enviar, el botón pasa a Enviado a firmar y se desactiva.
Los firmantes
| Firmante | Nombre | |
|---|---|---|
| 1 | email_to | email_to_name |
| 2 | email_to_2 | email_to_name_2 |
| 3 a 10 | email_to_3 a email_to_10 | email_to_name_3 a email_to_name_10 |
Del segundo en adelante valen también email_para_N y email_para_nombre_N. El tope es FirmaService.MaxFirmantes, que vale 10. Un número vacío en la serie no corta la lista: con el 2 y el 4 rellenos entran los dos.
La plantilla solo propone los firmantes: quien envía los corrige en el diálogo antes de crear el sobre.
Lo que comprueba el servicio
FirmaService rechaza el sobre con estos mensajes:
| Regla | Mensaje |
|---|---|
| Título obligatorio y de 200 caracteres como máximo | El título es obligatorio y no puede pasar de 200 caracteres. |
| Entre 1 y 10 firmantes | Hacen falta entre 1 y 10 firmantes. |
| Todos con nombre | Todos los firmantes necesitan un nombre. |
| El email, si va, una sola dirección válida y sin comas | Alguno de los emails de firmante no es válido. |
| PDF entre 5 bytes y 20 MB | El PDF debe pesar entre 5 bytes y 20 MB. |
El título del sobre es email_subject; sin él, el nombre del documento. Un asunto construido con F.Concat de varios campos puede pasar de 200 caracteres: comprueba su longitud.
| Metadato | Al firmar |
|---|---|
email_subject | Título del sobre: lo ve el firmante en el correo y en la pantalla de firma. |
email_attachment_name | Nombre del PDF. Si no termina en .pdf, Play lo añade. Sin él se usa titulo. |
email_body | Se ignora. El correo lo compone Dinaup Sign. |
email_from | Se ignora. Los avisos salen de Dinaup Sign. |
El PDF
El PDF lo genera el mismo servicio que el adjunto del correo: Cómo convierte Dinaup a PDF. Declara el margen en la plantilla:
@page { size: A4; margin: 14mm 14mm 12mm; }Usa @page { margin } y no el padding del contenedor. El padding de un bloque que ocupa varias páginas solo se aplica al inicio de la primera y al final de la última.
Qué no lleva un documento para firmar
| No pongas | Por qué |
|---|---|
| Campos de formulario | El firmante ve el PDF en el navegador. Lo que teclee encima no se guarda y firma el documento en blanco. |
| Recuadros de firma | La firma no se estampa sobre el documento. firmado.pdf es el original intacto más las páginas del certificado de firmas; dossier.pdf es la cronología de evidencias. |
| Datos por completar | El PDF recoge los datos del momento del envío. Su huella entra en la cadena de evidencias y lo que cambie después en el ERP no cambia el documento firmado. |
| Espacios por rellenar | Un campo opcional vacío dentro de una cláusula se lee como algo por rellenar. Ponle un condicional. |
Identifica a las partes dentro del texto, con nombre y documento de identidad. Los firmantes del sobre son un dato administrativo que no se imprime.
Prueba en el PDF
Los márgenes perdidos y los bloques partidos solo se ven en el PDF. Genera uno con un registro real antes de publicar la plantilla y comprueba el nombre del fichero en el diálogo de firma.
Siguiente: Envío de emails. Pantalla: Firmas.