Skip to content

Main content

Food Voucher Redemption Balance

Reconcile explicit voucher issue, redemption, and outward transfer values in the same currency.

Loading tool…

Description

Calculate remaining voucher value after redemption and outward transfer.

Food-assistance records track sources, quantities, vouchers, transfers and purchasing units. Nominal person-rations and whole-pack costs depend on supplied assumptions; they do not determine nutritional adequacy or legal entitlements. Returned quantities also do not establish that food can safely be redistributed.

Calculate remaining voucher value after redemption and outward transfer.

When to use this tool

Use Food Voucher Redemption Balance when checking the stated supplied assistance inventory, quantity or cost convention.

How to use the tool and how it works

  1. Enter issuedValue, redeemedValue, transferredOutValue. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read remainingValue. Use the output convention below.

Require nonnegative issued, redeemed and transferred-out values. Return issued-redeemed-transferred as remainingValue without clamping.1

Input fieldMeaning and unitsAccepted input
issuedValueIssued ValueRequired. Finite number; minimum 0.
redeemedValueRedeemed ValueRequired. Finite number; minimum 0.
transferredOutValueTransferred Out ValueRequired. Finite number; minimum 0.
Output fieldInterpretationReturned shape
remainingValueRemaining ValueRequired. Finite number.
json
{
  "input": {
    "issuedValue": 100,
    "redeemedValue": 35,
    "transferredOutValue": 20
  },
  "output": {
    "remainingValue": 45
  }
}

Limitations and assumptions

  • Negative balances are retained; no voucher validity, transfer authorization or actual benefit entitlement is verified.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • 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. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Use verified inventory and program records with qualified nutrition, food-safety and humanitarian professionals for actual dietary, distribution or benefit decisions.

References

  1. Calculation and input contract: food-security/food-voucher-redemption-balance — tool.io

Similar or alternative tools