Skip to main content
A Salú é uma plataforma de saúde e segurança do trabalho (SST). A API pública existe para que sistemas do cliente (ERP, folha, RH) mantenham, de forma segura e rastreável, a estrutura da empresa e os colaboradores — e, a partir disso, o ciclo de exames ocupacionais (ASO).
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.