Documentación

Conectar Cadulis con subcontratistas


Dé a sus subcontratistas los medios para intervenir eficazmente, sin complejidad técnica

Tanto si sus socios utilizan Cadulis como su propio sistema, Cadulis le permite:

  • Compartir intervenciones con subcontratistas
  • Planificar directamente en sus equipos
  • Recibir en tiempo real sus cierres, informes y estados
  • Todo ello sin exponer a sus usuarios ni sus datos internos

Esta guía le explica cómo configurar un webservice de subcontratista, adaptado tanto a un subcontratista interno (multi-BU) como a una empresa externa.


Casos de uso

Desea que un socio (por ejemplo, empresa de mantenimiento):

  • Reciba intervenciones a realizar
  • Las planifique en sus propios equipos
  • Devuelva automáticamente la información de cierre en su entorno

Y todo esto, sin acceso a su interfaz Cadulis, ni integración en su organización interna.


Pasos de configuración

1. Acceder a la configuración

Desde el menú lateral:

  1. Haga clic en Parámetros
  2. Acceda a Webservices subcontratistas (abajo a la derecha)
  3. Haga clic en Crear un webservice subcontratista

Una página introductoria le recuerda:

  • Lo que puede hacer el subcontratista: recibir, planificar, cerrar
  • Lo que usted controla: configuración, rentabilidad, independencia

Haga clic en Crear un webservice subcontratista para continuar.


2. Elegir el tipo de conexión

  • Tipo de acceso: Webservice REST
  • Seleccione la Business Unit correspondiente
  • Haga clic en Crear

3. Configurar el webservice

Información general

  • Nombre: explícito (ej. “SAV Norte – proveedor X”)
  • Descripción: tipo de actividades, frecuencia…

Asistente de planificación (si aplica)

  • Limitar las intervenciones simultáneas
  • Valor máximo autorizado
  • Usar la pertinencia (trayectos, horarios, etc.)
  • URL del asistente: si el subcontratista expone una API de planificación

Sin asistente (alternativa)

  • Duración fija de trayecto
  • Franja horaria del día
  • Pausa para comer (opcional)
  • Distancia / duración utilizadas para las mejores opciones

Definir los accesos autorizados

Marque solo los permisos útiles:

  • Modificar o cerrar una intervención
  • Ver o modificar la información de cierre
  • Crear / modificar un cliente
  • Uso del asistente de planificación

Estos derechos definen lo que usted autoriza, y lo que recuperará (informes, cierres, etc.)


Competencias y material

Agregue recursos específicos:

  1. Haga clic en Competencias / material
  2. Haga clic en + para añadir los criterios
  3. Haga clic en Validar

Esto permite que Cadulis no proponga actividades a subcontratistas no adecuados.


Tratamiento de los datos recibidos

En Modificar los datos recibidos, elija:

  • Ninguna modificación
  • Inicializar si está vacío
  • Reemplazar los datos existentes en Cadulis

4. Finalizar

  • Haga clic en Guardar
  • El webservice está activo

Escenario habitual

  1. Asigna una intervención a un subcontratista
  2. Se transmite a su sistema (API REST o vía Cadulis)
  3. Él la planifica en sus equipos
  4. Él cierra la intervención
  5. Usted recupera automáticamente informe, estado de cierre, etc.

Buenas prácticas

Optimice sus integraciones de subcontratistas

  • Cree un webservice por subcontratista
  • Utilice las competencias / material para filtrar con precisión
  • No otorgue más derechos de los necesarios
  • Active el asistente de planificación solo si es relevante

Dé a sus subcontratistas los medios para intervenir eficazmente, sin complejidad técnica

Tanto si sus socios utilizan Cadulis como su propio sistema, Cadulis le permite:

  • Compartir intervenciones con subcontratistas
  • Planificar directamente en sus equipos
  • Recibir en tiempo real sus cierres, informes y estados
  • Todo ello sin exponer a sus usuarios ni sus datos internos

Esta guía le explica cómo configurar un webservice de subcontratista, adaptado tanto a un subcontratista interno (multi-BU) como a una empresa externa.


🔄 Bonus: Conector Cadulis ↔ Cadulis

Si su subcontratista también utiliza Cadulis, la conexión es aún más sencilla y potente:

  • En el lado del subcontratista, Cadulis expone una API entrante que permite recibir automáticamente las intervenciones transmitidas
  • En el lado del cliente, utiliza una API saliente de subcontratista dedicada para enviar las intervenciones, seguir los estados y recuperar los cierres

🎯 Ventajas:

  • No se requiere desarrollo específico si ambas partes usan Cadulis
  • Sincronización nativa de intervenciones, estados e informes
  • Seguridad y trazabilidad garantizadas
  • Mejor resiliencia que conexiones API a medida
  • Configuración posible en ambos lados para ajustes de disponibilidad, planificación, visibilidad, etc.

Este conector le permite interconectar organizaciones independientes, manteniendo cada una el control de su entorno y de sus usuarios.


Próximo paso recomendado

Envío automático de intervenciones

Para automatizar el envío de intervenciones a sus subcontratistas según reglas de negocio:

  • Cierre KO
  • Replanificación
  • Intervención crítica

👉 Consulte la guía Disparadores avanzados