Pular para o conteúdo

Importar colaboradores via planilha Excel

POST
/colaborador/importar

Importa até 1000 colaboradores a partir de uma planilha Excel (.xlsx). Colunas obrigatórias: Nome Completo, CPF, Email Corporativo, Data de Admissão. Colunas opcionais: RG, Data de Nascimento, Gênero, Estado Civil, Nacionalidade, Telefone, Email Pessoal, Endereço, Código Funcionário, Código Posição, Tipo Contrato, Regime Trabalho, Horário Trabalho, PIS, CTPS, NIS. CPFs já existentes ou duplicados no lote serão ignorados (primeira ocorrência processada). O campo ‘enviarEmail’ controla o envio de email de convite com credenciais (padrão: true). Abas opcionais no mesmo arquivo: ‘Dependentes’, ‘Formações’ e ‘Contatos de emergência’, uma linha por item ligada pela coluna ‘CPF do Colaborador’ (da aba principal ou já cadastrado); reimportar atualiza, não duplica. Resultado por aba em ‘abasComplementares’.

Autorização
Módulo contratado: PESSOAS
Permissão: COLABORADOR

enviarEmail
string
default: true
object
arquivo
required
string format: binary

OK

object
totalLinhas
integer format: int32
importadosComSucesso
integer format: int32
ignorados
integer format: int32
erros
integer format: int32
resultados
Array<object>

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
linha
integer format: int32
nome
string
cpf
string
status
string
mensagem
string
estruturaCriada
Array<object>

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
tipo
string
nomes
Array<string>
salariosRegistrados
integer format: int32
avisos
Array<string>
colunasIgnoradas
Array<string>
colunasAmbiguas
Array<string>
abasComplementares
Array<object>

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
aba
string
nomeNaPlanilha
string
novos
integer format: int32
atualizados
integer format: int32
erros
integer format: int32
erro
string
colunasIgnoradas
Array<string>
colunasAmbiguas
Array<string>

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade

© 2026 T AI TECNOLOGIA LTDA