Módulo Veículos

Gerencie os veículos vinculados à sua conta na Frota162. Cada veículo deve estar associado a uma empresa e precisa de placa + pelo menos chassi ou RENAVAM para ser cadastrado.

Criar veículo

POST /key/create-car

curl -X POST \
  https://apidev.v1.frota162.com.br/key/create-car \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_id": 1,
    "car_plate": "ABC1234",
    "chassi": "1234567890ABC12",
    "renavam": "00123456789"
  }'

Campos

Campo	Tipo	Obrigatório	Descrição
company_id	integer	Sim	ID da empresa vinculada
car_plate	string	Sim	Placa do veículo
chassi	string	Sim*	Número do chassi
renavam	string	Sim*	RENAVAM do veículo
is_machinery	integer	Não	0 = veículo, 1 = maquinário
prefixo_frota	string	Não	Prefixo interno de frota
owner_doc	string	Não	CPF/CNPJ do proprietário — obrigatório para placas de RJ e MT
divisao	integer	Não	ID da divisão (hierarquia nível 1)
subdivisao	integer	Não	ID da subdivisão (hierarquia nível 2)

*É necessário informar pelo menos um: chassi ou renavam.

Resposta

{
  "message": "Carro cadastrado com sucesso",
  "error": false,
  "code": "fbk_200",
  "car": {
    "car_plate": "ABC1234",
    "chassi": "1234567890ABC12",
    "renavam": "00123456789"
  }
}

Erros comuns

Código	Descrição
fbk_003	Placa, chassi ou RENAVAM ausente ou inválido
fbk_004	ID da empresa não encontrado
fbk_400	Veículo com esse chassi/RENAVAM já cadastrado

Listar veículos

GET /key/list-cars

curl -X GET \
  'https://apidev.v1.frota162.com.br/key/list-cars?pagination[page]=1&pagination[perpage]=10' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "cars": {
    "current_page": 1,
    "data": [
      {
        "id": 42,
        "car_plate": "ABC1234",
        "chassi": "1234567890ABC12",
        "renavam": "00123456789",
        "brand": "TOYOTA",
        "model": "COROLLA",
        "active": "1",
        "driver_id": 10,
        "division_id": null,
        "sub_division_id": null
      }
    ],
    "total": 42,
    "per_page": "10",
    "last_page": 5
  },
  "error": false,
  "code": "fbk_200"
}

Consulte Paginação para detalhes sobre os parâmetros.

Buscar veículo por ID

GET /key/get-car/{id}

curl -X GET \
  https://apidev.v1.frota162.com.br/key/get-car/42 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Atualizar veículo

PUT /key/update-car/{id}

curl -X PUT \
  https://apidev.v1.frota162.com.br/key/update-car/42 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_id": 1,
    "car_plate": "ABC1234",
    "chassi": "1234567890ABC12",
    "renavam": "00123456789",
    "prefixo_frota": "FROTA-01"
  }'

Campos

Campo	Tipo	Obrigatório	Descrição
company_id	integer	Sim	ID da empresa
car_plate	string	Sim	Placa do veículo
chassi	string	Sim	Chassi
renavam	string	Sim	RENAVAM
prefixo_frota	string	Não	Prefixo de frota
uf	string	Não	UF do veículo
owner_doc	string	Não	CPF/CNPJ do proprietário
divisao	integer	Não	ID da divisão
subdivisao	integer	Não	ID da subdivisão

Campos opcionais só são alterados se enviados. Se divisao/subdivisao não forem enviados, os valores existentes são preservados.

Desativar veículo

DELETE /key/disable-car/{id_car}

Remove o veículo da listagem ativa. A operação pode ser revertida com o endpoint de reativação.

curl -X DELETE \
  https://apidev.v1.frota162.com.br/key/disable-car/42 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Reativar veículo

GET /key/enable-car/{id_car}

curl -X GET \
  https://apidev.v1.frota162.com.br/key/enable-car/42 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Vincular condutor a veículo

Define o condutor principal de um veículo diretamente, sem criar uma viagem.

PUT /key/cars/indicate-driver

Campo	Tipo	Obrigatório	Descrição
car_id	integer	Sim	ID do veículo
driver_id	integer	Sim	ID do condutor

curl -X PUT \
  https://apidev.v1.frota162.com.br/key/cars/indicate-driver \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'car_id=42' \
  -d 'driver_id=10'

Vincular via viagem

Para vincular condutores a multas e notificações automaticamente por período, use o Módulo Viagens. As viagens associam um condutor a um veículo em um intervalo de datas — sem precisar indicar manualmente cada infração.

---