Initiate a negotiable quote order by seller

This topic describes how a seller can use REST calls to create a negotiable quote for a specific buyer in Draft state, add products to the quote, update quote data such as name and expiration date, and apply a discount.

Prerequisites

• You have installed and enabled B2B for Adobe Commerce.
• You have created a company.
• You have an integration or admin authorization token to make calls on behalf of seller.

Create a negotiable quote

The following example shows the API request workflow for a seller to complete the following tasks:

• Initiate a negotiable quote for a company buyer by creating an empty draft quote
• Update the draft quote to add items and modify the quote name
• Apply a discount to the quote
• Send the quote to the buyer for review

Initiate a negotiable quote

The seller initiates a negotiable quote by creating a quote for a company buyer.

The new quote is empty with a draft_by_admin system state. In the interface, the quote has a Draft status and is visible only to the seller.

Endpoint:

POST <host>/rest/default/V1/negotiableQuote/draft

Headers:

Copy
Content-Type application/json
Authorization Bearer <admin token>
Copied to your clipboard
Content-Type application/json
Authorization Bearer <admin token>

Copy
{
  "customerId": 5
}
Copied to your clipboard
{
  "customerId": 5
}

Copy
`31` // An integer indicating the new quoteId
Copied to your clipboard
`31` // An integer indicating the new quoteId

Update negotiable quote

The seller can now update the quote to add products, and optionally change the negotiable quote name.

Headers:

Copy
Content-Type application/json
Authorization Bearer <admin token>
Copied to your clipboard
Content-Type application/json
Authorization Bearer <admin token>

Endpoint:

PUT /V1/negotiableQuote/31

Copy
{
  "quote": {
    "id": 31,
    "items": [
      {
        "sku": "24-UG02",
        "qty": 1
      },
      {
        "sku": "24-MB01",
        "qty": 100
      }
    ],
    "extension_attributes": {
      "negotiable_quote": {
        "quote_name": "5% for bags"
      }
    }
  }
}
Copied to your clipboard
{
  "quote": {
    "id": 31,
    "items": [
      {
        "sku": "24-UG02",
        "qty": 1
      },
      {
        "sku": "24-MB01",
        "qty": 100
      }
    ],
    "extension_attributes": {
      "negotiable_quote": {
        "quote_name": "5% for bags"
      }
    }
  }
}

Copy
// an empty array
Copied to your clipboard
// an empty array

Adjust the negotiable quote

The seller updates the quote to provide a 5% discount that applies to the entire quote. The negotiated_price_type value of 1 indicates a percentage discount.

Headers:

Copy
Content-Type application/json
Authorization Bearer <admin token>
Copied to your clipboard
Content-Type application/json
Authorization Bearer <admin token>

Endpoint:

PUT /V1/negotiableQuote/31

Copy
{
  "quote": {
      "id": 31,
      "extension_attributes": {
        "negotiable_quote": {
         "negotiated_price_type": 1,
          "negotiated_price_value": 5
        }
      }
    }
}
Copied to your clipboard
{
  "quote": {
      "id": 31,
      "extension_attributes": {
        "negotiable_quote": {
         "negotiated_price_type": 1,
          "negotiated_price_value": 5
        }
      }
    }
}

Copy
// an empty array
Copied to your clipboard
// an empty array

Recalculate prices

Before sending the quote to the buyer, the seller recalculates the prices to reflect the discount.

Headers:

Copy
Content-Type application/json
Authorization Bearer <admin token>
Copied to your clipboard
Content-Type application/json
Authorization Bearer <admin token>

Endpoint:

POST /V1/negotiableQuote/pricesUpdated

Copy
{
  "quoteIds": [31]
}
Copied to your clipboard
{
  "quoteIds": [31]
}

Copy
`true` // indicating the request was successful
Copied to your clipboard
`true` // indicating the request was successful

Send the negotiable quote to the buyer

After completing updates to the quote, the seller can submit the quote to the buyer for review, including any relevant comments. Then, the buyer can either accept the offer and begin the checkout process, or request further negotiations.

This call places the quote in the submitted_by_admin state. In the interface, the buyer quote status is Updated. The seller quote status is Submitted. At this point, the quote is locked and can be updated only by the buyer.

Headers:

Copy
Content-Type application/json
Authorization Bearer <admin token>
Copied to your clipboard
Content-Type application/json
Authorization Bearer <admin token>

Endpoint:

POST /V1/negotiableQuote/submitToCustomer

Copy
{
  "quoteId": 31,
  "comment": "We have provided a 5% discount to your order."
}
Copied to your clipboard
{
  "quoteId": 31,
  "comment": "We have provided a 5% discount to your order."
}

Copy
`true` // indicating the request was successful
Copied to your clipboard
`true` // indicating the request was successful

Related information

• Negotiable quote order
• Order processing tutorial

Last updated 3/27/2024

Was this helpful?

Yes

No