---

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

---