curl --request POST \
--url https://api.example.com/colaborador/externo \
--header 'Content-Type: application/json' \
--data '
{
"nomeCompleto": "João Carlos da Silva",
"email": "joao.silva@pontua.com.br",
"telefone": "11999999999",
"numeroRegistro": "64394537509",
"userType": "USER"
}
'{
"colaboradorId": "JOAO.9",
"nomeCompleto": "João Carlos da Silva",
"email": "joao.silva@pontua.com.br",
"telefone": "11999999999",
"numeroRegistro": "64394537509",
"userType": "USER"
}Colaborador
Cria colaborador externo (terceirizado/visitante)
Cadastra um colaborador externo — terceirizado, prestador de serviço, visitante recorrente — para que ele possa registrar ponto na sua UN sem ter vínculo CLT direto.
Diferença para POST /colaborador:
- Externo não exige vínculo organizacional completo (departamento/cargo/equipe)
- Não entra em fechamentos de folha
- Pode registrar ponto, ter foto e fazer login no app
Casos de uso:
- Prestador de manutenção que vem semanalmente
- Funcionário de empresa terceirizada que opera dentro da sua planta
- Auditor externo que precisa registrar entrada/saída
Atenção:
- O CPF informado precisa ser único na sua UN (mesma regra de colaboradores normais).
- Para promover um externo a colaborador CLT depois, use
PATCH /colaborador/:idpara preencher os vínculos organizacionais. - LGPD: dados do externo seguem as mesmas regras de retenção dos colaboradores regulares.
POST
/
colaborador
/
externo
curl --request POST \
--url https://api.example.com/colaborador/externo \
--header 'Content-Type: application/json' \
--data '
{
"nomeCompleto": "João Carlos da Silva",
"email": "joao.silva@pontua.com.br",
"telefone": "11999999999",
"numeroRegistro": "64394537509",
"userType": "USER"
}
'{
"colaboradorId": "JOAO.9",
"nomeCompleto": "João Carlos da Silva",
"email": "joao.silva@pontua.com.br",
"telefone": "11999999999",
"numeroRegistro": "64394537509",
"userType": "USER"
}Body
application/json
Dados mínimos do colaborador externo (nome, CPF, foto opcional)
Nome completo
Example:
"João Carlos da Silva"
Example:
"email@email.com"
Número de telefone
Example:
"11 99999-9999"
Número de CPF ou CNPJ
Example:
"123.456.789-00"
Tipo de acesso do colaborador
Available options:
ADMIN, GESTOR, USER Response
Colaborador externo criado com colaboradorId para uso em outras rotas
Nome completo
Example:
"João Carlos da Silva"
Example:
"email@email.com"
Número de telefone
Example:
"11 99999-9999"
Número de CPF ou CNPJ
Example:
"123.456.789-00"
Tipo de acesso do colaborador
Available options:
ADMIN, GESTOR, USER ID do colaborador
Example:
"JOAO.9"
Senha provisória para um colaborador recém-criado
Example:
"trc4dbu7"