Update an existing vehicle
POST/company/vehicles/:id
Atualiza as informações de um veículo existente, incluindo metadados e uploads de arquivos.
Objetivo
Permitir que as empresas modifiquem as especificações do veículo, atualizem a documentação e gerenciem as configurações padrão do veículo.
Casos de Uso
- Atualizar especificações do veículo (tipo, capacidades de carga)
- Substituir ou remover imagens do veículo e certificados de ITV
- Alterar o tipo de transporte e configurações de temperatura
- Definir ou remover o veículo como padrão do usuário
Fluxo de Validação
flowchart TD
A[Receber Solicitação] --> B{Usuário Tem Empresa?}
B -->|Não| C[401 CIA_NOT_FOUND]
B -->|Sim| D{Veículo Existe?}
D -->|Não| E[404 VEHICLE_NOT_FOUND]
D -->|Sim| F{Empresa é Proprietária do Veículo?}
F -->|Não| G[403 CIA_NOT_OWNER]
F -->|Sim| H{tipo_transporte Alterado?}
H -->|Sim para seco| I[Remover automaticamente temperatura_carga_fresca]
H -->|Sim para fresco| J{temperatura_carga_fresca Válida?}
J -->|Não| K[400 Temperatura Obrigatória]
J -->|Sim| L[Atualizar Veículo]
H -->|Não| L
I --> L
L --> M{veiculo_padrao = true?}
M -->|Sim| N[Atualizar Padrão do Usuário]
M -->|Não| O[Retornar Veículo Atualizado]
N --> O
Exclusão de Arquivo
Para excluir um arquivo existente (imagem ou itv), envie o campo com um valor de string vazia. O arquivo será removido do armazenamento S3 e o campo será definido como vazio.
Exemplo:
{
imagem: ,
itv:
}
Comport
Request
Responses
- 200
- 401
- 403
- 404
- 503
Veículo atualizado com sucesso.
Response Headers
O usuário não possui uma empresa associada
Veículo não pertence à empresa do usuário autenticado
Veículo ou usuário não encontrado
Erro do servidor durante a atualização