ATM Cassette Replenishment Plan Calculator

Plan actual per-denomination ATM replenishment constrained by cassette capacity against caller note-demand/reserve forecast, preserving unfunded requirement and signed post-demand shortage; no demand prediction, cash transport authorization or denomination substitution.

Description

ATM replenishment is constrained per cassette denomination.

ATM replenishment is constrained per cassette denomination. A capacity shortage leaves unfunded reserve or demand and can produce negative post-demand note counts.^[1]

The returned values include Planned refill note counts, Modeled post demand note counts, Unfunded reserve or demand note counts, Total refill cash minor. The How section below explains the calculation, input rules and interpretation.

When to use ATM Cassette Replenishment Plan Calculator

Use ATM Cassette Replenishment Plan Calculator when you need to evaluate the supplied records under the calculation and evidence rules below. No demand prediction, transport authorization or cash availability guarantee is supplied.

Prepare observed financial records and verified caller terms. Use one currency for integer minor-unit money and preserve leading zeros in identifier text. One basis point is 0.01 percentage points. Resolve dates, local clocks, counting rules and evidence flags as specified.

How to use ATM Cassette Replenishment Plan Calculator and understand its results

Prepare observed financial records and verified caller terms. Use one currency for integer minor-unit money and preserve leading zeros in identifier text. One basis point is 0.01 percentage points. Resolve dates, local clocks, counting rules and evidence flags as specified.
Enter cassetteDenominationMinor, observedCurrentNoteCounts, forecastDispensedNoteCounts, callerReserveNoteCounts, cassetteNoteCapacities using the field table and calculation rules, then run the tool.
Read plannedRefillNoteCounts, modeledPostDemandNoteCounts, unfundedReserveOrDemandNoteCounts, totalRefillCashMinor. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
cassetteDenominationMinor	Cassette denomination minor	list of number	Required
observedCurrentNoteCounts	Observed current note counts	list of number	Required
forecastDispensedNoteCounts	Forecast dispensed note counts	list of number	Required
callerReserveNoteCounts	Caller reserve note counts	list of number	Required
cassetteNoteCapacities	Cassette note capacities	list of number	Required

Enter aligned nonempty positive safe-integer denominations, integer capacities 1–1000000, current notes 0–capacity and forecast/reserve counts 0–1000000. Return refill notes, signed post-demand notes, unfunded counts and safe-integer refill cash. No denomination substitution occurs.

required=max(0,forecast+reserve−current); refill=min(required,capacity−current); post=current+refill−forecast

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
plannedRefillNoteCounts	Planned refill note counts	list of number
modeledPostDemandNoteCounts	Modeled post demand note counts	list of number
unfundedReserveOrDemandNoteCounts	Unfunded reserve or demand note counts	list of number
totalRefillCashMinor	Total refill cash minor	number

json

{
  "input": {
    "cassetteDenominationMinor": [
      100,
      500
    ],
    "observedCurrentNoteCounts": [
      10,
      20
    ],
    "forecastDispensedNoteCounts": [
      12,
      10
    ],
    "callerReserveNoteCounts": [
      3,
      5
    ],
    "cassetteNoteCapacities": [
      100,
      100
    ]
  },
  "output": {
    "plannedRefillNoteCounts": [
      5,
      0
    ],
    "modeledPostDemandNoteCounts": [
      3,
      10
    ],
    "unfundedReserveOrDemandNoteCounts": [
      0,
      0
    ],
    "totalRefillCashMinor": 500
  }
}

Limitations and assumptions

No demand prediction, transport authorization or cash availability guarantee is supplied.

Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Teller Drawer Variance Limit Checker: Drawer over/short compares counted denomination inventory with expected cash from the opening balance and ledger. A signed deficit differs from a tolerance flag. For a complementary task, use ATM Surcharge Breakeven Transactions Calculator: ATM break-even count divides cycle fixed cost by already net transaction contribution. Whole transactions require ceiling division.

References

ATM Cassette Replenishment Plan Calculator — tool.io

Similar or alternative tools

Teller Drawer Variance Limit Checker
Drawer over/short compares counted denomination inventory with expected cash from the opening balance and ledger. A signed deficit differs from a tolerance flag.
ATM Surcharge Breakeven Transactions Calculator
ATM break-even count divides cycle fixed cost by already net transaction contribution. Whole transactions require ceiling division.