Viafirma Documents – Versión 3.7.28

La versión 3.7.28 de Viafirma Documents trae las siguientes novedades:

Nuevas funcionalidades

Búsqueda de solicitudes por destinatario. Ahora podrás buscar más fácilmente una solicitud por el correo del destinatario situado en la sección del menú “Todas”:

Novedades en el módulo de Firma Web

"hideImageUpload": "true | false"
"hideImageCapture": "true | false"
hideOpenInApp: false

Ambas opciones podrán modificarse desde la sección “Mis estilos” en la Hoja de estilo de la pantalla de firma:

** Recuerda que en cada sección encontrarás enlaces de ayuda que podrás localizar fácilmente

Integradores – Mejoras y Novedades en el API

Para configurar esta funcionalidad las evidencias deben contener un código para su agrupación: 

Ejemplo json con ambas opciones:

{
   "groupCode":"viafirma",
   "title":"my SET title",
   "description":"my SET description",
   "autoFinalize":"true",
   "recipients":[
      {
         "key":"signer1",
         "phone":"+34xxxxxxxx5",
         "mail":"xxxxx@viafirma.com",
         "name":"Nombre firmante 1",
         "id":"DNI o Cédula firmante 1"
      }
   ],
   "customization":{
      "requestMailSubject":"Contrato listo para firmar",
      "requestMailBody":"Hola {{recipient.name}}. <br /><br />Ya puedes revisar y firmar el contrato. 
                         Haz click en el siguiente enlace y sigue las instrucciones.",
      "requestSmsBody":"En el siguiente link puedes revisar y firmar el contrato"
   },
   "messages":[
      {
         "notification":{
            "text":"Solicitud de firma de {{signer1.name}}"
         },
         "policies":[
            {
               "signatures":[
                  {
                     "type":"SERVER",
                     "helpText":"Documento certificado por Viafirma Documents (Servicios 
de Confianza)",
                     "typeFormatSign":"PADES_LT",
                     "stampers":[
                        {
                           "type":"TEXT",
                           "rotation":"ROTATE_270",
                           "width":36,
                           "height":291,
                           "xAxis":0,
                           "yAxis":302,
                           "page":1
                        }
                     ]
                  }
               ],
               "evidences":[
                  {
                     "type":"OTP_SMS",
                     "helpText":"Validación de SMS enviada al número {{signer1.phone}}",
                     "recipientKey":"signer1",
                     "metadataList":[
                        {
                           "key":"phoneNumber",
                           "value":"{{signer1.phone}}",
                           "internal":false
                        },
                        {
                           "key":"smsText",
                           "value":"Código de firma del documento",
                           "internal":false
                        },
                        {
                           "key":"groupCode",
                           "value":"batch_code",
                           "internal":false
                        }
                     ],
                     "positions":[
                        {
                           "rectangle":{
                              "x":255,
                              "y":289,
                              "width":100,
                              "height":50
                           },
                           "page":1
                        }
                     ]
                  }
               ]
            }
         ],
         "document":{
            "templateCode":"batch_otp_sms",
            "templateType":"url",
            "templateReference":"https://www.viafirma.com/download/documents/doc_demo.pdf"
         }
      },
      {
         "notification":{
            "text":"Solicitud de firma 2"
         },
         "policies":[
            {
               "signatures":[
                  {
                     "type":"SERVER",
                     "helpText":"Documento certificado por Viafirma Documents (Servicios de 
Confianza)",
                     "typeFormatSign":"PADES_LT",
                     "stampers":[
                        {
                           "type":"TEXT",
                           "rotation":"ROTATE_270",
                           "width":36,
                           "height":291,
                           "xAxis":0,
                           "yAxis":302,
                           "page":1
                        }
                     ]
                  }
               ],
               "evidences":[
                  {
                     "type":"OTP_SMS",
                     "helpText":"Validación de SMS enviada al número {{signer1.phone}}",
                     "recipientKey":"signer1",
                     "metadataList":[
                        {
                           "key":"phoneNumber",
                           "value":"{{signer1.phone}}",
                           "internal":false
                        },
                        {
                           "key":"smsText",
                           "value":"Código de firma del documento",
                           "internal":false
                        },
                        {
                           "key":"groupCode",
                           "value":"batch_code",
                           "internal":false
                        }
                     ],
                     "positions":[
                        {
                           "rectangle":{
                              "x":255,
                              "y":289,
                              "width":100,
                              "height":50
                           },
                           "page":1
                        }
                     ]
                  }
               ]
            }
         ],
         "document":{
            "templateCode":"batch_otp_sms",
            "templateType":"url",
            "templateReference":"https://www.viafirma.com/download/documents/doc_demo.pdf"
         }
      }
   ]
}

JSON de ejemplo:

{
    "groupCode": "codigo_grupo",
    "title" : "my SET title",
    "description" : "my SET description",
    "recipients":
    [
        {
            "key": "USER_01",
            "mail": "xxx@viafirma.com",
            "name": "Nombre firmante 1",
            "id": "DNI o Cédula firmante 1",
            "userCode": "user_code1",
            "order":1,
            "deviceCode": "deviceCode1" 
        },
        {
            "key": "USER_02",
            "mail": "xxx2@viafirma.com",
            "name": "Nombre firmante 2",
            "id": "DNI o Cédula firmante 2",
            "userCode": "userCode2",
            "order":2,
            "deviceCode": "deviceCode2" 
        }
    ],
    "customization":
    {
        "requestMailSubject": "Contrato listo para firmar",
        "requestMailBody": "Hola {{recipient.name}}. <br /><br />Ya puedes revisar 
        y firmar el contrato. Haz click en el siguiente enlace y sigue las instrucciones.",
        "requestSmsBody": "En el siguiente link puedes revisar y firmar el contrato" 
    },
    "messages":
    [
        {
            "document":
            {
                "templateCode": "codigo_plantilla" 
            }
        },
        {
            "document":
            {
                "templateCode": "codigo_plantilla" 
            }
        }
    ]
}

Correcciones y/o mejoras