Skip to main content

CartUpdateInput

Input for updating cart configuration and metadata.

Allows modification of cart settings including payment and shipping preferences, notes, language, and custom reference fields.

input CartUpdateInput {
  paymentData: CartPaymentDataInput
  postageData: CartPostageDataInput
  notes: String
  language: String
  reference: String
  shared: CartSharedAccess
  extra3: String
  extra4: String
  attributes: [AttributeBulkCreateInput!]
}

Fields​

CartUpdateInput.paymentData ● CartPaymentDataInput input​

Payment configuration updates for the cart.

Contains payment method selection, status updates, and external pricing overrides.

CartUpdateInput.postageData ● CartPostageDataInput input​

Shipping and delivery configuration updates for the cart.

Contains shipping method selection, delivery preferences, and external pricing overrides.

CartUpdateInput.notes ● String scalar​

General notes or comments for the cart.

Maximum length of 255 characters. Free-form text for cart-level notes, special instructions, or internal comments.

CartUpdateInput.language ● String scalar​

Language preference for the cart.

Two-character ISO 639-1 language code (e.g., 'en', 'nl', 'de') that determines the language for cart content and communications.

CartUpdateInput.reference ● String scalar​

External reference identifier for the cart.

Custom reference code or identifier that can be used to link the cart to external systems or customer references.

CartUpdateInput.shared ● CartSharedAccess enum​

Shared access level for the cart.

Controls whether other contacts of the same company can access this cart, and what they may do with it. Changing this value requires OWNABLE access (owner-only unless the cart is already OWNABLE).

CartUpdateInput.extra3 ● String scalar​

Additional custom information field for the cart.

Free-form text field that can store custom data or metadata that will be preserved through cart processing and order creation.

CartUpdateInput.extra4 ● String scalar​

Additional custom information field for the cart.

Free-form text field that can store custom data or metadata that will be preserved through cart processing and order creation.

CartUpdateInput.attributes ● [AttributeBulkCreateInput!] list input​

Custom attributes for the order, merged into the set captured at cart start.

Additive: attributes you do not mention are always kept. An entry whose description is already stored overwrites its value; a new description is appended. To remove a single attribute, send it with a null value. An omitted array changes nothing; an EMPTY array removes every order-level attribute in one call.

Either identifier addresses the same attribute: an entry sent with attributeDescriptionName is resolved to its description before it is stored, so it updates or removes the entry a previous attributeDescriptionId write created, and vice versa. Both identifiers come back on every read regardless of which one you sent.

Caveat: resolving the identifier you did not send is best-effort, and is briefly unavailable during an attribute-description outage. The write still succeeds, but such an entry is stored carrying only the identifier you sent; until a later write resolves it, a differently-addressed write cannot reach it and removals for it are not synced when the order is processed. An empty array carries no identifiers and is therefore always safe to clear with.

Member Of​

cartUpdate mutation