Primeros pasos con TruvioSense
Esta guía describe la instalación y configuración de TruvioSense en un entorno de Business Central.
Antes de comenzar, asegúrese de que se cumplen los siguientes requisitos previos:
- Microsoft Dynamics 365 Business Central online, versión 26.2 o posterior
- ExFlow - Extensión de automatización de cuentas por pagar instalada
- Acceso de administrador a Business Central, incluido el permiso para crear movimientos de cola de trabajos en todas las empresas
- Un Authentication Email en el usuario de Business Central que ejecuta la incorporación
- Ventanas emergentes permitidas en el navegador para Business Central
- Al menos 3–6 meses de datos históricos de facturas para obtener los mejores resultados
Guía de configuración para administradores de TI
La primera sección de esta guía está destinada a administradores de TI que preparan un inquilino de Microsoft Entra para la integración con la API Core de Truvio.
Para habilitar la comunicación segura con el servicio de IA de TruvioSense, es necesario crear un usuario de servicio dedicado.
Antes de que el usuario de servicio pueda iniciar sesión desde el ERP en la API Core, un administrador de TI debe:
- Asegurarse de que existe un usuario de servicio dedicado en Microsoft Entra ID que se utilizará para autenticarse desde el ERP.
- Otorgar consentimiento de administrador a nivel de inquilino para la aplicación Truvio Entra.
- Asignar el rol de aplicación Truvio.SubscriptionService al usuario de servicio.
Una vez completados estos requisitos previos, la cuenta de servicio se puede utilizar para iniciar sesión desde el ERP y conectarse a la API Core.
Requisitos previos
- Una cuenta con permiso para otorgar consentimiento de administrador a nivel de inquilino para aplicaciones en Microsoft Entra (normalmente un Administrador global o un Administrador de roles con privilegios).
- Acceso al portal de Azure con derechos para administrar aplicaciones empresariales en el inquilino.
- Un usuario de servicio disponible en Microsoft Entra ID (cree uno si aún no existe).
Esta guía describe los pasos que un administrador de Microsoft Entra debe completar antes de que un usuario pueda iniciar sesión desde el ERP en la API Core de Truvio.
Paso 1: Preparar un usuario de servicio en Entra
Cree (o identifique) un usuario de servicio dedicado en Microsoft Entra ID que se utilizará para autenticarse desde el ERP en la API Core.
El usuario de servicio debe ser una cuenta de miembro estándar en el inquilino. Trate las credenciales como una identidad de servicio compartida y almacénelas de forma segura.
Paso 2: Otorgar consentimiento de administrador a la aplicación Truvio Entra
Como administrador del inquilino, abra el siguiente enlace de consentimiento de administrador en un navegador e inicie sesión con una cuenta que tenga permiso para otorgar consentimiento a nivel de inquilino.
Revise los permisos solicitados y haga clic en Accept para otorgar el consentimiento a nivel de inquilino.
Después de otorgar el consentimiento, la aplicación Truvio aparecerá en el inquilino en Microsoft Entra ID -> Enterprise applications.
Paso 3: Asignar el rol de aplicación Truvio.SubscriptionService al usuario de servicio
- Inicie sesión en el portal de Azure.
- Navegue a Microsoft Entra ID -> Enterprise applications.
- Busque y abra la aplicación Truvio que recibió el consentimiento en el Paso 2.
- Vaya a Users and groups -> Add user/group.
- En Users, seleccione el usuario de servicio creado en el Paso 1.
- En Select a role, elija Truvio.SubscriptionService.
- Haga clic en Assign.
Solo las entidades de seguridad a las que se haya asignado el rol de aplicación Truvio.SubscriptionService podrán autenticarse en la API Core.
Paso 4: Configurar TruvioSense en Business Central
Todos los pasos fuera del sistema ERP están completados. Los pasos restantes se realizan en Business Central.
La página de configuración se llama TruvioSense - Coding & Approvals Setup. Ábrala buscando el nombre de la página, o desde ExFlow Setup --> TruvioSense - Coding & Approvals --> TruvioSense setup.
La página de configuración controla TruvioSense para todas las empresas de la base de datos desde un solo lugar. La lista de empresas muestra todas las empresas. Al seleccionar una empresa en la lista, las secciones Companies y Vendors se actualizan y muestran la configuración de esa empresa. La página se abre con la empresa actual seleccionada, y la empresa actual se muestra en negrita. En esta página no es posible agregar ni eliminar empresas.
La página tiene tres secciones:
- Companies (arriba): la categoría de cola de trabajos de la empresa seleccionada, más los campos de estado Job handler scheduled y Continuous export enabled
- Lista de empresas: todas las empresas de la base de datos, con Company identifier y Enabled. La empresa actual se muestra en negrita
- Vendors (abajo): los proveedores de la empresa seleccionada en la lista
Sección Companies
| Campo | Descripción |
|---|---|
| Job queue category | La categoría de cola de trabajos utilizada para los trabajos de TruvioSense en la empresa seleccionada. La categoría debe existir en esa empresa. Se requiere una categoría antes de poder programar el controlador de trabajos |
| Job handler scheduled | Sí cuando el controlador de trabajos de TruvioSense existe en la cola de trabajos. El controlador de trabajos es compartido por todas las empresas. Solo lectura |
| Continuous export enabled | Sí cuando el servicio de TruvioSense está disponible, de modo que los documentos se exportan en cuanto se crean. ExFlow puede desactivar esta opción durante un tiempo si el servicio no responde. Solo lectura |
Lista de empresas
| Campo | Descripción |
|---|---|
| Name | El nombre de la empresa. Solo lectura |
| Company identifier | El nombre de la empresa tal como se envía al servicio de TruvioSense, en un formato seguro para URL. Solo lectura |
| Enabled | Activa TruvioSense para la empresa. Solo se exportan documentos de empresas habilitadas. No es posible habilitar una empresa hasta que se haya ejecutado la actualización de datos |
Sección Vendors
| Campo | Descripción |
|---|---|
| Vendor No. | El número de proveedor |
| Name | El nombre del proveedor |
| Enabled | Activa TruvioSense para el proveedor. Los documentos del proveedor se exportan y se utilizan para predecir la codificación en el ExFlow Import Journal |
| Status | El último estado del proveedor según el servicio de TruvioSense. Utilícelo para encontrar proveedores con problemas |
| Document images sent | El número de imágenes de documentos enviadas para el proveedor. Profundice para abrir TruvioSense Documents filtrado por los documentos enviados del proveedor |
La sección Vendors también incluye las acciones Enable all vendors y Disable all vendors, que cambian todos los proveedores de la empresa seleccionada a la vez.
Instalar la extensión
- Abra Business Central
- Busque Extension Management
- Instale TruvioSense - Coding & Approvals de SignUp Software AB
- Espere a que se complete la instalación
- Reinicie la sesión si se solicita
Ejecutar la actualización de datos
- Abra TruvioSense - Coding & Approvals Setup
- Seleccione Related --> Run data upgrade
La actualización de datos se ejecuta para todas las empresas de la base de datos. Prepara las referencias de documentos de ExFlow existentes, crea el Prediction mapping predeterminado y establece el punto de partida de la exportación inicial por proveedor. No es posible habilitar una empresa, y View predictions no está disponible, hasta que se haya ejecutado la actualización de datos.
Incorporación
La incorporación conecta el entorno de Business Central con el servicio de TruvioSense. Utilice el usuario de servicio preparado en los pasos 1–3.
- En TruvioSense - Coding & Approvals Setup, seleccione Onboarding --> Onboard
- Welcome: seleccione Next
- Login: se abre una ventana aparte. Inicie sesión con el usuario de servicio y complete los pasos en esa ventana; después, vuelva a la página de incorporación. Si la ventana no se abre, permita las ventanas emergentes para el sitio e inténtelo de nuevo. Este paso se omite si el entorno ya ha iniciado sesión
- Register: revise la información que identifica el entorno ante TruvioSense:
- URL: la URL del entorno de Business Central
- ERP System Name: BC
- Onboarding Usage: External o Internal, tomado de ExFlow Global Setup
- Environment Type: el tipo de entorno, por ejemplo producción o sandbox
- Region: la región de Azure donde TruvioSense procesa y almacena los datos. Es el único campo que se puede cambiar. Déjelo en blanco para utilizar la región predeterminada
- Tenant ID: el identificador de inquilino del entorno
- Subscription Service Name y Authentication Email: la suscripción en la que está registrado el entorno y el correo electrónico del usuario de Business Central que ha iniciado sesión
- URL: la URL del entorno de Business Central
- Seleccione Next y confirme el registro
- Finish: seleccione Finish para cerrar la guía
El campo Authentication Email del usuario de Business Central debe tener un valor; de lo contrario, el registro se detiene con un error.
Onboarding Usage se establece en ExFlow Global Setup, en el grupo TruvioSense. El valor predeterminado es External. No lo cambie después de completar la incorporación.
Comprobar el estado de la incorporación
Seleccione Onboarding --> Onboarding status para ver la conexión con el servicio de TruvioSense:
| Campo | Significado |
|---|---|
| Core Client Id | El identificador que identifica el entorno ante el servicio core |
| Service Configuration | Sí cuando se ha leído la configuración del servicio |
| Core Service Login | Sí cuando el entorno ha iniciado sesión en el servicio core |
| Core Service Subscription State | El estado de la suscripción del entorno |
| Service URL | La dirección del servicio de TruvioSense, basada en la región y el entorno seleccionados en la incorporación |
| KeyVault Source | El origen de la configuración del almacén de claves |
Utilice Login to core services para volver a iniciar sesión y Logout of core services para cerrar la sesión. Todas las funciones de TruvioSense dejan de funcionar mientras el entorno no tiene la sesión iniciada.
Habilitar empresas
- Abra TruvioSense - Coding & Approvals Setup
- Para cada empresa que se vaya a activar:
- Seleccione la empresa en la lista
- Seleccione una Job queue category en la sección Companies
- Establezca Enabled en Sí
- Seleccione la empresa en la lista
Comience con una empresa para verificar que todo funciona antes de habilitar empresas adicionales.
Habilitar proveedores
TruvioSense funciona por proveedor. Con la empresa seleccionada en la lista, utilice la sección Vendors para seleccionar los proveedores que se van a activar:
- Establezca Enabled por proveedor, o
- Utilice Enable all vendors o Disable all vendors para cambiar todos los proveedores de la empresa a la vez
Buenos candidatos:
- Proveedores con 20+ facturas históricas
- Patrones de facturación regulares y repetitivos
- Codificación consistente
Malos candidatos:
- Proveedores de una sola vez
- Proveedores con tipos de factura muy variables
- Proveedores nuevos sin historial
Programar el controlador de trabajos
El controlador de trabajos ejecuta el procesamiento en segundo plano: inicia la exportación de documentos y la actualización de la información de proveedores.
- Abra TruvioSense - Coding & Approvals Setup
- Seleccione Schedule job handler y confirme
Se debe seleccionar una Job queue category para la empresa actual antes de poder programar el controlador de trabajos. A continuación, Job handler scheduled muestra Sí. El controlador de trabajos es compartido por todas las empresas, por lo que solo es necesario programarlo una vez.
El movimiento de cola de trabajos se ejecuta cada 60 minutos, de lunes a viernes, entre las 06:00 y las 18:00. Su descripción es Handles scheduling of TruvioSense related jobs.
Trabajos en segundo plano
TruvioSense utiliza tres trabajos de cola de trabajos. Solo el controlador de trabajos se programa manualmente. El controlador de trabajos crea los otros dos trabajos en cada ejecución, por lo que solo el movimiento del controlador de trabajos permanece en Job Queue Entries. El trabajo de exportación y el trabajo de información de proveedores tienen la misma descripción. Utilice Object ID to Run para distinguirlos.
Los trabajos se configuran una vez por base de datos, no una vez por empresa:
- Schedule job handler comprueba la cola de trabajos en todas las empresas. Si ya existe un controlador de trabajos en cualquier empresa, no se crea uno nuevo
- Los movimientos de cola de trabajos se crean en la empresa donde se ejecuta Schedule job handler, con la Job queue category de esa empresa
- Cada ejecución del trabajo de exportación y del trabajo de información de proveedores abarca todas las empresas donde Enabled es Sí. Las empresas que no están habilitadas se omiten
- Para programar el controlador de trabajos se requiere permiso para leer los movimientos de cola de trabajos en todas las empresas
Para encontrar los movimientos de cola de trabajos, abra Job Queue Entries en la empresa donde se programó el controlador de trabajos.
| Codeunit | Nombre | Descripción en la cola de trabajos | Cuándo se ejecuta | Cómo funciona |
|---|---|---|---|---|
| 12069082 | ExMLJobHandler | Handles scheduling of TruvioSense related jobs. | Periódico: cada 60 minutos, de lunes a viernes, 06:00–18:00. Se crea una vez con Schedule job handler | Programa los otros dos trabajos. En cada ejecución, comprueba en todas las empresas si hay un trabajo de exportación activo y un trabajo de información de proveedores activo (estado Ready, Waiting o In Process). Si un trabajo no está activo, crea un nuevo movimiento de cola de trabajos para él en la empresa actual. El movimiento se inicia de inmediato, se ejecuta una vez y utiliza la Job queue category de la empresa. Un trabajo que ya está activo no se vuelve a iniciar. Si el movimiento del controlador de trabajos está en Error u On Hold en la empresa actual, se reinicia al abrir la página de configuración |
| 12069080 | ExMLExport | ExFlow machine learning automation service | Una vez por ejecución del controlador de trabajos. También se puede iniciar con Run document export | Exporta las facturas registradas de todas las empresas habilitadas, empezando por las más recientes. Los abonos no se exportan. Omite los documentos de proveedores no habilitados y los documentos anteriores al punto de partida de exportación del proveedor. Para cada documento, primero envía el PDF (Document image sent = Sí) y después el documento registrado con su codificación (Posted document sent = Sí). Si un paso falla, el motivo se guarda en Error message y el documento se vuelve a intentar en la siguiente ejecución. Se detiene en una empresa donde no se ha ejecutado la actualización de datos |
| 12069104 | ExMLVendorInsights | ExFlow machine learning automation service | Una vez por ejecución del controlador de trabajos. También se puede iniciar con Update vendor insights | Actualiza el Status de los proveedores de todas las empresas habilitadas. Para cada proveedor, borra Status. Para los proveedores habilitados, obtiene a continuación el último estado del servicio de TruvioSense. Si el servicio aún no tiene datos del proveedor, Status queda en blanco. Se detiene en una empresa donde no se ha ejecutado la actualización de datos |
Configuración de los movimientos de cola de trabajos
La tabla muestra cómo se configura cada trabajo en Job Queue Entries. ExFlow rellena estos valores automáticamente. Utilice Schedule job handler para crear el controlador de trabajos, en lugar de crear el movimiento manualmente.
| Campo | Controlador de trabajos | Exportación de documentos | Información de proveedores |
|---|---|---|---|
| Object Type to Run | Codeunit | Codeunit | Codeunit |
| Object ID to Run | 12069082 | 12069080 | 12069104 |
| Object Caption to Run | ExMLJobHandler | ExMLExport | ExMLVendorInsights |
| Description | Handles scheduling of TruvioSense related jobs. | ExFlow machine learning automation service | ExFlow machine learning automation service |
| Job Queue Category Code | La Job queue category de la empresa donde se programa el controlador de trabajos | Igual que el controlador de trabajos | Igual que el controlador de trabajos |
| Recurring Job | Sí | No | No |
| No. of Minutes between Runs | 60 | – | – |
| Run on | De lunes a viernes | – | – |
| Starting Time / Ending Time | 06:00 / 18:00 | – | – |
| Maximum No. of Attempts to Run | 1 | 1 | 1 |
| Earliest Start Date/Time | El momento en que se selecciona Schedule job handler | El momento en que el controlador de trabajos crea el movimiento | El momento en que el controlador de trabajos crea el movimiento |
| Estado al crearse | Ready | Ready | Ready |
| Creado por | Schedule job handler en la página de configuración | El controlador de trabajos, en cada ejecución | El controlador de trabajos, en cada ejecución |
| Se utiliza para | Iniciar los otros dos trabajos | Enviar PDF y facturas registradas a TruvioSense, para que el servicio pueda crear el modelo de predicción por proveedor | Actualizar el Status de los proveedores en la sección Vendors de la página de configuración |
| Inicio manual | – | Related --> Run document export en la página de configuración | Related --> Update vendor insights en la página de configuración |
Un inicio manual ejecuta el trabajo de inmediato en la sesión actual, no a través de la cola de trabajos. El trabajo sigue abarcando todas las empresas habilitadas.
Estos trabajos no envían los PDF de los documentos del ExFlow Import Journal. Los envía la exportación continua cuando se actualiza el documento del diario, siempre que Continuous export enabled muestre Sí.
Esperar la exportación inicial de datos
Después de habilitar proveedores, el sistema exporta las facturas registradas históricas en segundo plano a través de la cola de trabajos.
- El controlador de trabajos inicia la exportación en cada ejecución
- Las facturas registradas de proveedores habilitados en empresas habilitadas se envían al servicio de ML, junto con el PDF de cada factura
- Supervise el progreso en la página TruvioSense Documents
La exportación inicial envía las facturas registradas más recientes por proveedor, hasta un límite establecido por el servicio de TruvioSense. Las facturas sin un PDF adjunto no se exportan. La exportación inicial puede tardar varias horas según el volumen de datos. No se requiere ninguna acción del usuario.
Para iniciar una exportación de inmediato, seleccione Related --> Run document export.
Verificar la configuración
Después de unas horas, confirme que el sistema está funcionando:
| Verificación | Cómo |
|---|---|
| Documentos exportados | Abra TruvioSense Documents: verifique que Document image sent y Posted document sent = Sí, y que Error message está en blanco |
| Estado del proveedor | En la sección Vendors de la página de configuración, Document images sent aumenta con el tiempo y Status muestra el último estado del servicio |
| Cola de trabajos en ejecución | Busque Job Queue Entries: el movimiento del controlador de trabajos de TruvioSense debe mostrar el estado Ready |
| Predicciones disponibles | Procese una nueva factura en el ExFlow Import Journal y seleccione TruvioSense --> View predictions (espere 24–48 horas después de la primera exportación) |
Otras acciones de la página de configuración
| Acción | Descripción |
|---|---|
| Documents | Abre TruvioSense Documents |
| Prediction mapping | Abre la asignación de los campos de predicción a los campos del diario. Consulte Uso de predicciones |
| Run document export | Ejecuta ahora la exportación para todas las empresas y proveedores habilitados |
| Update vendor insights | Obtiene ahora el último Status de los proveedores desde el servicio |
| Reset data | Marca todos los documentos como no enviados y restablece el punto de partida de exportación de todos los proveedores, de modo que todos los documentos se vuelven a exportar. Esta acción no se puede deshacer |