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

  1. Pending: the subject was submitted. Approvers are told. The request is on their To approve tab and on the requester's My requests tab.
  2. 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.
  3. 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:

ShownMeans
Waiting nowThis step is open and waiting for its approver.
NextThis step comes after the open one.
Not reachedThe request was decided before this step.
ApprovedThis step was approved.
RejectedThis step was rejected.
SkippedThis 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

RoleWhat they do
The requesterSubmits 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 rowDecides 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 AdminSet the rules on Settings › Approvals.
Leave approversDecide leave applications under the HRMS leave approval setting. See How a leave application moves from Submitted to Approved.