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.

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 

Note

This flow is used when the Quote Management Flow is active.

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

Note

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 

Note

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 

The quote statuses and management steps may differ depending on the active workflow.

Follow the links below for more information on available steps and transitions.