Ir al contenido principal

Registrar documentos desde un agente

Cuando tengo una factura o recibo impreso, quiero extraer sus datos con IA desde un agente y enviarlos a Versat para cargar la información en el sistema.

Escrito por Pablo Arnaldo Salinas Gonzalez

Descripción general

Esta característica permite digitalizar facturas y recibos en papel, extraer sus datos mediante IA desde un agente compatible con MCP y enviarlos automáticamente a Versat para su registro en el sistema. Con ello se reduce la captura manual y se estandariza la información enviada.

¿A quién beneficia?

  • Contador

  • Administrador de estancia

  • Facturista

  • Auxiliar contable

  • Auxiliar financiero

  • Auxiliar administrativo

Requisitos previos

  • Acceso a un agente compatible con MCP.

  • Token de API válido generado en el sistema, en el entorno correspondiente (pruebas o producción).

  • URL del servidor MCP proporcionada por tu organización.

  • Paquete de skills para lectura y envío de documentos (ZIP o carpeta).

Configuración del agente (MCP)

  1. Genera tu token de API en el sistema (asegúrate de crearlo en el entorno de trabajo correcto: pruebas o producción).

  2. En tu agente, abre la sección de configuración y ve a “Servidores MCP”.

  3. Añade un nuevo servidor: asigna un nombre y pega la URL del servidor MCP.

  4. Agrega el encabezado de autorización: usa el campo “Authorization” con tu token. Si tu agente permite variables de entorno, puedes guardarlo allí; no obstante, configurarlo como encabezado suele ser más sencillo.

  5. Guarda los cambios y verifica la conexión.

  6. Instala las skills necesarias: importa el paquete ZIP en el agente (arrastrándolo a la conversación si está soportado) o copia los archivos a la carpeta de skills del agente.

  7. Confirma que el servidor y el token corresponden al entorno adecuado (por ejemplo, pruebas) antes de iniciar cargas reales.

Uso paso a paso

  1. Digitaliza el documento: escanéalo a PDF o toma una foto nítida (sin sombras, cortes ni reflejos).

  2. Desde el agente, ejecuta la skill de lectura de facturas/recibos y adjunta el archivo.

  3. La IA extraerá los datos clave y los mostrará para revisión.

  4. Valida y corrige cualquier campo necesario.

  5. Envía los datos a Versat: la skill utilizará la conexión y tu token para registrar la información en el sistema.

  6. Comprueba la confirmación: verifica el identificador de registro o el estado de la operación en el agente o en el módulo de cargas de Versat.

Campos que normalmente se extraen

  • Proveedor/Emisor y, de ser aplicable, su identificador fiscal.

  • Número y serie de factura o recibo.

  • Fecha de emisión.

  • Moneda.

  • Subtotal, impuestos, descuentos y total.

  • Forma o método de pago.

  • Conceptos/partidas: descripción, cantidad y precio unitario.

Buenas prácticas

  • Usa imágenes nítidas (ideal ≥300 ppp) y documentos completos.

  • Un archivo por documento para evitar confusiones.

  • Valida siempre los importes e impuestos antes de enviar.

  • Mantén actualizado el paquete de skills del agente.

  • Si es posible, trabaja primero en el entorno de pruebas para afinar el flujo.

Solución de problemas

Errores de autenticación (401/403)

  • Revisa que el token esté vigente y corresponda al entorno activo.

  • Confirma que el encabezado “Authorization” está configurado correctamente.

No hay conexión con el servidor MCP

  • Valida la URL del servidor.

  • Comprueba tu red, firewall o políticas de acceso.

  • Reinicia el agente tras cambios de configuración.

Las skills no aparecen o no se cargan

  • Reinstala el paquete ZIP o copia nuevamente los archivos a la carpeta de skills.

  • Verifica permisos de lectura/escritura y reinicia el agente.

Extracción imprecisa de datos

  • Mejora la calidad del escaneo o fotografía (sin desenfoques ni sombras).

  • Evita documentos doblados o parcialmente cortados.

  • Corrige manualmente los campos críticos antes de enviar.

Errores al enviar a Versat

  • Comprueba que el token y el entorno sean correctos.

  • Revisa que los campos obligatorios estén completos.

  • Intenta nuevamente y, si persiste, contacta al equipo de soporte con el detalle del error.

Preguntas frecuentes

¿Qué formatos de archivo se aceptan?

Comúnmente PDF, JPG y PNG. Verifica las políticas de tu organización si se requiere un formato específico.

¿Puedo usarlo sin conexión?

No. Se requiere conexión al servidor MCP y a los servicios de Versat para procesar y registrar la información.

¿Dónde conviene guardar el token?

Puedes colocarlo en el encabezado “Authorization” del servidor MCP o, si tu agente lo soporta, en una variable de entorno. El encabezado suele ser la opción más directa.

¿Cómo pruebo sin afectar producción?

Genera un token y apunta el servidor al entorno de pruebas. Una vez validado el flujo, replica la configuración en producción.

¿Ha quedado contestada tu pregunta?