Pré-requisito: ter o
organization_id da empresa. Descubra-o em
Listar minhas organizações.1
Descobrir o organization_id
Liste as organizações às quais sua
x-api-key tem acesso e guarde o organization_id.2
Criar Unidades (Branch)
Crie cada local de trabalho com
organization_id, display_name e cnpj.
Guarde os id retornados (ou use client_integration_code para mapear ao seu sistema).3
Criar Setores (Sector)
Crie cada área/departamento com
organization_id, name e description.4
Criar Cargos (Position)
Crie cada função com
organization_id e name (e cbo, quando disponível).5
Pronto para colaboradores
Com Unidade, Setor e Cargo cadastrados, você já pode
cadastrar colaboradores — a hierarquia é
resolvida automaticamente a partir desses três IDs.
Use
client_integration_code em Unidades, Setores e Cargos para mapear cada registro ao ID
do seu sistema. Ele também serve de filtro nas listagens — útil para sincronizações
idempotentes. Veja Como usar §3.