Documentação do software de gestão, planeamento e otimização das intervenções

Ligar o Cadulis a subcontratados


Dê aos seus subcontratados os meios para intervir eficazmente, sem complexidade técnica

Quer os seus parceiros utilizem o Cadulis ou o seu próprio sistema, o Cadulis permite-lhe:

  • Partilhar intervenções com subcontratados
  • Planear diretamente nas suas equipas
  • Receber em tempo real os seus fechos, relatórios e estados
  • Tudo isto sem expor os seus utilizadores nem os seus dados internos

Este guia explica-lhe como configurar um webservice de subcontratado, adaptado tanto a um subcontratado interno (multi-BU) como a uma empresa externa.


Casos de utilização

Pretende que um parceiro (ex. empresa de manutenção):

  • Receba intervenções a realizar
  • As planeie nas suas próprias equipas
  • Devolva automaticamente as informações de fecho para o seu ambiente

E tudo isto, sem acesso ao seu interface Cadulis, nem integração na sua organização interna.


Etapas de configuração

1. Aceder à configuração

A partir do menu lateral:

  1. Clique em Definições
  2. Aceda a Webservices de subcontratados (no fundo, à direita)
  3. Clique em Criar um webservice de subcontratado

Uma página introdutória recorda-lhe:

  • O que pode fazer o subcontratado: receber, planear, fechar
  • O que controla: configuração, rentabilidade, independência

Clique em Criar um webservice de subcontratado para continuar.


2. Escolher o tipo de ligação

  • Tipo de acesso: Webservice REST
  • Selecione a Business Unit em causa
  • Clique em Criar

3. Parametrizar o webservice

Informações gerais

  • Nome: explícito (ex. “Pós-venda Norte – prestador X”)
  • Descrição: tipo de atividades, frequência…

Assistente de planeamento (se aplicável)

  • Limitar as intervenções simultâneas
  • Valor máximo autorizado
  • Utilizar a pertinência (trajetos, horários, etc.)
  • URL do assistente: se o subcontratado expuser uma API de planeamento

Sem assistente (alternativa)

  • Duração fixa de trajeto
  • Intervalo horário diário
  • Pausa para almoço (facultativo)
  • Distância / duração utilizadas para as escolhas ótimas

Definir os acessos autorizados

Assinale apenas as permissões necessárias:

  • Modificar ou fechar uma intervenção
  • Ver ou modificar as informações de fecho
  • Criar / modificar um cliente
  • Utilização do assistente de planeamento

Estes direitos definem o que autoriza, e o que irá recuperar (relatórios, fechos, etc.)


Competências e material

Adicione recursos específicos:

  1. Clique em Competências / material
  2. Clique em + para adicionar os critérios
  3. Clique em Validar

Isto permite ao Cadulis não propor atividades a subcontratados inadequados.


Tratamento dos dados recebidos

Em Modificar os dados recebidos, escolha:

  • Nenhuma modificação
  • Inicializar se vazio
  • Substituir os dados Cadulis existentes

4. Finalizar

  • Clique em Guardar
  • O webservice está ativo

Cenário habitual

  1. Atribui uma intervenção a um subcontratado
  2. Esta é transmitida para o seu sistema (API REST ou via Cadulis)
  3. Ele planeia nas suas equipas
  4. Ele fecha a intervenção
  5. Recupera automaticamente relatório, estado de fecho, etc.

Boas práticas

Otimize as suas integrações com subcontratados

  • Crie um webservice por subcontratado
  • Utilize as competências / material para filtrar de forma precisa
  • Não conceda mais direitos do que o necessário
  • Ative o assistente de planeamento apenas se fizer sentido

Dê aos seus subcontratados os meios para intervir eficazmente, sem complexidade técnica

Quer os seus parceiros utilizem Cadulis ou o seu próprio sistema, o Cadulis permite-lhe:

  • Partilhar intervenções com subcontratados
  • Planear diretamente nas suas equipas
  • Receber em tempo real os seus fechos, relatórios e estados
  • Tudo isto sem expor os seus utilizadores nem os seus dados internos

Este guia explica-lhe como configurar um webservice de subcontratado, adaptado tanto a um subcontratado interno (multi-BU) como a uma empresa externa.


🔄 Bónus: Conector Cadulis ↔ Cadulis

Se o seu subcontratado também utiliza Cadulis, a ligação é ainda mais simples e poderosa:

  • Do lado do subcontratado, o Cadulis expõe uma API de entrada que permite receber automaticamente as intervenções transmitidas
  • Do lado do dador de ordem, utiliza uma API de saída de subcontratado dedicada para enviar as intervenções, acompanhar os estados e recuperar os fechos

🎯 Vantagens:

  • Não é necessário qualquer desenvolvimento específico se ambas as partes utilizarem Cadulis
  • Sincronização nativa das intervenções, estados e relatórios
  • Segurança e rastreabilidade garantidas
  • Maior resiliência do que ligações API à medida
  • Configuração possível de ambos os lados para definições de disponibilização, planeamento, visibilidade, etc.

Este conector permite-lhe interligar organizações independentes, mantendo cada uma o controlo do seu ambiente e dos seus utilizadores.


Próximo passo recomendado

Disparo automático de envio

Para automatizar o envio de intervenções aos seus subcontratados de acordo com regras de negócio:

  • Fecho KO
  • Replaneamento
  • Intervenção crítica

👉 Consulte o guia Disparos avançados