Permit Fee Cap Margin Tool

Description

Apply an explicit fee formula and cap, without selecting a jurisdiction or schedule.

An administrative calculation applies supplied clocks, fees, exclusions, roles, and document conditions. Numeric consistency and an explicit condition match can be useful record checks. They do not select the governing authority, verify evidence, or establish legal rights and obligations.

Apply an explicit fee formula and cap, without selecting a jurisdiction or schedule.

When to use this tool

Use Permit Fee Cap Margin when you need a supplied administrative fee, clock, role, document, or accounting calculation before checking its substantive basis.

How to use the tool and how it works

Enter baseFee, perUnitFee, quantity, suppliedCap. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read uncappedFee, appliedFee, capMargin. Use the output convention below.

Calculate uncappedFee=baseFee+perUnitFee*quantity, appliedFee=min(uncappedFee,suppliedCap), and capMargin=suppliedCap-uncappedFee. Require nonnegative inputs.^[1]

Input field	Meaning and units	Accepted input
baseFee	Base Fee	Required. Finite number; minimum 0.
perUnitFee	Per Unit Fee	Required. Finite number; minimum 0.
quantity	Quantity	Required. Finite number; minimum 0.
suppliedCap	Supplied Cap	Required. Finite number; minimum 0.

Output field	Interpretation	Returned shape
uncappedFee	Uncapped Fee	Required. Finite number.
appliedFee	Applied Fee	Required. Finite number.
capMargin	Supplied cap minus uncapped fee; negative above cap.	Required. Finite number.

json

{
  "input": {
    "baseFee": 10,
    "perUnitFee": 2,
    "quantity": 5,
    "suppliedCap": 15
  },
  "output": {
    "uncappedFee": 20,
    "appliedFee": 15,
    "capMargin": -5
  }
}

Limitations and assumptions

The cap and rates are supplied. Quantity can be fractional and a negative margin reports the amount above the cap, without determining official fees, exemptions, entitlement, or currency rounding.
The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.

Alternative or Complementary methods

Consult the applicable authoritative rule and verify source records before deciding fees, authority, deadlines, or obligations. Keep a supplied scenario calculation separate from that evidence review.

References

Calculation and input contract: public-administration/permit-fee-cap-margin — tool.io

Similar or alternative tools

Permit Fee Area Tier One Band
One marginal fee band with explicit boundaries and rate; no permit schedule is selected.
Permit Clock Pause Overlap Term
Supplied pause-union clock accounting, without selecting permit law.