New Expense
Create, edit, submit, recall and track an expense of any type: Claim, Advance Clearance, Corporate Card or Petty Cash.
Goal
Record money you spent for the company, send it for approval, and follow it until it is approved.
Before you begin
Before you begin
- Expense categories exist, each linked to an expense account
- Expense Settings has the payable accounts for the types you use Employee Payable, Staff Advance, Corporate Card Payable. Without them approval cannot post.
- For Advance Clearance: you hold a disbursed advance
- For Petty Cash: an active petty cash fund exists
- An approval workflow or a default workflow is set up
Steps
Open the form
Go to My Expenses and choose New Expense. The page title is New Expense. When you reopen a saved expense the title is Edit Expense.
Screenshot pending
New Expense form with the header fields at the top and an empty expense lines grid below
- 1Title and Expense Type.
- 2Expense Lines grid.
- 3Save Draft and Submit for Approval.
Fill in the header
Enter the Title, choose the Expense Type and complete the fields it asks for. See the header table below.Add your lines
Choose Add New Row for each item. Pick a Category on every line, enter the amount, choose the Tax and attach a Receipt.Check the total
The footer shows Total Submitted Amount. Check it against your receipts.Save a draft
Choose Save Draft. You seeExpense saved as draftand the form reopens for editing. In edit mode the button reads Update.Preview (optional)
Choose Preview to see the printable claim, then print it or save it as a PDF from your browser.Submit
Choose Submit for Approval, then Submit in the dialog. You seeSubmitted for approval.
Field reference
Header fields
| Field | Type | Required | Details |
|---|---|---|---|
| Title | Text | Yes | Error if empty: "Title is required". |
| Expense Type | Dropdown | Yes | ClaimAdvance ClearanceCorporate CardPetty Cash Default: Claim Claim: you paid from your own pocket. Advance Clearance: you are accounting for advance cash you received. Corporate Card: the company card was used. Petty Cash: office petty cash was used. The type decides which of the next two fields appear and which accounts are posted. |
| Branch | Dropdown | No | Active branches. Used to choose the approval workflow. |
| Department | Dropdown | No | Active departments. Used to choose the approval workflow. |
| Currency | Dropdown | No | Leave as the home currency unless the expense was incurred abroad. See the warning above. |
| FX Rate | Number | Only when a foreign Currency is chosen | Default: 1 Hidden for the home currency. Filled in for you when a rate is stored; otherwise enter it. Errors: "FX rate must be a number", "FX rate cannot be negative". It is stored but not applied to amounts. |
| Link to Advance | Dropdown | Only when Expense Type is Advance Clearance | Shown only for Advance Clearance. Lists your advances that are disbursed or part-cleared with an amount still outstanding, as number and amount outstanding. Picking one fills the first blank line with the advance's expected category, the description and the outstanding amount. Error if empty: "Select the advance this claim is clearing". |
| Petty Cash Fund | Dropdown | Only when Expense Type is Petty Cash | Shown only for Petty Cash. Lists active funds as name and branch, and shows the balance available. The balance is a guide: the real check is at approval. Error if empty: "Select the petty cash fund this claim is drawn from". |
| Notes | Text area | No | |
| Print Template | Dropdown | No | A saved print layout for expenses. Leave blank for the company default. |
Under the header you see Policy: and the name of the policy that applies to you, or a line saying no policy applies and no limits are enforced. You cannot change it. After submission it shows the policy as it was at that time.
Expense Lines
The grid is headed Expense Lines. Choose Add New Row to add a line. A new row takes its Department and Cost Center from your default grants. The form keeps at least one line. Open the row menu to use Duplicate or Delete line (the menu is hidden when the form is locked).
| Field | Type | Required | Details |
|---|---|---|---|
| Date | Date | No | Default: Today The date the money was spent. Approval posts this line into the accounting period that contains this date. |
| Category | Dropdown | Yes | Active categories. Error if empty: "Line {n}: please select a category". A mileage category switches the row to distance and rate. |
| Description | Text | No | |
| Km | Number | No | Mileage categories only. |
| Rate/Km | Number | No | Mileage categories only. Starts at the policy rate, else the company standard rate. You can change it only when the company setting Allow Employee Rate Override is on. |
| Qty | Number | No | Default: 1 Other categories only. |
| Unit Amount | Number | No | Default: 0 Other categories only. Enter the price before tax. |
| Amount | Number | No | Calculated: quantity times unit amount, or km times rate. Before tax. |
| Tax | Chips | No | Choose taxes from the purchase-side list. Taxes are added on top of the amount. |
| Tax Amount | Number | No | Calculated from the chosen taxes. |
| Total | Number | No | Amount plus tax. This is the figure checked against limits. |
| Department | Dropdown | No | Only departments you are granted. |
| Branch | Dropdown | No | Read-only once a Warehouse is chosen; it then follows the warehouse. |
| Warehouse | Dropdown | No | Not carried into the ledger today. |
| Cost Center | Dropdown | No | Only cost centres you are granted. Not carried into the ledger today. |
| Business Segment | Multi-select | No | Not carried into the ledger today. |
| Receipt | File | Depends on category and policy | Image or PDF. The file uploads as soon as you pick it: you see Receipt uploaded, or Failed to upload receipt. A warning icon shows when the category requires a receipt and none is attached. Winlium sets no size limit itself. |
| Budget Remaining | Read-only | No | A dash when no budget line matches. Otherwise the amount remaining, a warning when more than 80 percent of the budget would be used, and Over budget by an amount when exceeded. |
| Status | Read-only | No | A dash on a new expense; later shows the line's state. |
There is no field for an attachment on the whole expense. Receipts are attached per line.
Receipts and policy checks
Winlium checks these when you save, and again for some at submit:
- Category requires a receipt. A non-mileage line without a receipt is refused:
Category "X" requires a receipt for line "Y". - Receipt threshold. If the line total is above the threshold, a receipt is required:
Receipt required for ... line of ₦X. Your policy requires receipts above ₦T.The threshold comes from your policy, else from Expense Settings. Mileage lines never need a receipt. - Single claim cap. A line whose total is above the policy's maximum single claim amount is refused. The cap applies to each line, not the whole expense.
- Allowed categories. If the policy lists allowed categories, a line in any other category is refused:
Category "X" is not allowed under this policy. - Monthly cap. At submit, your approved and paid expenses this month plus this one must stay within the policy's monthly limit.
- Budget. At submit, a line that would exceed its budget either asks you to confirm (Submit Anyway) or blocks the submission, depending on Expense Settings.
Receipt, cap and category checks run when you save, not at submit. If a policy changes after you saved a draft, save the draft again to apply it.
Statuses and what happens next
You can edit an expense only while it is Draft or Rejected. In every other status the form is read-only.
| Status | What it means |
|---|---|
| Draft | Editable. Save, submit or delete. |
| Awaiting Approval | Locked. A banner names the current approval step. You can recall it. |
| Approved | Claim only. Posted to the ledger and waiting for Finance to reimburse you. Locked. |
| Rejected | Editable. The banner shows the approver's reason. Any edit returns it to Draft; Submit for Approval is available again. |
| Paid | Finished. For a Claim, Finance has reimbursed you. For the other three types it is set at approval. |
- DraftAwaiting Approvalwhen Submit for Approval (Submitter)
- DraftApprovedwhen Submit for Approval, when the total is at or below the auto-approve amount in Expense Settings (Submitter)
- Awaiting ApprovalDraftwhen Recall (Submitter only)
- Awaiting ApprovalApprovedwhen Approve (approvals inbox); Claim type (Last approver)
- Awaiting ApprovalPaidwhen Approve (approvals inbox); Advance Clearance, Corporate Card, Petty Cash (Last approver)
- Awaiting ApprovalRejectedwhen Reject (approvals inbox) (An approver)
- RejectedAwaiting Approvalwhen Submit for Approval (Submitter)
- ApprovedPaidwhen Process Reimbursement (Finance (see Process Expenses))
You may see these labels in lists or filters, but Winlium never sets them: Submitted, Payment Pending, Partially Approved, Cancelled, Recalled.
Buttons
| Field | Type | Required | Details |
|---|---|---|---|
| Save Draft | Button | No | Creates the expense. Shown as Update when you edit. |
| Update | Button | No | Saves changes to an existing draft or rejected expense. Toast: Expense updated. |
| Submit for Approval | Button | No | Draft or Rejected only. Opens a dialog titled Submit for Approval; choose Submit or Cancel. Winlium saves your latest changes first. You cannot edit afterwards until it is approved, rejected or recalled. |
| Recall | Button | No | Awaiting Approval only. Pulls the expense back to Draft with no question asked. Toast: Expense recalled. Works only while no approver has acted. |
| New | Button | No | Starts a blank form. If you have unsaved changes it asks Discard Changes? with Discard or Cancel. |
| Preview | Button | No | Opens Expense Claim — Preview with print options. Use your browser's Save as PDF to keep a copy. |
At submit Winlium also checks that there is at least one line (Add at least one expense line), that every line has a category, and that required receipts are attached (One or more lines require a receipt before this can be submitted).
If the company warns on budget, a dialog titled This expense exceeds budget lists the lines over budget. Choose Submit Anyway to continue or Cancel to go back.
Approval, clarification, rejection and recall
- After you submit, the approvers named in the workflow decide. See Approvals.
- An approver can ask a question. A box appears: "The approver has requested clarification:" with the question. Type your answer in the box and choose Send Response. The expense stays Awaiting Approval. Winlium checks for a question every 15 seconds.
- If an approver rejects, the expense returns as Rejected with the reason. Edit it, then choose Submit for Approval again.
- If you recall, the expense returns to Draft and you can edit and resubmit. A new approval starts.
You cannot approve your own expense.
Ledger impact
Saving, editing, deleting, submitting, recalling, rejecting and answering a clarification never write to the ledger. Posting happens once, when the expense is approved. If the total is at or below the auto-approve amount in Expense Settings, there is no approval step and posting happens at the moment you choose Submit.
Every expense posts one set of lines per expense line: a debit to the category's expense account, a debit to the tax account for each tax, and a credit to a control account. The control account depends on the type. Each line posts on its own Date, so one expense can post into more than one accounting period. If the period is blocked or missing, posting fails and an error names the date.
Accounts come from these places:
- Expense account: the category's account, as it was when you last saved the draft (Expense Categories).
- Tax account: the tax's purchase account in Accounting > Taxes, else its default account.
- Control accounts: Expense Settings (see Expense settings) or the fund.
Ledger impact: Approval of a Claim, stage 1 of 2
Stage 1 of 2| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Category expense account | Expense Categories > Expense Account | Amount of each line, before tax |
| Dr | VAT input (the tax's account) | Accounting > Taxes > purchase account | Tax amount of each tax on the line |
| Cr | Employee Payable | Expense Settings > Employee Payable | Amount plus tax |
Example only: a hotel night of ₦200,000.00 with 7.5% VAT of ₦15,000.00. On approval, Dr Travel Expense ₦200,000.00, Dr VAT Input ₦15,000.00, Cr Employee Payable ₦215,000.00. The status becomes Approved.
Ledger impact: Reimbursement of a Claim (Process Reimbursement), stage 2 of 2
Stage 2 of 2| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Employee Payable | Expense Settings > Employee Payable | Amount plus tax |
| Cr | Bank or cash account chosen by Finance | Chosen on Process Expenses | Amount plus tax |
Example only: Finance pays the ₦215,000.00 from the bank. Dr Employee Payable ₦215,000.00, Cr Bank ₦215,000.00. See Process Expenses.
Ledger impact: Approval of an Advance Clearance (single stage)
| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Category expense account | Expense Categories > Expense Account | Amount of each line, before tax |
| Dr | VAT input (the tax's account) | Accounting > Taxes > purchase account | Tax amount |
| Cr | Staff Advance | Expense Settings > Staff Advance | Amount plus tax |
Example only: you spend ₦400,000.00 plus VAT of ₦30,000.00 against a ₦500,000.00 advance. On approval, Dr Travel Expense ₦400,000.00, Dr VAT Input ₦30,000.00, Cr Staff Advance ₦430,000.00. The advance shows ₦430,000.00 cleared and ₦70,000.00 outstanding. The expense becomes Paid. Tax counts as cleared. See Advance to clearance.
Ledger impact: Approval of a Petty Cash expense (single stage)
| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Category expense account | Expense Categories > Expense Account | Amount of each line, before tax |
| Dr | VAT input (the tax's account) | Accounting > Taxes > purchase account | Tax amount |
| Cr | The fund's cash control account | Petty Cash Fund > control account (as at the time you saved the draft), else Expense Settings default petty cash account | Amount plus tax |
Example only: ₦20,000.00 plus VAT of ₦1,500.00. Dr Expense ₦20,000.00, Dr VAT Input ₦1,500.00, Cr Petty Cash ₦21,500.00. A fund of ₦100,000.00 drops to ₦78,500.00. If the fund is inactive or does not hold enough and cannot go negative, approval fails: Petty cash fund "<name>" has insufficient balance (₦<balance>) to cover this claim of ₦<amount>. Replenish the fund first.
Ledger impact: Approval of a Corporate Card expense (single stage)
| Side | Account | Where the account comes from | Amount |
|---|---|---|---|
| Dr | Category expense account | Expense Categories > Expense Account | Amount of each line, before tax |
| Dr | VAT input (the tax's account) | Accounting > Taxes > purchase account | Tax amount |
| Cr | Corporate Card Payable | Expense Settings > Corporate Card Payable | Amount plus tax |
Example only: ₦50,000.00 plus VAT of ₦3,750.00. Dr Expense ₦50,000.00, Dr VAT Input ₦3,750.00, Cr Corporate Card Payable ₦53,750.00. The expense becomes Paid, but the card payable stays open until it is cleared elsewhere.
Approvals
Who approves is set by the approval workflow that matches the expense (total, type, department, branch). If no workflow matches and no default is set, submit fails. See Workflows and approvals and Approvals. Approvers act in the approvals inbox, not on this form.
Reverse or void
You can recall an expense that is waiting for approval, and delete a draft. Once an expense is approved it is posted and Winlium has no way to reverse or cancel it in the Expense module.
Who can do this
You need permission to create, read, update, submit and recall expenses (expense:expenses:create, expense:expenses:read, expense:expenses:update, expense:expenses-submit:create, expense:expenses-recall:create) and to answer a clarification (expense:expenses-provide-clarification:create). The form also reads categories, taxes, currencies, departments and branches, so your role needs read access to those. If one is missing, a list stays empty or the form keeps loading. See Roles and permissions.
Nigerian notes
If something goes wrong
Only Draft or Rejected expenses can be edited (current status: <STATUS>)
Appears: Save or Update
- Why it happens
- The expense is awaiting approval, approved or paid.
- How to fix it
- Recall it if it is awaiting approval, then edit.
Only Draft or Rejected expenses can be submitted for approval (current: <STATUS>)
Appears: Submit
- Why it happens
- The expense is already submitted or finished.
- How to fix it
- Check the status in My Expenses.
Cannot submit an expense with no lines
Appears: Submit
- Why it happens
- There are no lines.
- How to fix it
- Add at least one line.
No approval workflow matches this expense and no default workflow is configured. Please contact your administrator.
Appears: Submit
- Why it happens
- No workflow fits and no default is set.
- How to fix it
- Ask your administrator to set a default claim workflow.
This submission would bring your total expense claims for <Month Year> to ₦<projected>, exceeding your policy limit of ₦<limit>. You have ₦<remaining> remaining for this month.
Appears: Submit
- Why it happens
- The monthly cap in your policy.
- How to fix it
- Reduce the claim or submit next month.
Line <n> (<category>) would exceed the budget for this period by ₦<over>. Submission blocked. Contact your finance manager to request a budget revision.
Appears: Submit
- Why it happens
- Budget blocking is on.
- How to fix it
- Ask your finance manager for a budget revision.
Receipt required for <category> line of ₦<total>. Your policy requires receipts above ₦<threshold>.
Appears: Save
- Why it happens
- The line total is above the receipt threshold.
- How to fix it
- Attach a receipt to the line.
Category "<name>" is not allowed under this policy
Appears: Save
- Why it happens
- Your policy lists allowed categories and this is not one.
- How to fix it
- Choose another category.
Only expenses pending approval can be recalled (current: <STATUS>)
Appears: Recall
- Why it happens
- The expense is not awaiting approval.
- How to fix it
- Nothing to recall.
Cannot recall — an approver has already actioned this document
Appears: Recall
- Why it happens
- An approver has already acted.
- How to fix it
- Wait for the final decision.
Employee Payable account is not configured in Expense Settings
Appears: Approval or auto-approved submit
- Why it happens
- A control account is missing.
- How to fix it
- Ask your administrator to set it in Expense Settings.
No active financial period found for date: <YYYY-MM-DD>
Appears: Approval or auto-approved submit
- Why it happens
- No open accounting period covers a line date.
- How to fix it
- Ask Accounting to open the period, or correct the line date.
More in Troubleshooting.