API para integración con Pirani

Ahora en Pirani por medio de integración por API podrás reportar los eventos y los registros transaccionales de AML que tengas en otros sistemas de registros.

Ahora en Pirani contamos con la integración por API, funcionalidad que te facilitará el importe de registros desde otros sistemas de reporteria de eventos y de inscripción de registros transaccionales. 

API para eventos: Adicional a los dos métodos de registro de eventos disponibles, el interno y el externo, ahora con la integración por API podrás crear eventos que tengas en otros sistemas y registrarlos en el módulo de eventos de Pirani. Además podrás asignar los roles que pueden acceder a la funcionalidad.

→ Funcionalidad disponible para los sistemas de gestión (ORM, ISMS y Compliance) en el plan Enterprise. 

API para AML: Con la integración para AML (Antilavado de dinero) podrás crear y actualizar desde otros sistemas de inscripción los registros transaccionales, es decir los clientes, productos y transacciones que tengas registrados en tus sistemas actuales.

→ Funcionalidad disponible para AML y solo en el plan Enterprise. 

¿Cómo realizar la integración por API?

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”.

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

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

Documentación, Soporte y Access token

Documentación: Para encontrar la documentación de eventos o AML debes dar clic en cada botón y ahí se desplegará las instrucciones para implementar el API, la lista de errores, métodos y parámetros de cada una (Se recomienda que esta sea gestionada por un desarrollador).

Soporte: En esta sección podrás encontrar un help center donde podremos ayudarte si tienes alguna duda sobre el proceso de integración y los errores que pueda presentar el proceso.

Access Token: Aquí podrás genera tu código único para realizar la integración de forma segura y efectiva. 

Integración de Eventos a través de la API

La API de Pirani ahora permite la integración de campos dinámicos en la creación de eventos. Anteriormente, la API sólo admitía el envío de campos básicos, como: 

• Nombre del evento 
• Descripción 
• Indicador de si genera pérdidas 
• Lugar donde ocurrió 
• Fecha de inicio 
• Fecha de descubrimiento 

Los clientes pueden enviar campos adicionales personalizados desde su aplicación externa o Pirani, permitiendo integrar toda la información relevante sin restricciones a los campos básicos.

¿Para qué sistemas de gestión aplica esta actualización?

Esta mejora en la API está disponible para los siguientes sistemas de gestión:

ORM (Gestión de Riesgos Operativos)

Compliance (Cumplimiento)

ISMS (Gestión de Seguridad de la Información)

Nota: Esta funcionalidad no aplica para el sistema de AML.

¿Cómo hacer la integración de la API en eventos?

En el sección de información técnica dale clic en el botón de “métodos” ahora dale nuevamente clic en “crear evento”

Crea o verifica los campos dinámicos:

Asegúrate de que los campos dinámicos que deseas integrar estén creados. Por ejemplo, podrías tener campos como:

• Fecha de Finalización del Evento
• Descripción del Analista de Riesgos
• Impacto Económico

Si no existen, créalos asignándoles un nombre, tipo de dato (texto, número, fecha, etc.) y otras propiedades necesarias.

Preparación de la aplicación externa

En tu aplicación externa, debes asegurarte de que los datos que deseas enviar a Pirani estén correctamente estructurados. Esto incluye tanto los campos básicos como los campos dinámicos.

Recopila la información:

Asegúrate de que tu aplicación externa tenga acceso a los datos que deseas enviar, incluyendo:

Campos básicos (nombre, descripción, lugar, fechas, etc.).

Campos dinámicos (los que configuraste en Pirani).

Estructura los datos:

• Organiza los datos en un formato compatible con la API de Pirani (por ejemplo, JSON).

• Asegúrate de que los nombres de los campos dinámicos coincidan exactamente con los configurados en Pirani.

Configuración de la API

Este paso debe ser realizado por el equipo técnico de tu organización, ya que implica trabajar con código y parámetros de la API.

Obtén acceso a la API

• Asegúrate de tener las credenciales y permisos necesarios para usar la API de Pirani.

Configura la solicitud de creación de eventos:

• Utiliza el método Crear Evento de la API.
• Incluye los campos básicos y dinámicos en la solicitud. Por ejemplo, en formato JSON:

Envía la solicitud

Utiliza el endpoint correspondiente de la API para enviar la solicitud. Asegúrate de que la solicitud incluya los encabezados (headers) necesarios, como el token de autenticación.

Validación y creación del evento

Una vez enviada la solicitud, Pirani procesará la información y realizará las siguientes acciones

Validación de datos

Pirani verificará que los campos básicos y dinámicos estén correctamente estructurados y que los nombres de los campos dinámicos coincidan con los configurados en la plataforma.

Si hay errores (por ejemplo, un campo dinámico no existe o tiene un formato incorrecto), la API devolverá un mensaje de error con detalles para su corrección.

Creación del evento

Si la información es válida, Pirani creará el evento y lo almacenará en la plataforma.

El evento aparecerá en la sección correspondiente (ORM, Compliance o ISMS) con todos los campos básicos y dinámicos integrados.

Verificación en Pirani

Después de enviar la información, es importante verificar que el evento se haya creado correctamente.

Accede a la sección de eventos:

• Dentro de Pirani, ve a la sección de eventos del sistema de gestión correspondiente.

• Busca el evento recién creado.

Revisa los campos

• Asegúrate de que todos los campos básicos y dinámicos se muestren correctamente.

• Verifica que la información enviada desde tu aplicación externa coincida con la mostrada en Pirani.