Calcule o peso cubado e o peso faturável do frete
O frete nem sempre é calculado pelo número mostrado na balança. Uma transportadora pode cobrar um pacote grande e leve pelo espaço que ele ocupa, usando o peso cubado.
Executar grátis
Esta calculadora multiplica comprimento, largura e altura, divide o volume pelo fator de cubagem da transportadora e compara o resultado com o peso real. Ela apresenta os dois valores e informa qual deles será faturado, oferecendo a lojistas, equipes de expedição e compradores uma estimativa clara antes da compra da etiqueta.
Informe medidas compatíveis e o fator da transportadora
Comece pelo comprimento, pela largura e pela altura externos do pacote, incluindo saliências, alças e materiais de proteção que aumentem o espaço ocupado no transporte. As três dimensões precisam ser números positivos. Informe o peso real medido depois que a encomenda estiver totalmente embalada, e não apenas a soma dos pesos de catálogo dos produtos antes da inclusão da caixa e do enchimento. Por fim, use o divisor publicado para a transportadora, o serviço, o sistema de unidades e as condições comerciais aplicáveis. A compatibilidade é indispensável: um fator destinado a polegadas cúbicas e libras não pode ser usado com centímetros ou quilogramas. A calculadora não fixa rótulos de unidade, pois o divisor determina essa relação. Valores ausentes, zero, negativos, infinitos ou não numéricos são rejeitados para evitar uma estimativa enganosa. Regras e divisores podem mudar conforme serviço, destino, contrato e data; consulte a tabela vigente antes de usar o resultado em uma cotação para o cliente.
Entenda o peso cubado e o peso faturável
Primeiro, o cálculo encontra o volume do pacote multiplicando comprimento, largura e altura. Em seguida, divide esse volume pelo fator informado para obter o peso cubado. O resultado é comparado com o peso real, e o maior valor se torna o peso faturável. Quando os dois são exatamente iguais, a saída identifica o peso real como base, embora o número cobrado seja o mesmo. Os valores são exibidos com seis casas decimais para manter a automação estável, mas a comparação usa o resultado completo antes do arredondamento de apresentação. A ferramenta não arredonda dimensões nem eleva automaticamente o peso para a próxima faixa de cobrança. Muitas transportadoras arredondam cada medida antes da multiplicação, arredondam o peso final para cima, definem mínimos ou tratam formatos irregulares de modo diferente. Aplique essas regras antes de enviar os dados ou ajuste depois o peso faturável conforme a política publicada. O volume também aparece na saída, facilitando a conferência da fórmula e a identificação de medidas ou unidades incompatíveis.
Use a comparação nas decisões de expedição
A comparação é mais valiosa antes que o pacote chegue à transportadora. Execute o cálculo durante a escolha da caixa para descobrir se o espaço vazio faz um pedido leve ser cobrado pelo volume. Compare embalagens alternativas mantendo o mesmo peso real ou teste serviços disponíveis com o divisor publicado para cada opção. No checkout ou no armazém, registre entradas e resultados junto da estimativa para que a decisão possa ser reproduzida depois. A API custa US$ 0,002 por solicitação e executa uma conta determinística sem consultar a transportadora, sendo adequada tanto para verificações em lote quanto para uma única encomenda. Ela não informa o preço do frete, não escolhe o serviço, não valida contratos e não substitui a tarifação final da transportadora. Adicionais por excesso de tamanho, zona, manuseio, combustível, entrega residencial e outras regras ficam fora do cálculo. Trate o peso faturável como apenas um componente da cotação completa. Se o divisor ou a política de arredondamento mudar, atualize os dados e o fluxo em vez de reutilizar um resultado antigo.
Casos de uso
Escolher uma caixa menor
Compare embalagens antes da expedição e identifique quando o espaço vazio faz o peso cubado superar o peso da balança.
Conferir uma estimativa de frete
Reproduza a base de peso de uma cotação usando as medidas do pacote e o fator publicado para o serviço.
Auditar dados de expedição
Sinalize pedidos cujo peso faturável salvo não corresponda ao maior valor entre o peso cubado calculado e o peso real.
Perguntas frequentes
O que é peso cubado?
É a conversão do espaço ocupado pelo pacote em peso, obtida pela divisão do volume por um fator definido pela transportadora.
Qual peso será faturado?
O maior valor entre o peso cubado e o real é devolvido como faturável. Em caso de igualdade, a saída indica o peso real como base.
Quais unidades devem ser usadas?
Use as unidades de dimensão e peso previstas para o divisor. Todas as entradas devem pertencer ao mesmo sistema compatível.
A calculadora arredonda para uma libra ou um quilograma inteiro?
Não. Ela apresenta o resultado matemático com seis casas decimais. Aplique separadamente as regras publicadas de medida e faixa de cobrança.
O que acontece se uma dimensão for zero ou negativa?
A solicitação falha com erro de entrada inválida. Comprimento, largura e altura precisam ser números finitos positivos.
Quanto custa um cálculo pela API?
Cada solicitação da API custa US$ 0,002. O cálculo não consulta a transportadora e produz um resultado determinístico.
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-dimensional-weight \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}'const res = await fetch("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"length": 20,
"width": 15,
"height": 10,
"divisor": 139,
"actual_weight": 18
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/shipping-dimensional-weight",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"length": 20,
"width": 15,
"height": 10,
"divisor": 139,
"actual_weight": 18
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/shipping-dimensional-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
{
"length": 20,
"width": 15,
"height": 10,
"divisor": 139,
"actual_weight": 18
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.shipping_dimensional_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. |