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

# Onboarding de colaborador

> Cadastre o colaborador e gere automaticamente o exame admissional.

Cadastrar um colaborador faz duas coisas ao mesmo tempo: **posiciona a pessoa na hierarquia**
(unidade × setor × cargo) e, por padrão, **gera a pendência de exame admissional**.

<Info>
  Pré-requisito: a [estrutura da empresa](/public-api/br/fluxos/setup-empresa) (Unidade, Setor
  e Cargo) já deve existir, pois você informa `branch_id`, `sector_id` e `position_id`.
</Info>

## Sequência

```mermaid theme={null}
sequenceDiagram
    participant C as Seu sistema
    participant API as API Salú
    C->>API: POST /v0/employee (gov_id, branch_id, sector_id, position_id, admission_date, ...)
    API-->>API: Resolve/cria a Hierarquia (unidade × setor × cargo)
    API-->>API: create_exam=true → gera Pendência HIRING (Admissional)
    API-->>C: 201 Created (colaborador + ids)
    Note over API,C: A pendência admissional fica disponível em GET /v0/pendency
```

## Passo a passo

<Steps>
  <Step title="Montar o payload do colaborador">
    Informe os obrigatórios: `name`, `gov_id` (CPF), `sex`, `is_disabled`, `organization_id`,
    `branch_id`, `sector_id`, `position_id`, `admission_date` e `status`. Adicione os
    complementares que tiver (contato, `hr_code`, dados de eSocial, etc.).
  </Step>

  <Step title="Criar o colaborador">
    `POST /v0/employee`. A hierarquia é resolvida a partir dos três IDs; se a combinação ainda
    não existir na organização, ela é criada.
  </Step>

  <Step title="Exame admissional automático">
    Com `create_exam = true` (padrão), uma [pendência](/public-api/br/conceitos/pendencia-exame)
    do tipo `HIRING` é gerada. Use `send_email`/`send_date` para controlar a comunicação ao
    colaborador.
  </Step>

  <Step title="Acompanhar a pendência">
    Liste as pendências do colaborador em
    [Listar pendências](/public-api/br/endpoints/pendencies/public_list_pendencies_v0_pendency__get)
    e acompanhe o `status` até a conclusão (ASO).
  </Step>
</Steps>

<Note>
  Se o colaborador é **PCD** (`is_disabled = true`), pode ser necessário associar uma
  [Análise PCD](/public-api/br/fluxos/analise-pcd) (`disability_analysis_id`).
</Note>

## Eventos seguintes

Demissão, retorno e mudança de risco geram novas pendências automaticamente — veja
[Ciclo da pendência](/public-api/br/fluxos/ciclo-pendencia).