Skip to main content

CartItemBulkInput

Input for bulk cart item operations.

Supports adding, updating, or removing cart items in batch operations. Can target existing items by ID or create new items by product/cluster ID.

input CartItemBulkInput {
  itemId: String
  productId: Int
  clusterId: Int
  price: Float
  quantity: Int
  notes: String
  requestDate: String
  childItems: [CartChildItemBulkInput!]
}

Fields​

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

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

CartItemBulkInput.clusterId ● Int scalar​

Cluster identifier for configurable product groups.

Used when adding items that belong to a product cluster. All child items must be part of the same cluster configuration. Cannot be used with itemId.

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

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

CartItemBulkInput.notes ● String scalar​

Additional notes or special instructions for this item.

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

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

CartItemBulkInput.childItems ● [CartChildItemBulkInput!] list input​

Child items to include with this main item.

Used for configurable products, bundles, or items with components. Each child item must be part of the same cluster configuration as the parent item.

Member Of​

CartItemsBulkUpsertInput input