Integrate with the NegotiableQuote module
Negotiable quotes are a mechanism that allows a company user (buyer) and a seller (admin user) to negotiate product and/or shipping prices before the company user places an order. The negotiable quote functionality is available for companies only.
The negotiable quote lifecycle includes a number of stages, as shown in the following diagram.
The quoting process itself can be a continuous process, with a number of repeating cycles until the agreement is reached.
- The buyer creates and submits a negotiable quote
- The seller reviews and modifies or declines the quote
- The buyer reviews the seller's counteroffer
- Upon agreement, the buyer begins the checkout process and the system converts the negotiable quote into an order
A negotiable quote can also be initiated by a seller. In this case, the negotiation lifecycle includes the following stages:
- The seller creates and submits a negotiable quote
- The buyer reviews and modifies the quote, or begins the checkout process
- The seller reviews and modifies or declines the quote
- Upon agreement, the buyer begins the checkout process and the system converts the negotiable quote into an order
You cannot negotiate prices on individual items.
Quote statuses
The quote lifecycle is managed via quote statuses. The quoting interface allows both a seller and a buyer to manage items in the quote (add, delete, change quantity) as well as make an offer (or request a quote) for items and/or for shipping.
The negotiated price set in the negotiable quote is exactly the price that will be applied on a quote during checkout, order generation, and invoice generation.
Status | Description | Available actions to seller |
---|---|---|
Draft | The seller has created an empty quote that is not visible to the buyer. | View, submit, save as draft. Edit the name, expiration date, and item quantity, add or remove product items, enter a proposed price, add comments. |
New | The buyer submitted the quote, but the seller has not opened it yet. The buyer can edit the quote. The system creates a new quote record with its own ID. | View |
Open | The seller has opened the submitted quote and is reviewing/modifying it. The seller can edit the quote, but the buyer cannot. | View, submit, decline, save as draft. Edit the expiration date, item quantity, add/remove product items, enter a proposed price, add shipping method and shipping price, add comments. |
Submitted | The seller has reviewed the quote and has sent it back to buyer. The seller cannot edit the quote. | View |
Client reviewed | The buyer has opened the quote submitted by seller and is modifying it, by changing items or adding a shipping address. The seller cannot edit the quote. | View |
Updated | The buyer has re-submitted the quote to seller. The seller can edit the quote, but the buyer cannot. | View, submit, decline, save as draft. Edit the expiration date, item quantity, add/remove product items, enter a proposed price, add shipping method and shipping price, add comments. |
Ordered | The buyer has purchased the quote, and Adobe Commerce converts the quote to an order. Neither the seller nor the buyer can edit the quote. | View |
Closed | The buyer has cancelled the quote and thus stopped the negotiation process. Neither the seller nor the buyer can edit the quote. The buyer clicks the Close button from the Quote details page. (Not available using Web API) | View |
Declined | The seller has declined the quote. All custom pricing (if any) is removed from the quote. In admin panel, the quote is locked for editing. | View |
Expired | The expiration date has passed on a quote under buyer review. | View |
The following table maps the internal Commerce system state to the statuses displayed on the Storefront and Admin.
System state | Buyer status | Seller status |
---|---|---|
Draft by admin | N/A | Draft |
Created | Submitted | New |
Processing by customer | Open | Client Reviewed |
Processing by admin | Pending | Open |
Submitted by customer | Submitted | Updated |
Submitted by admin | Updated | Submitted |
Ordered | Ordered | Ordered |
Expired | Expired | Expired |
Declined | Declined | Declined |
Closed | Closed | Closed |
The following diagram shows the negotiable quote lifecycle from the perspective of statuses.