closeNegotiableQuotes mutation

The closeNegotiableQuotes mutation closes an active negotiable quote. Once a quote is closed, it cannot be re-opened. Closed negotiable quotes can be viewed by the merchant and company users.

This mutation requires a valid customer authentication token.

Syntax

1
2
3
    closeNegotiableQuotes(
        input: CloseNegotiableQuotesInput!
    ): CloseNegotiableQuotesOutput

Example usage

The following example closes the specified negotiable quote. The response includes a list of all the company negotiable quotes.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
mutation{
  closeNegotiableQuotes(input: {quote_uids: ["FYGOCooAxSJnMdxI9v0cMI5EBaTPtwrr"]} ){
    closed_quotes {
      uid
      name
      status
    }
    negotiable_quotes {
      total_count
      items {
        uid
        name
        status
      }
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "data": {
    "closeNegotiableQuotes": {
      "closed_quotes": [
        {
          "uid": "FYGOCooAxSJnMdxI9v0cMI5EBaTPtwrr",
          "name": "New request",
          "status": "SUBMITTED"
        }
      ],
      "negotiable_quotes": {
        "total_count": 3,
        "items": [
          {
            "uid": "kw6mLEvl6vjjPNsjtJqwpamv5o0iT1bc",
            "name": "Discount request",
            "status": "ORDERED"
          },
          {
            "uid": "xCA4wSZEHsb5QbFiKfoq5k1Dk8vIPBgb",
            "name": "April 22 request",
            "status": "SUBMITTED"
          },
          {
            "uid": "FYGOCooAxSJnMdxI9v0cMI5EBaTPtwrr",
            "name": "New request",
            "status": "CLOSED"
          }
        ]
      }
    }
  }
}

Input attributes

The CloseNegotiableQuotesInput object contains the following attribute.

Output attributes

The CloseNegotiableQuotesOutput output object contains the following attribute.

The negotiable_quotes attribute takes the following arguments.

NegotiableQuoteFilterInput attributes

The NegotiableQuoteFilterInput object defines the filter to use to return a list of negotiable quotes.

FilterEqualTypeInput attributes

Use the FilterEqualTypeInput object to construct a filter that returns values that are equal to the specified string or are in an array of values.

FilterMatchTypeInput attributes

Use the FilterMatchTypeInput object to construct a filter that returns products that exactly match a string or contain the specified pattern.

NegotiableQuoteSortInput attributes

NegotiableQuote attributes

The NegotiableQuote object contains details of a negotiable quote, including its status, contents, and history.

NegotiableQuoteComment attributes

The NegotiableQuoteComment object contains details about a single comment made by the seller or the buyer.

NegotiableQuoteCustomLogChange attributes

The NegotiableQuoteCustomLogChange object contains changes to a negotiable quote that were made by a third-party extension.

NegotiableQuoteHistoryChanges attributes

The NegotiableQuoteHistoryChanges object contains details about a single change in the history of a negotiable quote.

NegotiableQuoteHistoryCommentChange attributes

The NegotiableQuoteHistoryCommentChange object contains a plain-text comment.

NegotiableQuoteHistoryEntry attributes

The NegotiableQuoteHistoryEntry object contains details about a change to a negotiable quote, including all previous changes made at that point.

NegotiableQuoteHistoryExpirationChange attributes

The NegotiableQuoteHistoryExpirationChange object lists the current expiration date of the negotiable quote, and the previous expiration date, if applicable.

NegotiableQuoteHistoryProductsRemovedChange attributes

The NegotiableQuoteHistoryProductsRemovedChange object provides details about products removed from a negotiable quote because of an action by a buyer or seller, or because the item was removed from the catalog.

NegotiableQuoteHistoryStatusChange attributes

The NegotiableQuoteHistoryStatusChange object returns the status changes during the quote’s life cycle.

NegotiableQuoteHistoryStatusesChange attributes

The NegotiableQuoteHistoryStatusesChange object contains an array of all previous modifications to the negotiable quote.

NegotiableQuoteHistoryTotalChange attributes

The NegotiableQuoteHistoryTotalChange object contains the new total price of a negotiable quote after some change has been applied.

NegotiableQuoteUser attributes

The NegotiableQuoteUser contains the first and last name of a buyer or seller.