Módulo Condutores

Gerencie os condutores vinculados à sua conta. Condutores são identificados por CPF e CNH, e são usados para atribuir responsabilidade sobre multas, notificações e viagens.

Criar condutor

POST /key/create-driver

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

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

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

Buscar condutor por ID

GET /key/get-driver/{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}

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}

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}

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

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

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.

---