Important

You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Quote Management Flow

Overview

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.

Note

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:

1. Navigate to System > Workflows in the main menu.
2. Click Quote Management Flow to open the flow. The following page opens:

Note

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.

Statuses

When the QMF is active, the following statuses are available:

1. Internal Statuses are the statuses displayed in OroCommerce to the sales personnel:
   1. Draft
   2. Sent to Customer
   3. Expired
   4. Accepted
   5. Declined
   6. Deleted
   7. Cancelled

2. Customer Statuses are the statuses displayed to customers in the storefront:
   1. Open
   2. Expired
   3. Accepted
   4. Declined

Note

These statuses cannot be edited or deleted.

Steps and Transitions

The QMF consists of the following steps and transitions:

1. Steps:
   1. Draft
   2. Sent to Customer
   3. Closed
   4. Deleted
2. Transitions:
   1. For Draft: Edit, Clone, Delete, Send to Customer
   2. For Sent to Customer: Cancel, Expire, Delete, Create New Quote, Accept, Decline, Declined by Customer
   3. For Closed: Reopen
   4. For Deleted: Undelete

Note

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.

Sample Flow

As an illustration, let us go through a sample flow to see the QMF in action:

1. 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.

   

2. 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.

Note

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.

3. 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.

4. 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 22 to 23).