Conectar Cadulis a subcontratados

Dê aos seus subcontratados os meios para intervir de forma eficiente, sem complexidade técnica

Seus parceiros utilizam o Cadulis ou o próprio sistema deles, o Cadulis permite que você:

• Compartilhe intervenções com subcontratados
• Planeje diretamente nas equipes deles
• Receba em tempo real seus fechamentos, relatórios e status
• Tudo isso sem expor seus usuários nem seus dados internos

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

Casos de uso

Você deseja que um parceiro (ex: empresa de manutenção):

• Receba intervenções a serem realizadas
• Faça o planejamento em suas próprias equipes
• Retorne automaticamente as informações de fechamento para o seu ambiente

E isso, sem acesso à sua interface Cadulis, nem integração à sua organização interna.

Etapas de configuração

1. Acessar a configuração

No menu lateral:

1. Clique em Configurações
2. Acesse Webservices de subcontratados (no canto inferior direito)
3. Clique em Criar um webservice de subcontratado

Uma página introdutória relembra:

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

Clique em Criar um webservice de subcontratado para continuar.

2. Escolher o tipo de conexão

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

3. Configurar o webservice

Informações gerais

• Nome: explícito (ex: “SAV Norte – prestador X”)
• Descrição: tipo de atividades, frequência…

Assistente de planejamento (se aplicável)

• Limitar intervenções simultâneas
• Valor máximo permitido
• Usar relevância (trajetos, horários, etc.)
• URL do assistente: se o subcontratado expuser uma API de planejamento

Sem assistente (fallback)

• Duração fixa de trajeto
• Faixa horária do dia
• Pausa para almoço (opcional)
• Distância / duração usadas para as escolhas ótimas

Definir os acessos autorizados

Marque apenas as permissões necessárias:

• Modificar ou fechar uma intervenção
• Visualizar ou modificar as informações de fechamento
• Criar / modificar um cliente
• Uso do assistente de planejamento

Esses direitos definem o que você autoriza e o que você irá recuperar (relatórios, fechamentos, etc.)

Competências e equipamentos

Adicione recursos específicos:

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

Isso permite ao Cadulis não propor atividades para subcontratados inadequados.

Tratamento dos dados recebidos

Em Modificar os dados recebidos, escolha:

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

4. Finalizar

• Clique em Salvar
• O webservice está ativo

Cenário comum

1. Você atribui uma intervenção a um subcontratado
2. Ela é transmitida para o sistema dele (API REST ou via Cadulis)
3. Ele planeja nas suas equipes
4. Ele fecha a intervenção
5. Você recupera automaticamente relatório, status de fechamento, etc.

Boas práticas

Dê aos seus subcontratados os meios para intervir de forma eficiente, sem complexidade técnica

Seus parceiros utilizam Cadulis ou o próprio sistema deles, o Cadulis permite que você:

• Compartilhe intervenções com subcontratados
• Planeje diretamente nas equipes deles
• Receba em tempo real seus fechamentos, relatórios e status
• Tudo isso sem expor seus usuários nem seus dados internos

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

🔄 Bônus: Conector Cadulis ↔ Cadulis

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

• No lado do subcontratado, o Cadulis expõe uma API de entrada que permite receber automaticamente as intervenções transmitidas
• No lado do contratante, você utiliza uma API de saída de subcontratado dedicada para enviar as intervenções, acompanhar os status e recuperar os fechamentos

🎯 Vantagens:

• Nenhum desenvolvimento específico é necessário se ambas as partes utilizarem Cadulis
• Sincronização nativa das intervenções, status e relatórios
• Segurança e rastreabilidade garantidas
• Maior resiliência do que conexões API sob medida
• Configuração possível dos dois lados para ajustes de disponibilização, planejamento, visibilidade etc.

Este conector permite interligar organizações independentes, mantendo cada um o controle do seu ambiente e de seus usuários.

Próxima etapa recomendada