Approval Workflows
Approval Workflows define the multi-step approval process that entities (documents, audits, CAPAs, complaints, MRMs, etc.) must go through before they can be finalized. Each workflow consists of one or more approval steps, where each step is assigned to a Role.
Overview
An approval workflow specifies:
- Name — A descriptive name (e.g., "Document Approval", "CAPA Closure Approval")
- Description — An optional explanation of when this workflow should be used
- Entity Type — The type of entity this workflow applies to (e.g., Document, Audit, CAPA, Complaint, MRM)
- Steps — One or more sequential approval steps, each assigned to a role
Supported Entity Types
Approval workflows can be created for the following entity types:
| Entity Type | Description |
|---|---|
| Document | For document and record approvals |
| Audit | For internal audit report approvals |
| CAPA | For CAPA closure approvals |
| Complaint | For complaint closure approvals |
| MRM | For management review meeting approvals |
| Purchase Order | For purchase order approvals |
| Batch | For production batch approvals |
| Sales Order | For sales order approvals |
| GRN | For goods receiving note approvals |
| Delivery Challan | For delivery challan approvals |
| Sales Invoice | For sales invoice approvals |
Approval Types
Each step in a workflow can use one of the following approval types:
- Role — Any user assigned to the specified role can approve
- User — A specific user must approve
Execution Types
Steps can be executed in different ways:
- Sequential — Steps are executed one after another in order
- Parallel — Multiple steps can be executed simultaneously
Viewing All Workflows
- Navigate to QMS → Approval Workflows from the sidebar
- You will see a table listing all existing workflows with:
- Workflow Name
- Entity Type — Which type of entity this workflow applies to
- Number of Steps
- Description
- Actions (Edit, Delete)
Creating a New Workflow
- Navigate to QMS → Approval Workflows
- Click the Create Workflow button in the top-right corner
- Fill in the workflow details:
- Name (required) — Enter a name for the workflow (e.g., "CAPA Two-Step Approval")
- Description — Optionally describe when this workflow should be used
- Entity Type (required) — Select the type of entity this workflow applies to
- Add approval steps:
- Each step requires:
- Step Name — A descriptive name (e.g., "Quality Head Review")
- Step Order — The order in which the step is executed (auto-assigned)
- Approval Type — Select "Role" or "User"
- Role — If approval type is "Role", select the role whose members can approve
- Approval Count — Number of approvals required from the role (default: 1)
- Execution Type — Sequential or Parallel
- Click the Add Step button to add more steps
- Use the up/down arrows to reorder steps
- Click the remove button to delete a step
- Each step requires:
- Click Save to create the workflow
Example: Two-Step Document Approval
| Step | Name | Role | Approval Count |
|---|---|---|---|
| 1 | Quality Review | Quality Assurance | 1 |
| 2 | Management Approval | Managing Director | 1 |
In this example, the document first goes to the Quality Assurance role for review, and then to the Managing Director role for final approval.
Editing a Workflow
- Navigate to QMS → Approval Workflows
- Find the workflow you want to edit
- Click the Edit button (pencil icon) in the Actions column
- Modify the workflow name, description, entity type, or steps
- Click Save to update the workflow
Deleting a Workflow
- Navigate to QMS → Approval Workflows
- Find the workflow you want to delete
- Click the Delete button (trash icon)
- Confirm the deletion in the popup
Warning: Deleting a workflow that is referenced by active approval instances will not affect those in-progress approvals, but you will no longer be able to start new approvals with this workflow.
How Approvals Work
When an entity (e.g., a CAPA or an audit report) is submitted for approval:
- The user selects which approval workflow to use
- The system creates an Approval Instance and starts the first step
- Users assigned to the role in the current step receive a notification under Pending Approvals
- An approver can either Approve or Reject with comments
- If approved, the workflow advances to the next step (if any)
- If rejected, the entity is sent back and its status changes to "Rejected"
- Once all steps are approved, the entity's status changes to "Approved"
Approval Statuses
| Status | Description |
|---|---|
| Pending | Waiting for the first approval step |
| In Progress | At least one step has been completed, more remain |
| Approved | All steps have been approved |
| Rejected | An approver has rejected the entity |
| Expired | The approval has expired without action |
| Cancelled | The approval was cancelled |
Pending Approvals
Users can view their pending approvals by navigating to QMS → Pending Approvals. This page shows all approval instances where the current user is an eligible approver for the active step.
From this page, approvers can:
- View the entity details
- Approve with optional comments
- Reject with required comments
Best Practices
- Keep workflows simple — 2–3 steps is usually sufficient for most processes
- Match workflows to your SOP — Your approval workflows should reflect your documented standard operating procedures
- Use descriptive names — Name workflows clearly so users know which one to select (e.g., "SOP Approval - 2 Level" vs "CAPA Closure - QA + MD")
- Create separate workflows per entity type — Even if the approval steps are similar, having separate workflows for Documents, CAPAs, and Audits makes it easier to manage
Next Steps
- Make sure you have Roles set up before creating workflows
- Learn how approval workflows are used in Internal Audit, CAPA, Complaints, and MRM