Menu
updateMyQuote
Update an existing quote for the signed-in customer — pass its current version and an array of update actions.
Use it in a workflow
- Add a step and choose the Commercetools connector.
- Pick the updateMyQuote action (under Update).
- Fill in the fields below, then reference the result from later steps as
{{updatemyquote.response.data}}.
Query
This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.
mutation UpdateMyQuote($version: Long!, $actions: [MyQuoteUpdateAction!]!, $id: String, $key: String) {
updateMyQuote(version: $version, actions: $actions, id: $id, key: $key) {
customerRef {
typeId
id
}
customer {
id
customerNumber
email
addresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
defaultShippingAddressId
defaultBillingAddressId
shippingAddressIds
billingAddressIds
isEmailVerified
customerGroupRef {
typeId
id
}
externalId
key
authenticationMode
firstName
lastName
middleName
title
locale
salutation
dateOfBirth
companyName
vatId
password
customerGroup {
id
version
name
key
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
defaultShippingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
defaultBillingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
shippingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
billingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
storesRef {
typeId
key
}
stores {
id
version
key
nameAllLocales
languages
countries
productSelections
distributionChannelsRef
distributionChannels
supplyChannelsRef
supplyChannels
storefront
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
customerGroupAssignments {
customerGroupRef
customerGroup
}
custom {
typeRef
type
}
version
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
customerGroupRef {
typeId
id
}
customerGroup {
id
version
name
key
createdAt
lastModifiedAt
custom {
typeRef
type
}
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
customLineItems {
id
key
nameAllLocales {
locale
value
}
money {
type
currencyCode
centAmount
fractionDigits
}
totalPrice {
type
currencyCode
centAmount
fractionDigits
}
slug
quantity
state {
quantity
stateRef
state
}
taxCategory {
name
description
rates
key
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
taxCategoryRef {
typeId
id
}
taxRate {
name
amount
includedInPrice
country
state
id
key
subRates
}
taxedPrice {
totalNet
totalGross
taxPortions
totalTax
}
taxedPricePortions {
shippingMethodKey
taxedPrice
}
perMethodTaxRate {
shippingMethodKey
taxRate
}
discountedPricePerQuantity {
quantity
discountedPrice
}
custom {
typeRef
type
}
shippingDetails {
targets
valid
}
priceMode
recurrenceInfo {
recurrencePolicy
recurrencePolicyRef
expiresAt
}
}
totalPrice {
type
currencyCode
centAmount
fractionDigits
}
taxedPrice {
totalNet {
type
currencyCode
centAmount
fractionDigits
}
totalGross {
type
currencyCode
centAmount
fractionDigits
}
taxPortions {
rate
amount
name
}
totalTax {
type
currencyCode
centAmount
fractionDigits
}
}
shippingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom {
typeRef
type
}
}
billingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom {
typeRef
type
}
}
itemShippingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom {
typeRef
type
}
}
inventoryMode
taxMode
priceRoundingMode
taxRoundingMode
taxCalculationMode
country
shippingInfo {
shippingMethodName
price {
type
currencyCode
centAmount
fractionDigits
}
shippingRate {
price
freeAbove
isMatching
tiers
}
taxRate {
name
amount
includedInPrice
country
state
id
key
subRates
}
deliveries {
id
key
createdAt
items
parcels
address
custom
}
discountedPrice {
value
includedDiscounts
}
shippingMethodState
estimatedDelivery {
from
until
}
shippingMethod {
name
zoneRates
active
isDefault
predicate
key
carrier
taxCategoryRef
localizedDescriptionAllLocales
localizedNameAllLocales
storesRef
stores
taxCategory
custom
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
shippingMethodRef {
typeId
id
}
taxCategory {
name
description
rates
key
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
taxCategoryRef {
typeId
id
}
taxedPrice {
totalNet
totalGross
taxPortions
totalTax
}
}
paymentInfo {
payments {
key
customerRef
customer
anonymousId
interfaceId
amountPlanned
paymentMethodInfo
paymentStatus
transactions
custom
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
paymentRefs {
typeId
id
}
}
directDiscounts {
id
value {
type
}
target {
type
}
}
shippingRateInput {
type
}
storeRef {
typeId
key
}
store {
id
version
key
nameAllLocales {
locale
value
}
languages
countries {
code
}
productSelections {
productSelectionRef
productSelection
active
}
distributionChannelsRef {
typeId
id
}
distributionChannels {
id
version
key
roles
nameAllLocales
descriptionAllLocales
address
geoLocation
createdAt
lastModifiedAt
reviewRatingStatistics
custom
createdBy
lastModifiedBy
}
supplyChannelsRef {
typeId
id
}
supplyChannels {
id
version
key
roles
nameAllLocales
descriptionAllLocales
address
geoLocation
createdAt
lastModifiedAt
reviewRatingStatistics
custom
createdBy
lastModifiedBy
}
storefront {
checkoutUrlTemplate
orderUrlTemplate
termsOfServiceUrl
privacyPolicyUrl
refundPolicyUrl
shippingPolicyUrl
cookiePolicyUrl
imprintUrl
faqUrl
contactUrl
}
createdAt
lastModifiedAt
custom {
typeRef
type
}
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
businessUnit {
id
key
name
contactEmail
addresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
defaultShippingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
defaultBillingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
defaultShippingAddressId
defaultBillingAddressId
shippingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
billingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
shippingAddressIds
billingAddressIds
status
storesRef {
typeId
key
}
stores {
id
version
key
nameAllLocales
languages
countries
productSelections
distributionChannelsRef
distributionChannels
supplyChannelsRef
supplyChannels
storefront
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
storeMode
unitType
associates {
associateRoleAssignments
customerRef
customer
}
associateMode
inheritedAssociates {
associateRoleAssignments
customerRef
customer
}
custom {
typeRef
type
}
parentUnitRef {
typeId
key
}
parentUnit
ancestors
inheritedStores {
store
storeRef
}
topLevelUnitRef {
typeId
key
}
topLevelUnit
approvalRuleMode
customerGroupAssignments {
customerGroupRef
customerGroup
}
version
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
businessUnitRef {
typeId
key
}
key
quoteState
stagedQuoteRef {
typeId
id
}
stagedQuote {
key
stagedQuoteState
quoteRequestRef {
typeId
id
}
quoteRequest {
customerRef
customer
customerGroupRef
customerGroup
customLineItems
totalPrice
taxedPrice
shippingAddress
billingAddress
itemShippingAddresses
inventoryMode
taxMode
priceRoundingMode
taxRoundingMode
taxCalculationMode
country
shippingInfo
paymentInfo
directDiscounts
shippingRateInput
storeRef
store
businessUnit
businessUnitRef
key
quoteRequestState
comment
custom
stateRef
state
purchaseOrderNumber
cartRef
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
quotationCartRef {
typeId
id
}
quotationCart {
customerId
customer
customerEmail
anonymousId
customLineItems
totalPrice
taxedPrice
discountOnTotalPrice
shippingAddress
billingAddress
inventoryMode
taxMode
priceRoundingMode
taxRoundingMode
taxCalculationMode
customerGroup
customerGroupRef
country
shippingKey
shippingInfo
discountCodes
directDiscounts
refusedGifts
refusedGiftsRefs
paymentInfo
locale
shippingRateInput
origin
storeRef
store
itemShippingAddresses
businessUnit
businessUnitRef
shipping
taxedShippingPrice
shippingMode
shippingCustomFields
placement
discountTypeCombination
cartState
key
purchaseOrderNumber
lock
custom
deleteDaysAfterLastModification
totalLineItemQuantity
recurringPaymentConfiguration
freezeStrategy
warnings
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
customerRef {
typeId
id
}
customer {
id
customerNumber
email
addresses
defaultShippingAddressId
defaultBillingAddressId
shippingAddressIds
billingAddressIds
isEmailVerified
customerGroupRef
externalId
key
authenticationMode
firstName
lastName
middleName
title
locale
salutation
dateOfBirth
companyName
vatId
password
customerGroup
defaultShippingAddress
defaultBillingAddress
shippingAddresses
billingAddresses
storesRef
stores
customerGroupAssignments
custom
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
validTo
custom {
typeRef
type
}
stateRef {
typeId
id
}
state {
id
version
key
type
roles
nameAllLocales
descriptionAllLocales
builtIn
transitionsRef
transitions
initial
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
sellerComment
businessUnit {
id
key
name
contactEmail
addresses
defaultShippingAddress
defaultBillingAddress
defaultShippingAddressId
defaultBillingAddressId
shippingAddresses
billingAddresses
shippingAddressIds
billingAddressIds
status
storesRef
stores
storeMode
unitType
associates
associateMode
inheritedAssociates
custom
parentUnitRef
parentUnit
ancestors
inheritedStores
topLevelUnitRef
topLevelUnit
approvalRuleMode
customerGroupAssignments
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
businessUnitRef {
typeId
key
}
purchaseOrderNumber
storeRef {
typeId
key
}
store {
id
version
key
nameAllLocales
languages
countries
productSelections
distributionChannelsRef
distributionChannels
supplyChannelsRef
supplyChannels
storefront
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
id
version
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
quoteRequestRef {
typeId
id
}
quoteRequest {
customerRef {
typeId
id
}
customer {
id
customerNumber
email
addresses
defaultShippingAddressId
defaultBillingAddressId
shippingAddressIds
billingAddressIds
isEmailVerified
customerGroupRef
externalId
key
authenticationMode
firstName
lastName
middleName
title
locale
salutation
dateOfBirth
companyName
vatId
password
customerGroup
defaultShippingAddress
defaultBillingAddress
shippingAddresses
billingAddresses
storesRef
stores
customerGroupAssignments
custom
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
customerGroupRef {
typeId
id
}
customerGroup {
id
version
name
key
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
customLineItems {
id
key
nameAllLocales
money
totalPrice
slug
quantity
state
taxCategory
taxCategoryRef
taxRate
taxedPrice
taxedPricePortions
perMethodTaxRate
discountedPricePerQuantity
custom
shippingDetails
priceMode
recurrenceInfo
}
totalPrice {
type
currencyCode
centAmount
fractionDigits
}
taxedPrice {
totalNet
totalGross
taxPortions
totalTax
}
shippingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
billingAddress {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
itemShippingAddresses {
id
streetName
streetNumber
additionalStreetInfo
postalCode
city
region
state
country
company
department
building
apartment
pOBox
additionalAddressInfo
externalId
key
phone
mobile
email
fax
title
salutation
firstName
lastName
custom
}
inventoryMode
taxMode
priceRoundingMode
taxRoundingMode
taxCalculationMode
country
shippingInfo {
shippingMethodName
price
shippingRate
taxRate
deliveries
discountedPrice
shippingMethodState
estimatedDelivery
shippingMethod
shippingMethodRef
taxCategory
taxCategoryRef
taxedPrice
}
paymentInfo {
payments
paymentRefs
}
directDiscounts {
id
value
target
}
shippingRateInput {
type
}
storeRef {
typeId
key
}
store {
id
version
key
nameAllLocales
languages
countries
productSelections
distributionChannelsRef
distributionChannels
supplyChannelsRef
supplyChannels
storefront
createdAt
lastModifiedAt
custom
createdBy
lastModifiedBy
}
businessUnit {
id
key
name
contactEmail
addresses
defaultShippingAddress
defaultBillingAddress
defaultShippingAddressId
defaultBillingAddressId
shippingAddresses
billingAddresses
shippingAddressIds
billingAddressIds
status
storesRef
stores
storeMode
unitType
associates
associateMode
inheritedAssociates
custom
parentUnitRef
parentUnit
ancestors
inheritedStores
topLevelUnitRef
topLevelUnit
approvalRuleMode
customerGroupAssignments
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
businessUnitRef {
typeId
key
}
key
quoteRequestState
comment
custom {
typeRef
type
}
stateRef {
typeId
id
}
state {
id
version
key
type
roles
nameAllLocales
descriptionAllLocales
builtIn
transitionsRef
transitions
initial
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
purchaseOrderNumber
cartRef {
typeId
id
}
id
version
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
validTo
sellerComment
buyerComment
custom {
typeRef {
typeId
id
}
type {
key
nameAllLocales
descriptionAllLocales
resourceTypeIds
id
version
createdAt
lastModifiedAt
createdBy
lastModifiedBy
}
}
stateRef {
typeId
id
}
state {
id
version
key
type
roles
nameAllLocales {
locale
value
}
descriptionAllLocales {
locale
value
}
builtIn
transitionsRef {
typeId
id
}
transitions
initial
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef
userRef
associateRef
attributedTo
}
}
purchaseOrderNumber
id
version
createdAt
lastModifiedAt
createdBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef {
typeId
id
}
userRef {
typeId
id
}
associateRef {
typeId
id
}
attributedTo {
clientId
source
userRef
}
}
lastModifiedBy {
isPlatformClient
clientId
externalUserId
anonymousId
customerRef {
typeId
id
}
userRef {
typeId
id
}
associateRef {
typeId
id
}
attributedTo {
clientId
source
userRef
}
}
}
}
Variables
Pass these as a JSON object in the step's Variables field.
{
"version": "string",
"actions": [
{
"changeMyQuoteState": {
"quoteState": "string"
},
"requestQuoteRenegotiation": {
"buyerComment": "string"
},
"setCustomField": {
"name": "string",
"value": "string"
},
"setCustomType": {
"fields": "string",
"type": "string",
"typeKey": "string",
"typeId": "string"
}
}
],
"id": "string",
"key": "string"
}
Response
Read the result with {{updatemyquote.response.data.data.updateMyQuote}}. If the API returns errors, the step fails and they are at {{updatemyquote.response.data.errors}}.
Need more? See the Commercetools guide for connection setup and behaviour shared by every action.
Was this page helpful?