Surface Mail Weight Step Rate Table Lookup
Look up postal surface rate at first inclusive weight-step upper bound from actual caller historical service table. Caller independently verifies observations, reference edition, units and applicability; not a grading-service certificate, authentication, conservation treatment, actual market price or legal/insurance entitlement.
Description
Postal surface rates can increase at weight-step boundaries that depend on a particular period and service.
Postal surface rates can increase at weight-step boundaries that depend on a particular period and service.1
This lookup uses a supplied step table with inclusive upper limits, rather than a built-in tariff.
When to use Surface Mail Weight Step Rate Table Lookup
Use this tool when you need to summarize the supplied collecting records or matched observations. Prepare independently verified observations, reference edition/context, and matching units or currency basis.
How to use Surface Mail Weight Step Rate Table Lookup and understand its results
- Prepare independently verified observations, reference edition/context, and matching units or currency basis.
- Enter observedWeightGrams, callerInclusiveStepUpperGrams, callerStepRatesMinor, following the field table and calculation rules below, then run the tool.
- Read callerPostageMinor, matchedStepIndex. For result objects, inspect the nested output fields below, including any missing evidence or selected indices.
- Correct any input issues and run again. Before using a successful result, review its units, signs, evidence coverage, and stated model or reference assumptions.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| observedWeightGrams | Observed weight grams | number | Required |
| callerInclusiveStepUpperGrams | Caller inclusive step upper grams | list of number | Required |
| callerStepRatesMinor | Caller step rates minor; integer minor units in the explicit currency basis. | list of number | Required |
Require nonnegative weight, nonempty strictly increasing positive step upper limits, and aligned nonnegative safe-integer rate amounts. Select the first upper limit at least the weight and return its index and rate; a weight above the final limit fails. Zero weight selects the first step.
stepIndex=min{i:weight≤upper_i}; rate=rates[stepIndex] Read these symbols with the field meanings and branch or reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| callerPostageMinor | Caller postage minor; integer minor units in the explicit currency basis. | number |
| matchedStepIndex | Matched step index | number |
Where monetary amounts are used, keep one explicit currency and minor-unit basis; one basis point is 0.01 percent. Monetary integers and exact products must remain in JavaScript’s safe-integer range. Rational rounding uses nearest minor unit with half ties away from zero, rather than binary floating-point rounding. An input called a reference amount does not fetch or establish an actual price.
{
"input": {
"observedWeightGrams": 20,
"callerInclusiveStepUpperGrams": [
20,
50
],
"callerStepRatesMinor": [
100,
150
]
},
"output": {
"callerPostageMinor": 100,
"matchedStepIndex": 0
}
}Limitations and assumptions
Observations, reference edition, and applicability are independently supplied. Arithmetic and reference summaries do not provide authentication, a certified grade, or an actual market price.
Missing required fields, unknown fields, wrong types, and violated calculation rules return input issues. Numeric values must be finite; nonfinite numeric outputs are rejected. Arrays must be dense, with no missing cells. Numeric lists allow at most 10000 entries, subject to smaller tool-specific bounds above.
Alternative or Complementary methods
For a related task, use Rate Period Date Bracket Finder for Postal History: A historical rate period defines the dates when a particular postal reference applies. This finder checks explicit supplied start and end dates and preserves overlapping matching records instead of choosing one silently. For a complementary step, use Airmail Uprate Surcharge per Gram Historical Lookup: An airmail surcharge can be assessed per started weight step under a supplied tariff convention. This lookup-style calculator multiplies a provided per-step amount by the rounded-up step count without retrieving a postal rate.
References
Similar or alternative tools
- Rate Period Date Bracket Finder for Postal History
A historical rate period defines the dates when a particular postal reference applies. This finder checks explicit supplied start and end dates and preserves overlapping matching records instead of choosing one silently.
- Airmail Uprate Surcharge per Gram Historical Lookup
An airmail surcharge can be assessed per started weight step under a supplied tariff convention. This lookup-style calculator multiplies a provided per-step amount by the rounded-up step count without retrieving a postal rate.