Módulos

Veículos

Na Frota162, tudo gira em torno do veículo: multas, notificações e viagens chegam sempre vinculadas a ele. Este módulo mantém sua frota espelhada na plataforma, com cada veículo pertencendo a uma empresa da sua conta.

Para criar um registro basta a placa. Quanto mais dados enviar, mais completo fica o histórico que a plataforma usa nas consultas.

4 min de leituraVale para v1

O que dá para fazer

Ação	Endpoint	Quando usar
Criar veículo	`POST /key/create-car`	Veículo novo entrou na frota
Listar veículos	`GET /key/list-cars`	Sincronizar sua base com a da Frota162
Buscar por ID	`GET /key/get-car/{id}`	Consultar um veículo específico
Atualizar veículo	`PUT /key/update-car/{id}`	Corrigir dados ou mudar empresa/divisão
Desativar veículo	`DELETE /key/disable-car/{id_car}`	Veículo saiu da frota
Reativar veículo	`GET /key/enable-car/{id_car}`	Veículo voltou à operação
Vincular condutor	`PUT /key/cars/indicate-driver`	Definir o condutor principal do veículo

Antes de começar

Todas as chamadas usam os três headers de autenticação: Authorization, Key e cache-control. Ainda não tem as credenciais? Veja os Primeiros passos.

Criar veículo

POST/key/create-car

Registra um veículo na sua conta. Apenas company_id e car_plate são obrigatórios.

Quanto mais completo o cadastro, melhor: chassi, RENAVAM e proprietário fazem a diferença na hora de consultar multas e débitos do veículo.

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	Não	Número do chassi
`renavam`	string	Não	RENAVAM do veículo
`is_machinery`	integer	Não	`0` = veículo, `1` = maquinário
`prefixo_frota`	string	Não	Prefixo interno de frota — máximo 10 caracteres
`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)

Placas de RJ e MT

Para veículos emplacados no Rio de Janeiro e no Mato Grosso, owner_doc é obrigatório. Sem o CPF/CNPJ do proprietário, a consulta de débitos nesses estados não funciona.

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 ausente ou inválida
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

Retorna os veículos da conta em páginas. É o endpoint de sincronização: use na primeira carga e nas conferências periódicas para manter sua base alinhada com a da Frota162.

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"
}

Guarde o id

O id de cada item é a chave que os demais endpoints usam. Guarde-o no seu sistema. Para percorrer as demais páginas, veja Paginação.

Buscar veículo por ID

GET/key/get-car/{id}

Use quando você já tem o id e não quer listar a frota inteira.

Retorna o estado atual de um único veículo.

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}

Atualiza o cadastro de um veículo existente. Diferente da criação, aqui chassi e renavam também são obrigatórios.

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 — máximo 10 caracteres
`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

Atualização parcial

Campos opcionais só mudam se forem enviados. Quer trocar só o prefixo? Envie apenas prefixo_frota — divisão, subdivisão e os demais continuam como estão.

Desativar veículo

DELETE/key/disable-car/{id_car}

Remove o veículo da listagem ativa — ele some das consultas, mas o histórico permanece intacto. Nada é apagado e a operação pode ser revertida a qualquer momento.

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}

Devolve um veículo desativado à listagem ativa, com o mesmo id e todo o histórico anterior.

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

PUT/key/cars/indicate-driver

Define o condutor principal de um veículo sem criar uma viagem. O vínculo vale a partir de agora e não tem período definido.

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'

Precisa vincular por período?

Para associar condutores a multas e notificações automaticamente em um intervalo de datas, use o Módulo Viagens — sem precisar indicar cada infração manualmente.

Próximos passos

CondutoresGerencie condutores

Cadastre e gerencie os condutores da sua frota.

ViagensVincule condutores a veículos

Associe condutores a veículos em intervalos de datas.

EmpresasEstruture sua hierarquia

Organize sua frota por empresas, divisões e subdivisões.

O que dá para fazer​

Criar veículo​

Campos​

Resposta​

Erros comuns​

Listar veículos​

Resposta​

Buscar veículo por ID​

Atualizar veículo​

Campos​

Desativar veículo​

Reativar veículo​

Vincular condutor a veículo​

Próximos passos​

O que dá para fazer

Criar veículo

Campos

Resposta

Erros comuns

Listar veículos

Resposta

Buscar veículo por ID

Atualizar veículo

Campos

Desativar veículo

Reativar veículo

Vincular condutor a veículo

Próximos passos