Feature Availability and Limits
Vtiger Editions: One Pilot | One Growth | One Professional | One Enterprise | One AI
Supported modules - Inclusion: Leads, Contacts, Organizations, Opportunities, Cases, Projects, Project Tasks, Assets, Service Contracts, Inventory Modules (Quotes, SO, PO, Invoice, Subscriptions), Events, Payments, Campaigns.
- Exclusion: Comments, Inbox, Email Campaigns, Phone calls, Olark, Esign, Mail Manager, SMS Notifier, Tasks, Time Logs, Transactions, Marketing List, Email Sequences, Journey Templates
Introduction
Businesses have processes that require approvals by managers or other team members. Process owners can set up approval processes using Vtiger’s approvals to automate their business processes.
You can use the Approval process to:
- Streamline discounts allowed on a Quote.
- Budget utilized in a Campaign.
- Approval for a new hire.
- Approval of the leave by a user and so on.
Approval Process in Vtiger CRM
Vtiger approval process automation allows administrators or process owners to set up an approval process adhering to their business processes. There is also an option to set up a multi-level approval hierarchy. The Approver can be any user or a reporting manager. If the approval process’s entry criteria are met, rules are processed sequentially, with approval requests sent to each approver defined in the rule’s approval matrix. When the record is waiting for approval, the record is locked and cannot be edited until the process is completed. The process stops if an approver rejects the request for approval, and final rejection actions are run. Otherwise, the next rule is processed for approvals. When there are no more rules to execute, the record is approved, and final approval actions are run.
Use case
At TechNova, Asha, the CRM Administrator, wants to control large discounts. She sets up an approval process for the Quotes module so that the Sales Manager must approve any discount above 15%.
Later, Priya (Sales Executive) creates a quote with a 20% discount. The CRM detects this and prompts her to submit it for approval. She adds a note and clicks submit. Rahul, the Sales Manager, receives a notification and approves.. Once approved, the quote becomes editable again and can be shared with the customer.
Benefits of Using Approvals
The following are the benefits of Approvals CRM:
- Automates manual approval tasks and saves time.
- Ensures records are reviewed before execution.
- Locks records during approval to avoid changes.
- Supports multi-level approval chains.
- Sends email and CRM notifications to approvers.
- Allows adding notes and attachments to the record.
Approval Status Field in Approval Record
Each approval record has its own status field, which will change according to the approver’s actions. Status | Description |
Submitted | Waiting for action from the current approver. |
Pending | Waiting for approval by other approvers after the current approver has approved. |
Rejected | If the current approver has rejected the approval. This sets the status in the related record from waiting for approver to rejected. |
Auto Cancelled | If the current approver rejects the approval, the record is set to auto-cancel to the next level approver. |
Approved | If all the approvers have approved the record. |
The above statuses are also viewable in the Approval widget of the related record.
Approval Status Field in Related Record
The approval status field is added to a record when a module is linked to at least one active approval process. When a record is submitted for approval, the approval status field can be one of the values listed below. Status | Description |
Not Applicable | If the record did not match the entry criteria for any approvals |
Not Submitted | If the next level approver cannot be determined, or is assigned to a group, or the record is in a closed state. |
Waiting for Approval | If waiting for the approver’s action. |
Approved | If all the approvers have approved. |
Auto Approved | If the record matched the entry criteria but did not match any of the process rules. |
Rejected | If at least one or all the approvers have rejected. |
Cancelled | If an approver has canceled. |
Note:
- Any approval record is auto-approved when the approver is the record submitter.
- You cannot create any related records to a record that is waiting for approval. For example, when a quote is waiting for approval, you cannot create a sales order.
Approvals Watermark
When a record is pending approval, the PDF document in the record displays a watermark stating Not Approved.
The user is not allowed to print the pending approval PDF.
Once the approver approves the record, the watermark disappears, and the user can print the PDF document in the record.The following table shows the application of the watermark based on the approval status of the record: Approval Status | Watermark to be applied |
Waiting for Approval | Yes |
Rejected | Yes |
Not Submitted | Yes |
Auto-Approved | No |
Approved | No |
Not Applicable | No |
Mapping Approval Status and Related Record Status
The status field in the Approval record affects the status field in the related record as well.
Approval Record Status | Related Record Status |
Submitted | Waiting for approval |
Pending | Waiting for approval |
Rejected | Rejected Not applicable Not Submitted |
Auto Cancelled | Cancelled |
Approved | Approved Auto Approved |
Actions Not Possible
A submitter cannot perform specific actions depending on the Approval status after the record is sent for approval.
Approval Status | Actions unavailable |
Waiting for approval | Edit, Print related actions, convert actions |
Rejected | All print-related actions and convert actions |
Not Submitted | All print-related actions and convert actions |
Approved | None |
Not applicable | None |
Time-Based Conditions in Approvals
Approvals support DateTime and Time fields in the Approval Entry Criteria with the following condition options: - Less Than: Approval is submitted if the record is created between 12:00 AM and 7:59 AM.
- Less Than or Equal To: Triggers if the record is created between 12:00 AM and 8:00 AM.
- Greater Than: Triggers if the record is created between 9:01 AM and 11:59 PM.
- Greater Than or Equal To: Triggers if the record is created between 9:00 AM and 11:59 PM.
These options appear in both All and Any condition groups in the approval criteria.Approval Behavior
- Approvals can be sent to all users in a group when a group is assigned.
- Multi-level approvals are fully supported.
- On final approval or rejection, the corresponding actions will be executed as configured.
- If a record is edited, duplicated, or resubmitted within a qualifying time range and meets the approval condition, it will be submitted again for approval.
- Approval resubmission after cancellation is supported.
- Works seamlessly for non-admin users.
- Fully compatible with custom DateTime and Time fields.
- When the via process option is enabled, the record must satisfy both the approval rule and the associated process condition.
- If a Date field (without time) is selected, the Less Than and Greater Than options will not be shown.
Approval Rules
You can use the Created By or Assigned criteria in Approval Rules to initiate an Approval.
Consider the scenarios below. - Trigger Approvals based on the criteria - Created By User.
- Create new Approvals and set the user profile applied on = Created By. Create a record with a set of data that matches the rules given in the Approvals. Assign the record to the CRM user and save it.
- The Approval is triggered based on the Created By User rule. The Approval pop-up displays the list of approvers and matching rules.
- Trigger Approvals based on the criteria Created By User when the Assigned To is a Group.
- Create new Approvals and set the user profile applied on = Created By. Create a record with a set of data that matches the rules given in the approvals. Assign the record to any group and save it.
- The Approval triggers based on the criteria Created By user, even after the Assigned To is a group/other user. The Approvals pop-up displays a list of approvers and matching rules.
Submitting a Record for Approval
When a sales or marketing representative creates a record that matches at least one approval rule, they are prompted to send the record for approval to the approvers configured during setup.
Note: Make sure that your admins have set up an approval process before you submit an approval. To know more about setting up Approvals, click here.
Follow these steps to send a record for Approval:
- Create a record in any module that matches the entry criteria of an approval process.
- Enter the necessary details
- Click Save.
- You can add a note for the approvers in the Needs Approval window.
- Click Submit for Approvals.
Note: The record sent for approval is locked.You can also attach related documents while sending a record for Approval. This will provide the approver with all the details they need to see to approve without having to log in to the CRM. For example, while sending a quote for approval, you can add cost sheets and other receipts as attachments.
- You can attach up to three documents per approval.
- The file size of each document must not exceed 25MB.
- This enhancement is available in Sales Enterprise and All-in-one Enterprise editions.
Note: - When the destination fields are updated with the source field values via approvals, the CRM account owner’s preferences are applied. The preferences are set up under My Preferences and Calendar Settings.
- Consider this example: If a Deal’s Description field (destination) is updated with the Deal’s Expected Close Date (source) via an Approval, then the date format in the Description field takes the CRM account owner’s format.
Approving or Rejecting a Record
An approver can approve any record in the following ways:
- From Email - When an approval record is sent, you (as an approver) will receive the notification in your email. You can directly approve or reject the record from the email notification.
- From Actions - You will also receive a notification when a record is submitted for approval in the CRM under the Actions module.
- From Related record - You can approve the record from the related record also by clicking the Approve or Reject buttons.
- From the Approval record -
- List View: You can approve or reject a record in the List View of Approvals module. To approve or reject a record, hover over it and click the corresponding icons.
- Summary View: You can also approve a record in the Summary View. You can find the Approve and Reject buttons when you open a particular approval record that has been submitted.
Note: - If there are multiple approvers, the date and time when each approver approved the record will be displayed.
- You can send WhatsApp message notifications to the submitters, mentioning the record approval or rejection.
- You can create a link between Approvals and Workflows if you set conditions on the same field in both of them.
Approvals in Vtiger CRM Mobile App
Vtiger CRM mobile app enables you to approve or reject records that are waiting for approval. The records created from the mobile app are evaluated for any matching approval process and submitted for approval if applicable.
To know more about the features of the Vtiger CRM app, click here.
To download the Vtiger CRM mobile app, click here.
Viewing Approvals
List View
By default, the List view is the screen that is visible when you click on the Approvals module. This view sorts and lists all Approvals based on the last modified approval record.
Follow these steps to view the Approvals in List View:
- Log in to the CRM.
- Click main Menu.
- Click Essentials.
- Go to Collaborations > Approvals. The List View opens.
- View the following columns in the List View:
- Approval Name – Name of the Approval.
- Status – Current status of the Approval record.
- Related To – Module associated with the Approval.
- Assigned Approver – Name of the approver assigned to the record.
- Approval ID – Unique ID of the Approval.
- Approval Level – Current Approval level of the record.
- Use the Search bar to search for specific records or filter by field names, especially useful if you have many approval records
To learn more about List View in Vtiger CRM, click here.
Summary View
Follow these steps to view the Approvals in Summary View: - Log in to the CRM.
- Click main Menu.
- Click Essentials.
- Go to Collaborations > Approvals. The List View opens.
- Click on any approval record. The Summary View opens.
- View the following details in the Summary View:
- Assigned Approver – The person to whom the Approval is currently assigned.
- Status – The current status of the Approval record (e.g., Submitted, Pending, Approved, Rejected).
- Actual Approver – The person who actually approved or rejected the record.
- Approval Level – The current level of Approval in the approval hierarchy.
- Modified Time – The date and time when the Approval record was last updated.
- Requester Note – The message or note provided by the submitter of the Approval request.
- Approver Note – Any notes or comments added by the approver during the Approval process.
- Activity – A log of all actions and updates performed on the approval record.
To learn more about the Summary View in Vtiger CRM, click here.
Limitations
- Workflows and Webhooks adhere to the edition limits.
- Imported records matching the existing approval process is set to Not Submitted status. Actions are restricted on a record in this status.
- Comments on records waiting for approval are not available in the customer self-service portal.
Reference