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/:id para 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)

nomeCompleto

string

required

Nome completo

Example:

"João Carlos da Silva"

email

string

required

E-mail

Example:

"email@email.com"

telefone

string

required

Número de telefone

Example:

"11 99999-9999"

numeroRegistro

string

required

Número de CPF ou CNPJ

Example:

"123.456.789-00"

userType

enum<string>

default:ADMIN

required

Tipo de acesso do colaborador

Available options:

ADMIN,

GESTOR,

USER

Response

Colaborador externo criado com colaboradorId para uso em outras rotas

nomeCompleto

string

required

Nome completo

Example:

"João Carlos da Silva"

email

string

required

E-mail

Example:

"email@email.com"

telefone

string

required

Número de telefone

Example:

"11 99999-9999"

numeroRegistro

string

required

Número de CPF ou CNPJ

Example:

"123.456.789-00"

userType

enum<string>

default:ADMIN

required

Tipo de acesso do colaborador

Available options:

ADMIN,

GESTOR,

USER

colaboradorId

string

required

ID do colaborador

Example:

"JOAO.9"

senhaProvisoria

string

Senha provisória para um colaborador recém-criado

Example:

"trc4dbu7"

Resolve `código` interno do colaborador para `colaboradorId`Retorna o colaborador associado ao token autenticado