Skip to main content

CartAddBundleInput

Input for adding a product bundle to a shopping cart.

Contains the information needed to add a pre-configured bundle of products to the cart as a single unit with bundle-specific pricing and configuration.

input CartAddBundleInput {
  quantity: Int = 1
  notes: String
  requestDate: String
  attributes: [AttributeBulkCreateInput!]
  bundleId: String!
}

Fields​

CartAddBundleInput.quantity ● Int scalar​

Number of units to add to the cart.

Must be a positive integer. Defaults to 1 if not specified.

CartAddBundleInput.notes ● String scalar​

Additional notes or special instructions for this item.

Maximum length of 255 characters. HTML tags will be automatically removed for security.

CartAddBundleInput.requestDate ● String scalar​

Preferred delivery date for this specific item.

Must be provided in ISO 8601 date format (YYYY-MM-DD). Used for items that require specific delivery scheduling.

CartAddBundleInput.attributes ● [AttributeBulkCreateInput!] list input​

Custom attributes for this cart item, captured on the item and forwarded to the order item on processing.

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 depends on the operation. On the update path (cartUpdateItem) it removes every attribute on this item in one call. On the add paths (cartAddItem, cartAddBundle) it is a no-op, so re-adding the same product never wipes the attributes already captured on the line.

CartAddBundleInput.bundleId ● String! non-null scalar​

Unique identifier of the bundle to add to the cart.

Must reference a valid bundle configuration that defines the products, quantities, and pricing rules for the bundle.

Member Of​

cartAddBundle mutation