Petty Cash Funds
Create and maintain petty cash funds (imprest floats), and correct a fund's balance when someone mis-entered a top-up.
What this is for
A petty cash fund is a small float of cash that one person (the custodian) keeps to pay minor costs. Winlium follows the imprest method. In plain words: the fund has a fixed ceiling (the Imprest Amount). When money is spent, the fund goes down. Finance then tops it back up, but never above that ceiling.
Each fund has:
- one custodian, who is accountable for the float;
- a Control Account in the ledger that represents the float itself;
- an optional Funding Bank Account that top-ups are paid from;
- a Current Balance, which starts at ₦0.00.
Petty Cash claims draw the balance down when they are approved. Finance fills the fund with Replenish Petty Cash (see Replenish petty cash). A top-up can never take the balance above the Imprest Amount.
Before you begin
Before you begin
- Chart of Accounts: at least one account of type Cash and Cash Equivalents for the float, and one for the bank (set up in Accounting > Chart of Accounts) Both the Control Account and the Funding Bank Account must be of this type.
- An active user to be the custodian Add users under Administration. The list shows active users only.
- Optional: a branch Branches come from Administration.
- Expense Settings saved
- An open financial year and period before you correct a balance
Open the screen
In the menu choose Expense, then Configuration, then Petty Cash Funds. The browser address is /dashboard/expense/operation/petty-cash-fund.
Screenshot pending
Petty Cash Funds list with one fund, its imprest amount, a red zero balance and the New Fund button
- 1Select New Fund to create a fund.
- 2A balance of 0.00 or less shows in red.
- 3Open the three-dots menu for row actions.
The list
| Column | What it shows |
|---|---|
| Code | The fund code in a grey chip, or a dash. |
| Name | The fund name. |
| Branch | The branch saved with the fund, or a dash. |
| Custodian | The custodian's name (or email), or a dash. |
| Imprest Amount | The ceiling, with two decimals and no currency symbol, for example 500,000.00. |
| Current Balance | The balance, with two decimals and no currency symbol. Shown in red bold when it is 0 or below. |
| Status | Active or Inactive. |
| Action | A three-dots menu. |
The search box reads "Search Code, Name..." and searches those two fields. Double-click a row to edit the fund. The table also has Export, Add columns and Reset all. An empty list shows "No results."
Row actions
Open the three-dots menu on a row.
| Action | What it does |
|---|---|
| Edit fund | Opens the fund so you can change it. |
| Deactivate fund or Activate fund | Changes the status at once, with no confirmation. Toasts: "Deactivating {name}...", then "{name} deactivated" (or "Activating {name}...", "{name} activated"). |
| Adjust balance | Opens the Correct Petty Cash Fund Balance dialog (see below). |
| Delete fund | Asks "Are you sure you want to delete this petty cash fund? This action cannot be undone." with Delete and Cancel. |
An Inactive fund cannot be used on a claim: Winlium refuses with Petty cash fund "{name}" is inactive. The menu still offers Adjust balance on an inactive fund, but the server then refuses the correction with the same message, so activate the fund first.
What Delete really does
Winlium deletes a fund only when it has never had any movement and its balance is 0. If the fund has any history, or a balance above 0, Winlium only makes it Inactive. The server message is "Fund has transaction history or a non-zero balance and has been deactivated instead of deleted". The toast on screen still reads "Deleted fund: {name}". Check the Status column to see what happened.
Create or edit
Open the form
On Petty Cash Funds select New Fund. The page is titled Create Petty Cash Fund. To edit, choose Edit fund (or double-click the row). The page is titled Editing Petty Cash Fund.Fill in Fund Details
Complete Fund Name, Custodian, Control Account and Imprest Amount. Fill the optional fields you need.Set the options
Switch Allow Negative Balance on only if claims may be paid when the fund is empty.Save
Select the Save icon (it reads Update when you edit). Winlium returns to the list.
Screenshot pending
Create Petty Cash Fund form with the Fund Details and Options sections filled in
- 1Custodian is the person accountable for the float.
- 2Control Account must be a Cash and Cash Equivalents account.
- 3Imprest Amount is the ceiling for top-ups.
A new fund always starts Active with a balance of ₦0.00. The success message on create is "Petty cash fund created — it starts at a zero balance. Use Replenish to fund it up to its imprest amount." On edit it is "Petty cash fund updated successfully!". The edit page also shows the Activity Log.
Field reference
| Field | Type | Required | Details |
|---|---|---|---|
| Fund Name | Text | Yes | Example: Head Office Petty Cash, Warehouse Float. Names are not checked for duplicates. Error if empty: "Fund name is required". |
| Code | Text | No | A short reference of your own. Not checked for duplicates. |
| Branch | Dropdown (searchable) | No | Lists the branches of your company. Winlium saves the branch name with the fund. |
| Custodian | Dropdown (searchable) | Yes | The employee who holds and is accountable for this float. Lists active users only. If there are none you see "No active users available". Error if empty: "Custodian is required". |
| Control Account | Dropdown (searchable) | Yes | The ledger account that represents the float itself. Lists active Cash and Cash Equivalents accounts as code and name. If the list is empty you see "No Cash & Cash Equivalents accounts available. Configure Chart of Accounts first." Error if empty: "Control account is required". The server refuses an account that is not Cash and Cash Equivalents. |
| Funding Bank Account | Dropdown (searchable) | No | The bank account that top-up money comes from. It is the default bank account in the balance correction dialog. The server refuses an account that is not Cash and Cash Equivalents. |
| Imprest Amount | Number (naira) | Yes | The fixed ceiling the fund is topped up to. You can lower it below the current balance on edit; Winlium does not warn you. Default: 0.00 Error if 0 or less: "Imprest amount must be greater than 0". |
| Notes | Text area | No | Free text about the fund. |
| Allow Negative Balance | Yes/No switch | No | Lets claims post even if the fund would go below zero. Default: Off |
| Current Balance | Read-only number (edit only) | No | Locked. It changes only through claims, replenishment and the balance correction dialog, never by typing here. |
| Status | Dropdown (edit only) | Yes | Not shown on a new fund. ActiveInactive Default: Active |
Correct a fund's balance
Use this only to fix a genuine mistake, for example a top-up typed with too many zeros. It does not change the fund's ceiling. It posts a correcting entry to the ledger through a bank account you choose.
Open the dialog
In the row menu choose Adjust balance. The dialog is titled Correct Petty Cash Fund Balance. It shows the current balance and the imprest ceiling.Enter the right balance
In Correct Balance Should Be type what the balance should be. A hint under the box says whether the balance increases or decreases, and by how much.Choose the bank account
In Bank Account pick the cash or bank account the correction is posted through. It starts as the fund's Funding Bank Account, if one is set.Give a reason
In Reason explain the mistake. It goes on the audit trail and into the ledger description.Confirm
Select Confirm Correction. The button reads "Correcting..." while it saves.
Screenshot pending
Correct Petty Cash Fund Balance dialog with the new balance, bank account and reason filled in
- 1Type the balance the fund should have.
- 2Choose the bank account the correction posts through.
- 3Confirm Correction posts the entry.
Confirm Correction stays disabled until all of these are true:
- a bank account is chosen;
- a balance is entered;
- the new balance is different from the current balance;
- the reason is not blank.
| Field | Type | Required | Notes |
|---|---|---|---|
| Correct Balance Should Be | Number, 0 or more | Yes | Starts at the current balance. |
| Bank Account | Dropdown | Yes | Cash and bank accounts, shown as code and name. If none exist you see "No cash/bank accounts found". |
| Reason | Text area | Yes | Example hint: "e.g. Replenished ₦100,000,000 by mistake instead of ₦492,000". |
Messages you may see:
- "Select the bank account this correction is posted through"
- "Enter what the balance should actually be"
- "That is already the current balance — nothing to correct"
- "Enter a reason for this correction — it goes on the audit trail"
- From the server: "The corrected balance cannot be negative for a fund that does not allow a negative balance"
- From the server: "The corrected balance (₦{n}) cannot exceed the fund's imprest amount (₦{n})"
- From the server: Petty cash fund "{name}" is inactive
- On success: "Fund balance corrected to ₦{n}"
Ledger impact
Ledger impact: Correct Petty Cash Fund Balance (Confirm Correction)
Single stage, posted at once| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Fund Control Account | Petty Cash Funds > Control Account | The difference, when the balance goes UP |
| Cr | Chosen bank account | Bank Account chosen in the dialog | The difference, when the balance goes UP |
| Dr | Chosen bank account | Bank Account chosen in the dialog | The difference, when the balance goes DOWN |
| Cr | Fund Control Account | Petty Cash Funds > Control Account | The difference, when the balance goes DOWN |
Read it as two legs, not four. If the balance goes up you post the first two lines. If it goes down you post the last two. The amount is the difference between the old and new balance. The entry is dated today, so an open financial period must exist for today; otherwise Winlium stops with No active financial period found for date: {date}, or Financial period for date {date} is blocked for transactions. See Financial years and periods. Creating, editing, activating and deleting a fund do not post anything.
Who can do this
Page access needs expense:petty-cash-funds:read. To create you need expense:petty-cash-funds:create, to edit expense:petty-cash-funds:update, to delete expense:petty-cash-funds:delete, and for Adjust balance a separate expense:petty-cash-funds-adjust-balance:create. The pickers also need read access to Chart of Accounts, branches and users. Today only the Owner standard role holds these, so give other people a custom role. See Roles and permissions.
What this affects in other modules
- Petty Cash claims choose one of these funds and draw its balance down on approval. A fund with too little balance blocks the approval.
- Replenish petty cash tops the fund up to the Imprest Amount.
- The ledger shows the fund through its Control Account in Accounting.