placeNegotiableQuoteOrder mutation
The placeNegotiableQuoteOrder
mutation converts a negotiable quote into an order and returns an order ID.
The negotiable quote must have one of the following statuses:
- SUBMITTED
- DECLINED
- EXPIRED
If the status is DECLINED or EXPIRED, the negotiable quote is processed like a standard cart, without applying any discounts. The negotiable quote is not converted to a standard cart.
Perform the following actions before using the placeNegotiableQuoteOrder
mutation. It might be necessary to perform additional steps during the process of coming to an agreement during the negotiable quote lifecycle.
- Create an empty cart
- Add one or more products to the cart
- Request a negotiable quote
- Set the billing address
- Set the shipping address
- Set the shipping method
- Set the payment method
You cannot manage orders with GraphQL, because orders are part of the backend. You can use REST or SOAP calls to manage orders to their completion.
Syntax
1
2
3
4
5
6
7
mutation {
placeNegotiableQuoteOrder(
input: PlaceNegotiableQuoteOrderInput
) {
PlaceNegotiableQuoteOrderOutput
}
}
Example usage
Request:
1
2
3
4
5
6
7
8
9
10
11
mutation {
placeNegotiableQuoteOrder(
input: {
quote_uid: "xCA4wSZEHsb5QbFiKfoq5k1Dk8vIPBgb"
}
) {
order {
order_number
}
}
}
Response:
1
2
3
4
5
6
7
8
9
{
"data": {
"placeNegotiableQuoteOrder": {
"order": {
"order_number": "000000006"
}
}
}
}
Input attributes
The PlaceNegotiableQuoteOrderInput
object must contain the following attribute:
Attribute | Data Type | Description |
---|---|---|
quote_uid |
String! | The unique ID of a NegotiableQuote object |
Output attributes
The placeOrderOutput
object returns an order
object.
Attribute | Data Type | Description |
---|---|---|
order |
Order! | Contains the generated order number |
Order object
Attribute | Data Type | Description |
---|---|---|
order_number |
String | The unique ID that identifies the order |