What it is
When someone submits a material request, an employee expense claim or a leave application, DuctArchitect opens an approval request for it. Task completions that need a reviewer use the same approval requests. The thing being approved is called the subject.
Every approval request is decided in one place: the Approvals page, in the sidebar, with a count badge of the requests waiting for you. The same Approval card (the approval panel) also shows on the subject's own page: the material request page, the to-do's material requests drawer, and the pages of the other subjects.
A subject has at most one open approval request at a time. If a request is withdrawn and the subject is submitted again, a new approval request is opened; the earlier ones stay in its history.
The rule for each subject
Owner and Admin set one rule each for material requests and for employee expense claims on Settings › Approvals. See Set how requests are approved. The rule says:
- whether an approval is needed at all,
- for material requests, whether a request within the project's quoted quantity is approved automatically,
- whether a person may approve their own request,
- who is told when something is submitted.
A company with no saved rule needs an approval for everything, approves nothing automatically and never lets a person approve their own request. Leave follows the leave approval setting on Settings › HRMS, not this page. See Choose who approves leave.
Who is told and who may decide
Who is told on submit is one of: "The project's manager, else everyone who can approve" (for expense claims: "The employee's reporting manager, else everyone who can approve"), "Everyone who can approve", or "Chosen people (who can approve)". Being told is only a notification: "Anyone who can approve may still decide from the Approvals page, whoever was told."
To decide, a person needs the subject's module, Approve on the subject's record row (for material requests, Approve on Material requests) and View on Approvals. Workers never decide: "Decisions are made in the office app."
How it moves
- Pending: the subject was submitted. Approvers are told. The request is on their To approve tab and on the requester's My requests tab.
- A person who may decide makes the decision:
- Approved: approved. When the request has more than one step, it is approved only when no step is left.
- Partially approved: some lines of a material request are approved in part. Only material requests with one step can be partially approved.
- Rejected: rejected, always with a reason the requester sees.
- The requester is told the decision. What happens next depends on the subject: an approved material request can be issued or ordered; an approved company card expense claim is paid; an approved leave application updates the leave; an approved task completion completes the task.
Other moves:
- Withdrawn: the person who raised it withdraws it while it is pending. A material request goes back to Draft. See Follow your own requests: withdraw or answer a question.
- Auto-approved: written at submit, when the rule needs no approval or the automatic condition holds. Nobody decides it.
There is no "send back" action. To get changes made, ask in Comments; the requester then withdraws the request, changes the subject and submits it again. Or reject it with a reason.
Steps
Material requests and expense claims have one step. A leave application may have two: the reporting manager, then a final approval. When there is more than one step, or a step was skipped, the card shows the chain as "Step [n]: [name]", each step marked:
| Shown | Means |
|---|---|
| Waiting now | This step is open and waiting for its approver. |
| Next | This step comes after the open one. |
| Not reached | The request was decided before this step. |
| Approved | This step was approved. |
| Rejected | This step was rejected. |
| Skipped | This step had nobody to decide it, for example "Skipped: no reporting manager". |
The step names are "Reporting manager", "Final approval", "Leave approver" or "Approver". Only the person the open step waits for can decide it: "This step is waiting for someone else."
The trail and comments
The card lists every event as "[event] by [name], [date and time]: [note]". The events are Submitted, Approved, Partially approved, Rejected, Withdrawn and Auto-approved. The trail cannot be changed.
While the request is pending, a person who may decide and the requester can write in Comments ("Ask for clarification, or answer one"). The other side is told. A decided request takes no more comments.
Who is involved
| Role | What they do |
|---|---|
| The requester | Submits the subject, follows it on My requests, answers questions, and withdraws it while it is pending. |
| Anyone with the subject's module and Approve on its record row | Decides on To approve, but not their own request unless the rule allows it. For material requests this is, by default, every Manager, Technician and User, as well as Owner and Admin. Employee expense claims need Employee Expenses, which by default only Owner and Admin hold. |
| Owner and Admin | Set the rules on Settings › Approvals. |
| Leave approvers | Decide leave applications under the HRMS leave approval setting. See How a leave application moves from Submitted to Approved. |
