Adicional combustível frete
Transforme o frete base e o percentual de combustível vigente no valor a cobrar: uma base de 48,5 com 12,5 % soma um adicional de 6,06 e chega a um frete total de 54,56. Você informa os dois números; nenhuma tabela é consultada. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Taxa base
- 48,5
- Sobretaxa (%)
- 12,5
- Valor da sobretaxa
- 6,06
- Frete total
- 54,56
Transportadoras e redes de encomendas publicam adicionais de combustível como percentual do cargo base de transporte, de modo que o valor cobrado do cliente nunca é só a tarifa de lista do mapa de zonas. Equipes de operações, vendedores de marketplaces e corretores de frete precisam de um único passo determinístico que transforme uma tarifa base conhecida e o percentual de combustível vigente no valor do adicional e no total de frete completo.
Como um adicional percentual de combustível transforma a tarifa base no frete total
Um adicional de combustível quase sempre é expresso como percentual do cargo base de transporte ou envio para um nível de serviço, faixa de peso e zona de destino.
Se a cotação da transportadora ou a sua tabela mostra uma tarifa base de quarenta e oito vírgula cinco unidades monetárias e o fator de combustível publicado é de doze vírgula cinco por cento, o valor do adicional é base vezes percentual dividido por cem, e o frete total é base mais esse adicional—ou, de forma equivalente, base vezes um mais o percentual sobre cem.
Fazer as contas à mão é fácil para um único volume e penoso ao conciliar uma fatura semanal com centenas de linhas, cada uma com base diferente e a mesma tabela semanal de combustível. Esta capacidade implementa exatamente essa identidade em dois passos sem consulta à rede da transportadora e sem tabela dependente de data: você informa a tarifa base que já conhece e o percentual de adicional válido no período que está precificando.
As saídas monetárias são arredondadas half-up para duas casas decimais, de modo que intermediários de ponto flutuante como seis vírgula zero seis dois cinco se tornam seis vírgula zero seis no adicional e cinquenta e quatro vírgula cinco seis no total, alinhados à contabilidade e às linhas de fatura usuais.
Onde calcular o adicional de combustível ajuda
Plataformas de e-commerce usam uma calculadora de adicional de combustível para que checkout e ferramentas de back-office mostrem o frete aterrissado alinhado aos boletins semanais da transportadora sem codificar uma constante nova toda segunda-feira. Operadores logísticos terceiros e corretores de frete precisam de um oráculo determinístico para e-mails de cotação, tabelas e checagens de margem quando a mesma base aparece sob tabelas de combustível diferentes por região ou serviço.
Mantenha a base e o percentual como únicas entradas, fixe os campos monetários arredondados nos testes e obtenha totais de frete reproduzíveis para marketplaces, plugins WMS e workers na borda sem montar um motor de tarifação completo próprio.
Casos de uso
Checkout e exibição do frete aterrissado
Mostre a compradores ou clientes B2B o frete total aplicando o percentual de combustível vigente da transportadora à tarifa base cotada antes do pagamento.
Linhas de fatura e auditoria da transportadora
Reconstrua o adicional e o frete total de cada linha base ao conciliar faturas semanais da transportadora com a tabela de combustível publicada para aquele período.
E-mails de cotação e tabelas de frete
Gere cotações de corretor ou 3PL que listem tarifa base, valor do adicional de combustível e frete total a partir de um único percentual compartilhado entre muitos SKUs.
Perguntas frequentes
Esta ferramenta consulta tabelas de combustível ao vivo?
Não. Você informa o percentual válido no período que está precificando.
Como se calcula o adicional de combustível do frete?
Multiplique o frete base pelo percentual de combustível e divida por cem; depois some esse valor à base para obter o total. Uma base de 100 com 8 % dá adicional de 8, que depois é somado à base.
Como o adicional e o total são arredondados?
Os dois são arredondados para duas casas decimais, com a metade para cima, como nas linhas de fatura mais comuns. Por isso uma base de 48,5 com 12,5 % mostra adicional de 6,06 e frete total de 54,56.
O frete base ou o percentual podem ser zero?
Sim. Qualquer um dos dois em zero dá adicional zero, e o total fica igual à base. Valores negativos são recusados, e o percentual de combustível não pode passar de mil por cento.
Devo digitar 12,5 ou uma fração decimal para 12,5 %?
Digite 12,5. O número de combustível é lido como percentual do frete base, do jeito que as transportadoras publicam nas tabelas, então não é preciso convertê-lo para decimal antes.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/ecom/fuel-surcharge \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_rate":48.5,"surcharge_percent":12.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/fuel-surcharge", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_rate": 48.5,
"surcharge_percent": 12.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/fuel-surcharge",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_rate": 48.5,
"surcharge_percent": 12.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/fuel-surcharge", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_rate":48.5,"surcharge_percent":12.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_rate":48.5,"surcharge_percent":12.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/fuel-surcharge", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Esta calculadora de adicional de combustível no frete aceita a tarifa base de envio e o percentual do adicional, multiplica a base pelo percentual sobre cem para o valor do adicional, soma esse valor à base para o frete total e arredonda os campos monetários half-up para duas casas decimais, alinhando faturas e clientes API. Base zero ou percentual zero são permitidos e geram adicional nulo; entradas negativas falham com invalid_input e não são cobradas.
Como um adicional percentual de combustível transforma a tarifa base no frete total
A resposta ecoa as entradas enviadas, devolve surcharge_amount e total_freight e inclui uma string formula curta que você pode exibir na interface ou no log de auditoria ao lado dos números.
Contrato de entrada, formato da resposta e validação
A tarifa base é limitada a um trilhão de unidades monetárias e o percentual de adicional a mil por cento para que uma automação descontrolada não estoure rotas de exibição. Uma base de cem com oito por cento gera adicional oito e total cento e oito. Solicitações inválidas não são cobradas. Envie um corpo JSON via POST com dois números finitos não negativos obrigatórios: base_rate, o valor de envio ou frete antes do combustível (também aceito nos aliases shipping_rate, rate, base_shipping_rate e freight_base); e surcharge_percent, o percentual de combustível, por exemplo doze vírgula cinco para doze vírgula cinco por cento (aliases fuel_surcharge_percent, percent, fuel_percent e surcharge_pct). Cada campo pode chegar como número JSON ou string numérica; strings vazias, campos ausentes, valores não finitos e negativos falham com invalid_input indicando o campo. Em sucesso o corpo inclui base_rate e surcharge_percent como números normalizados, surcharge_amount e total_freight como dinheiro half-up de duas casas, e formula reafirmando a identidade. Exemplo: base_rate quarenta e oito vírgula cinco e surcharge_percent doze vírgula cinco produzem surcharge_amount seis vírgula zero seis e total_freight cinquenta e quatro vírgula cinco seis. Combine este endpoint com o seu próprio passo de tarifa por zona ou peso dimensional se ainda precisar derivar a base; esta calculadora só aplica o percentual de combustível quando a base já é conhecida.
Onde uma API de adicional de combustível no frete gera valor
Substitutos de planilhas e automações low-code chamam a API para que o financeiro possa reprecificar envios históricos ao auditar uma linha de fatura contestada que usou o fator de combustível do mês passado. Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída.
Perguntas técnicas
Como calcular o adicional de combustível no frete?
Envie base_rate e surcharge_percent não negativos. A API devolve surcharge_amount = base_rate × surcharge_percent / 100 e total_freight = base_rate + surcharge_amount, com dinheiro arredondado half-up para duas casas.
Quais unidades devo usar para base_rate?
Qualquer unidade monetária consistente (USD, EUR, etc.). A calculadora é agnóstica à unidade: multiplica e arredonda; não converte moedas nem consulta tabelas da transportadora.
surcharge_percent pode ser zero ou passar de 100?
Zero é permitido e gera adicional nulo. Valores acima de 100 são aceitos até 1000 para tabelas temporárias extremas; percentual negativo é rejeitado com invalid_input.
Quanto custa a calculadora de adicional de combustível no frete?
A ferramenta no navegador é gratuita. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.