1. Help Center
  2. Ajustes del sistema

Integración de herramientas analíticas con Pirani

Pirani ahora se conecta con las principales herramientas analíticas para una gestión de riesgos más estratégica. En Pirani sabemos que el análisis de datos es clave para tomar mejores decisiones.

 Por eso, hemos integrado nuestra plataforma con herramientas analíticas como Power BI, Tableau, Cognos y Looker, entre otras.

Ahora puedes visualizar y analizar la información de riesgos de forma más ágil y personalizada.

¿Qué significa esto para ti?

  • Decisiones más acertadas, gracias a reportes y dashboards diseñados a tu medida.

  • Datos conectados, al integrar la información de Pirani con sistemas financieros, contables y más.

  • Menos trabajo manual, porque ya no necesitas exportar datos una y otra vez.

  • Total flexibilidad, con compatibilidad en diversas plataformas.

  • Gestión de riesgos alineada al negocio, para que las estrategias sean más efectivas.

Esta funcionalidad estará disponible para los planes Enterprise en los sistemas de gestión ORM, ISMS, Compliance, AML y Auditoría. Así, podrás potenciar la gestión de riesgos con insights más profundos y decisiones más informadas.

¿Cómo realizar la integración con Pirani?

Para realizar la integración con el software de Pirani debes dar clic en la parte superior izquierda, en los puntos que se encuentran al lado del logo de Pirani, ahí se desplegará un recuadro en el cual debes dar clic en la sección “Administrar organización

Power BI 1

Al lado derecho encontrarás varias opciones para gestionar tu organización, ahora debes dar clic en la opción “ajustes del sistema

Power-BI-2.

En esta sección podrá encontrar toda la información técnica para integrar el API:

Documentación, API, Soporte y Access token

Power-BI-3.

Access token:

Es una clave única que permite autenticar y autorizar la conexión entre Pirani y herramientas analíticas como Power BI. Gracias a esta llave digital, la integración se realiza de forma segura, asegurando que solo los usuarios autorizados puedan acceder y utilizar los datos.

URL de la API

Para utilizar la URL de la API en la integración con herramientas como Power BI, es necesario reemplazar <Nombre modulo> con el módulo específico que se desea conectar.

En Pirani existen varios módulos como controles, riesgos, procesos, entre otros, y cada uno de ellos representa una fuente de información distinta.

Para obtener datos de un módulo en particular, simplemente se debe sustituir <Nombre modulo> en la URL con el nombre correspondiente de la entidad.

Ejemplo:

Si queremos extraer información del módulo de riesgos, la URL quedaría así:
➡️ https://api.pirani.co/prod/services/appclients/data-extraction/v1/resource/RISKS

De esta manera, cada integración puede personalizarse según los datos que se necesiten conectar y analizar.

📌 Para facilitar este proceso, proporcionaremos una tabla con los nombres de cada entidad, de manera que puedas identificar fácilmente cómo construir la URL según el módulo que deseas integrar.

Tabla-nombre-entidad-power-bi

Use el encabezado:

El encabezado (HEADERS) en una solicitud a la API define información adicional que el sistema necesita para procesar correctamente la petición. En este caso, se requieren un encabezado clave:

  1. X-PIRANI-APIKEY: ${APIKEY}
    • Es el token de autenticación que permite validar que el usuario tiene permisos para acceder a la API.
    • ${APIKEY} debe ser reemplazado con la clave de acceso generada en Pirani, asegurando una conexión segura.

Este encabezado es esencial para que la API reconozca la solicitud y permita la extracción de datos de forma segura y estructurada.

Una vez que tengamos la información necesaria para integrar los servicios de Pirani en tus aplicativos, el siguiente paso es acceder a Power BI o otras herramientas analíticas que este usando para integrar los datos de Pirani.

Dentro de Power BI, haz clic en "Obtener datos" y luego selecciona "Web". A continuación, aparecerá una ventana en la que debes elegir la opción "Uso avanzado".

Power-BI-4

Luego, en el campo "Partes de URL", ingresa la siguiente URL de la API:

https://api.pirani.co/prod/services/appclients/data-extraction/v1/resource/RISKS

Recuerda que cada módulo requiere una integración independiente, como mencionamos anteriormente.

En los parámetros de encabezado de la solicitud HTTP, ingresa "X-PIRANI-APIKEY" y, a continuación, el Access Token. Una vez completado este paso, haz clic en "Aceptar".