> ## 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.

# Ciclo da pendência (exame)

> Do pedido do exame ao ASO — e como demissão, retorno e periódico geram pendências.

A [Pendência](/public-api/br/conceitos/pendencia-exame) acompanha o exame ocupacional do
pedido até o **ASO** (Atestado de Saúde Ocupacional) ou o cancelamento. Pela API pública você
**cria**, **lista** e **cancela** pendências e acompanha o `status`; o agendamento em clínica e
a realização são orquestrados internamente pela Salú.

## Ciclo de vida

```mermaid theme={null}
sequenceDiagram
    participant C as Seu sistema
    participant API as API Salú
    participant S as Salú (interno)
    C->>API: cria pendência (evento do colaborador ou POST /v0/pendency)
    API-->>C: pendência em status Pendente
    S-->>S: agenda exame em clínica
    S-->>S: exame realizado → ASO emitido
    C->>API: GET /v0/pendency (acompanha status)
    Note over C,API: Para encerrar sem realização: POST /v0/pendency/cancel
```

## Como as pendências surgem

| Origem                                       | Tipo gerado         |
| -------------------------------------------- | ------------------- |
| Admissão de colaborador (`create_exam=true`) | `HIRING`            |
| Dispensa de colaborador                      | `DISMISSAL`         |
| Retorno ao trabalho                          | `RETURN`            |
| Mudança de risco (hierarquia)                | `RISK_CHANGE`       |
| Periódico (parâmetros da organização)        | `PERIODIC`          |
| Criação direta                               | `POST /v0/pendency` |

## Operações disponíveis

<Steps>
  <Step title="Criar uma pendência avulsa">
    `POST /v0/pendency` com `employee_id`, `type_exam` e `send_email` (e opcionalmente
    `send_date`/`exam_date`).
  </Step>

  <Step title="Listar e filtrar">
    `GET /v0/pendency` com filtros por `organization_id`, `employee_id`, `status` e `type_exam`,
    além de paginação por cursor.
  </Step>

  <Step title="Cancelar">
    `POST /v0/pendency/cancel` com `pendency_id` e, opcionalmente, uma `note` com o motivo.
  </Step>
</Steps>

<Info>
  Não há endpoint público para **agendar** o exame: o agendamento e a realização acontecem
  dentro da plataforma Salú. Você acompanha o resultado pelo `status` da pendência.
</Info>

## Endpoints

<CardGroup cols={3}>
  <Card title="Listar" icon="list" href="/public-api/br/endpoints/pendencies/public_list_pendencies_v0_pendency__get" />

  <Card title="Criar" icon="plus" href="/public-api/br/endpoints/pendencies/public_create_pendency_v0_pendency__post" />

  <Card title="Cancelar" icon="xmark" href="/public-api/br/endpoints/pendencies/public_cancel_pendency_v0_pendency_cancel_post" />
</CardGroup>