Módulos

Condutores

Toda infração tem um responsável. O módulo de Condutores mantém as pessoas que dirigem sua frota cadastradas na plataforma, identificadas por CPF e CNH, para que multas, notificações e viagens possam ser atribuídas corretamente.

Sem o condutor cadastrado, não há como vincular uma infração a quem a cometeu — e a indicação ao órgão de trânsito fica impossível. Comece sempre pelo cadastro; o resto do fluxo depende dele.

4 min de leituraVale para v1

O que dá para fazer

Ação	Endpoint	Quando usar
Criar condutor	POST /key/create-driver	Novo condutor entrou na equipe
Listar condutores	GET /key/list-drivers	Sincronizar sua base com a da Frota162
Buscar por ID	GET /key/get-driver/{id}	Consultar um condutor específico
Atualizar condutor	PUT /key/update-driver/{id}	Corrigir dados ou atualizar CNH
Desativar condutor	DELETE /key/disable-driver/{id_driver}	Condutor saiu da equipe
Reativar condutor	GET /key/enable-driver/{id_driver}	Condutor voltou a dirigir
Vincular à multa	PUT /key/tickets/indicate-driver	Definir quem cometeu uma infração
Vincular à notificação	PUT /key/notifications/indicate-driver	Definir quem recebeu uma notificação

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 condutor

POST/key/create-driver

Cadastra um novo condutor identificado por CPF e CNH. Apenas cpf, name, cnh, company_id e driver_category são obrigatórios.

Quanto mais dados enviar, mais completo fica o perfil — datas de emissão, validade da CNH e endereço ajudam na hora de notificações e processos formais.

curl -X POST \
  https://apidev.v1.frota162.com.br/key/create-driver \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "cpf": "12345678900",
    "name": "Carlos Souza",
    "cnh": "12345678900",
    "cnh_uf": "SP",
    "company_id": 1,
    "driver_category": "B"
  }'

Campos

Campo	Tipo	Obrigatório	Descrição
cpf	string	Sim	CPF do condutor (somente números)
name	string	Sim	Nome completo
cnh	string	Sim	Número da CNH
cnh_uf	string	Não	UF emissora da CNH (ex: SP)
company_id	integer	Sim	ID da empresa vinculada
driver_category	string	Sim	Categoria da CNH (A, B, AB, C, D, E)
rg	string	Não	RG do condutor
born_date	string	Não	Data de nascimento (formato YYYY-MM-DD)
issue_date	string	Não	Data de emissão da CNH (YYYY-MM-DD)
expiration_date	string	Não	Data de validade da CNH (YYYY-MM-DD)
first_license_date	string	Não	Data da primeira habilitação (YYYY-MM-DD)
mother_name	string	Não	Nome da mãe
father_name	string	Não	Nome do pai
email	string	Não	E-mail do condutor
ticket_points	integer	Não	Pontos na carteira
city	string	Não	Cidade
uf	string	Não	UF de residência
zip_code	string	Não	CEP (somente números)
address	string	Não	Logradouro
address_number	string	Não	Número
address_comp	string	Não	Complemento
metadata	array	Não	Campos customizados [{ "key": "string", "value": "string" }]

Resposta

{
  "message": "Condutor cadastrado com sucesso",
  "error": false,
  "code": "fbk_200",
  "driver": {
    "id": 15,
    "name": "Carlos Souza",
    "cpf": "12345678900",
    "cnh": "12345678900",
    "cnh_uf": "SP",
    "driver_category": "B"
  }
}

Erros comuns

Código	Descrição
fbk_400	Condutor já cadastrado com esse CPF (retorna dados do condutor existente)
fbk_400	CPF inválido
fbk_004	ID da empresa não encontrado

---

Listar condutores

GET/key/list-drivers

Retorna a lista paginada de condutores da sua conta. É 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-drivers?pagination[page]=1&pagination[perpage]=10' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "drivers": {
    "current_page": 1,
    "data": [
      {
        "id": 15,
        "name": "Carlos Souza",
        "cpf": "12345678900",
        "cnh": "12345678900",
        "cnh_uf": "SP",
        "driver_category": "B",
        "status_active": 1,
        "email": null
      }
    ],
    "total": 25,
    "per_page": "10",
    "last_page": 3
  },
  "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 condutor por ID

GET/key/get-driver/{id}

Retorna os dados de um condutor específico pelo seu ID.

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

---

Atualizar condutor

PUT/key/update-driver/{id}

Atualiza os dados cadastrais de um condutor existente. Todos os campos opcionais do cadastro podem ser atualizados.

curl -X PUT \
  https://apidev.v1.frota162.com.br/key/update-driver/15 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "cpf": "12345678900",
    "name": "Carlos Souza",
    "cnh": "12345678900",
    "cnh_uf": "SP",
    "company_id": 1,
    "driver_category": "B",
    "email": "carlos@empresa.com"
  }'

Os campos seguem o mesmo padrão do endpoint de criação. Todos os campos opcionais do cadastro podem ser atualizados.

---

Desativar condutor

DELETE/key/disable-driver/{id_driver}

Remove o condutor 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-driver/15 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "message": "Condutor desabilitado com sucesso",
  "error": false,
  "code": "fbk_200"
}

---

Reativar condutor

GET/key/enable-driver/{id_driver}

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

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

---

Vincular condutor à multa ou notificação

Para registrar manualmente o condutor responsável por uma infração ou notificação no sistema:

informação

Esse vínculo é interno ao sistema Frota162. Não equivale à indicação formal ao órgão de trânsito — esse processo é realizado pelo módulo de Indicação de Motoristas da API v2.

Vincular à multa

PUT/key/tickets/indicate-driver

Define o condutor responsável por uma multa específica.

Campo	Tipo	Descrição
ticket_id	integer	ID da multa
driver_id	integer	ID do condutor

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

---

Vincular à notificação

PUT/key/notifications/indicate-driver

Define o condutor responsável por uma notificação específica.

Campo	Tipo	Descrição
notification_id	integer	ID da notificação
driver_id	integer	ID do condutor

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

Vinculação automática via viagens

Ao criar uma viagem com um condutor e um intervalo de datas, todas as multas e notificações do veículo nesse período são automaticamente vinculadas ao condutor — sem precisar chamar esses endpoints manualmente.

---

Próximos passos

VeículosGerencie sua frota

Cadastre, atualize e gerencie os veículos da sua frota.

ViagensVincule condutores a veículos

Associe condutores a veículos em intervalos de datas.

MultasAtribua infrações

Vincule condutores a multas e notificações de trânsito.