Vehicle

​

Campos

​

Relacionamentos

• Relaciona-se com Cooperative por cooperativeId.
• Relaciona-se com múltiplos VehicleTransportOperator.
• Relaciona-se com múltiplos SeatType.
• Relaciona-se com múltiplos Seat.
• Relaciona-se com múltiplos Trip.
• Relaciona-se com múltiplos TripSchedule.

​

Regras de Negócio

• A placa (licensePlate) deve ser única em todo o sistema. É normalizada em caracteres maiúsculos, sem espaços e sem hífen.
• registrationNumber, quando preenchido, deve ser único e usado para regularidade/fiscalização do veículo.
• serviceType deve ser compatível com as Trips e autorizações operacionais em que o veículo for usado.
• features deve registrar recursos que impactam elegibilidade, acessibilidade, busca ou venda, não detalhes puramente visuais.
• Cada veículo pertence ao contexto operacional de uma cooperativa.
• Um veículo só pode operar por um permissionário quando existir VehicleTransportOperator ativo.
• SeatType e Seat pertencem ao veículo e são gerenciados em conjunto com ele. O catálogo hierárquico (seatTypes[].seats[]) é opcional na criação/atualização; quando enviado, veículo e catálogo são atualizados na mesma operação. Veja Vehicle Setup.
• Ativação e desativação são ações próprias do ciclo de vida do veículo.
• Veículos inativos ou suspensos por regra administrativa não podem iniciar novas Trips.

​

Enums

​

VehicleType

​

FloorLevel

​

VehicleStatus

​

Example

{
  "vehicleId": "0197a809-3eb8-7eb8-9c4f-8a6c2e7e5b1a",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "type": "VAN",
  "licensePlate": "ABC1D23",
  "registrationNumber": "12345678901",
  "model": "Sprinter 516",
  "manufacturer": "Mercedes-Benz",
  "year": 2024,
  "serviceType": "CHARTER",
  "features": ["ACCESSIBILITY", "AIR_CONDITIONING"],
  "floorCount": "FIRST",
  "status": "ACTIVE",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T14:20:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T14:20:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}