Pular para o conteúdo principal

Fluxo de atividades (manutenção preventiva)

Objetivo

Percorrer o fluxo de manutenção preventiva — da consulta do agendamento ao registro de baixa, medições e materiais — com exemplos reais dos endpoints da API.

A manutenção preventiva é planejada: um Plano de Atividades gera Tarefas agendadas sobre os ativos.

Hierarquia​

Plano de Atividades
 └── Atividade
      └── Aplicação   (Unidade | Área | Equipamento)
           └── Tarefa  (instância agendada)

1. Consultar atividades agendadas​

curl "https://lighthousev2.lkp.app.br/v1/atividades" \
  -H "Authorization: Bearer SEU_TOKEN"

Variações úteis:

EndpointUso
GET /v1/atividades/diaspendentesDias com pendências no mês.
GET /v1/atividades/planoAtividades por plano.
GET /v1/atividades/aplicacaoAtividades por aplicação.
GET /v1/atividades/{ativid}/medicoesMedições de uma atividade.

2. Dar baixa em tarefas​

A baixa registra a execução. Há baixa individual e em lote (v2 traz BaixarAtividadesEmLote). Campos obrigatórios de BaixaAtividadeCommand: tarefasIds, plataforma.

Os exemplos -d '{...}' abaixo são bash/POSIX. No PowerShell, use o padrão de arquivo — ver Primeiros passos → PowerShell.

# Informações para baixar um conjunto de atividades
curl -X POST "https://lighthousev2.lkp.app.br/v1/atividades/baixa/list" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[101, 102, 103]'

# Executar a baixa
curl -X PUT "https://lighthousev2.lkp.app.br/v1/atividades/baixa" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "tarefasIds": [101, 102, 103], "plataforma": 6, "dataRealizada": "2026-05-31T10:00:00Z" }'

3. Medições, fotos e materiais​

Campos obrigatórios de SaveMedicoesAtividadeCommand: tarefaId, medicoes (array de MedicaoAtividadeCommand).

# Salvar medições
curl -X POST "https://lighthousev2.lkp.app.br/v1/atividades/medicoes" \
  -H "Authorization: Bearer SEU_TOKEN" -H "Content-Type: application/json" \
  -d '{ "tarefaId": 101, "medicoes": [{ "tarefaMedicaoId": 10, "atividadeMedicaoId": 20, "valorMedicao": 42.5 }] }'

# Custos de materiais de uma tarefa
curl "https://lighthousev2.lkp.app.br/v1/atividades/777/custosmateriais" \
  -H "Authorization: Bearer SEU_TOKEN"

4. Atividades que geram ocorrências​

Uma medição fora do limite esperado pode abrir uma ocorrência corretiva automaticamente. Veja Fluxo de ocorrências.

5. Executor efetivo​

Ao processar tarefas, lembre da regra de fallback de executor: Tarefa → Aplicação → Atividade.

Os campos obrigatórios de cada comando estão indicados nas seções acima. Para o contrato completo (campos opcionais, tipos, validações), consulte a Referência de API.