---
title: "Calcula Frete ANTT"
description: "API Frete - Cálculo Fácil e Confiável para Transportes"
lang: pt-BR
canonical: https://doc.apibrasil.io/apis/creditos/da05ccf3-0d65-43bd-9c37-d402f61d61ed
markdown: https://doc.apibrasil.io/apis/creditos/da05ccf3-0d65-43bd-9c37-d402f61d61ed.md
source: apibrasil-documentation
---

# Calcula Frete ANTT

> API Frete - Cálculo Fácil e Confiável para Transportes

- **Categoria:** Serviços Digitais
- **Cobrança:** por consulta, só com o Bearer Token
- **Preço:** R$ 0,05 por consulta
- **Limite:** 999.000 por mês
- **Cadastro:** exige CNPJ
- **Versão:** v2
- **Publicada por:** APIBrasil
- **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/da05ccf3-0d65-43bd-9c37-d402f61d61ed/openapi.json

## Como chamar

**Endereço base:** `https://gateway.apibrasil.io/api/v2`

Autenticação: cabeçalho `Authorization: Bearer <token>`. Nada além disso.

Com `homolog: true` no corpo, o gateway responde de uma base fixa, com a forma real da resposta, e não cobra. O CPF 00000000000 é dessa base e não é de ninguém: use-o nos testes, nunca em produção.

## Endpoints (6 endpoints)

**Sumário**

1. `POST /consulta/frete-antt/credits`
2. `POST /consulta/frete-antt/credits`
3. `POST /consulta/frete-antt/credits`
4. `POST /consulta/frete-antt/credits`
5. `POST /consulta/frete-antt/credits`
6. `POST /consulta/frete-antt/credits`

### 1. POST /consulta/frete-antt/credits

API de Frete ANTT - Calcule Seu Frete Rápido e Com Precisão

A API Calcula Frete ANTT permite que sua empresa integre rapidamente o cálculo de fretes conforme a tabela oficial da ANTT, trazendo praticidade e total aderência à legislação para seus processos logísticos. Com uma simples chamada POST ao endpoint consulta/frete-antt/credits, você recebe em tempo real o valor detalhado do frete, otimizando a tomada de decisão e agregando valor imediato ao seu sistema de gestão. Ideal para transportadoras, embarcadores e plataformas ERP, essa API facilita a automatização de cotações e contratos, garantindo segurança e transparência nos custos. Potencialize resultados e proporcione uma experiência inovadora aos seus usuários, confiando no cálculo sempre atualizado diretamente em sua operação.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "calcula-frete",
  "homolog": true,
  "tipoCarga": "carga_geral",
  "eixos": 6,
  "distanciaKm": 100,
  "composicaoVeicular": "cavalo_trucado",
  "altoDesempenho": false,
  "retornoVazio": false,
  "dataReferencia": "2026-03-20"
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"calcula-frete","homolog":true,"tipoCarga":"carga_geral","eixos":6,"distanciaKm":100,"composicaoVeicular":"cavalo_trucado","altoDesempenho":false,"retornoVazio":false,"dataReferencia":"2026-03-20"}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "pisoMinimo": {
      "bruto": 777.77,
      "formatado": "R$ 777,77",
      "moeda": "BRL"
    },
    "ccdAplicado": {
      "bruto": 3.1415,
      "formatado": "3,1415",
      "unidade": "R$/km"
    },
    "ccAplicado": {
      "bruto": 120.5,
      "formatado": "R$ 120,50",
      "moeda": "BRL"
    },
    "versaoNormativa": "9.999/2099",
    "documentoBase": "9.999/2099",
    "vigenciaInicio": "2099-01-01",
    "vigenciaFim": null
  }
}
```

### 2. POST /consulta/frete-antt/credits

API Frete ANTT - Calcule o preço ideal do transporte em segundos

Com a Calcula Frete ANTT, sua empresa obtém o valor exato do frete rodoviário de acordo com a tabela ANTT em poucos cliques, por meio de uma integração rápida e segura. Através deste endpoint, você recebe instantaneamente dados precisos para simular opções de custo de transporte e garantir o cumprimento da legislação, maximizando a rentabilidade de suas operações. A API retorna o cálculo do frete conforme o perfil desejado, possibilitando a automatização dos orçamentos em plataformas de gestão, ERPs ou sistemas logísticos, agilizando processos e evitando custos indevidos. Simplifique agora o cálculo do frete, gere confiança para seus clientes e mantenha-se competitivo no mercado.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "opcoes-calculo",
  "homolog": true,
  "dataReferencia": "2026-03-20"
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"opcoes-calculo","homolog":true,"dataReferencia":"2026-03-20"}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "versaoNormativa": "9.999/2099",
    "vigenciaInicio": "2099-01-01",
    "vigenciaFim": null,
    "tipoCarga": [
      "carga_demo_palete",
      "granel_demo_controlado"
    ],
    "eixos": [
      4,
      6,
      9
    ],
    "composicaoVeicular": [
      "bitrem_demo",
      "truck_demo"
    ],
    "altoDesempenho": [
      false,
      true
    ],
    "retornoVazio": [
      false,
      true
    ]
  }
}
```

### 3. POST /consulta/frete-antt/credits

API Frete e Carga - Calcule fretes ANTT com praticidade e precisão

Otimize o cálculo do frete regulado com a API Calcula Frete ANTT, ideal para transportadoras, marketplaces, TMS e plataformas logísticas que buscam agilidade e conformidade. Com integração rápida via POST, você consulta créditos de frete conforme tabela ANTT, definindo detalhes como modelos de carga e data de referência. O serviço retorna valores completos de acordo com as regras atualizadas, permitindo uma precificação precisa, transparência nas operações e integração direta ao seu sistema. Potencialize decisões comerciais e garanta competitividade com cálculos automáticos, prontos para escala e homologados para uso no seu negócio.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "modelos-carga",
  "homolog": true,
  "dataReferencia": "2026-03-20"
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"modelos-carga","homolog":true,"dataReferencia":"2026-03-20"}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "versaoNormativa": "9.999/2099",
    "vigenciaInicio": "2099-01-01",
    "vigenciaFim": null,
    "tipoCarga": [
      "carga_demo_palete",
      "granel_demo_controlado"
    ],
    "catalogoOficial": [
      {
        "id": 901,
        "nome": "Carga Demo Paletizada",
        "chave": "carga_demo_palete"
      },
      {
        "id": 902,
        "nome": "Granel Demo Controlado",
        "chave": "granel_demo_controlado"
      },
      {
        "id": 903,
        "nome": "Conteiner Demo Lacrado",
        "chave": "conteiner_demo_lacrado"
      }
    ]
  }
}
```

### 4. POST /consulta/frete-antt/credits

API Frete ANTT - Calcule o frete oficial em segundos

Com a API Calcula Frete ANTT, você integra rapidamente o cálculo oficial do frete rodoviário conforme a normativa vigente, garantindo total conformidade e agilidade nas suas operações logísticas. Realize consultas rápidas via POST e obtenha o valor exato do frete, com restituição clara dos créditos e estimativas para tomada de decisão instantânea. A solução se adapta facilmente ao seu sistema, otimizando simulações comerciais, geração automática de orçamentos ou atualização de propostas junto aos seus clientes, tudo com segurança e confiabilidade. Potencialize seu negócio com cálculos atualizados e alta performance.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "normativa-atual",
  "homolog": true,
  "dataReferencia": "2026-03-20"
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"normativa-atual","homolog":true,"dataReferencia":"2026-03-20"}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "id": "mock-version-001",
    "versionLabel": "9.999/2099",
    "validFrom": "2099-01-01T00:00:00.000Z",
    "validTo": null,
    "reason": "Versao ficticia para homologacao",
    "document": "9.999/2099"
  }
}
```

### 5. POST /consulta/frete-antt/credits

API de Frete ANTT - Calcule Fretes Oficiais com Facilidade

A API Calcula Frete ANTT permite calcular de forma automática e precisa o valor base do frete rodoviário de cargas segundo a tabela ANTT, garantindo total conformidade com as normas vigentes. Com integração rápida via POST e resposta instantânea incluindo todos os detalhes exigidos pela legislação, seu sistema pode agregar o cálculo oficial de frete a cada orçamento, cotação, emissão de conhecimento de transporte ou qualquer processo logístico de sua operação. Aumente a eficiência operacional, reduza riscos fiscais e entregue valor ao cliente integrando em poucos minutos uma solução homologada, pronta para uso e sempre atualizada conforme as versões normativas da ANTT.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "versoes-normativas",
  "homolog": true
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"versoes-normativas","homolog":true}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "items": [
      {
        "id": "mock-version-001",
        "versionLabel": "9.999/2099",
        "validFrom": "2099-01-01T00:00:00.000Z",
        "validTo": null,
        "reason": "Versao ficticia para homologacao",
        "baseDocumentId": "mock-doc-001"
      },
      {
        "id": "mock-version-000",
        "versionLabel": "9.998/2098",
        "validFrom": "2098-12-01T00:00:00.000Z",
        "validTo": "2098-12-31T00:00:00.000Z",
        "reason": "Historico ficticio",
        "baseDocumentId": "mock-doc-000"
      }
    ]
  }
}
```

### 6. POST /consulta/frete-antt/credits

API de Frete ANTT - Otimize o cálculo de fretes em segundos

A API Calcula Frete ANTT fornece cálculos precisos e atualizados conforme as normativas da ANTT, permitindo que seu sistema automatize orçamentos de transporte com máxima confiabilidade e agilidade. Com integração rápida via POST, o serviço retorna informações detalhadas de crédito e valores normativos prontos para uso imediato em suas operações, reduzindo erros e acelerando decisões comerciais. Ganhe vantagem competitiva integrando esse recurso ao seu fluxo, atendendo as exigências do setor de transporte e garantindo transparência e economia para seus clientes.

- **Método:** `POST`
- **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits`
- **Versão da rota:** v2

**Cabeçalhos**

| Cabeçalho | Valor |
| --- | --- |
| `Content-Type` | `application/json` |
| `Authorization` | `Bearer $APIBRASIL_TOKEN` |

**Corpo da requisição**

```json
{
  "tipo": "sincroniza-normativas",
  "homolog": true
}
```

**Em cURL**

```bash
curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/frete-antt/credits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIBRASIL_TOKEN" \
  -d '{"tipo":"sincroniza-normativas","homolog":true}'
```

Este endpoint aceita `homolog: true` no corpo: a resposta volta com dados válidos, `api_limit_for` igual a `homolog` e sem tarifação.

**Resposta de exemplo, do catálogo**

```json
{
  "user": {
    "first_name": "[omitido]",
    "email": "[omitido]",
    "cellphone": "[omitido]",
    "notification": "yes"
  },
  "balance": "1.044,110",
  "error": false,
  "message": "Dados validos em homologacao! Voce nao foi tarifado e a requisicao nao foi contabilizada.",
  "tax": "0,000",
  "valor_consulta": 0,
  "api_limit_for": "homolog",
  "homolog": true,
  "data": {
    "synced": true,
    "versionId": "mock-version-001",
    "coefficientCount": 24,
    "references": {
      "normativeBase": {
        "reference": "9.999/2099",
        "date": "2099-01-01",
        "url": "https://homolog.exemplo.local/normative-base",
        "title": "Resolucao ficticia de homologacao",
        "fetchedAt": "2099-01-15T10:00:00.000Z"
      },
      "updates": {
        "reference": "Atualizacao ficticia de homologacao",
        "date": "2099-01-15",
        "url": "https://homolog.exemplo.local/updates",
        "title": "Atualizacao simulada",
        "fetchedAt": "2099-01-15T10:05:00.000Z"
      }
    }
  }
}
```

Nos exemplos de resposta, os campos da conta que gerou o exemplo (`user.first_name`, `user.email`, `user.cellphone`) saem como `[omitido]`. O resto é o que o catálogo publica.

## Armadilhas: o que uma integração erra sem avisar

Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto:

1. **O erro chega no CORPO, com HTTP 200.**
   A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`.

2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.**
   Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los.

3. **Cada chamada custa dinheiro.**
   Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas.

4. **HTTP 402 é saldo insuficiente, e repetir não resolve.**
   É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos.

5. **`extra_charges` cobra à parte do preço da consulta.**
   Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois.

## Ver também

- Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/da05ccf3-0d65-43bd-9c37-d402f61d61ed/openapi.json
- Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md)
- SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/da05ccf3-0d65-43bd-9c37-d402f61d61ed