Skip to main content
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

O schema exato do response (campos 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