Classe de frete por densidade

O volume deve ser estritamente positivo: volume zero ou negativo não define densidade e falha com invalid_input em vez de inventar uma classe.

Como a densidade se torna uma classe de frete NMFC

Meça sempre o cubo a partir das dimensões externas de envio da caixa, caixote ou envelope de palete realmente entregue à transportadora, não só do produto, para que a densidade retornada pela API coincida com o que as operações vão reivindicar.

Contrato de entrada, campos de resposta e regras de erro

Combine-o com sua própria calculadora de embalagem para obter volume como comprimento vezes largura vezes altura quando partir de dimensões em vez de cubo. Envie por POST um corpo JSON com dois números finitos obrigatórios: weight_lb, o peso total do envio em libras (não negativo), e volume_cu_ft, o volume cúbico total em pés cúbicos (deve ser maior que zero). Cada campo pode chegar como número JSON ou como string numérica; aliases como weight, pounds, volume, cubic_feet e cu_ft são aceitos para que armazéns e sistemas de e-commerce mapeiem nomes existentes sem renomear pipelines. Campos ausentes, valores não finitos, peso negativo e volume não positivo falham com invalid_input indicando o problema; essas falhas não são cobradas. Em sucesso o corpo devolve weight_lb e volume_cu_ft, density_pcf arredondada para automação estável, freight_class como classe numérica (por exemplo 70 ou 92.5), density_min_pcf para a borda inferior da faixa, density_max_pcf opcional quando a faixa tem teto finito (omitido na faixa aberta da classe 50 a partir de trinta PCF), uma string legível density_band e method igual a nmfc_density_freight_class. Chaves de saída opcionais são omitidas em vez de null para simplificar clientes web e SDK. O endpoint não consulta números de item NMFC, códigos hazmat nem exceções da transportadora: apenas mapeia densidade para a faixa de referência.

Onde uma API de classe de frete por densidade agrega valor

Operações de e-commerce e 3PL usam uma calculadora de classe de frete a partir da densidade para pontuar opções de cartonização antes de reservar LTL: reduzir o preenchimento vazio ou consolidar SKUs pode cruzar a borda de uma faixa e baixar a classe o bastante para mudar o custo final. Vendedores de marketplaces que enviam mercadoria superdimensionada ou leve precisam de uma verificação rápida de PCF para que as estimativas de frete do anúncio não subcotem frete de classe 150 ou superior como se fosse classe 70 densa. Motores de tarifa e plugins TMS chamam uma API de parse pequena em vez de embutir uma planilha frágil da tabela de densidades, mantendo a automação determinística entre regiões e idiomas. Compras e engenharia de embalagem comparam materiais alternativos fixando o peso e variando o cubo, ou o inverso, e leem freight_class como restrição lateral junto ao custo do produto. Como a implementação é parse 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. Mantenha peso e volume em libras e pés cúbicos neste endpoint, converta fontes métricas uma vez na borda se necessário, fixe density_pcf e freight_class nos testes e obtenha buscas reproduzíveis de faixa NMFC para cotar, treinar e melhorar de forma contínua sem montar uma integração completa de bureau de classificação.