Se você ainda não leu, comece por Como usar: ambientes,
autenticação por
x-api-key, paginação e erros.As entidades centrais
Como se relacionam
Em palavras:- Uma Organização possui Unidades, Setores e Cargos.
- A combinação de uma Unidade + um Setor + um Cargo forma uma Hierarquia — a “posição” na qual um colaborador é alocado. É essa combinação que define os riscos ocupacionais e, portanto, os exames exigidos.
- Um Colaborador é o vínculo de uma Pessoa (identificada pelo CPF) com a organização, em uma Hierarquia. Cada ação no colaborador (admissão, demissão, periódico, retorno, mudança de risco) gera uma Pendência de exame.
- A Pendência acompanha o exame até a conclusão (recebimento do ASO) ou cancelamento. O agendamento em clínica e a realização do exame são orquestrados internamente pela Salú.
Agendamento e Clínica aparecem no diagrama para explicar o ciclo do exame, mas
não têm endpoints públicos — são gerenciados dentro da plataforma Salú. A API pública
expõe os recursos marcados na tabela acima.
Próximos passos
Montar a estrutura da empresa
Crie Unidades, Setores e Cargos antes de cadastrar colaboradores.
Onboarding de colaborador
Cadastre o colaborador e gere o exame admissional.