ForHosting KIT · Ferramentas para dev

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.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/ecom/shipping-dimensional-weight

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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}'
{
  "length": 20,
  "width": 15,
  "height": 10,
  "divisor": 139,
  "actual_weight": 18
}
{
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →