Nodo de documentos - Extraer textos con OCR
Explicación rápida
DANAconnect permite ejecutar procesos de OCR directamente desde un flujo de Conversation Manager utilizando el Nodo de Documentos.
La operación OCR permite permite extraer texto de un archivo disponible dentro de un flujo de Conversation Manager.
Para configurarla, debe indicar la etiqueta del archivo en File Tag, seleccionar el motor OCR en Engine Type y elegir el formato de salida en Output Format.
El resultado del OCR puede guardarse en campos de la lista de contactos o utilizarse en pasos posteriores del flujo para validar información, tomar decisiones o continuar una automatización.
Esta funcionalidad es útil cuando se necesita leer información contenida en documentos adjuntos, imágenes o archivos PDF para utilizarla posteriormente dentro de una automatización.
¿Qué es OCR?
OCR significa Optical Character Recognition, o reconocimiento óptico de caracteres.
En términos simples, OCR permite convertir el contenido visual de un documento en texto que puede ser leído, procesado o utilizado por el sistema.
Por ejemplo, si un cliente envía una imagen, una factura, una cédula, una constancia o un comprobante, el OCR permite extraer el texto contenido en ese archivo.
¿Para qué sirve la opción OCR del Nodo de Documentos?
La operación OCR del Nodo de Documentos permite extraer texto desde un archivo dentro de un flujo automatizado.
Puede utilizarse, por ejemplo, para:
- Leer datos desde documentos enviados por clientes.
- Extraer texto de comprobantes, formularios, facturas o certificados.
- Procesar imágenes o PDFs recibidos como archivos adjuntos.
- Guardar el resultado del OCR en un campo de la lista de contactos.
- Usar el texto extraído en pasos posteriores del flujo.
- Enviar el resultado a otro sistema o servicio.
- Validar información contenida en un documento.
Recomendación antes de comenzar
La operación OCR del Nodo de Documentos está pensada para extraer texto de un archivo y devolverlo en un formato simple o estructurado.
Si necesita hacer una extracción más compleja, por ejemplo identificar campos específicos dentro de un documento, interpretar información, clasificar contenido, comparar datos, validar condiciones o extraer valores con lógica contextual, se recomienda utilizar el Nodo GenAI.
El Nodo GenAI permite trabajar con instrucciones más avanzadas y puede ser más adecuado cuando el objetivo no es solamente leer el texto del documento, sino interpretar su contenido o extraer información específica a partir de ese texto.
Por ejemplo, use OCR cuando necesite obtener el texto completo de un documento.
Use el Nodo GenAI cuando necesite obtener algo más específico, como:
- Número de factura
- Fecha de emisión
- Nombre del titular
- Monto total
- Tipo de documento
- Datos de una tabla
- Resultado de una validación
- Clasificación del documento
- Resumen del contenido
En muchos casos, OCR y GenAI pueden usarse de forma complementaria: primero se extrae el texto del documento con OCR y luego se utiliza el Nodo GenAI para interpretar o procesar ese texto.
Consideraciones previas
Antes de configurar la operación OCR desde el Nodo de Documentos, asegúrese de contar con lo siguiente:
- Un flujo creado en Conversation Manager.
- Un Nodo de Documentos agregado al flujo.
- Un archivo disponible dentro del flujo.
- La etiqueta donde se encuentra almacenado el archivo.
- Un motor OCR disponible para la operación.
- Un formato de salida definido para el resultado.
- Campos disponibles en la lista de contactos, si desea guardar algún resultado del OCR.
Paso 1: Agregar o editar el Nodo de Documentos
Dentro del flujo en Conversation Manager, agregue un Nodo de Documentos o edite uno existente.
En la ventana de configuración del nodo verá los campos principales:
- Nombre del paso
- Tipo de Operación
- Tipo de Documento
- Tipo de Servicio
- Pestañas de configuración: OCR y Configuración
En el campo Tipo de Operación, seleccione OCR.
Paso 2: Configurar la etiqueta del archivo
En la pestaña OCR, complete el campo File Tag.
El campo File Tag corresponde a la etiqueta que ira mapeada al momento de la activación al campo de la lista de contacto donde se encuentra la ruta del archivo que será procesado por OCR.
Por ejemplo:
Campo | Valor |
|---|---|
File Tag |
|
La etiqueta indicada debe corresponder a un archivo disponible dentro del flujo.
Si la etiqueta no existe, está vacía o no contiene un archivo válido, el nodo no podrá ejecutar correctamente el proceso OCR.
Paso 3: Seleccionar el formato de salida
En el campo Output Format, seleccione el formato en el que desea recibir el resultado del OCR.
Las opciones disponibles pueden incluir:
Texto simpleBloquesBloques con confianzaBloques con confianza global
¿Qué significa cada formato de salida?
El formato de salida define cómo se entregará la información extraída del documento.
Texto simple
La opción Texto simple devuelve el contenido detectado como texto plano.
Es la opción más sencilla cuando solo se necesita obtener el texto leído del documento, sin información adicional sobre estructura o nivel de confianza.
Puede ser útil para:
- Guardar el texto extraído en un campo.
- Enviar el texto a otro paso del flujo.
- Revisar de forma general el contenido detectado.
- Usar el resultado en una validación posterior.
Bloques
La opción Bloques devuelve el resultado dividido en bloques de información.
Esto puede ser útil cuando se necesita conservar una estructura más detallada del contenido detectado, por ejemplo líneas, fragmentos o secciones del documento.
Puede ser útil para:
- Procesar documentos con varias secciones.
- Analizar información por partes.
- Identificar elementos específicos dentro del documento.
- Enviar el resultado a un procesamiento posterior más avanzado.
Bloques con confianza
La opción Bloques con confianza devuelve los bloques detectados junto con un valor de confianza asociado.
La confianza indica qué tan seguro está el motor OCR sobre el texto reconocido en cada bloque.
Puede ser útil cuando se necesita validar la calidad del reconocimiento antes de usar el dato.
Por ejemplo, si un bloque tiene baja confianza, el flujo podría enviar el documento a revisión manual o solicitar al cliente que cargue una imagen más clara.
Bloques con confianza global
La opción Bloques con confianza global devuelve los bloques detectados y una referencia general del nivel de confianza del resultado.
Puede ser útil cuando se necesita evaluar el resultado completo del OCR, no solamente cada bloque individual.
Por ejemplo, puede utilizarse para decidir si el documento tiene suficiente calidad para continuar el flujo o si debe ser revisado por un agente.
Paso 5: Configurar campos a actualizar
En la pestaña Configuración, puede agregar campos que serán actualizados con valores obtenidos como resultado del OCR.
Para hacerlo, haga clic en Add Field to Update.
Luego complete:
- Field Name: código del campo de la lista de contactos que desea actualizar.
- XPath/JsonPath: ruta desde donde se tomará el valor que actualizará ese campo.
Esta opción es útil cuando se necesita guardar en la base de datos algún dato específico devuelto por la operación OCR.
Por ejemplo, puede utilizarse para actualizar un campo con:
- Texto extraído del documento.
- Estado del procesamiento OCR.
- Nivel de confianza del resultado.
- Resultado estructurado por bloques.
- Mensaje o respuesta generada por el motor OCR.
Ejemplo de configuración básica
Supongamos que un flujo recibe un comprobante enviado por un cliente y se desea extraer el texto contenido en ese archivo.
La configuración podría ser:
Campo | Valor |
|---|---|
Tipo de Operación |
|
File Tag |
|
Engine Type |
|
Output Format |
|
En este caso, el Nodo de Documentos tomará el archivo ubicado en la etiqueta FileLabel, lo procesará con el motor Textract y devolverá el texto detectado en formato simple.
Ejemplo de uso
Un flujo de gestión documental puede recibir una imagen o PDF cargado por un cliente y aplicar OCR para leer su contenido.
Por ejemplo, si el cliente envía un comprobante, el flujo puede:
- Recibir el archivo adjunto.
- Guardarlo en una etiqueta del flujo.
- Ejecutar el Nodo de Documentos con la operación
OCR. - Extraer el texto del documento.
- Guardar el resultado en un campo de la lista de contactos.
- Usar el texto extraído para validaciones posteriores o revisión interna.
¿Qué puede hacer el flujo después de ejecutar OCR?
Después de ejecutar el OCR, el flujo puede utilizar el resultado para continuar el proceso.
Por ejemplo, puede:
- Actualizar campos de la lista de contactos.
- Guardar el texto extraído del documento.
- Validar si el documento contiene cierta información.
- Enviar el resultado a otro sistema.
- Continuar por una ruta del flujo según el resultado.
- Escalar el caso a un agente si el documento no pudo ser leído correctamente.
- Usar el resultado como entrada para otro nodo o proceso.
Errores frecuentes
El archivo no se procesa
Verifique que el campo File Tag contenga el nombre correcto de la etiqueta donde se encuentra el archivo.
También confirme que esa etiqueta tenga un archivo disponible en el momento en que el flujo ejecuta el Nodo de Documentos.
El resultado del OCR llega vacío
Revise que el archivo tenga texto legible.
El resultado puede llegar vacío si el documento está borroso, incompleto, mal escaneado, en baja resolución o si el texto no puede ser reconocido correctamente.
El texto extraído no coincide exactamente con el documento
El OCR interpreta visualmente el contenido del archivo.
Si la imagen tiene baja calidad, sombras, inclinación, manchas, letras pequeñas o texto poco claro, el resultado puede contener errores.
En estos casos, puede ser necesario solicitar al cliente un archivo más claro o enviar el documento a revisión manual.
El campo no se actualiza
Verifique que el campo configurado en Field Name exista en la lista de contactos.
También revise que la ruta indicada en XPath/JsonPath corresponda con la estructura del resultado devuelto por el OCR.
El botón Guardar aparece deshabilitado
Revise que los campos obligatorios estén completos, especialmente:
- Tipo de Operación
- File Tag
- Engine Type
- Output Format
Recomendaciones para mejores resultados
Para mejorar la calidad del OCR, procure que los documentos cargados cumplan con estas condiciones:
- Imagen o PDF con buena resolución.
- Texto claro y legible.
- Documento completo, sin cortes.
- Buena iluminación.
- Archivo sin sombras, reflejos o exceso de inclinación.
- Texto no cubierto por sellos, marcas o elementos visuales.
- Formato de archivo compatible con el proceso.
Actualizado el: 07/07/2026
¡Gracias!