Skip to main content

CartChildItemInput

Input for adding child items within a product cluster.

Represents a component item that is part of a configurable product cluster. Contains the same fields as the main item input but excludes cluster-level properties.

input CartChildItemInput {
  quantity: Int = 1
  notes: String
  requestDate: String
  attributes: [AttributeBulkCreateInput!]
  productId: Int!
  price: Float
}

Fields​

CartChildItemInput.quantity ● Int scalar​

Number of units to add to the cart.

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

CartChildItemInput.notes ● String scalar​

Additional notes or special instructions for this item.

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

CartChildItemInput.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.

CartChildItemInput.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.

CartChildItemInput.productId ● Int! non-null scalar​

Unique identifier of the product to add to the cart.

Must reference a valid product that is available for purchase and matches the cart's shop and channel configuration.

CartChildItemInput.price ● Float scalar​

Override price per unit for external pricing systems.

When specified, overrides the calculated price with a custom value. Should only be used when integrating with external pricing systems. Maximum 5 decimal places allowed.

Member Of​

CartAddItemInput input