You are browsing the documentation for version 3.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get the updated information.
See our Release Process documentation for more information on the currently supported and upcoming releases.
Use Quotes Workflows
The quote management procedure depends on the active quote-related workflow. Out of the box, the Oro application supports Simple Quote Management and Quote Management with Approvals.
Simple Quote Management
This flow is used when the Quote Management Flow is active.
Quote Management Flow (QBW) is a system workflow that defines a sequence of steps and transitions that a quote can go through as a deal progresses.
The difference between the simple Quote Management Flow and the one with approval is covered in the Understanding Quote Workflows section.
To reach the workflow:
- Navigate to System > Workflows in the main menu.
- Click Quote Management Flow to open the flow. The following page opens:
Since Quote Management Flow is a system workflow, it cannot be edited or deleted.
On the Quote Management Flow page, you can perform the following actions:
- Deactivate the workflow - click Deactivate to deactivate the workflow.
When the QMF is active, the following statuses are available:
- Internal Statuses are the statuses displayed in OroCommerce to the sales personnel:
- Sent to Customer
- Customer Statuses are the statuses displayed to customers in the storefront:
These statuses cannot be edited or deleted.
Steps and Transitions
The QMF consists of the following steps and transitions:
- Sent to Customer
- For Draft: Edit, Clone, Delete, Send to Customer
- For Sent to Customer: Cancel, Expire, Delete, Create New Quote, Accept, Decline, Declined by Customer
- For Closed: Reopen
- For Deleted: Undelete
Please note that Accepted and Declined transitions for the Sent to Customer step are automatically triggered by the changes of customer statuses and they do not, therefore, take the form of buttons in the interface.
As an illustration, let us go through a sample flow to see the QMF in action:
Once a quote is created, it is automatically moved to the Draft step with the possibility to edit, clone, delete and send the quote to a customer.
The quote with an offer valid until 19 April is sent to a customer.
The quote transitions from Draft state into Sent to Customer. Now it is possible to cancel, expire, delete, create a quote, or mark it as declined by customer.
If a customer generates an order based on the quote, you can leave the quote in the Sent to Customer state so that customer user could reuse it for future orders, or expire it to disable orders based on this quote.
- The customer provided no feedback on the quote before 19 April, and the quote is expired by the sales personnel, leaving it in the Closed step.
- The offer has been reconsidered and validation date was extended until 21 April. The quote is reopened. It is moved back to the draft step with the possibility to edit, clone, delete and send the quote to a customer. The quote number is changed (in our case, from 21 to 22).
See more information about the simple quote management via the Quote Management Flow. You will learn additional details on the steps and actions available at every step.
Quote Management with Approvals
This flows activates when the Backoffice Quote Flow with Approvals is enabled.
Read more in Quote Management with Approvals via the Backoffice Quote Flow with Approvals. You will learn additional details on the steps and actions available at every step.
Workflow-Specific Statuses and Steps
Depending on the active workflow, the quote statuses and management steps may differ.
Follow the links below for more information on available steps and transitions.
- Simple quote management (workflow-based)
- Quote management with approvals (workflow-based)
- Basic quote lifecycle management actions are used when quote-related workflows are disabled.