Edit in GitHubLog an issue
Adobe Commerce only. Learn more

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.

Negotiable quote workflow

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

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.

StatusDescriptionAvailable 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 stateBuyer statusSeller 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.

Negotiable quote status

  • Privacy
  • Terms of Use
  • Do not sell or share my personal information
  • AdChoices
Copyright © 2024 Adobe. All rights reserved.