Surcharge colis hors gabarit

Comment les indicateurs hors gabarit et surpoids deviennent un total d'expédition

Après l'envoi de length, width et height, ce calculateur oriente le plus grand côté comme longueur afin qu'une planche longue ne se dissimule pas sous l'étiquette largeur. Le colis est signalé hors gabarit lorsque le plus grand côté dépasse length_limit ou lorsque longueur plus tour dépasse girth_limit. Il est signalé en surpoids lorsque weight dépasse weight_limit. Les deux indicateurs peuvent se déclencher sur le même carton, et les deux frais se cumulent : total_shipping égale base_rate plus oversize_fee si hors gabarit plus overweight_fee si surpoids. Les champs monétaires sont arrondis half-up à deux décimales afin que factures et clients API restent alignés au même centime.

Contrat d'entrée, forme de la réponse et validation

Les requêtes invalides ne sont pas facturées. Associez ce point d'accès à votre propre étape de tarif par zone ou de poids dimensionnel si vous devez encore dériver la base ; ce calculateur n'applique les frais de taille et de poids qu'une fois la base connue. Envoyez un corps JSON en POST avec sept nombres finis obligatoires : length, width et height comme côtés positifs dans l'unité de longueur choisie ; weight comme poids facturé non négatif ; base_rate comme le montant d'expédition avant ces surcharges ; oversize_fee comme l'argent ajouté lorsque le carton est hors gabarit ; et overweight_fee comme l'argent ajouté en cas de surpoids. Le champ facultatif unit_system est l'enum imperial ou metric et vaut imperial par défaut. Les facultatifs length_limit, girth_limit et weight_limit remplacent les valeurs par défaut de ce système. Chaque champ numérique peut arriver comme nombre JSON ou comme chaîne numérique ; chaînes vides, champs obligatoires manquants, valeurs non finies, côtés non positifs et argent ou poids négatifs échouent avec invalid_input en nommant le champ. Des alias existent pour les surnoms courants (l, w, h, depth, wt, shipping_rate, oversize_surcharge, weight_fee, units). En cas de succès le corps inclut unit_system, longest_side, girth, length_plus_girth, weight, les trois seuils réellement utilisés, les booléens is_oversize et is_overweight, le détail oversize_fee_applied et overweight_fee_applied, surcharge_amount, le base_rate renvoyé, total_shipping, un tableau triggers des chaînes oversize et overweight dans cet ordre, et une chaîne formula qui rappelle l'identité. Exemple : length cinquante, width vingt, height quinze, weight vingt, base_rate dix-huit point cinq, oversize_fee vingt-cinq, overweight_fee quarante en impérial donnent longest_side cinquante, girth soixante-dix, length_plus_girth cent vingt, is_oversize true car cinquante dépasse quarante-huit, is_overweight false, surcharge_amount vingt-cinq et total_shipping quarante-trois point cinq.

Où un calculateur de surcharge colis hors gabarit trouve son utilité

Les remplacements de tableur et les automatisations low-code appellent l'API pour que la finance reprice des expéditions historiques lors de l'audit d'une ligne contestée qui utilisait la coupure de taille de la saison précédente. Parce que l'implémentation est parse pur 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.