LogFrota
Para desenvolvedores

A API que move o LogFrota

Todo o Portal do LogFrota e os aplicativos de gestor e motorista conversam com a plataforma pela mesma API REST, autenticada por token, isolada por base (uma transportadora nunca enxerga o dado de outra). Esta página explica o que ela cobre hoje e como integrar o seu próprio sistema a ela.

O que a API já cobre

É a mesma API, em produção, que sustenta a emissão fiscal e a operação de frota de transportadoras reais rodando no LogFrota hoje — organizada por domínio:

Fiscal

Emissão e consulta de CT-e, MDF-e e NF-e, do preenchimento até a autorização na SEFAZ.

GET /api/v1/portal/fiscal/cte?status=authorized&page=1

Response

{
  "data": [
    {
      "id": 4821,
      "number": 900,
      "series": 1,
      "status": "authorized",
      "access_key": "31260912345678000199570010000009001234567890",
      "protocol_number": "135260000012345",
      "issued_at": "2026-09-10T14:32:00-03:00"
    }
  ],
  "meta": { "current_page": 1, "last_page": 6, "total": 118 }
}

Frota

Veículos, motoristas, filiais, manutenção, abastecimento e checklist de viagem.

GET /api/v1/portal/vehicles?active=true

Response

{
  "data": [
    {
      "id": 57,
      "plate": "ABC1D23",
      "model": "Volvo FH 540",
      "branch_id": 1,
      "is_own_fleet": true,
      "active": true
    }
  ]
}

Financeiro

Contas a pagar e a receber, acerto de motorista e o financeiro da viagem, ponta a ponta.

POST /api/v1/portal/financeiro/titulos

Request

{
  "type": "receber",
  "partner_id": 12,
  "description": "Frete Betim → Louveira",
  "value_cents": 340000,
  "due_date": "2026-10-05"
}

Response

{
  "data": {
    "id": 6021,
    "type": "receber",
    "value_cents": 340000,
    "due_date": "2026-10-05",
    "status": "aberto"
  }
}

CIOT, seguro e vale-pedágio

Contratação de frete de terceiro, averbação de seguro e vale-pedágio integrados ao MDF-e.

GET /api/v1/portal/fiscal/mdfe/312/ciot

Response

{
  "data": {
    "ciot_number": "0012345678",
    "status": "encerrado",
    "declared_value_cents": 340000,
    "toll_value_cents": 18500
  }
}

Toda resposta segue o mesmo envelope (data + meta quando paginado), valores monetários sempre em centavos, datas em ISO 8601.

Como funciona a autenticação

Toda chamada exige um token (`Authorization: Bearer`) e roda sobre HTTPS. Cada base (cada transportadora cliente) tem seu próprio banco de dados isolado, então o token de uma nunca dá acesso ao dado de outra, mesmo dentro da mesma instalação do LogFrota. É a mesma trava que já protege o Portal e os aplicativos de gestor e motorista.

Integração dedicada para o seu sistema

Quem já é cliente LogFrota gera a própria chave direto no Portal — sem abrir chamado, sem esperar ninguém liberar nada. Está em Integrações → API LogFrota:

  1. 1. Ative e gere a chave

    Ative a integração, dê um nome pra chave (ex.: “Integração ERP”) e copie o token na hora — ele só aparece uma vez.

  2. 2. Use com a sua permissão

    A chave enxerga exatamente o que o seu usuário enxerga no Portal — nem mais, nem menos — e muda se o seu perfil de acesso mudar depois.

  3. 3. Configure webhooks

    Cadastre uma URL sua e escolha os eventos (CT-e autorizado, MDF-e autorizado, título pago) — cada entrega vem assinada (HMAC-SHA256) pra você validar que veio da LogFrota.

  4. 4. Revogue quando quiser

    Uma chave comprometida ou uma integração que acabou some com um clique — sem precisar trocar senha nem esperar suporte.

Ainda não é cliente e quer entender se a LogFrota integra com o seu sistema? Fale com a gente.

Também mantemos catálogos de dados próprios (rotas entre municípios, base do IBGE) — veja em Dados e APIs.

Pronto para colocar sua frota sob controle?

Agende uma demonstração gratuita e veja, na prática, como a LogFrota pode reduzir seus custos e transformar a gestão da sua operação.