# Card Scan ## Introducción El **GBS CardScan** es una aplicación web para la captura de fichas de identificación con datos biométricos tales como huellas dactilares, huellas palmares, fotos faciales, firmas y datos biográficos textuales. La aplicación captura los datos de las fichas y los registra en la base de datos biométrica del GBS. Emplea extracción de campos flexible y configurable, permitiendo operar con múltiples modelos de fichas. Este manual está actualizado para la versión 1.6.2 de CardScan. ### Acceso y Autenticación Debe acceder a CardScan con un navegador y recomendamos Google Chrome. La URL de acceso es específica para cada entorno. {% hint style="info" %} Si es necesario, póngase en contacto con el equipo de soporte de Griaule para obtener la URL correcta. {% endhint %} La autenticación es necesaria para acceder a la aplicación. Las credenciales necesarias para CardScan son nombre de usuario y contraseña. ![](/files/358c504a5158aa9106fc96137d985ca2de3d74b5) {% hint style="info" %} En la parte inferior de la pantalla hay una opción para cambiar el idioma al deseado. Esta opción también está disponible en la configuración después del inicio de sesión. {% endhint %} ### Autenticación de dos factores (2FA) Cuando la autenticación de dos factores (2FA) esté activada, la primera vez que inicie sesión, tras introducir su usuario y contraseña, se mostrará un código QR que debe registrarse en Google Authenticator. {% hint style="info" %} Google Authenticator es un generador de códigos de autenticación disponible como aplicación para smartphones [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2\&hl=en\&gl=US) y [iOS](https://apps.apple.com/us/app/google-authenticator/id388497605). {% endhint %} ![Código QR de Google Authenticator para autenticación de dos factores](/files/2e0c96239aed26e9fe8b8a27e8ed53eff45de569) Después de registrar con éxito el código QR en Google Authenticator, introduzca el código de seis dígitos generado y haga clic en Enviar. Solo necesitará registrar el código QR una vez. Pero, en cada inicio de sesión posterior, tendrá que introducir el código de seis dígitos generado por Google Authenticator. ![Autenticación de dos factores](/files/57fe0cb402e1e2bb35e3c1d89a64e89187340894) Existe un número limitado de intentos de inicio de sesión fallidos que un usuario puede realizar. Siempre que se introduzca un código incorrecto, se mostrará un mensaje de error: ![Autenticación de dos factores - código incorrecto](/files/9cf1031115a3106a44e728aa58342fd7073ed873) Si alcanza el número máximo de intentos de inicio de sesión fallidos, su cuenta será bloqueada automáticamente. ![Autenticación de dos factores - cuenta bloqueada](/files/90768b6da3fa6e52a31db896c15c99efc2a74e94) {% hint style="warning" %} Si su cuenta está bloqueada, póngase en contacto con el administrador del sistema. {% endhint %} ### Inicios de sesión simultáneos y Registro de Navegador Solo se permite una sesión por usuario. No es posible iniciar sesión simultáneamente con el mismo perfil más de una vez en la aplicación. Si un usuario ya está conectado y se produce otro acceso usando el mismo nombre de usuario y contraseña, el usuario con la sesión más antigua será notificado y desconectado en la próxima acción. ![](/files/8cf209a51232b583d5eca3f18bef8d83bce59a0b) Además, solo se puede usar un navegador a la vez. Al intentar iniciar sesión usando un navegador diferente, se informará al usuario que es necesario autenticar el nuevo navegador. La autenticación de un nuevo navegador revocará el acceso del navegador anterior. ![](/files/d6537389a52d3ce517870b9e7c6665adda7cd909) Para autenticar un nuevo navegador, haga clic en Autenticar y, a continuación, introduzca el código de verificación que será enviado al correo electrónico vinculado a la cuenta del usuario. ![](/files/3c664c97c8815df0f6100e2b6efa3dbbeb9665c4) Si la autenticación tiene éxito, aparecerá una notificación en la esquina superior derecha de la pantalla tras el inicio de sesión. ![](/files/ea0b89d4dc905ca8b67c7f73ce09fcf846dd3b5e) ### Restablecer contraseña Puede restablecer su contraseña si la olvida. Para restablecer su contraseña, en la pantalla de inicio de sesión haga clic en ¿Olvidó su contraseña?: ![](/files/ef80baaeb89473968d5bfd942176690efb9c2288) A continuación, introduzca el nombre de usuario del perfil y haga clic en Enviar. ![](/files/acc927d44331517342acfa6a1680d45305c2eb05) Se enviará un correo electrónico con un código de verificación a la dirección de correo vinculada a ese perfil. Introduzca el código de verificación y haga clic en Enviar código. ![](/files/f17a6c2865afb83a3f96a38edc601b653bddf506) Si el código es correcto, podrá crear una nueva contraseña. Introduzca la nueva contraseña dos veces. Asegúrese de cumplir los requisitos de la contraseña, están listados debajo del campo de nueva contraseña y se volverán verdes cuando se cumplan. Por último, para confirmar el restablecimiento, haga clic en Restablecer contraseña. ![](/files/cc22492c4e933a3f96870b65362df8b6becd0810) ## Interfaz de Usuario ### Pantalla principal La pantalla principal muestra las funciones principales de la aplicación: ![Página principal](/files/36e705c3da62d529be9facc4a3993eb441b2bab6) Las funciones están distribuidas en 3 grupos: **Requerir**, **Listar** y **Editar**. Estas funciones también pueden ser accesadas desde la barra de navegación en la parte superior de la página. ### Requerir Este grupo de funciones se usa para capturar y registrar fichas con datos biográficos y biométricos. Esta operación puede realizarse de 3 formas: **Ficha unitaria**, **Múltiples fichas en archivo**, y **Múltiples fichas en servidor**. #### Ficha unitaria Esta operación se utiliza para procesar una única. ![Ficha única](/files/58a74dde043f84dd81074805a2f00b6cfb27544e) Una solicitud de ficha única requiere 4 parámetros: **Nombre del proceso** > Un identificador (campo libre) para la operación. **Resolución** > Resolución de escaneo de la(s) imagen(es). Para un mejor resultado, la ficha debe escanearse en la misma resolución que el layout seleccionado. **Layout** > El layout de ficha utilizado para interpretar la imagen. Se mostrará una miniatura del layout seleccionado. **Archivos** > Uno o más archivos de imagen que contienen el escaneo de la ficha. Si la ficha tiene varias páginas, o contenido anverso/reverso, deben enviarse múltiples imágenes (una por página). Después de completar los parámetros y enviar las imágenes, el usuario puede reordenar las imágenes enviadas para que coincidan con el orden del layout, arrastrando los iconos en el lado izquierdo de la pantalla. Las imágenes pueden ser eliminadas haciendo clic en el icono `X`: ![Ficha única](/files/179f9127af8d996c401334540b8580d4a17c3b91) Haga clic en **Enviar** para enviar la solicitud para su procesamiento en el servidor. Para verificar el progreso de la operación, seleccione **Listar > Procesos** en la barra de navegación en la parte superior de la pantalla. #### Múltiples fichas en archivo Este tipo de operación se utiliza para procesar un paquete que contiene múltiples fichas escaneadas. El paquete debe ser un único archivo *Zip* que contenga todas las imágenes escaneadas. El *CardScan* procesará los archivos siguiendo el orden lexicográfico de sus nombres. **Se recomienda iniciar los nombres de archivo con números para garantizar un orden predecible de procesamiento.** ![Múltiples fichas en archivo](/files/b0e7af1741807cb8b5358891274baf4e0f6a278d) #### Múltiples fichas en servidor Esta operación se utiliza para procesar una lista de archivos ubicados en el servidor que ejecuta el servicio de CardScan. Procesará los archivos siguiendo el orden lexicográfico de sus nombres. **Se recomienda iniciar los nombres de archivo con números para garantizar un orden predecible de procesamiento.** Esta operación está indicada para migración de datos a gran escala, y puede requerir credenciales administrativas en el servidor. ### Listar Este grupo de funciones permite al usuario listar los **perfiles** generados para registro al procesar solicitudes; listar las solicitudes enviadas e inspeccionar su estado; y para inspeccionar **registros** de operación. #### Perfiles Esta sección muestra una lista de los perfiles existentes creados por el sistema. Es posible filtrar la lista por ID de proceso, ID del perfil, clave, dato biográfico y/o estado, permitiendo la localización de perfiles específicos. ![Listar perfiles](/files/aed177326e6555ce0710095a6a4c62e3e3a6cf12) Hacer clic en una fila de la lista de perfiles muestra sus detalles, tales como imágenes originales de la ficha e imágenes biométricas extraídas de la ficha (huellas dactilares, huellas palmares, foto facial, firma, etc.). ![Detalles del perfil](/files/b975d38b69606a3fea5429e1152b83a949772096) En esta página también es posible editar los campos textuales obtenidos por OCR (siglas en inglés para reconocimiento óptico de caracteres), eliminar el perfil, actualizar la lista y reprocesar los datos del perfil. **Editando campos OCR:** En la página de detalles del perfil el usuario puede editar campos textuales tales como datos biográficos, claves y rótulos (*labels*). Para ello, debe hacer clic en **Editar**: ![Editar detalles del perfil](/files/b87b21d17fb62e3f2167a585ac3eec050f7bbf64) Después de hacer clic en **Editar**, los campos del perfil pueden ser editados manualmente por el usuario. Los campos pueden ser Claves (Keys), Biográficos (Biographics) y Labels. Cuando el OCR no puede extraer la información de Biográficos, Claves o Labels de la imagen escaneada, deben ser ingresadas manualmente usando esta opción. Los campos mostrados son los configurados por el administrador del sistema. Si tiene los permisos necesarios, podrá ver y modificar estos campos en la aplicación GBS BCC. Para más información, consulte la sección [Campos](/gbs/es/aplicaciones/bccweb.md#campos) en el [manual del GBS BCC](/gbs/es/aplicaciones/bccweb.md). Después de editar los campos, haga clic en **Guardar cambios** para confirmar los cambios. Si el usuario desea cancelar los cambios, haga clic en **Cancelar**. Para limpiar los campos, haga clic en **Borrar campos**. {% hint style="info" %} Algunos campos pueden ser obligatorios, indicados por el mensaje "Este campo es obligatorio". Si un campo obligatorio queda en blanco, el usuario no podrá enviar el perfil al GBDS. {% endhint %} ![](/files/750e24fd5afbaf83c00245c5481f8d7645088efa) **Revisión manual:** Al usar el tipo de solicitud **Múltiples fichas en servidor**, dependiendo de la configuración de su entorno, los perfiles pueden requerir revisión manual si el número de ID leído por OCR no está incluido en un rango indicado en el nombre de la carpeta del servidor. Por ejemplo, si el nombre de la carpeta es `cartoes_1000_2000` y este recurso está activado en su entorno, el sistema verificará si el número de ID leído por OCR está entre 1000 y 2000. Aquellos que no estén dentro de ese rango recibirán el estado `Revisión manual pendiente` y esperarán revisión manual. Al abrir un perfil que requiere revisión manual, el usuario verá la pantalla del perfil con los campos en un estado editable. El usuario debe entonces revisar el documento escaneado, editar o introducir la información necesaria y hacer clic en **Guardar**. {% hint style="warning" %} Algunas informaciones, como claves de identificación, pueden verificarse en la base de datos ABIS para garantizar que sean únicas. Si la clave ya está en la base de datos, se mostrará como **inválida**. {% endhint %} ![](/files/8d8dd7c1d910cd9497fbac267d5193a9c6c10b1e) **Enviando el perfil al GBDS:** Si la ficha se ha procesado sin errores, el botón **Enviar al GBDS** estará habilitado, permitiendo al usuario enviar el perfil para registro en la base de datos biométrica GBS. {% hint style="info" %} Algunos campos biográficos pueden ser obligatorios. Si un campo obligatorio se deja en blanco, el usuario no podrá enviar el perfil al GBDS. Para continuar, haga clic en **Editar** y complete los campos obligatorios. {% endhint %} ![Enviar al GBDS](/files/06d37886c6b30c4994a4cc0a42609dcbb67f3710) {% hint style="warning" %} Una vez enviado al GBDS, los campos OCR ya no pueden ser modificados. {% endhint %} **Estado del perfil:** Todos los perfiles tienen un estado que indica su situación actual. El estado del perfil normalmente está asociado al estado del proceso. Cuando un proceso tiene el estado **Procesando**, los perfiles asociados pueden tener los siguientes estados:
EstadoDescripción
GeneradoPerfil creado.
SegmentandoSegmentación en curso.
ValidaciónValidación en curso.
Error de segmentaciónError en el proceso de segmentación.
Segmentación OKLa segmentación se realizó con éxito, esperando que el usuario envíe el perfil al GBDS.
Cuando el procesamiento se completa, el estado del perfil puede asumir otros valores:
EstadoDescripción
Revisión manual pendienteEl ID leído por OCR no está en el rango esperado. Se requiere revisión manual.
Revisión manual hechaRevisión manual completada, esperando que el usuario envíe el perfil al GBDS.
EliminadoPerfil eliminado antes de ser enviado al GBDS.
ReprocesadoEl layout del perfil fue editado y el perfil fue reprocesado con el nuevo layout.
ValidaciónValidación en curso.
Error de segmentaciónError en el proceso de segmentación.
Listo para el GBDSListo para ser enviado al GBDS.
Enviando al GBDSEnviando al GBDS.
Enviado al GBDSEnvío al GBDS completado.
OK en el GBDSRegistro completado con éxito en el GBDS, puede realizar la transición a OK.
OKRegistro completo en el GBDS y flujo del perfil concluido en CardScan - este es un estado final.
ErrorError al procesar el perfil.
Fallo en el GBDSFallo en el registro en el GBDS.
Rechazado en el GBDSPerfil fue rechazado por el GBDS.
En análisis (MIR)Esperando revisión manual de calidad en GBS MIR.
Aprobado (MIR)Aprobado en la revisión de calidad en GBS MIR, puede realizar la transición a OK.
Rechazado (MIR)Rechazado en la revisión de calidad en GBS MIR.
En análisis (ETR)El registro generó una excepción, esperando resolución en GBS ETR.
Mismas biometrias (ETR)Resolución en GBS ETR: encontradas las mismas biometrias (fraude en operación de registro).
Biometrias diferentes (ETR)Resolución en GBS ETR: biometrias diferentes (fraude en operación de actualización).
Recolección (ETR)Resolución en GBS ETR: recolección necesaria.
Aprobado (ETR)Resolución en GBS ETR: aprobado, puede realizar la transición a OK.
#### Procesos La sección de procesos muestra una lista de procesos existentes y sus detalles. La lista puede filtrarse por fecha, nombre de usuario, ID del proceso y/o estado. ![Listar procesos](/files/4a9c4e3a67de1fc8b8f5812aa36631550ba83890) Hacer clic en una fila de la lista de procesos abre una página con detalles del proceso y opciones para recargar la información, mostrar perfiles asociados y registros del proceso: ![Detalle del proceso](/files/d557a59b525d10f2795f6d5ae4c0e1ed4cf9825a) **Estado del proceso:** Todo proceso tiene un estado que indica su situación actual, que puede asumir los siguientes valores:
EstadoDescripción
RecibidoProceso recibido y creado.
ValidandoEl proceso está siendo validado.
Detectando layoutDetectando el layout automáticamente.
Layout no detectadoError: el sistema no pudo detectar el layout.
Layout detectadoDetección de layout completada con éxito.
Listo para segmentaciónListo para ser segmentado. Esperando validación del usuario.
ProcesandoProcesando perfiles.
Perfiles generadosPerfiles generados con éxito, el usuario puede enviarlos al GBDS.
ProcesadoProcesamiento completado.
ErrorError en el proceso.
#### Registros de operación La sección de registros de operación muestra una lista de los registros existentes y sus detalles. ![Lista de registros](/files/f874c3a19699cd5688ebb76e1067dd5f695704f5) Esta lista no ofrece una vista detallada de cada entrada de registro, a diferencia de las otras listas. ### Editar Este grupo de funciones permite al usuario editar configuraciones de la aplicación, así como layouts. #### Configuraciones Esta sección permite al usuario cambiar configuraciones generales de la aplicación: ![Configuraciones](/files/d7379a8cb79dceeb98e2698e238fcfe56d054eec) Es posible cambiar el tema de la aplicación de oscuro a claro, el idioma, el formato de fecha/hora y el tipo de búsqueda. Estas configuraciones afectan solo la interfaz con el usuario, y no las operaciones de procesamiento de fichas. #### Layouts Esta sección muestra una lista de layouts existentes y permite al usuario editarlos, clonarlos y/o eliminarlos. Tenga en cuenta que un layout solo puede editarse o eliminarse si no hay procesos asociados a él. ![Lista de layouts](/files/d7f7bf43c2f5bf7b16eb870e7cb2287c93ca4f1e) Hacer clic en un layout de la lista abrirá una página mostrando el layout con sus campos destacados: ![Detalle de layout](/files/bc7a8529dc4491aa327b567df5590641acdb71f7) ## Layouts Un layout es una representación de un modelo específico de ficha biométrica. Cada modelo distinto de ficha debe tener un layout correspondiente en el sistema. En el ejemplo siguiente podemos ver las huellas (difuminadas en este manual para anonimización) y datos biográficos de una persona: ![Ejemplo de layout](/files/e1361c403f52abb7239717e3fba16e83e1a5d21b) Para crear un layout correspondiente, el usuario necesita especificar las regiones de la imagen donde hay datos biométricos y biográficos. ### Creando un nuevo layout Para crear un nuevo layout, haga clic en **Nuevo Layout**: ![Crear nuevo layout](/files/c681a9e692b2d387153dd11d2a23d1e61d134908) Se mostrará la pantalla de creación de layout: ![Crear nuevo layout (vacío)](/files/6656cd08b9c33195c1822432b0acf23aa4967559) #### Importar archivo o Adquirir imagen El primer paso en la creación del layout es importar un archivo de imagen para servir de base: ![Imagen de ficha biométrica importada](/files/abd3620d706d45e8d436373529da424369ac96ff) #### Resolución Un paso importante es la especificación de la resolución de la imagen importada (dada en puntos por pulgada, *dpi* en la sigla en inglés). La resolución puede indicarse manualmente en la barra lateral a la derecha: ![Imagen de ficha biométrica importada: resolución](/files/23485e16934654375166e54dcd4b77257d95e919) El usuario también puede hacer clic en **Ajustar resolución** en la barra de herramientas a la izquierda: ![Herramienta de ajuste de resolución](/files/91ddf346eaff209c87d6442e2d5ac3ff640a4601) Elija la unidad de medida deseada e informe la distancia que será marcada en la imagen: ![Ejemplo de uso de la herramienta de ajuste de resolución](/files/b21f974839d05c73c32ba64d0911bbcc6cf8f7db) En este ejemplo, el primer paso (1) indica 5 cm como la distancia que será marcada en la imagen. El segundo paso (2) es la marcación de la distancia en la imagen. Tras los pasos 1 y 2, la aplicación informará la resolución calculada (3). En este ejemplo, 354 dpi. {% hint style="warning" %} La resolución mínima permitida es 300 dpi. {% endhint %} La siguiente información puede agregarse al layout: **Nombre** > Un identificador (campo libre) para el layout. **Descripción** > Descripción del layout (ej.: "fichas del estado de Roraima, 1985-1993") **Idioma** > El idioma en que los datos de las fichas están escritos. ![Propiedades del layout.](/files/ea7a85f201d0b04b3bb8c4ed27a717576d4eaa21) #### Crear región A continuación, el usuario debe especificar una o más regiones de la imagen que contengan datos biométricos o biográficos. En la barra de herramientas, haga clic en **Extraer región**: ![Extraer región con herramienta de rectángulo](/files/6f349c164e9636686361718c7b1b8a1b14eb3912) Haga clic y arrastre el ratón sobre la imagen para definir un rectángulo, y luego use la barra lateral a la derecha para completar sus detalles: ![Detalles de la región](/files/4d6e334021a17991e5f5a906a51b24f78d97b173) Es posible ajustar la posición y el tamaño de la región. En esta pantalla, el usuario también puede cambiar los siguientes ajustes: * **Ángulo:** * Sin rotación: sin cambio en la región creada * Rotar 90° en sentido horario: rota la región por este ángulo * Rotar 90° en sentido antihorario: rota la región por este ángulo * Invertir: rotación de 180° * **Tipo:** * Dactilar: huella dactilar * Palmar: huella palmar * Firma: firma * Clave: para campos que serán clave (valores que no pueden repetirse para personas distintas). Las claves serán almacenadas en la base de datos del GBS. * Biográfico: para campos con datos biográficos de la persona. Esta información será almacenada en la base de datos del GBS. * Etiqueta: para campos que serán tratados como rótulos (labels). Las labels serán almacenadas en la base de datos del GBS. * **Subtipo para Dactilares:** * Dactilar simple: para regiones con una sola huella. * Dos pulgares: para regiones con dos pulgares. * Dos huellas: para regiones con dos huellas dactilares. * Cuatro huellas: para regiones con cuatro huellas dactilares. * **Dígitos:** > Esta opción depende del subtipo anterior, e indica qué dedo o dedos están presentes en la región. * **Subtipo para Palmares:** * Interdigital izquierda * Tenar izquierda * Hipotenar izquierda * Interdigital derecha * Tenar derecha * Hipotenar derecha * Completa izquierda * Escritura izquierda * Completa derecha * Escritura derecha * **Subtipo para Face:** * Rostro frontal * Mugshot izquierdo * Mugshot derecho * **Subtipo para Clave:** * Clave OCR: El campo será interpretado por OCR (reconocimiento óptico de caracteres). * Clave Código de barras: El campo será interpretado como un código de barras. * **Campos para Claves:** * Lista los campos registrados en el servidor GBS para el tipo `Clave`: ![Campos clave](/files/bc570bc33c2b4c82e07ba4eca3244ca1909551e5) * Ejemplos de campos clave: número de pasaporte, número de licencia de conducir, número del título de elector. * **Subtipo para Biográfico:** * Biográfico OCR: El campo será interpretado por OCR (reconocimiento óptico de caracteres). * Biográfico Código de barras: El campo será interpretado como un código de barras. * **Campos biográficos:** * Lista los campos registrados en el servidor GBS para el tipo `Biográfico`: ![Campos biográficos](/files/36831ab2b769dd794ac5ccb374e43956494e4091) * Ejemplos de campos biográficos: nombre, fecha de nacimiento, nombre de la madre, nombre del padre. * **Subtipo para Label:** * Label OCR: El campo será interpretado por OCR (reconocimiento óptico de caracteres). * Label Código de barras: El campo será interpretado como un código de barras. * **Campos de Label:** * Lista los campos registrados en el servidor GBS para el tipo `Label`: ![Campos de Label](/files/de2ac8209c258927147a8d1e58beb7e5e7997ca7) * Las labels pueden usarse para agrupar y filtrar personas en las operaciones de búsqueda del GBS. Cuando la creación de la región se completa, la imagen tendrá las regiones asociadas como en la imagen de abajo: ![Ficha biométrica demarcada](/files/ed30230f95e814abc6442bbef88fe9c3288f1e59) Para ajustar cualquier región creada, haga clic en ella. Sus detalles se destacarán en la barra lateral y se mostrará la lista de opciones: ![Ventana de edición de región](/files/2d22acf6452699ac16906d91740632f304d54993) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.griaule.com/gbs/es/aplicaciones/cardscanweb.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.