POST /colaborador/import é o caminho recomendado para criar mais de
~50 colaboradores. Reduz round-trips, dá relatório consolidado de erros
e é muito mais rápido que loop de POST individuais.
Pré-requisitos
- Token de API (Quick Start)
- Estrutura organizacional pré-cadastrada — Departamentos e Cargos precisam existir antes (ver Estrutura Organizacional)
- Arquivo CSV no formato esperado (schema na Referência)
Fluxo geral
Implementação
totalLinhas, totalImportados,
erros, etc.) está em Referência da API.
Estratégias de tratamento de erro
Estratégia 1: Re-importar só os erros
Estratégia 2: Criar individuais como fallback
Erros comuns no CSV
Volumetria recomendada
Importar muito grande de uma vez pode atingir timeout de gateway (ALB
tem 60s default). Lotes pequenos são mais robustos.
Veja também
- Colaboradores — schema completo da entidade
- Estrutura Organizacional — pré-requisito de sync
- Cadastrar primeiro colaborador — fluxo unitário
- Idempotência — evitar duplicatas em retry