Integraciones
Un proceso sirve cuando habla con lo que ya tiene.
KulturPro no pretende reemplazar sus sistemas. Expone una API para lo que quiera automatizar, recibe datos de afuera con un token acotado y llama a sus servicios desde el propio formulario.
- Proveedores
- Clientes
- Contratistas
- Tareas por correo con código de verificación
- Webhook /v1/webhook/submit
- API REST /v1
- Formularios públicos por token
- Llamada a su servicio HTTP
- Correo SMTP o SendGrid
- Exportar a Excel y PDF
- SQL Server propio
- Esquema de tablas de catálogo
- Vistas de solo lectura
- Microservicio propio
- Hospedado bajo otra suite
- Su ERP, por API
Punto por punto
Cómo se conecta cada cosa.
API REST
- Una sola API bajo /v1
Todo lo que hace la pantalla pasa por la misma API: procesos, tareas, módulos, datos, calendarios, plazos, usuarios y activos.
- Respuesta uniforme
Cada llamada devuelve éxito, datos y un identificador de traza que sirve para rastrear el error en el registro del servidor.
- Documentada con Swagger
La documentación se genera del propio código, así que no se queda atrás de la versión instalada.
- Sesión con cookie o token
La aplicación usa cookies de sesión; para integraciones se emiten tokens acotados a lo que van a hacer.
Webhook de entrada
- Token para una tarea concreta
El token se genera desde la aplicación y queda amarrado a una instancia, una tarea y un campo, con vencimiento.
- Cifrado y sin estado
Va cifrado con AES-256-GCM; si alguien lo altera, deja de servir. El servidor no necesita guardarlo.
- Se escribe una sola vez
La primera escritura gana; una segunda recibe un conflicto. Así un reintento del sistema externo no duplica el dato.
- Con límite de peticiones
El punto de entrada es público pero está limitado por frecuencia, y responde con códigos claros para vencido, revocado o no encontrado.
Llamadas salientes
- Desde el formulario
Al abrir el formulario, al cambiar un campo o al pulsar un botón, se llama a un servicio suyo y se mapea la respuesta a los campos.
- Con la sesión del usuario
La llamada puede llevar la sesión de quien está trabajando, para que su servicio aplique sus propios permisos.
- También para el usuario externo
Un tercero que llena un formulario por correo puede disparar la misma llamada, con una autenticación integrada.
- Configurada, no programada
El servicio, los encabezados y el mapeo se definen en el diseñador.
Correo y notificaciones
- SendGrid o su SMTP
Se elige el proveedor en la configuración del servidor; también hay una carpeta local para pruebas.
- En el idioma de cada quien
El correo sale en el idioma que tiene guardado el destinatario.
- Plantilla por alerta
Cada alerta de plazo lleva su propio mensaje.
- Enlaces para terceros
El correo al usuario externo lleva el enlace de la tarea y, aparte, el código de verificación.
Extender con lo suyo
- Microservicio compañero
Un servicio propio puede compartir la misma base de datos y la misma sesión, y devolver su resultado al proceso por el webhook.
- Tablas de catálogo
Las listas desplegables leen tablas del esquema de datos del producto, que se pueden llenar por API.
- Hospedado en otra suite
KulturPro corre como aplicación hija de un ERP, tomando su sesión y su mapa de permisos, y se enciende por empresa.
- Sin conectores empaquetados
No hay conector listo para SAP, Oracle o Dynamics: la integración se hace por API y webhook.
# 1. La aplicación emite un token para un campo de una tarea POST /v1/webhook/generate-token { "processInstanceId": 4821, "taskInstanceId": 9137, "componentId": "resultadoInspeccion", "expiresInHours": 48 } # 2. El sistema externo escribe una sola vez, sin sesión POST /v1/webhook/submit { "token": "eyJhbGciOi…", "value": "Conforme" } # 3. Respuesta 200 { "success": true, "traceId": "0HN7…" } 409 // ya se había escrito: el reintento no duplica 410 // el token venció o fue revocado
Reglas
Cómo integramos.
Cuatro decisiones que evitan las integraciones que nadie se atreve a tocar después.
El token no es una llave maestra
Cada token del webhook sirve para una instancia, una tarea y un campo. No abre nada más, y vence.
La integración no adivina
Si el dato llega dos veces, la segunda recibe un conflicto explícito en vez de duplicar en silencio.
Nada obligatorio en la nube
El correo, la IA y los servicios externos son opcionales: sin ellos el producto funciona, con menos automatismo.
Los datos se pueden consultar
Todo queda en tablas de SQL Server suyas; no hay un formato propietario del que haya que rescatarlos.
Preguntas
Sobre integrar.
¿Puede un sistema nuestro arrancar un proceso?
Sí, por la API. El arranque de un proceso es una llamada como cualquier otra, y también se puede disparar desde un registro de un módulo o desde un elemento de activos.
¿Y si el sistema externo no puede autenticarse?
Para ese caso está el webhook: usted genera el token desde la aplicación, se lo entrega al sistema externo y él solo puede escribir en el campo para el que se emitió.
¿Hay webhooks de salida?
No en el sentido de suscribirse a eventos. Lo que hay son llamadas salientes configuradas en el formulario y en los eventos de tarea.
¿Se integra con el directorio de la empresa?
Hoy no. No hay inicio de sesión único, SAML ni Active Directory: los usuarios viven en KulturPro, con su política de contraseñas y su segundo factor.
Traiga el sistema con el que tiene que hablar.
En la demo revisamos su caso concreto y le decimos si se resuelve con la API, con el webhook o con un servicio aparte.