Übergroßen-Paketzuschlag

Wie Übergroßen- und Übergewichtsflaggen zur Versandsumme werden

Nachdem Sie length, width und height senden, richtet dieser Rechner die längste Seite als Länge aus, damit ein langes Brett nicht als Breite getarnt bleibt. Das Paket wird als übergroß gekennzeichnet, wenn die längste Seite length_limit überschreitet oder wenn Länge plus Umfang girth_limit überschreitet. Es wird als übergewichtig gekennzeichnet, wenn weight weight_limit überschreitet. Beide Flaggen können am selben Karton zünden, und die beiden Gebühren stapeln sich: total_shipping entspricht base_rate plus oversize_fee bei Übergröße plus overweight_fee bei Übergewicht. Geldfelder werden half-up auf zwei Nachkommastellen gerundet, damit Rechnungen und API-Clients auf demselben Cent bleiben.

Eingabevertrag, Antwortform und Validierungsverhalten

Ungültige Anfragen werden nicht abgerechnet. Kombinieren Sie diesen Endpunkt mit Ihrem eigenen Zonentarif- oder Volumengewichtsschritt, wenn Sie die Basis noch ableiten müssen; dieser Rechner wendet die Größen- und Gewichtsgebühren erst an, wenn die Basis bekannt ist. Senden Sie per POST einen JSON-Body mit sieben erforderlichen endlichen Zahlen: length, width und height als positive Seiten in der gewählten Längeneinheit; weight als nichtnegatives fakturiertes Gewicht; base_rate als den Versandbetrag vor diesen Zuschlägen; oversize_fee als das Geld, das bei Übergröße addiert wird; und overweight_fee als das Geld, das bei Übergewicht addiert wird. Das optionale Feld unit_system ist das Enum imperial oder metric und steht standardmäßig auf imperial. Die optionalen length_limit, girth_limit und weight_limit überschreiben die Vorgaben dieses Systems. Jedes Zahlenfeld kann als JSON-Zahl oder numerische Zeichenkette ankommen; leere Zeichenketten, fehlende Pflichtfelder, nicht endliche Werte, nicht positive Seiten sowie negatives Geld oder Gewicht scheitern mit invalid_input und benennen das Feld. Aliase gibt es für die üblichen Kurznamen (l, w, h, depth, wt, shipping_rate, oversize_surcharge, weight_fee, units). Bei Erfolg enthält der Body unit_system, longest_side, girth, length_plus_girth, weight, die drei tatsächlich verwendeten Grenzen, die Booleans is_oversize und is_overweight, die Aufteilung oversize_fee_applied und overweight_fee_applied, surcharge_amount, den zurückgegebenen base_rate, total_shipping, ein triggers-Array der Zeichenketten oversize und overweight in dieser Reihenfolge sowie eine formula-Zeichenkette, die die Identität wiederholt. Beispiel: length fünfzig, width zwanzig, height fünfzehn, weight zwanzig, base_rate achtzehn Punkt fünf, oversize_fee fünfundzwanzig, overweight_fee vierzig im imperialen System ergeben longest_side fünfzig, girth siebzig, length_plus_girth einhundertzwanzig, is_oversize true weil fünfzig achtundvierzig überschreitet, is_overweight false, surcharge_amount fünfundzwanzig und total_shipping dreiundvierzig Punkt fünf.

Wo ein Übergroßen-Paketzuschlag-Rechner seinen Nutzen bringt

Tabellenersatz und Low-Code-Automatisierungen rufen die API auf, damit die Finanzabteilung historische Sendungen neu bepreisen kann, wenn eine strittige Zeile den Größenschnitt der Vorsaison verwendete. Weil die Implementierung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz.