Módulos

Empresas

Tudo na Frota162 começa pela empresa. Veículos e condutores são sempre associados a uma delas, e a hierarquia de divisões (nível 1) e subdivisões (nível 2) é o que organiza a sua operação por filial, setor ou regional.

Cadastrar a estrutura correta de primeira economiza retrabalho: os IDs de empresa, divisão e subdivisão são usados na criação de veículos e condutores — e trocá-los depois exige atualizações em lote.

3 min de leituraVale para v1

O que dá para fazer

Ação	Endpoint	Quando usar
Listar empresas	GET /key/companies	Sincronizar sua base com a da Frota162
Criar empresa	POST /key/create-company	Nova empresa entrou na sua conta
Desativar empresa	DELETE /key/disable-company/{id_company}	Empresa saiu da operação
Reativar empresa	GET /key/enable-company/{id_company}	Empresa voltou à operação
Listar divisões	GET /key/divisions	Obter os IDs para o campo divisao do veículo
Listar subdivisões	GET /key/subdivisions	Obter os IDs para o campo subdivisao 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.

---

Listar empresas

GET/key/companies

Retorna as empresas vinculadas à sua conta. Use para descobrir os ids que os demais endpoints esperam — o id retornado aqui é o que vai no campo company_id de veículos e condutores.

curl -X GET \
  'https://apidev.v1.frota162.com.br/key/companies?per_page=50' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "companies": [
    {
      "id": 1,
      "name": "Transportadora XYZ Ltda",
      "fantasy_name": "Transportadora XYZ",
      "doc": "00.000.000/0001-00"
    }
  ],
  "error": false,
  "code": "fbk_200"
}

---

Criar empresa

POST/key/create-company

Cadastra uma nova empresa na sua conta. Apenas cnpj, name e fantasy_name são obrigatórios.

curl -X POST \
  https://apidev.v1.frota162.com.br/key/create-company \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "cnpj": "00000000000100",
    "name": "Transportadora XYZ Ltda",
    "fantasy_name": "Transportadora XYZ"
  }'

Campos

Campo	Tipo	Obrigatório	Descrição
cnpj	string	Sim	CNPJ da empresa (somente números)
name	string	Sim	Razão social
fantasy_name	string	Sim	Nome fantasia
address	string	Não	Logradouro
address_number	string	Não	Número
address_comp	string	Não	Complemento
district	string	Não	Bairro
city	string	Não	Cidade
state	string	Não	UF (ex: SP)
zip_code	string	Não	CEP (somente números)
email	string	Não	E-mail de contato
phone_1	string	Não	Telefone principal
phone_2	string	Não	Telefone secundário

Resposta

{
  "company": {
    "id": 1,
    "name": "Transportadora XYZ Ltda",
    "fantasy_name": "Transportadora XYZ",
    "doc": "00000000000100",
    "address": null,
    "city": null,
    "state": null,
    "zip_code": null,
    "email": null,
    "phone_1": null,
    "phone_2": null,
    "account_id": 10,
    "created_at": "2024-01-15T10:00:00.000Z"
  },
  "error": false
}

Erros comuns

Código	Descrição
fbk_400	CNPJ já cadastrado
fbk_004	CNPJ inválido
fbk_001	Usuário não encontrado

---

Desativar empresa

DELETE/key/disable-company/{id_company}

Remove a empresa da listagem ativa. O histórico de veículos e condutores vinculados permanece intacto e a operação pode ser revertida.

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

Resposta

{
  "message": "Empresa desabilitada com sucesso",
  "error": false,
  "code": "fbk_200"
}

---

Reativar empresa

GET/key/enable-company/{id_company}

Devolve uma empresa desativada à listagem ativa, com o mesmo id e todo o histórico anterior.

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

---

Divisões (hierarquia nível 1)

Divisões são empresas filiais de nível 1 — a primeira camada de organização depois da empresa. Consulte os IDs quando precisar distribuir sua operação por região ou filial.

Use os IDs retornados aqui ao criar veículos com o campo divisao.

GET/key/divisions

curl -X GET \
  'https://apidev.v1.frota162.com.br/key/divisions?page=1&limit=10' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "divisions": [
    {
      "id": 123,
      "name": "Filial São Paulo",
      "fantasy_name": "SP",
      "doc": "00.000.000/0002-00",
      "active": true,
      "hierarchy_level": 1
    }
  ],
  "error": false,
  "code": "fbk_200"
}

---

Subdivisões (hierarquia nível 2)

Subdivisões são empresas filiais de nível 2, o nível mais granular da hierarquia — útil para setores ou equipes dentro de uma divisão. Use os IDs retornados aqui ao criar veículos com o campo subdivisao.

GET/key/subdivisions

curl -X GET \
  'https://apidev.v1.frota162.com.br/key/subdivisions?page=1&limit=10' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "subdivisions": [
    {
      "id": 789,
      "name": "Setor Operacional SP",
      "fantasy_name": "Operacional",
      "doc": "00.000.000/0003-00",
      "active": true,
      "hierarchy_level": 2
    }
  ],
  "error": false,
  "code": "fbk_200"
}

Divisões em veículos

Ao criar ou atualizar um veículo, use os campos divisao (ID de divisão) e subdivisao (ID de subdivisão) para organizar o veículo na hierarquia da empresa. Consulte o Módulo Veículos para detalhes.

---

Próximos passos

VeículosGerencie sua frota

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

UsuáriosControle de acesso

Gerencie usuários e permissões de acesso ao painel.