Skip to main content

CartChildItemBulkInput

Input for child items in bulk cart operations.

Represents component items that belong to a main item in configurable products or bundles. Contains the same fields as the main item input except for child items and cluster ID.

input CartChildItemBulkInput {
  itemId: String
  productId: Int
  price: Float
  quantity: Int
  notes: String
  requestDate: String
  attributes: [AttributeBulkCreateInput!]
}

Fields​

CartChildItemBulkInput.itemId ● String scalar​

Unique identifier of an existing cart item to update or remove.

Must be a valid UUID. Cannot be used together with productId or clusterId. Used for modifying items already in the cart.

CartChildItemBulkInput.productId ● Int scalar​

Product identifier for adding new items to the cart.

Must be a valid product ID from the catalog. Cannot be used with itemId. Used for adding new products to the cart.

CartChildItemBulkInput.price ● Float scalar​

Override price per unit for this cart item.

When specified, replaces the calculated price with this custom value. Primarily used for external pricing systems. Must be a positive number with maximum 5 decimal places.

CartChildItemBulkInput.quantity ● Int scalar​

Number of units to add, update, or maintain in the cart.

Defaults to 1 if not specified. When updating existing items, setting to null will reset quantity to 1. Setting to 0 will remove the item from the cart.

CartChildItemBulkInput.notes ● String scalar​

Additional notes or special instructions for this item.

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

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

CartChildItemBulkInput.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 removes every attribute on this item in one call.

Member Of​

CartItemBulkInput input