Working with approvals
Approve, reject or delegate documents waiting on you, follow work still to be done, set up a delegation while you are away, and track a document you submitted.
Many documents need a manager's approval before they post. The Approvals area is where you act on those documents. It is near the top of the menu. Everyone who signs in can open it.
The rules for who approves what are set by an administrator in a Workflow Template. This page shows the screens. For the rules, see Workflows and approvals.
| Menu item | Use it to |
|---|---|
| My Approvals | Approve, reject or pass on documents waiting on you. |
| Outstanding Work | See documents that are part-way through a process and need a next action. |
| My Delegations | Hand your approvals to someone while you are away. |
What "Awaiting Approval" means
When you submit a document, its status changes to Awaiting Approval. It means the document is with an approver and is waiting on a decision. You wait for the decision. For an expense, the document is locked until it is approved or recalled.
The document then moves on.
- Approved: the document continues to its next stage. Some documents then need a further action, for example posting.
- Rejected: the approver gives a reason. You can see it on the approval page.
- Returned for clarification: the approver asked you a question. You answer it, and the approval continues.
See Document numbers and statuses for the usual status words.
My Approvals
Select Approvals, then My Approvals. The page shows "Documents waiting on your approval across all modules."
Screenshot pending
My Approvals page with four summary cards, filters for document type, status and search, and a table of documents waiting for approval
- 1Summary cards: Pending Action, Due Today, Overdue and Approved Today.
- 2Filter by document type and status, or search.
- 3Each row is one document waiting on you.
- 4Open the row menu for Approve, Reject and more.
The summary cards
| Card | What it counts |
|---|---|
| Pending Action | Tasks waiting on you. |
| Due Today | Tasks due today. |
| Overdue | Tasks past their due time. |
| Approved Today | Tasks you approved today. |
Filters
| Filter | Choices |
|---|---|
| Document Type | All Document Types, or one type such as Supplier Payment, Customer Invoice, Purchase Order, Expense, Advance Request, Delivery Order, Supplier Bill, Credit Note, Journal Batch, AR Batch, AP Batch, Inventory Adjustment, Transfer, Return to Supplier, Sales Order, Customer Receipt, Inventory Count, Requisition, Maintenance Request, Manufacturing Order, RFQ, Prospective Vendor Onboarding, Prospective Vendor Restriction, Prospective Customer Approval or Custom. |
| Status | Pending (the default), Overdue, Done and All. Done shows tasks already approved, rejected, delegated, escalated, recalled or replaced. |
| Search | Type a document number or description. The box reads "Search document no. / description…". |
The table
| Column | What it shows |
|---|---|
| Priority | OVERDUE, DUE_TODAY, UPCOMING or DONE. |
| Document No | The document's number. |
| Type | The kind of document. |
| Submitted By | The person who sent it for approval. |
| Amount | The document total, for example ₦1,250,000.00. |
| Submitted | How long ago it was sent, for example "2 hr ago". |
| Due | When your decision is due, for example "Today 5:00 PM", or "Overdue 2 days". |
| Approval Status | The status of the approval, not of the document. Hover over the heading for this note. |
| Actions | A menu of things you can do. |
Winlium sets a due time when a task is assigned. Unless the step says otherwise, it is 24 hours later. A reminder, titled "Reminder: approval pending", goes to you after 8 hours unless the step sets another time.
Act on one document
Open the row menu
Select the three dots at the end of the row. The menu shows Approve, Request Clarification, Reject, Delegate and Open Document. The first four show only for tasks still waiting on you.Choose an action
Select the action. A box opens. Its title is the action and the document number, for example "Approve — PO-0001" (an example). Under it you see the document type and the step.Add a comment
Type a note in Comment. It is optional for Approve and Delegate, and required for Reject and Request Clarification.Confirm
Select the confirm button: Approve, Reject, Send Request or Delegate. Winlium shows "Task approved", "Task rejected", "Clarification requested" or "Task delegated".
| Action | What it does |
|---|---|
| Approve | Gives your approval. The document moves to the next step, or finishes. |
| Reject | Stops the approval. You must give a reason. The submitter sees it. |
| Request Clarification | Sends the document back to the submitter with your question. The status becomes Returned for clarification. Your task stays open until the submitter answers. |
| Delegate | Hands this one task to someone else. |
| Open Document | Opens the approval page for the document, with its progress and history. |
| Field | Type | Required | Details |
|---|---|---|---|
| Comment | Text area | Required for Reject and Request Clarification | The button stays off until you type a comment where one is required. |
| Delegate to (user id) | Text | Required for Delegate | The id of the user to hand the task to. The Delegate button stays off while it is empty. |
| Name | Text | No | The delegate's full name. Placeholder: Full name. |
| Text | No | The delegate's email. |
Act on several documents
Tick the rows
Tick the box at the start of each row you want. Only rows still pending can be ticked. The box in the heading ticks all pending rows.Choose Bulk Approve or Bulk Reject
A count such as "3 selected" appears with the buttons Bulk Approve and Bulk Reject. Select one.Add a comment
The box is titled for example "Bulk Approve — 3 tasks". It says "This action will be applied to all selected tasks. A single comment is used for each." A comment is required for reject.Confirm
Select the confirm button, for example Approve 3. Winlium shows "3 tasks approved".
Empty and error states
| Message | What it means |
|---|---|
| Nothing to approve | No tasks match the filter. "When documents are submitted for your approval, they'll show up here." |
| Loading approvals… | Winlium is loading the list. |
| Failed to load approvals. Please try again. | The list did not load. Refresh the page. |
Why an action can fail
You cannot approve a document you submitted
Appears: After Approve
- Why it happens
- You submitted this document. Winlium normally skips you as an approver on your own document. The only exceptions are manufacturing (production) orders and maintenance requests.
- How to fix it
Ask another approver to act on it.
You are not the assignee for this approval task
Appears: After any action
- Why it happens
- The task is assigned to someone else, for example because a delegation sent it to your colleague.
- How to fix it
Refresh the page. Act only on tasks that show in your own list.
This task is no longer actionable
Appears: After any action
- Why it happens
- Someone already acted on the task, or the approval was recalled or replaced. The message ends with the task status in brackets.
- How to fix it
Refresh the page. Nothing more to do.
Workflow is no longer active
Appears: After any action
- Why it happens
- The approval already finished or was cancelled. The message ends with the status in brackets.
- How to fix it
Refresh the page.
A reason is required to reject
Appears: After Reject
- Why it happens
- You left the comment empty.
- How to fix it
Type the reason for the rejection.
A comment is required for this step
Appears: After any action
- Why it happens
- This step is set to need a comment every time.
- How to fix it
Type a comment and try again.
This step does not allow delegation
Appears: After Delegate
- Why it happens
- The workflow step is set to forbid passing the task on.
- How to fix it
Approve or reject it yourself, or ask your administrator.
This step does not allow clarification requests
Appears: After Request Clarification
- Why it happens
- The workflow step is set to forbid clarification requests.
- How to fix it
Approve or reject it, or contact the submitter directly.
The approval page for one document
Select Open Document on a row, or select an approval notification. The page opens with a Back button.
Screenshot pending
Approval page for one document showing the document number, the current step, a status badge, a comment box with Approve, Request Clarification and Reject buttons, and the Approval Progress and Approval History sections
- 1Document number, type, who submitted it and when.
- 2The status of the approval and the amount.
- 3Type a comment, then choose an action.
- 4Approval Progress shows each step and who has acted.
- 5Approval History lists every event.
The top card shows:
- The document number, its type and description, and "Submitted by" with the person and the time.
- The current step, for example "Step 1 of 2 — Finance review".
- A status badge: PENDING, APPROVED, REJECTED, CANCELLED, RETURNED FOR CLARIFICATION or RECALLED.
- The amount, when the document has one.
- For a requisition, RFQ or purchase order, extra detail about the document.
- After a rejection, a red note: "Rejected:" and the reason.
- After a clarification request, a purple note: "Clarification requested:" and the question.
Below it, Approval Progress lists every step, in order.
| What you see | What it means |
|---|---|
| Approved by name · time | The step is done. |
| Skipped — no action required | The step did not apply, or no valid approver was found. |
| Waiting on name | The step is current and that person has not acted. |
| Returned to you for clarification | The approver asked the submitter a question. |
| Rejected: reason | An approver rejected the document. |
| Recalled by submitter, or Cancelled | The approval was stopped. |
| Not yet reached | A later step. |
Approval History lists every event in order, for example submitted, task assigned, approved, rejected, delegated, recalled and completed. Each line shows who did it, any comment, and when. With none it says "No history yet."
If a task is waiting on you
A comment box and three buttons show: Approve, Request Clarification and Reject. The comment is required for the last two. Winlium shows "Please provide a comment" if you leave it empty, then "Submitting…" and "Done".
If you submitted the document
Answer a question
When the status is RETURNED FOR CLARIFICATION, type your answer in the box, then select Submit Clarification. Winlium shows "Please provide your clarification" if the box is empty, and "Clarification submitted" when it works. The approval carries on.Take the document back
While the status is PENDING and no approver has acted yet, select Recall. Winlium shows "Recalled". The tasks are cancelled and the approvers are told. You can then change the document.
Cannot recall — an approver has already actioned this document
Appears: After Recall
- Why it happens
- At least one approver has already approved, rejected or passed on the document.
- How to fix it
You cannot recall it. Ask the approver to reject it, or to ask for clarification.
Only pending workflows can be recalled
Appears: After Recall
- Why it happens
- The approval already finished, was rejected or was recalled. The message ends with the current status in brackets.
- How to fix it
Nothing to recall.
Only the submitter can recall this document
Appears: After Recall
- Why it happens
- You are not the person who submitted it.
- How to fix it
Ask the submitter to recall it.
On the Expense form, a Recall button sits on the form itself while the expense is Awaiting Approval.
Outstanding Work
Select Approvals, then Outstanding Work. The page says "Documents part-way through a process and waiting on a next step." It lists work that is not an approval, for example a delivery that still has to be processed or a requisition that still needs an RFQ.
Screenshot pending
Outstanding work page with a count of actions outstanding and collapsible groups, each with a count badge
- 1How many actions are outstanding for you.
- 2Switch between your work and everyone's.
- 3Each group is one kind of action. Select a group to open it.
- The page first shows only work you can do. A line says, for example, "5 actions outstanding".
- Select Show everything to also see work for other people. The button shows how many more, for example "Show everything (12 more)". Select Show only mine to go back.
- Work is grouped by the action needed, for example "Process Delivery Order". A number badge shows how many documents are in the group. Select a group to open it.
- Each row shows the document number and its type. When a step covers several items it says, for example, "2 of 5 remaining".
- Select View to go to the screen where you do the work.
- A row you cannot act on shows a padlock and the role that can. Hover to read "Requires" and that role, then "— you don't hold this permission."
- A row can say "No screen is wired up for this step yet." Open the document from its own list instead.
| Message | What it means |
|---|---|
| Loading outstanding work… | Winlium is loading. |
| Nothing outstanding for you. | You have no pending actions. |
| Nothing outstanding anywhere. | Nobody has pending actions. Shown after Show everything. |
| Nothing waiting on you | Empty state when you have none. |
| Everything is up to date | Empty state after Show everything. |
On a document's own page, a "What's next" panel shows what the document still needs. It shows "This transaction is complete" when nothing is left.
My Delegations
Use a delegation when you will be away. While it is active, new approvals that would come to you go to your delegate instead.
Select Approvals, then My Delegations. The page is titled Approval Delegations. It says "Hand off your approvals when you're away, and see whose approvals you're covering."
Screenshot pending
Approval Delegations page with a New Delegation button, tabs My Delegations and Covering For Me, and a table of delegations with Deactivate buttons
- 1Select New Delegation.
- 2My Delegations are yours. Covering For Me are other people's that you cover.
- 3Select Deactivate to end a delegation early.
Create a delegation
Start
Select New Delegation. The box Delegate my approvals opens. It says "While you're away, approvals assigned to you are routed to your delegate for the period below."Choose the delegate
Open Delegate to and pick a colleague. The list shows name and email. It leaves out yourself and users who are not active.Set the dates
Choose Start date and End date.Choose document types
Optionally pick one or more types in Document types (leave empty for all). Leave it empty to cover every type.Add a reason
Optionally type a Reason, for example "Annual leave".Create
Select Create. Winlium shows "Creating delegation…" then "Delegation created". Select Cancel to close without saving.
| Field | Type | Required | Details |
|---|---|---|---|
| Delegate to | Dropdown with search | Yes | Error if empty: "Please select a delegate". The placeholder reads Select a user… and "No users found." shows when the search finds nobody. |
| Start date | Date | Yes | Error if either date is empty: "Start and end dates are required". |
| End date | Date | Yes | Error if either date is empty: "Start and end dates are required". The delegation covers the whole of the end date. |
| Document types (leave empty for all) | Multi-select | No | Leave empty to cover all document types. Placeholder: All document types. |
| Reason | Text area | No | Free text. Placeholder: e.g. Annual leave. |
How a delegation works:
- It applies to approvals that are created while the delegation is active. The date must fall between the start date and the end date, and the document type must match.
- It does not move approvals that were already waiting on you. Hand those over with Delegate in My Approvals, or approve them yourself.
- The delegate sees the task in their own My Approvals. The task notes that it was delegated from you.
Read the two tabs
The page has two tabs.
| Tab | What it shows |
|---|---|
| My Delegations | Delegations you created. The first column is Delegate. |
| Covering For Me | Delegations where someone chose you. The first column is Delegator. |
Columns: Delegate or Delegator, Period, Document Types (or "All"), Reason, Status (Active or Inactive) and Actions.
End a delegation
In My Delegations, select Deactivate on the row. Winlium shows "Deactivating…" then "Delegation deactivated". The status becomes Inactive. From then on, new approvals come to you again. A row that is already inactive shows a dash. The screen has no button to switch an inactive delegation back on. Create a new one instead.
With none, the tab says "No delegations."
Notifications about approvals
Winlium tells you in the bell and on the Notifications page. Each title starts with one of these words, then the document number.
| Title starts with | When you get it |
|---|---|
| Approval required | An approval is assigned to you. |
| Delegated approval | Someone delegated a task to you. |
| Reminder: approval pending | A task has waited longer than its reminder time. |
| Escalated approval, or Your approval was escalated | A step passed its escalation time, if the step is set up to escalate. |
| Step approved, or Approval progress | Your document moved on a step. |
| Approved | Your document was approved. |
| Rejected | Your document was rejected. |
| Clarification requested | An approver asked you a question. |
| Clarification provided | The submitter answered your question. |
| Recalled | The submitter took the document back. |
Select the notification to go to the approval page. See Navigating the app.