Skip to main content

​
Campos

CampoTipoDescrição
vehicleIdUUIDIdentificador único
companyIdUUIDReferência à empresa
typeVehicleTypeTipo do veículo
licensePlateStringPlaca do veículo
modelStringModelo do veículo
manufacturerString?Fabricante
yearInt?Ano de fabricação
floorCountFloorLevelQuantidade de andares do veículo
statusVehicleStatusStatus do veículo
createdByUUID?Usuário que criou o registro, quando aplicável
createdAtDateTimeData de criação
updatedByUUID?Usuário que fez a última atualização, quando aplicável
updatedAtDateTimeData da última atualização
deletedByUUID?Usuário que removeu o registro, quando aplicável
deletedAtDateTime?Data de remoção

​
Relacionamentos

  • Relaciona-se com Company
  • Relaciona-se com múltiplos SeatType
  • Relaciona-se com múltiplos Seat
  • Relaciona-se com múltiplos Trip
  • Relaciona-se com múltiplos TripSchedule (modelos de geração automática de viagens)

​
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.
  • Cada veículo pertence a uma única empresa via companyId. A multi-tenancy é resolvida na consulta via company.organizationId.
  • O campo floorCount determina se o veículo é de andar simples ou double-decker.
  • 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.

​
Enums

​
VehicleType

ValorDescrição
VANVan de transporte de passageiros

​
FloorLevel

ValorDescrição
FIRSTPrimeiro andar (andar único ou andar inferior)
SECONDSegundo andar (andar superior — double-decker)

​
VehicleStatus

ValorDescrição
ACTIVEVeículo ativo
INACTIVEVeículo inativo

​
Example

{
  "vehicleId": "0197a809-3eb8-7eb8-9c4f-8a6c2e7e5b1a",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "type": "VAN",
  "licensePlate": "ABC1D23",
  "model": "Sprinter 516",
  "manufacturer": "Mercedes-Benz",
  "year": 2024,
  "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
}