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

# Fluxo: Análise PCD

> Registrar e acompanhar a análise de pessoa com deficiência.

A [Análise PCD](/public-api/br/conceitos/analise-pcd) valida a condição de **pessoa com
deficiência** de um candidato ou colaborador.

## Sequência

```mermaid theme={null}
sequenceDiagram
    participant C as Seu sistema
    participant API as API Salú
    C->>API: POST /v0/analysis/disability (name, gov_id, organization_id, [employee_id])
    API-->>C: 201 Created (análise em status PENDING)
    API-->>API: avaliação interna
    C->>API: GET /v0/analysis/{analysis_id} (acompanha status)
    API-->>C: APPROVED ou REJECTED
```

## Passo a passo

<Steps>
  <Step title="Criar a análise">
    `POST /v0/analysis/disability` com `name`, `gov_id` (CPF) e `organization_id`. Se o
    candidato **já é colaborador**, informe também `employee_id`.
  </Step>

  <Step title="Acompanhar o status">
    Consulte por `id` (`GET /v0/analysis/{analysis_id}`) ou liste (`GET /v0/analysis/`) e
    acompanhe o `status` (`PENDING` → `APPROVED`/`REJECTED`).
  </Step>

  <Step title="Referência de deficiências">
    Use `GET /v0/analysis/disability/disabilities` para obter os grupos e tipos de deficiência
    suportados.
  </Step>

  <Step title="Associar ao colaborador (quando aplicável)">
    Ao cadastrar/atualizar um colaborador PCD (`is_disabled = true`), o
    `disability_analysis_id` pode apontar para a análise aprovada.
  </Step>
</Steps>

<Note>
  As páginas de **referência** dos endpoints de Analysis serão publicadas junto com o OpenAPI
  atualizado. Este fluxo descreve o comportamento e a sequência de chamadas.
</Note>