Pular para o conteúdo principal

Create multiple vehicles from CSV file

POST 
/company/vehicles/bulk/

Permite a criação em massa de múltiplos veículos a partir do upload de um arquivo CSV.

Objetivo​

Permitir que empresas importem eficientemente toda a sua frota ou grandes lotes de veículos de sistemas externos ou planilhas.

Casos de Uso​

  • Migrar frota existente de outro sistema
  • Importar veículos de planilhas de gestão de frota
  • Cadastro em massa de novos veículos
  • Atualizar múltiplos veículos simultaneamente

Fluxo de Validação​

flowchart TD
  A[Receber Arquivo CSV] --> B{Limite de Pagamento OK?}
  B -->|Não| C[402 Pagamento Necessário]
  B -->|Sim| D{Arquivo Presente?}
  D -->|Não| E[404 ARQUIVO_NÃO_ENCONTRADO]
  D -->|Sim| F{Analisar CSV}
  F --> G{Cabeçalhos Válidos?}
  G -->|Não| H[Retornar ko: CABEÇALHOS_MINIMOS]
  G -->|Sim| I{Dados Presentes?}
  I -->|Não| J[400 DADOS_INVALIDOS]
  I -->|Sim| K[Processar Cada Linha]
  K --> L{Linha Válida?}
  L -->|Sim| M[Criar Veículo - Adicionar a ok]
  L -->|Não| N[Adicionar a ko com motivo]
  M --> O{Mais Linhas?}
  N --> O
  O -->|Sim| K
  O -->|Não| P[Atualizar Empresa]
  P --> Q[Retornar arrays ok e ko]

Limites de Pagamento​

Este endpoint está sujeito aos limites do plano de pagamento via middleware isPaymentUpdate. Se a empresa atingiu seu limite de veículos, a requisição falhará com erro 402 antes de processar o CSV.

Estrutura do CSV​

Cabeçalhos obrigatórios (mínimo):

  • cargo_type
  • vehicle_type
  • plate
  • shipping_type

Cabeçalhos opcionais:

  • fresh_cargo_temp

Request​

Responses​

Criação em massa concluída (pode incluir falhas parciais). Verifique os arrays 'ok' e 'ko' para os resultados.

Response Headers