Classe de fret par densité

Le volume doit être strictement positif : un volume nul ou négatif ne définit pas de densité et échoue avec invalid_input au lieu d'inventer une classe.

Comment la densité devient une classe de fret NMFC

Mesurez toujours le cube à partir des dimensions extérieures d'expédition du carton, de la caisse ou de l'enveloppe de palette réellement remise au transporteur, et non du seul produit, afin que la densité renvoyée par l'API corresponde à ce que les opérations revendiqueront.

Contrat d'entrée, champs de réponse et règles d'erreur

Le point de terminaison ne consulte pas les numéros d'article NMFC, les codes hazmat ni les exceptions transporteur : il mappe uniquement la densité vers la bande de référence. Associez-le à votre propre calculateur d'emballage pour obtenir le volume comme longueur fois largeur fois hauteur lorsque vous partez de dimensions plutôt que du cube. Envoyez en POST un corps JSON avec deux nombres finis obligatoires : weight_lb, le poids total de l'envoi en livres (non négatif), et volume_cu_ft, le volume cubique total en pieds cubes (doit être strictement positif). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; des alias tels que weight, pounds, volume, cubic_feet et cu_ft sont acceptés pour que les entrepôts et les systèmes e-commerce mappent des noms existants sans renommer les pipelines. Champs manquants, valeurs non finies, poids négatif et volume non positif échouent avec invalid_input en nommant le problème ; ces échecs ne sont pas facturés. En succès le corps renvoie weight_lb et volume_cu_ft, density_pcf arrondie pour une automatisation stable, freight_class comme classe numérique (par exemple 70 ou 92.5), density_min_pcf pour le bord inférieur de la bande, density_max_pcf optionnel lorsque la bande a un plafond fini (omis pour la bande ouverte de classe 50 à partir de trente PCF), une chaîne lisible density_band et method égal à nmfc_density_freight_class. Les clés de sortie optionnelles sont omises plutôt que mises à null pour simplifier les clients web et SDK.

Où une API de classe de fret par densité apporte de la valeur

Les opérations e-commerce et 3PL utilisent un calculateur de classe de fret à partir de la densité pour noter les choix de cartonisation avant de réserver du LTL : réduire le vide ou consolider des SKU peut franchir le bord d'une bande et baisser la classe assez pour changer le coût final. Les vendeurs de places de marché qui expédient des marchandises surdimensionnées ou légères ont besoin d'un contrôle rapide du PCF pour que les estimations de fret de l'annonce ne sous-cotent pas un fret de classe 150 et plus comme s'il s'agissait d'une classe 70 dense. Les moteurs de tarifs et plugins TMS appellent une petite API de parse plutôt que d'embarquer une feuille de calcul fragile de la table de densités, en gardant l'automatisation déterministe entre régions et langues. Les achats et l'ingénierie d'emballage comparent des matériaux alternatifs en fixant le poids et en variant le cube, ou l'inverse, et lisent freight_class comme contrainte latérale à côté du coût produit. Comme l'implémentation est parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Conservez le poids et le volume en livres et pieds cubes pour ce point de terminaison, convertissez les sources métriques une fois en bordure si besoin, figez density_pcf et freight_class dans les tests, et vous obtenez des recherches de bande NMFC reproductibles pour cotiser, former et améliorer en continu sans monter une intégration complète de bureau de classification.