Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

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

Configure Quote Management Flow in the Back-Office 

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:

../../../../../../_images/QuoteBackofficeFlow.png

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

../../../../../../_images/InternalStatusesGrid.png
  1. 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

../../../../../../_images/QBW_steps_transitions_table.png

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.

    ../../../../../../_images/Illustration_1.png
  2. The quote with an offer valid until 19 April is sent to a customer.

    ../../../../../../_images/Illustration_2.png

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.

../../../../../../_images/Illustration_3.png

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.

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

../../../../../../_images/Illustration_4.png
  1. 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).

../../../../../../_images/Illustration_5.png