GUIA DE INTEGRAÇÃO

API de pedágio para operações rodoviárias no Brasil.

Conecte seu TMS, ERP, cotador de frete ou plataforma logística a um resultado estruturado de distância e pedágios, com veículo, vigência e revisão explícita.

O que uma API de pedágio entrega?

Uma API de pedágio transforma origem, destino, data e configuração do veículo em dados que outros sistemas podem consumir. A resposta do Geodagio separa distância, cobranças encontradas, total e estado de revisão.

Resposta curta

A API Geodagio calcula a rota, associa praças ou pórticos ao trajeto e aplica a tarifa oficial vigente para a classe informada.

Dados devolvidos por cálculo

Distância
Quilometragem rodoviária devolvida em metros para cálculo exato.
Pedágios
Sequência de cobranças, valor individual e total quando precificado.
Correspondência
Distância do match, confiança e resolução de sentido.
Revisão
Motivos explícitos quando tarifa, rodovia ou sentido exigem conferência.
POST /api/v1/routes/calculate
Idempotency-Key: calculo-pedido-48391
Authorization: Bearer <token>

{ "origin": "Campinas, SP", "destination": "Curitiba, PR", "vehicle": { "axleCount": 2, "vehicleClassCode": "CAR" }, "calculationDate": "2026-08-21" }

Como o Geodagio evita totais enganosos

O total só é apresentado quando as cobranças estão precificadas e o sentido está resolvido. Se faltar tarifa oficial ou houver ambiguidade, o status muda para revisão e a resposta explica o motivo.

  • tarifas versionadas por período de vigência;
  • idempotência para evitar consumo e cálculo duplicados;
  • isolamento de dados por empresa;
  • trilha de fonte e referência oficial;
  • sinais externos usados apenas como apoio de auditoria.

Quem usa API de pedágio e quilometragem

O contrato atende transportadoras, embarcadores, plataformas de frete, operadores logísticos, TMS, ERPs e equipes que precisam comparar custo planejado e realizado.

Principais fluxos

  • cotação de frete com custo rodoviário;
  • planejamento e auditoria de viagens;
  • simulação por tipo de veículo e eixos;
  • processamento de planilhas com múltiplas rotas;
  • conciliação e análise de divergências.

Comece pela documentação técnica

Consulte o contrato OpenAPI, códigos de erro e regras de autenticação antes de integrar. Para lotes extensos, use a importação observável em vez de disparar requisições concorrentes sem controle.

Pronto para avaliar?

Abra o console ou consulte o contrato completo da API.

Ver documentação