quoteDecline

Mutationin Quote

Turn a quote down, which ends the negotiation and makes it unorderable

Arguments

Argument	Type	Description
`id`	`ID!`

Returns

QuoteDeclineResponse!

Field	Type	Description
`quote`	`Quote`	The declined quote, absent when declining failed
`quoteErrors`	`[QuoteDeclineError!]!`	Error details if declining failed

Example

mutation QuoteDecline($id: ID!) {
  quoteDecline(id: $id) {
    quote {
      quoteNumber
      createdAt
      status
      comment
      sellerComment
      purchaseOrderNumber
      validUntil
    }
    quoteErrors {
      __typename
      ... on ValidationError {
        message
      }
      ... on QuoteNotPendingError {
        message
        status
      }
    }
  }
}

{
  "id": "id-1"
}

{
  "data": {
    "quoteDecline": {
      "quote": {
        "quoteNumber": "Example",
        "createdAt": "2026-10-01T09:30:00Z",
        "status": "PENDING",
        "comment": "Example",
        "sellerComment": "Example",
        "purchaseOrderNumber": "Example",
        "validUntil": "2026-10-01T09:30:00Z"
      },
      "quoteErrors": [
        {
          "__typename": "ValidationError",
          "message": "Example"
        }
      ]
    }
  }
}

The query selects the return type's fields two levels deep; pick the ones you need. The response shows its shape with placeholder values.

Served by

@evolve-framework/commercetools	Resolved
@evolve-framework/medusa	Resolved
@evolve-framework/sfcc	Not resolved

Used by

The storefront packages that send it, in these GraphQL documents:

@evolve-storefront/feature-quote: QuoteDecline