1. Home
  2. Docs
  3. Integração via API Calcul...
  4. Consumo da API Calculador...
  5. Calculadora Pedágio

Calculadora Pedágio

Calculadora de Tributos para o Pedágio

Esse endpoint calcula o valor do tributo (IVA/IBS) aplicado ao pedágio com base nas informações enviadas no corpo da requisição.

Aplicação Principal: CT-e (Conhecimento de Transporte Eletrônico)

O CT-e é o documento que registra a prestação do serviço de transporte e é onde ocorre a tributação.

Com a Reforma: O IBS e o CBS incidirão sobre os serviços de transporte. O serviço de exploração de rodovia (pedágio) será tributado, e o cálculo na Calculadora é fundamental para garantir que os novos campos de IBS/CBS no layout do CT-e estejam corretos. A Receita Federal já lançou Notas Técnicas (NT 2025.001) para adequar o layout do CT-e aos novos tributos.

URL 

https://piloto-cbs.tributos.gov.br/servico/calculadora-consumo/api/calculadora/pedagio

Parameters: No parameters
Tipo: POST

Dados de entrada

Exemplo de requisição

Para envio dos dados o Content-Type da requisição deverá ser definido como application/json.

{
  "dataHoraEmissao": "2027-01-01T09:50:05-03:00",
  "codigoMunicipioOrigem": 4314902,
  "ufMunicipioOrigem": "RS",
  "cst": "000",
  "baseCalculo": 200,
  "trechos": [
    {
      "numero": 1,
      "municipio": 4314902,
      "uf": "RS",
      "extensao": 10
    }
  ],
  "cClassTrib": "000002"
}
Exemplos de retorno

Retorno com sucesso

CodeDescription
200Cálculo realizado com sucesso

Exemplo de retorno 

{
    "dataHoraEmissao": "2027-01-01T09:50:05.000-0300",
    "municipioOrigem": 4314902,
    "ufMunicipioOrigem": "RS",
    "cst": "000",
    "cClassTrib": "000002",
    "baseCalculo": 200,
    "extensaoTotal": 10,
    "trechos": [
        {
            "numero": 1,
            "municipio": 4314902,
            "uf": "RS",
            "baseCalculo": 200,
            "extensaoTrecho": 10,
            "cbs": {
                "aliquota": 0.08400000,
                "aliquotaEfetiva": 0.08400000,
                "tributoCalculado": 16.8000
            },
            "ibsEstadual": {
                "aliquota": 0.00050000,
                "aliquotaEfetiva": 0.00050000,
                "tributoCalculado": 0.1000
            },
            "ibsMunicipal": {
                "aliquota": 0.00050000,
                "aliquotaEfetiva": 0.00050000,
                "tributoCalculado": 0.1000
            }
        }
    ],
    "total": {
        "cbsTotal": {
            "baseCalculo": 200,
            "valorApurado": 16.80,
            "valorDevido": 16.80,
            "valorTributo": 16.80
        },
        "ibsEstadualTotal": {
            "baseCalculo": 200,
            "valorApurado": 0.10,
            "valorDevido": 0.10,
            "valorTributo": 0.10
        },
        "ibsMunicipalTotal": {
            "baseCalculo": 200,
            "valorApurado": 0.10,
            "valorDevido": 0.10,
            "valorTributo": 0.10
        }
    }
}

Retorno com erro de dados

CodeDescription
400Estrutura e/ou dados informados em formato não reconhecido
404Erro na URL da requisição
422Erro de validação
500Erro interno na API

Exemplo de retorno 

{
  "type": "https://example.com/",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "https://example.com/",
  "properties": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}

How can we help?