> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salu.com.vc/llms.txt
> Use this file to discover all available pages before exploring further.
# Pendência (Exame)
> A obrigação de um exame ocupacional, do pedido ao ASO.
Uma **Pendência** representa uma **obrigação de exame ocupacional** de um colaborador —
admissional, demissional, periódico, retorno ao trabalho ou mudança de risco. É o registro
que acompanha o ciclo **desde a solicitação do exame até a conclusão** (recebimento do ASO) ou
o **cancelamento**.
## Tipos de exame (`type_exam`)
| Código | Tradução (PT) | Quando ocorre |
| ------------- | ------------------- | --------------------------------------------------- |
| `HIRING` | Admissional | Na admissão do colaborador. |
| `DISMISSAL` | Demissional | Na demissão. |
| `PERIODIC` | Periódico | Periodicamente, conforme parâmetros da organização. |
| `RETURN` | Retorno ao Trabalho | No retorno após afastamento. |
| `RISK_CHANGE` | Mudança de Risco | Quando muda a hierarquia/risco do colaborador. |
O conjunto completo e canônico de tipos está no **schema do endpoint** (OpenAPI). A tabela
acima cobre os principais.
## Ciclo de vida
```mermaid theme={null}
flowchart LR
A[Pendência criada] --> B[Pendente]
B --> C[Agendada]
C --> D[Realizada / ASO emitido]
B -. cancelar .-> X[Cancelada]
C -. cancelar .-> X
```
1. **Criada** — automaticamente (ao admitir/dispensar etc.) ou via endpoint de criação.
2. **Pendente** — aguardando agendamento.
3. **Agendada** — exame marcado em clínica (orquestrado internamente pela Salú).
4. **Realizada** — exame concluído e **ASO** emitido.
5. **Cancelada** — encerrada sem realização.
O **agendamento em clínica** e a **realização** do exame são gerenciados dentro da
plataforma Salú — não há endpoint público para agendar. Pela API pública você **cria**,
**lista** e **cancela** pendências, e acompanha o `status`.
## Campos da criação
| Campo | Obrigatório | Descrição |
| ------------- | ----------- | --------------------------------------------------------------- |
| `employee_id` | sim | Colaborador alvo do exame. |
| `type_exam` | sim | Tipo do exame (ver tabela acima). |
| `send_email` | sim | Se `true`, dispara comunicação ao colaborador. |
| `send_date` | não | Data/hora do envio (assume "agora" quando `send_email = true`). |
| `exam_date` | não | Data prevista do exame. |
Para **cancelar**, informe o `pendency_id` e, opcionalmente, uma `note` com o motivo.
## Prazos (`due_date`)
O prazo do exame é calculado pela plataforma conforme o tipo — por exemplo, admissional com
prazo anterior à admissão e demissional com prazo após a data de demissão. Esses valores
aparecem no retorno da pendência.
## Endpoints