Calculadora de custo de frete por zona
Transforme peso e distância em um preço de entrega por zona: 2,5 kg a uma tarifa local de 4 na zona 3, com multiplicador 1,55, dão 15,50 pela zona, e 1,50 de manuseio leva o total a 17,00. 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
- Peso
- 2,5
- Tarifa por unidade
- 4
- Zona
- 3
- Manuseio
- 1,5
- Taxa mínima
- 0
- Nome da zona
- super_regional
- Multiplicador de zona
- 1,55
- Distância mínima
- 300
As transportadoras quase nunca publicam um único valor postal para cada destino. Elas dividem o mapa em zonas de distância, cotam uma tarifa local por quilograma ou libra e multiplicam essa base por um fator de zona que cresce com o comprimento do trecho. Esta calculadora de custo de frete por zona aplica uma tabela genérica de preços por zona de distância: recebe o peso do pacote, a sua tarifa de zona 1 por unidade de peso e, ou uma zona de destino, ou uma distância em quilômetros, e devolve o multiplicador de zona, o encargo por peso, o manuseio opcional e o custo final de frete após qualquer cobrança mínima. A moeda é a sua; a ferramenta não converte câmbio nem escolhe uma transportadora nomeada.
O que é o frete por zonas e como a tabela genérica é montada
A precificação por zonas é o cavalo de batalha das tabelas de frete de encomendas e LTL. Em vez de cotar um preço único para cada par origem-destino, a rede agrupa destinos que caem na mesma faixa de distância a partir do hub de expedição e atribui a cada faixa um multiplicador. Entregas locais ficam perto de 1.00 vezes a tarifa publicada por unidade.
Faixas regionais e nacionais sobem conforme caminhões ou aeronaves gastam mais tempo e combustível. Faixas transcontinentais e internacionais ficam no topo da escada porque consomem mais capacidade de rede.
Esta calculadora traz uma tabela genérica de oito zonas que segue esse padrão sem prender você a uma carta de marca: a zona 1 local vai de 0 até 150 quilômetros com multiplicador 1.00; a zona 2 regional, de 150 até 300 com 1.25; a zona 3 super-regional, de 300 até 600 com 1.55; a zona 4 nacional, de 600 até 1000 com 1.90; a zona 5 estendida, de 1000 até 1400 com 2.30; a zona 6 distante, de 1400 até 1800 com 2.75; a zona 7 transcontinental, de 1800 até 2500 com 3.25; a zona 8 internacional, 2500 quilômetros em diante, com 4.00.
As faixas são semiabertas, então um trecho de exatamente 150 quilômetros é regional, não local. A fórmula monetária é então mecânica: multiplique o peso pela tarifa de zona 1 por unidade para obter o encargo-base, escale essa base pelo multiplicador de zona, some qualquer taxa fixa de manuseio e eleve o resultado à cobrança mínima quando o piso for maior.
É a mesma estrutura que as equipes de operações já guardam em planilhas, só que a tabela e o arredondamento vivem em um módulo determinístico em vez de uma célula que alguém vai sobrescrever no trimestre que vem.
Casos de uso
Estimativas de frete no checkout
Mostre aos compradores um total de entrega por zona a partir do peso do carrinho, da sua tarifa local por unidade e da zona de destino, antes de haver cotação ao vivo da transportadora.
Checagens de etiqueta no armazém
Depois de pesar o cartão, calcule o encargo de zona e o manuseio para o romaneio bater com a tabela de frete que o financeiro já aprovou.
Auditorias de fatura e de zona
Reexecute o peso do pedido e a distância do trecho pela tabela genérica para explicar por que um envio caiu numa faixa mais cara do que o previsto.
Perguntas frequentes
Como se calcula o custo de frete por zona?
O multiplicador vem de uma tabela genérica de oito faixas distância-zona (1.00 local até 4.00 international).
Devo enviar um número de zona ou uma distância?
Qualquer um dos dois. zone é um inteiro 1–8. distance vai em quilômetros e seleciona a faixa.
Quais são as faixas genéricas de zona?
Quilômetros, faixas semiabertas: 0–150 (local ×1.00), 150–300 (×1.25), 300–600 (×1.55), 600–1000 (×1.90), 1000–1400 (×2.30), 1400–1800 (×2.75), 1800–2500 (×3.25), 2500+ international (×4.00).
Isso substitui uma cotação ao vivo da transportadora?
Não. Aplica uma tabela genérica de distância-zona para as estimativas permanecerem explicáveis.
Um trajeto de exatamente 150 km é local ou regional?
Regional. Cada faixa inclui o limite inferior, mas não o superior, então 150 km já é a zona 2, a 1,25 vez a tarifa local, e qualquer distância menor continua na zona 1, a 1,00.
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/shipping-cost-by-zone \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"weight":2.5,"rate_per_unit":4,"zone":3}'const res = await fetch("https://api.kit.forhosting.com/ecom/shipping-cost-by-zone", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"weight": 2.5,
"rate_per_unit": 4,
"zone": 3
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/shipping-cost-by-zone",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"weight": 2.5,
"rate_per_unit": 4,
"zone": 3
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/shipping-cost-by-zone", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"weight":2.5,"rate_per_unit":4,"zone":3}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"weight":2.5,"rate_per_unit":4,"zone":3}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/shipping-cost-by-zone", 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
{
"weight": 2.5,
"rate_per_unit": 4,
"zone": 3
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.shipping_cost_by_zone",
"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
Contrato de entrada, campos de resposta e validação
Depois envie zone como inteiro de 1 a 8, ou distance como trecho não negativo em quilômetros, ou ambos. Campos monetários arredondam para duas casas decimais para comparações estáveis de moeda; o peso e uma distance ecoada mantêm estabilidade de doze decimais. Combine a resposta com os seus próprios rótulos de unidade. Este extremo nunca converte quilogramas em libras nem quilômetros em milhas, e nunca finge ser uma cotação ao vivo da UPS, FedEx, DHL ou de um serviço postal. Envie um corpo JSON com dois números não negativos obrigatórios e pelo menos uma forma de escolher a zona. weight é a massa do pacote embalado e deve ser estritamente positiva. rate_per_unit é o seu preço local (zona 1) pela mesma unidade de peso; zero é permitido quando você só cobra manuseio. Se os dois chegarem, precisam concordar com a tabela: um trecho de 400 quilômetros é zona 3, então combiná-lo com zona 5 falha como invalid_input e não é cobrado. handling e min_charge valem zero quando omitidos. Cada campo numérico pode chegar como número JSON ou como cadeia numérica; valores obrigatórios ausentes, cadeias vazias, cifras não finitas, dinheiro negativo e uma zona fora de 1 a 8 falham nomeando o campo. Em caso de sucesso o corpo ecoa as entradas, nomeia a zona resolvida e zone_name (local até international), informa zone_multiplier e a faixa em quilômetros como distance_min e, salvo o trecho internacional aberto, distance_max, e devolve base_charge, zone_charge, shipping_cost e min_applied para o checkout mostrar por que um piso disparou. Exemplo: weight 2.5, tarifa 4.00, zone 3, handling 1.50 produz base 10.00, encargo de zona 15.50 e custo de frete 17.00.
Onde uma calculadora de custo de frete por zona se paga
Analistas financeiros reexecutam o peso do pedido e a distância de destino pela tabela para conciliar faturas que cobraram uma zona mais cara do que o armazém esperava. Validação falha não consome saldo. Equipes de checkout de comércio eletrônico usam uma calculadora de custo de frete por zona para estimar a entrega antes de chamar a API da transportadora, para que o comprador veja um valor transparente por zona em vez de uma surpresa na porta. Marketplaces e comércios com vários armazéns projetam cada par origem-destino nas mesmas oito faixas e reutilizam um rate_per_unit por nível de serviço, o que deixa as tabelas de frete explicáveis para o financeiro. Softwares de gestão de armazém e de bancada de embalagem podem chamar a API depois de pesar o cartão para imprimir um encargo de zona ao lado da etiqueta sem montar um motor de cotação completo. 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 e sem rede de saída. Documente qual carta de zonas física você aproximou com esta tabela genérica, guarde a unidade de peso ao lado de cada SKU e você obtém matemática de frete por zona reproduzível para cotações, SLA e workers na borda sem licenciar um SDK de transportadora para um produto de quatro termos.
Perguntas técnicas
Quanto custa a calculadora de custo de frete por zona?
A ferramenta no navegador é gratuita. Requisições API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.