data-src=../../../../../includes/commerce-only.md
requestNegotiableQuote mutation
The requestNegotiableQuote mutation initiates a negotiable quote on behalf of a company user. The company user must add all products to the cart before requesting a negotiable quote. Once the request is submitted, company users cannot add new products to the quote.
If the request is successful, the application assigns the cart ID to the negotiable quote. Therefore, the same cart ID is used throughout the lifecycle of the negotiable quote. The application generates a new cart ID if the company user starts a new order while a negotiable quote is in process. The cart ID must be active. You cannot create a negotiable quote if the quote is cancelled or converted to an order.
If the request is successful, the negotiable quote has the SUBMITTED status.
data-variant=info
data-slots=text
setNegotiableQuoteShippingAddresses mutation to add the address to the standard quote during the negotiable quote process.This mutation requires a valid customer authentication token.
Syntax
requestNegotiableQuote(
input: RequestNegotiableQuoteInput!
): RequestNegotiableQuoteOutput
Reference
The requestNegotiableQuote reference provides detailed information about the types and fields defined in this mutation.
Example usage
The following examples show negotiable quote requests with and without attachments.
Request a negotiable quote
The following example requests a negotiable quote. The cart contains three items.
Request:
mutation {
requestNegotiableQuote (
input: {
cart_id: "kw6mLEvl6vjjPNsjtJqwpamv5o0iT1bc"
quote_name: "Discount request"
comment: {
comment: "Requesting a 10% discount for being a repeat customer."}
}
){
quote {
uid
created_at
status
buyer {
firstname
lastname
}
comments {
uid
created_at
author {
firstname
lastname
}
creator_type
text
}
items {
product {
uid
sku
name
price_range {
maximum_price {
regular_price {
value
}
}
}
}
quantity
}
prices {
subtotal_excluding_tax {
value
}
subtotal_including_tax {
value
}
subtotal_with_discount_excluding_tax {
value
}
grand_total {
value
}
}
}
}
}
Response:
{
"data": {
"requestNegotiableQuote": {
"quote": {
"uid": "kw6mLEvl6vjjPNsjtJqwpamv5o0iT1bc",
"created_at": "2021-04-20 19:01:38",
"status": "SUBMITTED",
"buyer": {
"firstname": "Taina",
"lastname": "Garofalo"
},
"comments": [
{
"uid": "MQ==",
"created_at": "2021-04-20 19:57:49",
"author": {
"firstname": "Taina",
"lastname": "Garofalo"
},
"creator_type": "BUYER",
"text": "Requesting a 10% discount for being a repeat customer."
}
],
"items": [
{
"product": {
"uid": "MTY=",
"sku": "24-UG07",
"name": "Dual Handle Cardio Ball",
"price_range": {
"maximum_price": {
"regular_price": {
"value": 12
}
}
}
},
"quantity": 1
},
{
"product": {
"uid": "NTI=",
"sku": "24-WG080",
"name": "Sprite Yoga Companion Kit",
"price_range": {
"maximum_price": {
"regular_price": {
"value": 77
}
}
}
},
"quantity": 1
},
{
"product": {
"uid": "MTc=",
"sku": "24-UG04",
"name": "Zing Jump Rope",
"price_range": {
"maximum_price": {
"regular_price": {
"value": 12
}
}
}
},
"quantity": 1
}
],
"prices": {
"subtotal_excluding_tax": {
"value": 101
},
"subtotal_including_tax": {
"value": 101
},
"subtotal_with_discount_excluding_tax": {
"value": 101
},
"grand_total": {
"value": 101
}
}
}
}
}
}
Request a negotiable quote with attachments
data-src=../../../../../includes/saas-only.md
The following example requests a negotiable quote with an attachment. The attachment must be uploaded to Amazon S3 before you can reference it in the mutation. See the initiateUpload mutation and finishUpload` mutationfor more information about uploading files.
Request:
mutation {
requestNegotiableQuote(
input: {
cart_id: "SAIanv9ZcoVbQwAFRWq6XzQbU1jK1dUT"
quote_name: "Test NQ"
comment: {
comment: "Please provide your best pricing for these bulk office supplies. We're looking for a long-term partnership."
attachments: [
{
key: "test-document1_32cb1fe50dab390be841461e.txt"
}
]
}
}
) {
quote {
uid
name
status
comments {
text
attachments {
name
url
}
}
}
}
}
Response:
{
"data": {
"requestNegotiableQuote": {
"quote": {
"uid": "SAIanv9ZcoVbQwAFRWq6XzQbU1jK1dUT",
"name": "Test NQ",
"status": "SUBMITTED",
"comments": [
{
"text": "Please provide your best pricing for these bulk office supplies. We're looking for a long-term partnership.",
"attachments": [
{
"name": "test-document1.txt",
"url": "http://bucket1.s3mock:9000/bucket1/tenant1/negotiable_quotes_attachment/test-document1_32cb1fe50dab390be841461e.txt?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20250909%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20250909T170138Z&X-Amz-SignedHeaders=host&X-Amz-Expires=6600&X-Amz-Signature=a4fa238e4f4f88d4819f0b80fe2699ec6374e81cd88e70fd281a7fc8fae232ec"
}
]
}
]
}
}
}
}