Importa colaboradores em massa via CSV

curl --request POST \
  --url https://api.example.com/colaborador/import \
  --header 'Content-Type: application/json' \
  --data '
{
  "base64": "data:text/csv;base64,SGVsbG8sIFdvcmxkIQ=="
}
'

{
  "status": true,
  "mensagem": "OK"
}

Colaborador

Importa colaboradores em massa via CSV

Cria múltiplos colaboradores em uma única chamada a partir de arquivo CSV (multipart/form-data). Caminho recomendado para volumes acima de 50 colaboradores — muito mais rápido e robusto que loop de POST /colaborador.

Pré-requisitos:

Departamentos, cargos, equipes e centros de custo já cadastrados na UN (ver Estrutura Organizacional)
Arquivo CSV no schema esperado (UTF-8 com BOM, separador ;, primeira linha = cabeçalho)

Como funciona:

Endpoint recebe o arquivo, valida estrutura e cabeçalhos
Processa linha por linha — cada linha vira tentativa de criação
Retorna relatório consolidado com totais e erros linha-a-linha
Linhas que dão erro não bloqueiam as demais — successo parcial é normal

Erros comuns por linha:

CPF já existe na UN
Departamento/cargo informado não encontrado
CPF inválido (dígito verificador)
Data de admissão fora de ISO 8601 (yyyy-MM-dd)

Volumetria recomendada: lotes de 100 colaboradores por chamada. Volumes maiores podem atingir timeout de gateway (60s).

Veja o guia Importar colaboradores em massa via CSV para schema completo, exemplos e estratégias de retry.

POST

colaborador

import

Importa colaboradores em massa via CSV

curl --request POST \
  --url https://api.example.com/colaborador/import \
  --header 'Content-Type: application/json' \
  --data '
{
  "base64": "data:text/csv;base64,SGVsbG8sIFdvcmxkIQ=="
}
'

{
  "status": true,
  "mensagem": "OK"
}

Body

application/json

Multipart com campo arquivo contendo CSV no formato Pontua

base64

file

required

Base64 do arquivo CSV de colaboradores

Response

Relatório de importação com totalLinhas, totalImportados, totalErros e detalhamento de erros

status

boolean

required

Status da operação

Example:

true

mensagem

string

Mensagem de retorno

Example:

"OK"

Busca colaboradores por CPF Altera status do colaborador (ATIVO/INATIVO/AFASTADO/DEMITIDO)