Uprated Cover Short-Paid Fee Deficiency Calculator
Audit actual uprated postage shortfall and independently verified deficiency fee rule; excess postage retained signed. 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
Shortpaid mail carries less postage than the required amount, while an uprated item can already cover or exceed it.
Shortpaid mail carries less postage than the required amount, while an uprated item can already cover or exceed it.1
This calculator applies a supplied deficiency multiplier and fixed fee only when the signed postage shortfall is positive.
When to use Uprated Cover Short-Paid Fee Deficiency Calculator
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 Uprated Cover Short-Paid Fee Deficiency Calculator and understand its results
- Prepare independently verified observations, reference edition/context, and matching units or currency basis.
- Enter callerRequiredPostageMinor, observedUpratedPostageMinor, callerDeficiencyMultiplierNumerator, callerDeficiencyMultiplierDenominator, callerFixedDeficiencyFeeMinor, following the field table and calculation rules below, then run the tool.
- Read signedPostageShortfallMinor, callerAssessedDeficiencyMinor. 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 |
|---|---|---|---|
| callerRequiredPostageMinor | Caller required postage minor; integer minor units in the explicit currency basis. | number | Required |
| observedUpratedPostageMinor | Observed uprated postage minor; integer minor units in the explicit currency basis. | number | Required |
| callerDeficiencyMultiplierNumerator | Caller deficiency multiplier numerator | number | Required |
| callerDeficiencyMultiplierDenominator | Caller deficiency multiplier denominator | number | Required |
| callerFixedDeficiencyFeeMinor | Caller fixed deficiency fee minor; integer minor units in the explicit currency basis. | number | Required |
Use one currency’s nonnegative safe-integer minor units for required postage, observed uprating, and fixed fee, plus positive safe-integer multiplier numerator and denominator. Compute required minus uprated. For a positive shortfall, round its multiplied rational value to minor units and add the fixed fee; for zero or negative shortfall, return zero assessed deficiency. Exact integer arithmetic checks representability.
shortfall=required−uprated; deficiency=shortfall>0?roundMinor(shortfall×num/den)+fee:0 Read these symbols with the field meanings and branch or reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| signedPostageShortfallMinor | Signed postage shortfall minor; integer minor units in the explicit currency basis. | number |
| callerAssessedDeficiencyMinor | Caller assessed deficiency minor; integer minor units in the explicit currency basis. | 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": {
"callerRequiredPostageMinor": 120,
"observedUpratedPostageMinor": 100,
"callerDeficiencyMultiplierNumerator": 2,
"callerDeficiencyMultiplierDenominator": 1,
"callerFixedDeficiencyFeeMinor": 10
},
"output": {
"signedPostageShortfallMinor": 20,
"callerAssessedDeficiencyMinor": 50
}
}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.
Alternative or Complementary methods
For a related task, use Surface Mail Weight Step Rate Table Lookup: Postal surface rates can increase at weight-step boundaries that depend on a particular period and service. This lookup uses a supplied step table with inclusive upper limits, rather than a built-in tariff. 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
- Surface Mail Weight Step Rate Table Lookup
Postal surface rates can increase at weight-step boundaries that depend on a particular period and service. This lookup uses a supplied step table with inclusive upper limits, rather than a built-in tariff.
- 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.