Escanear PDF417 para rellenar tus formularios

Nueva funcionalidad en Viafirma Documents para optimizar los tiempos empleados en completar formularios y mejorar la calidad de los datos recopilados.

El nuevo ÍTEM del tipo scan permite la lectura de un PDF417 y la transcripción de los datos obtenidos a otros campos del formulario. 

Un ejemplo de uso de este tipo de código PDF-417 se da en algunos documentos de identidad, como la cédula colombiana, que incorpora en su parte trasera este código que contiene información pública del ciudadano y que podrás trasladar automáticamente a tu formulario.

 

Configuración y uso

Para el uso de esta funcionalidad podrás configurar tus formularios, como es habitual, de dos formas: en el diseñador de formularios que encontrarás en el panel de gestión de tus plantillas, o directamente en la definición del servicio cuando lo consumes a través de API.

Configuración desde el diseñador

En la gestión de plantillas, módulo formularios, podrás editar las propiedades de tu formulario, incorporando un ítem del tipo «Scan». Este tipo te permitirá definir un comportamiento predeterminado para los posibles valores soportados en distintas plantillas de 417 que se irán incorporando al producto.

Por ejemplo, la plantilla «Cédula Colombia» te permitirá extraer los siguientes datos:

raw, number, name1, name2, name, surname1, surname2, surname, fullname, birthdate, birth_day, birth_month, birth_year, gender, bloodtype

y asociarlos a los campos de tu formulario. La opción «ocultar el campo de texto del elemento scan» te permitirá imprimir el valor capturado tras el escaneo, y te resultará útil durante la etapa de configuración de tu formulario.

Uso mediante API

La configuración interna del formulario para que puedas hacer uso de la funcionalidad scan debe incorporar los siguientes metadatos.

{
"key" : "<your_key_id>",
"type" : "scan",
"label" : "<your_label_text>",
"size" : "<your_size>",
"scanTypes" : [ "PDF417" ],
"scanHideTextfield" : false|true,
"scanExpression" : "<your_expression>"
}
Ejemplo JSON
{
"key" : "cedula_scan",
"type" : "scan",
"label" : "Enfoca el código trasero de la cédula",
"size" : "100",
"scanTypes" : [ "PDF417" ],
"scanHideTextfield" : false,
"scanExpression" : "fullname|nombre_completo;number|cedula"
}

reserva tu cita