Calculadora de peso cobrável
Saiba por qual peso a transportadora vai cobrar antes de imprimir a etiqueta: uma caixa de 5 lb com 20 × 15 × 10 polegadas e divisor 139 é cobrada por cerca de 21,58 lb de peso dimensional. 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 real
- 5
- Comprimento
- 20
- Largura
- 15
- Altura
- 10
- Divisor dimensional
- 139
- Volume
- 3.000
- Peso dimensional
- 21,582733813
- Peso faturável
- 21,582733813
- Cobrado por
- dimensional
As transportadoras faturam pacotes pelo peso cobrável —também chamado peso faturável—, e não só pelo que a balança mostra. Quando a caixa é grande mas leve, o peso dimensional (volumétrico) pode superar o peso real e você paga pelo valor maior. Esta calculadora de peso cobrável aceita o peso real de balança, comprimento, largura e altura do pacote, mais o divisor dimensional da sua transportadora, e devolve o peso dimensional, o resultado cobrável e se a cotação deve seguir a regra real ou a dimensional. O arredondamento para cima opcional alinha-se a políticas de teto em unidade inteira comuns nas tabelas de frete. As unidades permanecem consistentes com quem chama: use polegadas e libras com divisores como 139 ou 166, ou centímetros e quilogramas com 5000, sem conversão silenciosa.
O que significa peso cobrável e como se calcula o peso dimensional
Peso cobrável —também chamado peso faturável— é a cifra de peso que a transportadora usa ao cotar um envio. Nem sempre é o número da balança do armazém. Em muitos programas de encomendas e LTL o valor cobrável é o maior de duas quantidades: o peso real da mercadoria embalada e o peso dimensional derivado do tamanho externo do cartão.
O peso dimensional existe porque a capacidade de aviões e caminhões é limitada pelo cubo tanto quanto pela massa; um pacote grande e pouco denso pode consumir tanto espaço de rede quanto uma caixa mais densa com as mesmas dimensões externas. A fórmula padrão é peso dimensional igual a comprimento vezes largura vezes altura dividido por um divisor dimensional publicado.
Esse divisor não é universal: programas domésticos dos Estados Unidos costumam usar 139 quando as dimensões estão em polegadas e o peso em libras; algumas rotas internacionais usam 166 com a mesma convenção polegada-libra; programas métricos frequentemente usam 5000 quando as dimensões estão em centímetros e o peso em quilogramas. Seu contrato, tabela de frete ou portal da transportadora é a fonte da verdade sobre qual divisor se aplica —nunca assuma uma constante global única.
Conhecido o peso dimensional, o peso cobrável é simplesmente o máximo entre o peso real e o dimensional. Quando os dois valores são iguais, a cotação segue o peso real de balança. Quando o dimensional é maior, o envio está limitado pelo volume e é cobrado pelo cubo.
Onde uma calculadora de peso cobrável entrega valor
Equipes de operações de e-commerce usam uma calculadora de peso cobrável antes de imprimir etiquetas para marcar caixas leves superdimensionadas e apertar o embalamento antes da fatura da transportadora chegar. Marketplaces e comparadores multi-transportadora precisam de um oráculo determinístico que aplique a mesma regra de máximo entre real e dimensional em UPS, FedEx, USPS, DHL e integradores regionais depois que o divisor correto for informado por serviço.
Analistas de finanças e logística conciliam faturas da transportadora com o histórico de pedidos reexecutando dimensões e pesos pela mesma fórmula em vez de desmontar uma planilha. Validação falha não consome saldo.
Casos de uso
Checkout e comparação de fretes
Estime o peso cobrável para cotações multi-transportadora aplicando o divisor dimensional de cada serviço ao mesmo L×W×H e peso real.
Conciliação de faturas
Reexecute as dimensões do pedido pela fórmula de peso cobrável para explicar por que a transportadora cobrou peso dimensional em vez da leitura da balança do armazém.
Perguntas frequentes
Preciso de unidades compatíveis para peso e dimensões?
Sim. Mantenha um único sistema: polegadas com libras e divisor em polegadas, ou centímetros com quilogramas e divisor métrico. A calculadora nunca converte unidades em silêncio.
Como se calcula o peso dimensional?
Multiplique comprimento, largura e altura e divida pelo divisor da sua transportadora. Uma caixa de 20 × 15 × 10 tem volume de 3000; dividido por 139, isso dá cerca de 21,58, bem acima de um peso real de 5.
Qual divisor dimensional devo usar?
O que consta no seu contrato ou na sua tabela de frete. Muitos envios domésticos nos Estados Unidos usam 139 com polegadas e libras, algumas rotas internacionais usam 166 e programas métricos costumam usar 5000 com centímetros e quilos.
Dá para arredondar o peso cobrável para o quilo ou a libra seguinte?
Sim. Ative a opção de arredondamento e o resultado sobe para a próxima unidade inteira depois da comparação entre peso real e dimensional, como fazem muitas tabelas. Sem ela, a precisão completa é mantida.
Por que pago mais do que mostra a balança?
Porque a caixa é grande para o que pesa. As transportadoras cobram o maior valor entre peso real e dimensional, então um pacote leve e volumoso é cobrado pelo tamanho. Quando os dois coincidem, vale o peso real.
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/billable-weight \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"actual_weight":5,"length":20,"width":15,"height":10,"dim_divisor":139}'const res = await fetch("https://api.kit.forhosting.com/ecom/billable-weight", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"actual_weight": 5,
"length": 20,
"width": 15,
"height": 10,
"dim_divisor": 139
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/billable-weight",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"actual_weight": 5,
"length": 20,
"width": 15,
"height": 10,
"dim_divisor": 139
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/billable-weight", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"actual_weight":5,"length":20,"width":15,"height":10,"dim_divisor":139}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"actual_weight":5,"length":20,"width":15,"height":10,"dim_divisor":139}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/billable-weight", 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
{
"actual_weight": 5,
"length": 20,
"width": 15,
"height": 10,
"dim_divisor": 139
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.billable_weight",
"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
O que significa peso cobrável e como se calcula o peso dimensional
Muitas transportadoras arredondam em seguida o peso cobrável para cima até a próxima libra ou quilograma inteiro antes de consultar a tarifa; esta calculadora expõe esse passo como flag opcional round_up para que a automação coincida com o motor de frete que você já usa.
Contrato de entrada, campos de resposta e comportamento de validação
Uma string formula curta reafirma a regra para exibição ao lado do resultado. Exemplo: peso real cinco, dimensões vinte por quinze por dez, divisor cento e trinta e nove produz volume três mil, peso dimensional cerca de vinte e um ponto cinquenta e oito, e peso cobrável pelo lado dimensional. Envie um corpo JSON com cinco números finitos positivos obrigatórios: actual_weight (peso de balança do pacote acabado), length, width e height das dimensões externas em uma única unidade de comprimento coerente, e dim_divisor da regra dimensional da sua transportadora. Opcionalmente envie round_up como booleano; quando omitido o padrão é false e a cifra cobrável mantém precisão total após a comparação de máximos. Cada campo numérico pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias, valores não finitos, zeros e negativos falham com invalid_input nomeando o campo, e essas falhas não são cobradas. Em caso de sucesso o corpo ecoa as entradas, informa volume como length vezes width vezes height, dimensional_weight como volume dividido por dim_divisor, e billable_weight como o máximo de actual_weight e dimensional_weight —com teto opcional quando round_up é true. O campo charged_by é actual ou dimensional para que as interfaces destaquem qual lado venceu sem recomparar floats. Combine a resposta com seus próprios rótulos de unidade; este endpoint não converte polegadas em centímetros nem libras em quilogramas —misturar sistemas com o divisor errado é problema de qualidade de dados fora da matemática pura. Mantenha as requisições pequenas, fixe saídas arredondadas nos testes e reutilize o mesmo módulo no navegador e na API para que prévias gratuitas coincidam com a automação pré-paga.
Onde uma calculadora de peso cobrável entrega valor
Software de WMS e de bancada de embalagem pode chamar a API a cada leitura de cartão para mostrar à equipe se a balança ou a fita métrica vai definir o custo. Como a implementação é parse puro tier 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 a origem de dim_divisor nos runbooks, armazene unidades de comprimento e peso junto a cada SKU ou perfil de caixa, e você obtém peso cobrável reproduzível para estimativas de checkout, auditorias de SLA e workers na borda sem montar um motor de frete completo próprio.
Casos de integração
Checagens de embalagem antes da etiqueta
Leia dimensões do cartão e peso de balança na bancada; mostre peso cobrável e charged_by para a equipe reduzir caixas volumosas antes de comprar etiquetas.
Perguntas técnicas
Como se calcula o peso cobrável?
O peso cobrável (faturável) é max(actual_weight, dimensional_weight), onde dimensional_weight = (length × width × height) / dim_divisor. O round_up opcional arredonda para cima até unidades inteiras.
Qual dim_divisor devo usar?
Use o divisor do contrato ou da tabela da transportadora. Valores comuns: 139 (doméstico EUA in·lb), 166 (algumas rotas internacionais in·lb) e 5000 (cm·kg). Esta ferramenta não escolhe a transportadora por você.
Quando charged_by é dimensional versus actual?
charged_by é dimensional quando o peso dimensional é estritamente maior que o real; caso contrário é actual (inclusive quando os dois valores são iguais).
Quanto custa a calculadora de peso cobrável?
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.