Se aplica a: Administración · Administración de socios · Módulo: API pública / Integraciones
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Proveedor: Power BI · Tipo de integración: unidireccional · Dirección: de Alvys a Power BI.
Conecte Power BI a la API pública de Alvys para incorporar datos operativos en tiempo real a los paneles e informes de Power BI mediante los métodos GET y POST para filtrar y recuperar datos.
Descripción general
Esta integración conecta Microsoft Power BI (también conocido como Power BI, PowerBI, Microsoft Power BI o inteligencia empresarial) con la API pública de Alvys (OData/REST API) para que pueda importar datos operativos en tiempo real a Power BI para generar informes y análisis. Una vez conectado, Power BI recupera datos de Alvys en tiempo real para que pueda crear paneles actualizados y usar las herramientas de visualización de Power BI para representar los datos de Alvys. La conexión admite solicitudes GET para la recuperación básica de datos y métodos POST para búsquedas avanzadas, que incluyen filtrado, selección de rangos de fechas y consultas basadas en el estado que van más allá de los informes básicos. Los datos se mueven en una sola dirección: de Alvys a Power BI. Con acceso a puntos finales como Cargas, Conductores, Combustible, Facturas, Viajes y Camiones, puede explorar datos en múltiples áreas operativas y generar análisis adaptados a sus necesidades.
Requisitos previos
Antes de conectar Power BI a Alvys, asegúrese de cumplir con los siguientes requisitos: Su cuenta cuenta con uno de los roles necesarios: para generar y administrar las credenciales de la API pública de Alvys, se requiere el rol de Administrador o Administrador de socios . Sus credenciales de la API de Alvys están listas: necesita su ID de cliente, ID de inquilino y secreto de cliente de la plataforma Alvys, generados en Perfil y luego en API. Power BI Desktop está instalado con la última versión disponible. La configuración de privacidad de Power BI está configurada para deshabilitar las comprobaciones de privacidad, de modo que la integración de la API se ejecute sin problemas.
¿Cómo conectarse?
En la plataforma Alvys, vaya a Perfil y luego a API para abrir la página de la API pública.
Localiza tus credenciales de API en esa página. Necesitas el ID de cliente, el ID de inquilino y el secreto de cliente. Estos tres valores autentican Power BI en la API pública de Alvys.
Genera un token de API. El token autentica cada solicitud que Power BI envía a los puntos finales de la API de Alvys.
Abra Power BI Desktop y confirme que tiene instalada la última versión.
En Power BI Desktop, configure los ajustes para desactivar las comprobaciones de privacidad y así lograr que la integración de la API se ejecute sin interrupciones.
Utilice sus credenciales y token para conectar Power BI a los puntos finales de la API pública de Alvys sobre los que desea generar informes.
Para obtener información completa sobre la configuración, incluidos ejemplos de consultas y un archivo de Power BI preconfigurado para una integración rápida, consulte la documentación de la API pública de Alvys .
¿Qué se sincroniza?
Power BI obtiene datos de los puntos de conexión de la API pública de Alvys, y cada punto de conexión se corresponde con un área operativa de Alvys. El punto de conexión de búsqueda de cargas devuelve datos de cargas y permite filtrarlas por criterios como fecha y estado. El punto de conexión de búsqueda de conductores devuelve los detalles de los conductores y permite realizar consultas por flota o estado. El punto de conexión de búsqueda de combustible devuelve el historial de transacciones de combustible. El punto de conexión de búsqueda de facturas devuelve datos de facturas y permite recuperarlas por fecha o estado. Hay puntos de conexión adicionales disponibles para viajes y camiones, lo que permite importar datos de varias áreas operativas a Power BI.
La conexión es unidireccional y bajo demanda. Power BI recupera datos de la API pública de Alvys en tiempo real al ejecutar o actualizar una consulta, de modo que los paneles de Power BI reflejan los datos actuales de Alvys en el momento de la recuperación. Las solicitudes GET gestionan la recuperación básica de datos. Los métodos POST gestionan las búsquedas avanzadas, incluido el filtrado por estado o por rangos de fechas. Los datos fluyen únicamente desde Alvys a Power BI; no se escribe nada de vuelta en Alvys.
Verifica que funcione.
En Power BI Desktop, ejecute una consulta en uno de los puntos finales de Alvys, como Loads Search.
Confirma que los datos de Alvys se cargan en Power BI sin errores de autenticación o privacidad.
Crea una visualización sencilla a partir de los datos devueltos para confirmar que los campos se rellenan como se espera.
Solución de problemas
Power BI no puede autenticarse en la API de Alvys.
Confirma que has iniciado sesión en Alvys con el rol de Administrador o Administrador de socios , ya que solo estos roles pueden generar y administrar credenciales de API públicas.
Ve a Perfil, luego a API y confirma que tu ID de cliente, ID de inquilino y secreto de cliente sean correctos y se hayan copiado sin espacios adicionales.
Genera un nuevo token de API y úsalo para tus solicitudes.
Power BI bloquea la conexión con un error de privacidad.
Abra la configuración de Power BI Desktop.
Desactive las comprobaciones de privacidad para que Power BI permita que se ejecute la conexión con la API de Alvys.
Vuelve a ejecutar tu consulta.
Una consulta no devuelve datos o devuelve resultados limitados.
Confirme que está utilizando el método POST cuando necesite filtrar, buscar por rango de fechas o por estado, ya que las solicitudes GET solo devuelven datos básicos.
Comprueba los valores de tu filtro, rango de fechas y estado comparándolos con los ejemplos de consulta que aparecen en la documentación de la API pública de Alvys.
Límites y sin soporte
Esta es una conexión unidireccional de solo lectura. Power BI extrae datos de Alvys y no puede escribir ni enviar datos de vuelta a Alvys. El filtrado avanzado, la selección de rangos de fechas y las consultas basadas en el estado requieren métodos POST. Las solicitudes GET solo admiten la recuperación básica de datos.
Preguntas frecuentes
P: ¿Puedo usar Power BI para conectarme directamente a la API de Alvys?
R: Sí. La API pública de Alvys admite la integración con Power BI y permite los métodos GET y POST para recuperar datos.
P: ¿Por qué utilizar métodos POST con Power BI?
A: Las solicitudes GET permiten la recuperación básica de datos. Los métodos POST habilitan capacidades de búsqueda avanzadas, incluido el filtrado por estado o por rangos de fechas.
P: ¿Dónde puedo encontrar mis credenciales de API?
A: Tus credenciales de API (ID de cliente, ID de inquilino y secreto de cliente) están disponibles en Perfil y luego en API en la plataforma Alvys.