API de preços de diesel da ANP: como usar dados oficiais na precificação de fretes e rotas

1. Quais dados oficiais de combustível estão disponíveis

No transporte rodoviário de cargas no Brasil, o óleo diesel não é apenas um insumo: ele é o principal vetor de risco financeiro de transportadoras e operadores logísticos. A oscilação semanal de centavos na bomba pode transformar uma operação lucrativa em prejuízo operacional se o cotador de frete utilizar índices desatualizados.

A autoridade regulatória nacional para dados de preços no Brasil é a ANP (Agência Nacional do Petróleo, Gás Natural e Biocombustíveis). A ANP realiza semanalmente o Levantamento de Preços de Combustíveis (LPC), auditando milhares de postos revendedores em centenas de municípios estratégicos em todas as 27 Unidades da Federação.

Os dados disponibilizados oficialmente incluem:

• Preço Médio de Revenda: O valor médio apurado na bomba para o consumidor final em cada praça pesquisada (em R$/litro).
• Dispersão Estatística: Preço mínimo, preço máximo, desvio padrão e margem média de comercialização da revenda.
• Cadastro de Postos Revendedores Autorizados: Razão social, CNPJ, distribuidora/bandeira (ex: Vibra, Ipiranga, Raízen/Shell ou Bandeira Branca), endereço completo e situação cadastral do posto.
• Série Histórica e Temporal: Evolução histórica dos preços permitindo análise de tendências e cláusulas contratuais de reajuste automático vinculadas ao diesel.

2. Diesel S10, Diesel S500 e a granularidade geográfica

Um erro frequente de desenvolvedores de software logístico é tratar o termo genérico "diesel" como um produto único. No mercado regulado brasileiro, coexistem duas especificações principais com diferenças técnicas, regulatórias e comerciais profundas:

Dispersão de Preços por UF e Carga Tributária (ICMS monofásico)

Desde a implementação da Lei Complementar nº 192/2022, o ICMS sobre combustíveis passou a ser monofásico e com alíquota ad rem uniforme nacionalmente em R$/litro. Entretanto, o preço final na bomba apresenta variações substanciais de até R$ 1,40 por litro entre diferentes regiões do Brasil.

Fatores logísticos como frete de distribuição por cabotagem ou dutos, distâncias até refinarias (Paulínia/REPLAN, Betim/REGAP, Duque de Caxias/REDUC, Araucária/REPAR) e margens regionais de concorrência fazem com que municípios vizinhos apresentem custos discrepantes. Uma rota que percorre São Paulo, Paraná e Santa Catarina encontra realidades de preço distintas em cada posto de parada.

3. Por que usar competência temporal e governança de dados versionados

No ambiente corporativo de embarcadores e transportadoras de grande porte, um cálculo de frete não pode ser volátil nem "mágico". Toda cotação precisa ser auditável em caso de litígio comercial ou fiscalização tributária.

Se o seu sistema consultar um preço de diesel hoje e sobreescrever o valor amanhã sem histórico, você perde a capacidade de explicar por que uma rota cotada no dia 10 custou R$ 4.200 e a mesma rota cotada no dia 18 custou R$ 4.550.

4. Como transformar preço por litro em custo de viagem auditável

Transformar o dado bruto da ANP em uma previsão financeira precisa para a esteira de cotação exige uma equação paramétrica clara:

Por exemplo, em uma rota de 820 km realizada por uma carreta 6 eixos (consumo médio de 2,2 km/L) com Diesel S10 cotado na média regional da ANP a R$ 6,15/L:

• Consumo em litros: 820 km ÷ 2,2 km/L = 372,73 litros
• Custo de combustível: 372,73 L × R$ 6,15 = R$ 2.292,29
• Custo de diesel por quilômetro rodado: R$ 2.292,29 ÷ 820 km = R$ 2,80/km

Somado aos pedágios e aos custos fixos de motorista e depreciação, o diesel define a rentabilidade líquida do frete.

5. Consumo médio, distância rodoviária e litros estimados

No transporte de cargas pesadas, a média de consumo varia consideravelmente de acordo com o perfil da rota e a tecnologia do conjunto:

6. Estratégia de abastecimento ao longo da rota

Em rotas de longa distância (superiores a 1.000 km), os caminhões pesados possuem autonomia suficiente graças a tanques de combustível que variam de 600 a 1.100 litros. Isso permite ao gestor de frota e ao motorista planejar o abastecimento em postos estratégicos com preços mais vantajosos.

A API do Geodagio permite parametrizar diferentes estratégias no endpoint POST /api/v1/fuel/route-cost:

• ORIGIN_MUNICIPALITY_LATEST: Utiliza o preço médio do município de origem (ideal quando a transportadora possui base própria ou parceria local).
• DESTINATION_MUNICIPALITY_LATEST: Precifica com base no destino da carga.
• STATE_AVERAGE: Utiliza a média ponderada da UF do trecho percorrido, mitigando distorções de micro-regiões.
• NATIONAL_AVERAGE: Média Brasil, recomendada para acordos contratuais de frete spot sem praça fixa de abastecimento.

7. Exemplos práticos em cURL, TypeScript e Python

Abaixo estão exemplos reais e auditáveis de integração consumindo os endpoints oficiais do Geodagio.

7.1. Consulta Rápida de Preço mais Recente via cURL

curl -X GET "https://api.geodagio.com/api/v1/fuel/prices/latest?product=DIESEL_S10&state=SP&municipality=Campinas" \
  -H "Authorization: Bearer sec_live_9a8b7c6d5e4f3a2b1c0d" \
  -H "Accept: application/json"

7.2. Cálculo de Custo Financeiro de Rota em TypeScript

Este exemplo consome o endpoint /api/v1/fuel/route-cost, enviando parâmetros veiculares e estratégia de média estadual:

export interface FuelCostRequest {
  origin: string;
  destination: string;
  product: 'DIESEL_S10' | 'DIESEL_S500';
  kmPerLiter: number;
  strategy?: 'ORIGIN_MUNICIPALITY_LATEST' | 'DESTINATION_MUNICIPALITY_LATEST' | 'STATE_AVERAGE' | 'NATIONAL_AVERAGE';
}

export interface FuelCostResult {
  distanceKm: number;
  estimatedLiters: number;
  pricePerLiter: number;
  totalCostBrl: number;
  competenceWeek: string;
  geographicKey: string;
}

export async function calculateRouteFuelCost(
  apiKey: string,
  params: FuelCostRequest
): Promise<FuelCostResult> {
  const response = await fetch('https://api.geodagio.com/api/v1/fuel/route-cost', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'Idempotency-Key': `fuel-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`
    },
    body: JSON.stringify({
      origin: params.origin,
      destination: params.destination,
      product: params.product,
      consumption: {
        kmPerLiter: params.kmPerLiter
      },
      strategy: params.strategy || 'STATE_AVERAGE'
    })
  });

  if (!response.ok) {
    const err = await response.json().catch(() => ({}));
    throw new Error(`Erro na API de Combustível [${response.status}]: ${err?.error?.message || 'Falha de comunicação'}`);
  }

  const json = await response.json();
  const data = json.data;

  return {
    distanceKm: data.distanceKm,
    estimatedLiters: data.estimatedLiters,
    pricePerLiter: data.pricePerLiter,
    totalCostBrl: data.totalCost,
    competenceWeek: data.sourceCompetence || '2026-W34',
    geographicKey: data.geographicKey
  };
}

7.3. Script de Extração e Auditoria em Python

import requests
import json

def get_latest_diesel_price(api_key: str, state: str, municipality: str = None):
    url = "https://api.geodagio.com/api/v1/fuel/prices/latest"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Accept": "application/json"
    }
    params = {
        "product": "DIESEL_S10",
        "state": state
    }
    if municipality:
        params["municipality"] = municipality

    response = requests.get(url, headers=headers, params=params, timeout=8)
    response.raise_for_status()
    data = response.json()["data"]

    print(f"Produto: {data['product']}")
    print(f"Região / UF: {data['geographicKey']}")
    print(f"Preço Médio ANP: R$ {data['averagePrice']:.2f} / litro")
    print(f"Semana da Pesquisa: {data.get('surveyWeek', 'N/A')}")
    return data

# Exemplo de execução
if __name__ == "__main__":
    get_latest_diesel_price("sec_live_mock_token", "PR", "Curitiba")

Vídeo Oficial: Preço do Diesel S10 no Frete e Redução de Custos

Assista ao vídeo explicativo do canal oficial Geodagio no YouTube mostrando como as variações regionais do diesel impactam a rentabilidade do transporte e como planejar paradas de abastecimento:

8. Como integrar o preço de combustível ao motor de cotação do TMS

Em sistemas TMS e ERPs logísticos, o módulo de cotação de fretes deve acionar o cálculo de combustível como parte do ciclo unificado de formação de tarifas:

1. Recebimento da Solicitação de Cotação: O cliente web ou EDI solicita cotação para uma carga de 32 toneladas entre São Paulo e Belo Horizonte.
2. Consulta de Distância e Pedágios: O TMS aciona a rota no Geodagio, obtendo a distância rodoviária exata e as praças de pedágio.
3. Apuração do Combustível: O TMS chama /api/v1/fuel/route-cost com a média do veículo vinculado à frota.
4. Consolidação com o Piso da ANTT: O sistema verifica se o frete resultante respeita o piso regulatório da ANTT (Resolução nº 5.867/2020) via /api/v1/freight-floor/calculate.
5. Gravação de Memória Contábil: A ordem de frete armazena o consumo em litros e o preço ANP de referência para eventual aplicação de cláusula de gatilho do diesel.

9. Tratamento de dados ausentes e arquitetura de fallbacks determinísticos

Nem todos os mais de 5.570 municípios brasileiros são pesquisados pela ANP a cada semana. A ANP prioriza capitais, regiões metropolitanas e municípios polo com alto volume de revenda de combustíveis.

Para que uma aplicação em produção nunca fique sem resposta, o Geodagio implementa uma cascata hierárquica e determinística de fallback:

O envelope de resposta traz sempre a flag fallbackApplied: true e a chave geográfica real utilizada, garantindo transparência técnica total para os algoritmos de frete.

10. Casos de uso: transportadoras, operadores logísticos e embarcadores

• Auditoria de Abastecimento em Viagem: Comparar os comprovantes fiscais (NFC-e) entregues pelos motoristas com o preço médio oficial da ANP no município de abastecimento para identificar sobrepreços anormais.
• Cláusulas Contratuais de Diesel (Fuel Surcharge): Grandes embarcadores industriais mantêm contratos com cláusulas de reajuste automático sempre que o diesel variar mais de 5% no levantamento da ANP. A API fornece o dado neutro oficial que elimina discussões entre as partes.
• Roteirização com Otimização de Parada: Identificar postos autorizados no corredor da rodovia com preços mais baixos para programar paradas obrigatórias da Lei do Descanso com menor custo por litro.

11. Perguntas Frequentes sobre a API de Preços de Diesel ANP (FAQ)

Fontes Primárias e Regulatórias Homologadas

Este guia técnico foi estruturado com base nos dados públicos e normativas oficiais vigentes em outubro de 2026:

• ANP (Agência Nacional do Petróleo): Levantamento de Preços de Combustíveis (LPC) e Dados Abertos (gov.br/anp).
• Normas PROCONVE / CONAMA: Resoluções nº 403/2008 e nº 490/2018 (Fases P7 e P8 de controle de emissões para veículos pesados).
• Lei Federal nº 13.703/2018: Política Nacional de Pisos Mínimos do Transporte Rodoviário de Cargas (Gatilho do Diesel de ±5%).
• Lei Complementar nº 192/2022: Regime de tributação monofásica do ICMS sobre combustíveis.

Continue Explorando a Engenharia Logística do Geodagio:

• API de Combustível & Preços ANP — Consulta de dados oficiais de diesel, gasolina e postos credenciados.
• Tabela ANTT 2026: Gatilho do Diesel e Piso Mínimo — Como a variação do diesel aciona o reajuste extraordinário do piso.
• Cálculo do Custo Total de Rotas de Caminhão — O impacto conjunto de diesel, pedágio e altimetria no custo real.
• API de Pedágio para Caminhões por Eixos — Integração em TMS e ERPs com suporte a Free Flow e idempotência.