Saltar al contenido principal

​
Descripción general

ABBYY Vantage permite el procesamiento automatizado de documentos con capacidades de extracción inteligente. Esta guía se centra en el flujo de trabajo mediante SFTP, que le permite subir documentos a una carpeta compartida y recuperar automáticamente los resultados procesados. Lo que logrará:
  • Crear y configurar una Habilidad de proceso
  • Configurar el acceso SFTP para entrada y salida
  • Subir documentos mediante la línea de comandos
  • Descargar los resultados de extracción
Tiempo estimado para completar: 15-20 minutos

​
Paso 1: Crear una Habilidad de proceso

Una Habilidad de proceso es la base de su flujo de trabajo de procesamiento de documentos en Vantage.
  1. Vaya a la sección Documentos en ABBYY Vantage.
  2. Haga clic en Skill Designer en la barra lateral izquierda.
  3. Seleccione Habilidad de proceso entre los tipos de skill.
Selecting Process Skill
  1. En el cuadro de diálogo Create Process skill, introduzca:
    • Skill Name: Un nombre descriptivo para su proceso (por ejemplo, “Process Skill Test 1”)
    • Description: Descripción opcional de lo que hace esta skill
    • Technology Core Version: 3.0 (recomendado)
Naming Process Skill
  1. Haga clic en Create

​
Paso 2: Configurar el flujo de trabajo de la Habilidad de proceso

Después de crear su skill, configurará el flujo de trabajo de procesamiento de documentos.
  1. En Skill Designer, verá el panel Select Process Skill a la derecha
  2. Elija Simple Document skill workflow para procesar tipos de documento individuales
Selecting Simple Workflow Esto crea un flujo de trabajo preconfigurado que incluye:
  • Conector de Input: donde los documentos ingresan al sistema
  • skill de OCR: Reconocimiento óptico de caracteres (OCR)
  • skill de Extract: extracción de datos
  • Conector de Output: donde se entregan los resultados
El flujo de trabajo aparecerá en el lienzo central mostrando: Input → OCR → Extract → Output

​
Paso 3: Configurar la entrada mediante SFTP

Configure la actividad Input para aceptar documentos mediante SFTP.
  1. Haga clic en la actividad Input en el flujo de trabajo.
  2. En el panel Actions de la derecha, marque Select additional source.
  3. Seleccione el botón de opción Shared folder.
  4. Haga clic en Settings para configurar.
Configuring Input Activity

​
Configurar parámetros de entrada

En el cuadro de diálogo Input Settings: Shared Folder: Input Settings Dialog Configuración de la carpeta:
  • Folder name: Input (predeterminado)
  • Import method: Single file
Credenciales de importación (mostradas para su uso):
  • Folder link: .../Input
  • Exceptions folder link: .../Input-exception
  • Username: Un UUID generado (por ejemplo, 685df03c-9e22-41cb-a96f-4c408ab52735)
  • Password: Se muestra con la opción de mostrar/ocultar
Nota: Copie estas credenciales; las necesitará para conectarse mediante SFTP. Los archivos que no se puedan importar se moverán a la carpeta de excepciones. Vantage comprueba si hay archivos cada 20 segundos después de publicar la Skill.
  1. Haga clic en Save.

​
Paso 4: Configurar la salida mediante SFTP

Configure la actividad Output para enviar los resultados mediante SFTP.
  1. Haga clic en la actividad Output en el flujo de trabajo.
  2. En el panel Actions, marque Select additional destination.
  3. Seleccione el botón de opción Shared folder.
  4. Haga clic en Settings para configurar.
Configuración de la actividad Output

​
Configurar parámetros de salida

En el cuadro de diálogo Output Settings: Shared Folder: Output Settings Dialog Información:
  • Folder name: Output (predeterminado)
  • Folder: .../Output
  • Username: Un UUID generado (p. ej., 685df03c-9e22-41cb-a96f-4c408ab52735)
  • Password: Se muestra con la opción de mostrar/ocultar
Datos exportados:
  • Fields (JSON): Formato de exportación predeterminado
Nota: Los resultados se organizan en subcarpetas con el nombre del archivo de origen y el ID de la transacción (p. ej., invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82). Los archivos se eliminan automáticamente según la política de retención de datos.
  1. Haga clic en Save.

​
Paso 5: Configurar Skills de extracción

Configura qué tipos de documentos debe reconocer y procesar la actividad Extract.
  1. Haz clic en la actividad Extract en el flujo de trabajo.
  2. En el panel Actions, verás Document Skills.
Configuring Extraction Skills Las Skills de documento disponibles incluyen:
  • Invoice
  • Invoice AU-NZ
  • Invoice CA
  • Invoice ES
  • Invoice UA
  • Invoice US
  1. Selecciona los tipos de documentos relevantes para tu caso de uso.
  2. Haz clic en Add Skill si necesitas tipos de documento adicionales.
  3. Usa Edit Mapping para personalizar la extracción de campos si es necesario.

​
Paso 6: Publicar y obtener el ID de la Habilidad

Antes de poder usar SFTP, necesitas publicar la Habilidad y encontrar su ID.
  1. Haz clic en el botón Publish en la parte superior derecha de Skill Designer.
  2. Una vez publicada, anota el Skill ID de la URL del navegador.
Obtener el Skill ID desde la URL El formato de la URL es: 
https://vantage-preview.abbyy.com/skill-editor/Processing/{skill-id}
Por ejemplo: fc7116ea-ab6c-40fa-b10d-1aef61aaaa2c Advertencia: Mantén a mano el ID de la Skill: lo necesitarás para acceder a las carpetas correctas de Input y Output en SFTP.

​
Paso 7: Conectarse a SFTP

Ahora está listo para conectarse mediante SFTP utilizando las credenciales de su configuración de entrada/salida.

​
Detalles de la conexión

En su configuración de Entrada/Salida, dispone de:
  • Servidor: 172.172.228.138
  • Puerto: 2022
  • Nombre de usuario: Su UUID generado
  • Contraseña: Su contraseña generada
  • Ruta base: /{skill-id}/

​
Conectarse desde la terminal

Abra una terminal y conéctese con: 
sftp -P 2022 {username}@172.172.228.138
Ejemplo: 
sftp -P 2022 [email protected]
Nota: Use -P en mayúscula para indicar el número de puerto en SFTP (la -p en minúscula se utiliza para otro propósito). Cuando se le pida, introduzca su contraseña.

​
Paso 8: Navegar por la estructura de carpetas de SFTP

Una vez conectado, verás el indicador de SFTP: sftp>

​
Ver las Habilidades disponibles

Mostrar todas las Habilidades de proceso disponibles: 
sftp> ls
Acceso a las carpetas de Skill Verás carpetas para cada skill (identificadas por su ID de skill), además de:
  • Catalogs - Catálogos de Skill de documento
  • Catalogs-exception - Importaciones de catálogos con errores
  • skills-import - Directorio de importación de skills
Utilice el ID de la Habilidad del paso 6: 
sftp> cd {your-skill-id}
sftp> ls
Verá tres carpetas:
  • Input - Carpeta donde carga los documentos para su procesamiento
  • Input-exception - Aquí se mueven las importaciones fallidas
  • Output - Carpeta donde aparecen los resultados procesados

​
Paso 9: Cargar documentos para su procesamiento

Vaya a la carpeta Input y cargue sus documentos. 
sftp> cd Input
sftp> pwd
Remote working directory: /{skill-id}/Input

​
Cargar un único archivo

Cargue un archivo indicando la ruta completa: 
sftp> put ~/Documents/Sample\ Files/Demo\ Docs/invoice_1.jpg
O bien, cambie primero el directorio local: 
sftp> lcd ~/Documents/Sample\ Files/Demo\ Docs
sftp> lls
sftp> put invoice_1.jpg
Cargar y descargar archivos

​
Subir varios archivos

sftp> mput *.jpg
sftp> mput invoice_*.pdf
Nota: Los archivos subidos a Input se eliminan automáticamente tras procesarse correctamente (normalmente en unos 20 segundos). Si no ves tu archivo después de subirlo, ¡significa que Vantage ya lo ha recogido para procesarlo!

​
Verificar la carga

Verifica que los archivos aún se encuentren en la carpeta Input: 
sftp> ls
Si la carpeta está vacía o no aparece su archivo, el procesamiento ya ha comenzado.

​
Paso 10: Comprobar el estado del procesamiento

​
Supervisar la carpeta Input-exception

Si un archivo no se puede importar, aparecerá aquí: 
sftp> cd ..
sftp> cd Input-exception
sftp> ls
Una carpeta vacía indica que todos los archivos se importaron correctamente.

​
Espere el procesamiento

El tiempo de procesamiento varía según:
  • Complejidad del documento
  • skills de extracción configuradas
  • Carga actual del sistema
Normalmente, las facturas simples se procesan en un plazo de 30 a 60 segundos.

​
Paso 11: Descargar resultados procesados

Una vez completado el procesamiento, los resultados se encuentran en la carpeta Output. 
sftp> cd ..
sftp> cd Output
sftp> ls

​
Comprender la estructura de salida

Los resultados se organizan en subcarpetas con este patrón de nomenclatura: 
{original-filename}-{transaction-id}
Ejemplo: 
invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82

​
Ver el contenido de la carpeta de resultados

sftp> cd invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82
sftp> ls
Contenido típico:
  • Invoice_US.json - Datos extraídos en formato JSON
  • Invoice_US.csv - Datos extraídos en formato CSV (si se ha configurado)
  • Archivos adicionales según la configuración de salida

​
Descargar los resultados

Establezca su directorio local de descargas: 
sftp> lcd ~/Downloads
sftp> lpwd
Local working directory: /Users/yourname/Downloads
Descargar un único archivo: 
sftp> get Invoice_US.json
Descarga todos los archivos de la carpeta: 
sftp> mget *
Descargar de forma recursiva toda la carpeta de resultados: 
sftp> cd ..
sftp> get -r invoice_1.jpg-4ac2a31b-d1b6-4231-99b2-39f00bc5df82

​
Comprender la salida JSON

La salida predeterminada es un archivo JSON que contiene:
  • Estructura del documento - Diseño y organización
  • Valores de campos extraídos - Datos obtenidos del documento
  • Niveles de confianza - Fiabilidad de cada extracción
  • Errores de reglas - Cualquier problema de validación
  • Metadatos de los campos - Información adicional sobre cada campo
Ejemplo de estructura: 
{
  "Document": {
    "DocumentType": "Invoice US",
    "Fields": [
      {
        "Name": "InvoiceNumber",
        "Value": "INV-12345",
        "Confidence": 0.98
      },
      {
        "Name": "Total",
        "Value": "1250.00",
        "Confidence": 0.95
      }
    ]
  }
}
Para obtener la documentación detallada del esquema JSON, consulte la documentación de la API de ABBYY Vantage.

​
Comandos SFTP útiles

ComandoDescripciónEjemplo
lsListar archivos remotosls
llsListar archivos localeslls
pwdMostrar directorio remotopwd
lpwdMostrar directorio locallpwd
cd folderCambiar de directorio remotocd Output
lcd folderCambiar de directorio locallcd ~/Downloads
put fileSubir un solo archivoput invoice.pdf
mput filesSubir varios archivosmput *.jpg
get fileDescargar un solo archivoget result.json
mget filesDescargar varios archivosmget *
get -r folderDescargar una carpeta recursivamenteget -r results/
exitDesconectarexit

​
Solución de problemas

​
Problemas de conexión

Problema: errores de “Connection refused” o de tiempo de espera (timeout) Soluciones:
  • Verifica que estés conectado a la VPN de la empresa
  • Comprueba el número de puerto (debe ser 2022 y usar -P en mayúscula)
  • Confirma que tu nombre de usuario y contraseña sean correctos
  • Prueba la conectividad básica de red: ping 172.172.228.138

​
Problemas de carga

Problema: Los archivos no se están procesando Soluciones:
  • Revise la carpeta Input-exception para ver las importaciones con errores
  • Verifique que el formato de archivo sea compatible (PDF, JPG, PNG, TIFF, etc.)
  • Asegúrese de que la Habilidad de proceso esté publicada
  • Compruebe los límites de tamaño de archivo (varían según la configuración)

​
Sin archivos de salida

Problema: La carpeta de salida está vacía después de la carga Soluciones:
  • Espere un poco más: el procesamiento puede tardar de 30 a 60 segundos o más
  • Verifique que Output esté configurado con el destino “Shared folder”
  • Revise los registros de la transacción en la interfaz web de Vantage
  • Confirme que la actividad Extract tenga configuradas las skills de documento apropiadas

​
Errores de permisos

Problema: “Permission denied” al subir/descargar Soluciones:
  • Verifique que está utilizando las credenciales correctas para Input y Output
  • Las credenciales de Input permiten: subir, eliminar
  • Las credenciales de Output permiten: ver, descargar, renombrar, eliminar
  • Compruebe que la skill esté publicada y activa

​
Buenas prácticas

​
Seguridad

  • Nunca comparta credenciales SFTP en texto plano
  • Utilice canales seguros para transmitir contraseñas
  • Renueve las credenciales periódicamente
  • Limite el acceso SFTP al personal necesario

​
Gestión de archivos

  • Utiliza nombres de archivo descriptivos que incluyan fechas o identificadores (ID)
  • Procesa archivos en lotes durante las horas de menor actividad, si es posible
  • Descarga y archiva los resultados lo antes posible
  • Elimina periódicamente las carpetas de resultados antiguos

​
Supervisión

  • Revise periódicamente la carpeta Input-exception para detectar importaciones fallidas
  • Supervise los tiempos de procesamiento para identificar cuellos de botella
  • Revise los niveles de confianza de la extracción en los resultados
  • Configure alertas para errores críticos (si están disponibles)

​
Optimización del flujo de trabajo

  • Agrupe tipos de documentos similares
  • Configure las Skill de documento adecuadas para su caso de uso
  • Pruebe con documentos de ejemplo antes de usarlo en producción
  • Documente su flujo de trabajo SFTP como referencia para el equipo

​
Próximos pasos

Ahora que ya tiene en funcionamiento un flujo de procesamiento de documentos basado en SFTP:
  1. Pruebe con distintos documentos - Cargue diferentes tipos de archivos y variaciones de documentos
  2. Revise la precisión de la extracción - Verifique los resultados JSON y los niveles de confianza
  3. Personalice la extracción - Use Edit Mapping para afinar la extracción de campos
  4. Automatice las cargas - Cree scripts para automatizar la carga de archivos
  5. Integre con sistemas - Conecte sus aplicaciones mediante la API REST de Vantage
  6. Escale su flujo de trabajo - Agregue más Skill de documento o cree Habilidades de proceso adicionales
Para configuraciones avanzadas, integración mediante API o flujos de trabajo personalizados, consulte la documentación de ABBYY Vantage.

​
Recursos adicionales

  • Documentación de la API REST: Para la carga programática de archivos y la obtención de resultados
  • Skill Catalog: Explore skills de documento predefinidas
  • Support: Póngase en contacto con el soporte técnico de ABBYY para recibir asistencia técnica

​
Resumen

Has completado correctamente lo siguiente:
  • ✅ Creado una Habilidad de proceso en ABBYY Vantage
  • ✅ Configurado el acceso SFTP para entrada y salida
  • ✅ Configurado skills de extracción de documentos
  • ✅ Conectado mediante la línea de comandos de SFTP
  • ✅ Cargado documentos para su procesamiento
  • ✅ Descargado los resultados de extracción
¡Tu flujo de procesamiento de documentos ya está operativo y listo para su uso en producción!