Pular para o conteúdo principal

Bulk create truckers from CSV

POST 
/company/truckers/bulk/

Crie múltiplos transportadores em massa através da importação de arquivo CSV.

Fluxo de importação:

  1. Usuário carrega arquivo CSV com dados dos transportadores
  2. Sistema valida cabeçalhos obrigatórios
  3. Processa cada linha validando os dados
  4. Verifica unicidade de e-mail, taxid e telefone
  5. Gera senhas automáticas se não fornecidas
  6. Cria transportadores com sucesso
  7. Retorna relatório com sucessos e erros

Validações por linha:

  • Email: Único no sistema e formato válido
  • Taxid: Único e formato válido conforme país
  • Phone: Formato válido conforme regex
  • Default_vehicle: Existe na empresa (por placa/matrícula)
  • Role: Valor válido (é normalizado automaticamente)

Cabeçalhos obrigatórios CSV:

  • name, lastname, email, phone, taxid
  • Opcional: default_vehicle (placa/matrícula do veículo)

Geração de credenciais:

  • Se senha não for fornecida: É gerada automaticamente
  • E-mail de boas-vindas com credenciais é enviado
  • E-mail personalizado com nome da empresa

Formato do CSV:

  • Separador: vírgula (,)
  • Codificação: UTF-8
  • Primeira linha: cabeçalhos
  • Exemplo: name,lastname,email,phone,taxid,default_vehicle

Resposta detalhada:

  • ok: Array de transportadores criados com sucesso
  • ko: Array de erros com linha, motivo e dados

Estrutura de erros:

{
  line: 5,
  reason: EMAIL_ALREADY_IN_USE,
  data: {...},
  details: john@example.com
}

Códigos de erro comuns:

  • MIN_HEADERS: Faltam cabeçalhos obrigatórios
  • EMAIL_ALREADY_IN_USE: E-mail duplicado
  • TAXID_ALREADY_IN_USE: Taxid duplicado
  • EMAIL_NOT

Request​

Responses​

Processo de importação concluído