---
title: "Update Cart Items"
method: PUT
path: "/commerce/carts/current/bulkitems"
tags: ["Cart"]
---

# Update Cart Items

`PUT /commerce/carts/current/bulkitems`

Updates multiple cart items in the cart of the current shopper.

## Query parameters

- `throwErrorOnInvalidItems` boolean
- `zipCode` string
- `removeInvalidItems` boolean
- `responseFields` string

## Request body

- CommerceRuntimeCartItem[]
  - `adjustedLineItemSubtotal` number, double, nullable — Order Level taxable sub total
  - `auditInfo` CoreApiContractsAuditInfo
    - `createBy` string, nullable
    - `createDate` string, date-time, nullable
    - `updateBy` string, nullable
    - `updateDate` string, date-time, nullable
  - `autoAddDiscountId` integer, nullable — Track the discoutid from which the item was auto added
  - `childItemIds` string[], nullable — List of Child Item Ids for this order item
  - `data` object, nullable — Custom data for a given vendor set within the commerce process.
  - `discountTotal` number, double, nullable — How much the shopper saves with the applied discount or sale price. This is a negative number.
  - `discountedTotal` number, double, nullable — Subtotal minus any discounts.
  - `dutyAmount` number, double, nullable — Indicate Duty Amount for this item.
  - `extendedTotal` number, double, nullable — Line item extended total (quantity multiplied by unit extended price) before discounts.
  - `feeTotal` number, double, nullable — Not implemented. Total cost of fees that apply to this item.
  - `fulfillmentLocationCode` string, nullable — Location code from which to obtain this item
  - `fulfillmentMethod` string, nullable — Fulfillment method used to fulfill this item
  - `handlingAmount` number, double, nullable — Product-level handling fee for this item (e.g. special packaging, hazmat fees). This does NOT include order-level handling fees — those are in Mozu.CommerceRuntime.Contracts.Commerce.CommerceItem.WeightedOrderHandlingFee. Total handling on the shipment = HandlingAmount + WeightedOrderHandlingFee.
  - `id` string, nullable — Unique identifier of the item in the cart.
  - `inventoryTags` InventoryTags[], nullable
    - `name` string, nullable
    - `value` string, nullable
  - `isAssemblyRequired` boolean — Assembly Required for this order item
  - `isRecurring` boolean, nullable — If true, the cart item lists a product that can be purchased or fulfilled at regular intervals, for example, monthly billing or a subscription.
  - `isTaxable` boolean, nullable — Not implemented. If true, the cart item is eligible for tax.
  - `itemTaxTotal` number, double, nullable — Total price of taxes that apply to products in this item.
  - `lineId` integer, nullable — The line id assigned to the order item. Visible only in the Admin, this is set from the Admin or in CommerceRuntime when a cart is converted to an order.
  - `lineItemAdjustment` number, double, nullable
  - `localeCode` string, nullable — Locale code for language that appears in text and descriptions on the site, for example, en_US. This is not the currency code. Currently only en_US is supported.
  - `parentItemId` string, nullable — Indicates Parent Item Id for this order item
  - `priceMode` string, nullable — Determines if the item is using external or internal(catalog) pricing
  - `product` CommerceRuntimeProduct — The product as it appears on the order item.
    - `allocationExpiration` string, date-time, nullable — Allocation ID associated with this product on this order.
    - `allocationId` integer, nullable — Allocation ID associated with this product on this order.
    - `bundledProducts` CommerceRuntimeBundledProduct[], nullable — Products bundled with this product (if the current product is a bundle)
      - `allocationExpiration` string, date-time, nullable — Allocation ID associated with this product on this order.
      - `allocationId` integer, nullable — Allocation ID associated with this product on this order.
      - `creditValue` number, double, nullable — Credit value. Only populated if the bundled product is a gift card or digital credit
      - `deltaPrice` number, double, nullable — Only populated for extras
      - `description` string, nullable — Short description of the product in the language specified by LocaleCode.
      - `fulfillmentStatus` string, nullable — Fulfillment status of the product.
      - `goodsType` string, nullable — Goods Type
      - `imageUrl` string, nullable — ImageUrl of product
      - `isPackagedStandAlone` boolean — Indicates that this product ships by itself.
      - `measurements` CommerceRuntimePackageMeasurements — Physical dimensions of the package required to ship the product and its weight.
        - `height` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `length` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `weight` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `width` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
      - `name` string, nullable — Name of the product, this is the current value of the product's name in the language specified by LocaleCode.
      - `optionAttributeFQN` string, nullable — Fully Qualified Name of the selected option's attribute
      - `optionValue` unknown
      - `productCode` string, nullable — Merchant-created code that uniquely identifies the product.
      - `productReservationId` integer, nullable — Reservation ID associated with this product in the bundle.
      - `quantity` integer — Quantity of the product included in the bundle.
      - `stock` ProductStock
        - `aggregateInventory` integer, nullable
        - `availableDate` string, date-time, nullable
        - `availableFutureInventories` integer
        - `futureInventories` CommerceRuntimeFutureInventory[], nullable
          - `allocated` integer, nullable
          - `available` integer, nullable
          - `createDate` string, date-time, nullable
          - `deliveryDate` string, date-time, nullable
          - `futureInventoryID` integer, nullable
          - `onhand` integer, nullable
          - `pending` integer, nullable
        - `isOnBackOrder` boolean
        - `isSubstitutable` boolean, nullable
        - `manageStock` boolean
        - `stockAvailable` integer, nullable
        - `totalAvailableStock` integer
    - `categories` CommerceRuntimeCategory[], nullable — Categories to which this product belongs.
      - `id` integer, nullable — Unique identifier of the category. System-supplied and read-only.
      - `parent` object
    - `condition` string, nullable — Condition
    - `description` string, nullable — Short description of the product in the language specified by LocaleCode.
    - `discountsRestricted` boolean, nullable — Is the product discount restricted
    - `discountsRestrictedEndDate` string, date-time, nullable — Product discount restriction end date
    - `discountsRestrictedStartDate` string, date-time, nullable — Product discount restriction start date
    - `fulfillmentFields` CommerceRuntimeFulfillmentField[], nullable — List of unique product identifiers for an item on shipment
      - `name` string, nullable
      - `required` boolean
      - `userEnteredValue` unknown
    - `fulfillmentStatus` string, nullable — Fulfillment status of the product.
    - `fulfillmentTypesSupported` string[], nullable — Types of fulfillment that are supported for this product.
    - `goodsType` string, nullable — Goods Type
    - `imageAlternateText` string, nullable — Descriptive text of the image associated with the product in the language specified by LocaleCode.
    - `imageUrl` string, nullable — URL of the image that appears next to the product on the order item. Optional.
    - `isPackagedStandAlone` boolean — Indicates that this product ships by itself.
    - `isRecurring` boolean, nullable — If true, the product is purchased or fulfilled at regular intervals, for example, a monthly billing or a subscription.
    - `isTaxable` boolean, nullable — If true, the product is eligible for tax.
    - `measurements` CommerceRuntimePackageMeasurements — Physical dimensions of the package required to ship the product and its weight.
      - `height` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `length` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `weight` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `width` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
    - `mfgPartNumber` string, nullable — Manufacturing Part Number of the product.
    - `name` string, nullable — Name of the product, this is the current value of the product's name in the language specified by LocaleCode.
    - `options` CommerceRuntimeProductOption[], nullable — If the product contains configurable or stand-alone options, the list of product options that the shopper selected for this product.
      - `attributeFQN` string, nullable — Value of the product option.
      - `dataType` string, nullable — Value of the product option.
      - `name` string, nullable — Name of the product option that appears with the order item in the language specified by LocaleCode.
      - `shopperEnteredValue` unknown
      - `stringValue` string, nullable — Value of the product option.
      - `value` unknown
    - `price` CommerceRuntimeProductPrice — Price of the product with any sale and discounts applied.
      - `creditValue` number, double, nullable — Credit Value when the product happens to be a gift card or similar product
      - `isOverRidePriceSalePrice` boolean, nullable — Indicate that External Price (TenantOverridePrice) is a Sale Price. And is used to calculate the line item discounts.
      - `msrp` number, double, nullable — MSRP of product.
      - `price` number, double, nullable — Price of the product. This is the price that the merchant intends to sell the product if no sale price is present.
      - `priceListCode` string, nullable — Pricelist code for the product
      - `priceListEntryMode` string, nullable — Pricelist entry mode of the product. Note: possible values are below 1. null : Product doesn't participate in pricelist 2. Bulk : Bulk volume price available(unit price vary based on quantity) 3. Simple:
      - `salePrice` number, double, nullable — Current sale price of the product, which is a specific numerical amount (not a percentage off).
      - `tenantOverridePrice` number, double, nullable — An override price applied on the product by the tenant.
    - `productCode` string, nullable — Merchant-created code that uniquely identifies the product.
    - `productReservationId` integer, nullable — Reservation ID associated with this product in the bundle.
    - `productType` string, nullable — Type of product, which can be a product with configurable options, a product with stand-alone options, or a simple product with no options.
    - `productUsage` string, nullable — Usage of the product, primarily used to indicate a bundle in this context
    - `properties` CommerceRuntimeProductProperty[], nullable — If the product contains properties, the list of properties that the shopper selected for this product.
      - `attributeFQN` string, nullable
      - `dataType` string, nullable
      - `isMultiValue` boolean
      - `name` string, nullable
      - `values` CommerceRuntimeProductPropertyValue[], nullable
        - `stringValue` string, nullable
        - `value` unknown
    - `serialNumber` string, nullable — Serial Number
    - `sku` string, nullable — Product Identifier specific to the store
    - `stock` ProductStock
      - `aggregateInventory` integer, nullable
      - `availableDate` string, date-time, nullable
      - `availableFutureInventories` integer
      - `futureInventories` CommerceRuntimeFutureInventory[], nullable
        - `allocated` integer, nullable
        - `available` integer, nullable
        - `createDate` string, date-time, nullable
        - `deliveryDate` string, date-time, nullable
        - `futureInventoryID` integer, nullable
        - `onhand` integer, nullable
        - `pending` integer, nullable
      - `isOnBackOrder` boolean
      - `isSubstitutable` boolean, nullable
      - `manageStock` boolean
      - `stockAvailable` integer, nullable
      - `totalAvailableStock` integer
    - `upc` string, nullable — Universal Product Code of the product.
    - `variationProductCode` string, nullable — For configurable products, the unique identifier of the product variation that has been selected.
  - `productDiscount` CommerceRuntimeAppliedLineItemProductDiscount
    - `appliesToSalePrice` boolean, nullable — Determines if the discount applies to the sale price of the order
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
  - `productDiscounts` CommerceRuntimeAppliedLineItemProductDiscount[], nullable — A list of discounts applied to the product
    - `appliesToSalePrice` boolean, nullable — Determines if the discount applies to the sale price of the order
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
  - `purchaseLocation` string, nullable — The location where the product is being purchased.. default is null. Products can have different prices by purchaseLocation via custom priceListResolution...
  - `quantity` integer — Number of products ordered.
  - `shippingAmountBeforeDiscountsAndAdjustments` number, double, nullable — Shipping amount before Discounts and adjustments
  - `shippingDiscounts` CommerceRuntimeAppliedLineItemShippingDiscount[], nullable — A discount applied to the shipping
    - `discount` CommerceRuntimeAppliedDiscount — Discount applied to the order, which is a negative number to be subtracted from the original price to get the final price. If multiple discounts for the order exist, this is the value most advantageous to the shopper.
      - `couponCode` string, nullable — Code of the coupon associated with the discount if a coupon code is required to get the discount.
      - `data` object, nullable — Stores any custom data sent from external discounts.
      - `discount` CommerceRuntimeDiscount — Discounts that apply to the order, if any. For example, when the subtotal of the order exceeds a certain amount, or for free shipping.
        - `expirationDate` string, date-time, nullable — Date when the discount expires. Default is null (no expiration date).
        - `hasMultipleTargetProducts` boolean — Indicates that the discount targets more than a product. Used primarily for BoGa discounts with multiple targets.
        - `id` integer — Unique identifier of the discount.
        - `itemIds` string[], nullable — List of discounts for each order item.
        - `name` string, nullable — Name of the discount in the language specified by LocaleCode.
      - `excluded` boolean, nullable — Determines whether or not this discount is set up to be ignored by the pricing runtime.
      - `groupId` string, nullable — Group identifier for the discount.
      - `impact` number, double, nullable — Value of the discount applied. This is a negative number to be subtracted from the original price to get the final price.
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
    - `impactPerUnit` number, double — The impact of this discount pur discount quantity.
    - `methodCode` string, nullable — Unique identifier of the shipping method discount.
  - `shippingTaxTotal` number, double, nullable — Total price of taxes that apply to the shipping of this item.
  - `shippingTotal` number, double, nullable — Total price of shipping that apply to this item.
  - `subscription` SubscriptionInfo
    - `frequency` Frequency
      - `unit` string, nullable
      - `value` integer
    - `required` boolean, nullable — Indicates commerce item is subscribed or not.
    - `trial` Trial
      - `duration` integer — Trial duration in days
      - `enabled` boolean — Indicates if the trial is enabled
      - `substituteProductCode` string, nullable — Product code to substitute once the trial period is finished.
      - `substituteProductOptions` CommerceRuntimeProductOption[], nullable — Configurable Options to substitute once the trial period is finished.
        - `attributeFQN` string, nullable — Value of the product option.
        - `dataType` string, nullable — Value of the product option.
        - `name` string, nullable — Name of the product option that appears with the order item in the language specified by LocaleCode.
        - `shopperEnteredValue` unknown
        - `stringValue` string, nullable — Value of the product option.
        - `value` unknown
      - `substituteProductQuantity` integer — Product quantity to substitute once the trail period is finished.
      - `substituteVariationProductCode` string, nullable — Variation product code to substitute once the trail period is finished.
  - `substituteInfo` SubstituteInfo
    - `optIn` string, nullable — Determines if and when substitution is allowed. Allowed values are `None`, `Yes`, `No`, or `OnlyAtFulfillment`. Default is `None`.
    - `substituteProductCode` string, nullable — Allows user to provide a specific product that should be substituted if substitution occurs.
    - `substituteVariantCode` string, nullable — Allows user to provide a specific variant that should be substituted if substitution occurs.
  - `subtotal` number, double, nullable — Line item subtotal (quantity multiplied by price) before discounts.
  - `taxData` object, nullable — Storage for any additional/custom tax data.
  - `taxableTotal` number, double, nullable — Line item subtotal (quantity multiplied by price) before discounts.
  - `total` number, double, nullable — Total price of this cart item taking into account any discounts.
  - `totalWithWeightedShippingAndHandling` number, double, nullable — Line item total with line item, Tax, Weighted Tax with Weighted shipping and handling costs
  - `totalWithoutWeightedShippingAndHandling` number, double, nullable — Taxable Subtotal including Weighted Order amounts
  - `unitPrice` CommerceUnitPrice — Pricing details for the product listed on a cart item, including the original price, discount amount, and final price.
    - `extendedAmount` number, double, nullable — Extended amount, this is in order of precedence: OverrideAmount, SaleAmount, ListAmount
    - `listAmount` number, double, nullable — Product list amount.
    - `overrideAmount` number, double, nullable — Amount as manually overridden by the Merchant
    - `saleAmount` number, double, nullable — Sale amount indicated on the product.
  - `weightedOrderAdjustment` number, double, nullable — Order Level Manual Adjustment applied to this Item
  - `weightedOrderDiscount` number, double, nullable — Order Level Discount applied to this Item
  - `weightedOrderDuty` number, double, nullable — Order Level Duty applied to this Item
  - `weightedOrderHandlingAdjustment` number, double, nullable — Order-level handling manual adjustment allocated to this item.
  - `weightedOrderHandlingFee` number, double, nullable — Order-level handling fee allocated to this item (e.g. flat handling fee spread across all items). This is separate from product-level handling in Mozu.CommerceRuntime.Contracts.Commerce.CommerceItem.HandlingAmount. Total handling on the shipment = HandlingAmount + WeightedOrderHandlingFee.
  - `weightedOrderHandlingFeeDiscount` number, double, nullable — Order-level handling fee discount allocated to this item.
  - `weightedOrderHandlingFeeTax` number, double, nullable — Total handling tax for this item (covers both product-level and order-level handling tax combined). On the shipment item, this is split into: HandlingTax (total) and WeightedOrderHandlingFeeTax (order-level portion only).
  - `weightedOrderShipping` number, double, nullable — Order Level Shipping applied to this Item
  - `weightedOrderShippingDiscount` number, double, nullable — Order Level Shipping discount applied to this Item
  - `weightedOrderShippingManualAdjustment` number, double, nullable — Order Level Shipping Manual Adjustment applied to this Item
  - `weightedOrderShippingTax` number, double, nullable — Order Level Shipping Tax applied to this Item
  - `weightedOrderTax` number, double, nullable — Order Level tax applied to this Item

## Response `200`

OK

- CommerceRuntimeCartItem[]
  - `adjustedLineItemSubtotal` number, double, nullable — Order Level taxable sub total
  - `auditInfo` CoreApiContractsAuditInfo
    - `createBy` string, nullable
    - `createDate` string, date-time, nullable
    - `updateBy` string, nullable
    - `updateDate` string, date-time, nullable
  - `autoAddDiscountId` integer, nullable — Track the discoutid from which the item was auto added
  - `childItemIds` string[], nullable — List of Child Item Ids for this order item
  - `data` object, nullable — Custom data for a given vendor set within the commerce process.
  - `discountTotal` number, double, nullable — How much the shopper saves with the applied discount or sale price. This is a negative number.
  - `discountedTotal` number, double, nullable — Subtotal minus any discounts.
  - `dutyAmount` number, double, nullable — Indicate Duty Amount for this item.
  - `extendedTotal` number, double, nullable — Line item extended total (quantity multiplied by unit extended price) before discounts.
  - `feeTotal` number, double, nullable — Not implemented. Total cost of fees that apply to this item.
  - `fulfillmentLocationCode` string, nullable — Location code from which to obtain this item
  - `fulfillmentMethod` string, nullable — Fulfillment method used to fulfill this item
  - `handlingAmount` number, double, nullable — Product-level handling fee for this item (e.g. special packaging, hazmat fees). This does NOT include order-level handling fees — those are in Mozu.CommerceRuntime.Contracts.Commerce.CommerceItem.WeightedOrderHandlingFee. Total handling on the shipment = HandlingAmount + WeightedOrderHandlingFee.
  - `id` string, nullable — Unique identifier of the item in the cart.
  - `inventoryTags` InventoryTags[], nullable
    - `name` string, nullable
    - `value` string, nullable
  - `isAssemblyRequired` boolean — Assembly Required for this order item
  - `isRecurring` boolean, nullable — If true, the cart item lists a product that can be purchased or fulfilled at regular intervals, for example, monthly billing or a subscription.
  - `isTaxable` boolean, nullable — Not implemented. If true, the cart item is eligible for tax.
  - `itemTaxTotal` number, double, nullable — Total price of taxes that apply to products in this item.
  - `lineId` integer, nullable — The line id assigned to the order item. Visible only in the Admin, this is set from the Admin or in CommerceRuntime when a cart is converted to an order.
  - `lineItemAdjustment` number, double, nullable
  - `localeCode` string, nullable — Locale code for language that appears in text and descriptions on the site, for example, en_US. This is not the currency code. Currently only en_US is supported.
  - `parentItemId` string, nullable — Indicates Parent Item Id for this order item
  - `priceMode` string, nullable — Determines if the item is using external or internal(catalog) pricing
  - `product` CommerceRuntimeProduct — The product as it appears on the order item.
    - `allocationExpiration` string, date-time, nullable — Allocation ID associated with this product on this order.
    - `allocationId` integer, nullable — Allocation ID associated with this product on this order.
    - `bundledProducts` CommerceRuntimeBundledProduct[], nullable — Products bundled with this product (if the current product is a bundle)
      - `allocationExpiration` string, date-time, nullable — Allocation ID associated with this product on this order.
      - `allocationId` integer, nullable — Allocation ID associated with this product on this order.
      - `creditValue` number, double, nullable — Credit value. Only populated if the bundled product is a gift card or digital credit
      - `deltaPrice` number, double, nullable — Only populated for extras
      - `description` string, nullable — Short description of the product in the language specified by LocaleCode.
      - `fulfillmentStatus` string, nullable — Fulfillment status of the product.
      - `goodsType` string, nullable — Goods Type
      - `imageUrl` string, nullable — ImageUrl of product
      - `isPackagedStandAlone` boolean — Indicates that this product ships by itself.
      - `measurements` CommerceRuntimePackageMeasurements — Physical dimensions of the package required to ship the product and its weight.
        - `height` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `length` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `weight` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
        - `width` CommerceRuntimeMeasurement
          - `unit` string, nullable
          - `value` number, double, nullable
      - `name` string, nullable — Name of the product, this is the current value of the product's name in the language specified by LocaleCode.
      - `optionAttributeFQN` string, nullable — Fully Qualified Name of the selected option's attribute
      - `optionValue` unknown
      - `productCode` string, nullable — Merchant-created code that uniquely identifies the product.
      - `productReservationId` integer, nullable — Reservation ID associated with this product in the bundle.
      - `quantity` integer — Quantity of the product included in the bundle.
      - `stock` ProductStock
        - `aggregateInventory` integer, nullable
        - `availableDate` string, date-time, nullable
        - `availableFutureInventories` integer
        - `futureInventories` CommerceRuntimeFutureInventory[], nullable
          - `allocated` integer, nullable
          - `available` integer, nullable
          - `createDate` string, date-time, nullable
          - `deliveryDate` string, date-time, nullable
          - `futureInventoryID` integer, nullable
          - `onhand` integer, nullable
          - `pending` integer, nullable
        - `isOnBackOrder` boolean
        - `isSubstitutable` boolean, nullable
        - `manageStock` boolean
        - `stockAvailable` integer, nullable
        - `totalAvailableStock` integer
    - `categories` CommerceRuntimeCategory[], nullable — Categories to which this product belongs.
      - `id` integer, nullable — Unique identifier of the category. System-supplied and read-only.
      - `parent` object
    - `condition` string, nullable — Condition
    - `description` string, nullable — Short description of the product in the language specified by LocaleCode.
    - `discountsRestricted` boolean, nullable — Is the product discount restricted
    - `discountsRestrictedEndDate` string, date-time, nullable — Product discount restriction end date
    - `discountsRestrictedStartDate` string, date-time, nullable — Product discount restriction start date
    - `fulfillmentFields` CommerceRuntimeFulfillmentField[], nullable — List of unique product identifiers for an item on shipment
      - `name` string, nullable
      - `required` boolean
      - `userEnteredValue` unknown
    - `fulfillmentStatus` string, nullable — Fulfillment status of the product.
    - `fulfillmentTypesSupported` string[], nullable — Types of fulfillment that are supported for this product.
    - `goodsType` string, nullable — Goods Type
    - `imageAlternateText` string, nullable — Descriptive text of the image associated with the product in the language specified by LocaleCode.
    - `imageUrl` string, nullable — URL of the image that appears next to the product on the order item. Optional.
    - `isPackagedStandAlone` boolean — Indicates that this product ships by itself.
    - `isRecurring` boolean, nullable — If true, the product is purchased or fulfilled at regular intervals, for example, a monthly billing or a subscription.
    - `isTaxable` boolean, nullable — If true, the product is eligible for tax.
    - `measurements` CommerceRuntimePackageMeasurements — Physical dimensions of the package required to ship the product and its weight.
      - `height` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `length` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `weight` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
      - `width` CommerceRuntimeMeasurement
        - `unit` string, nullable
        - `value` number, double, nullable
    - `mfgPartNumber` string, nullable — Manufacturing Part Number of the product.
    - `name` string, nullable — Name of the product, this is the current value of the product's name in the language specified by LocaleCode.
    - `options` CommerceRuntimeProductOption[], nullable — If the product contains configurable or stand-alone options, the list of product options that the shopper selected for this product.
      - `attributeFQN` string, nullable — Value of the product option.
      - `dataType` string, nullable — Value of the product option.
      - `name` string, nullable — Name of the product option that appears with the order item in the language specified by LocaleCode.
      - `shopperEnteredValue` unknown
      - `stringValue` string, nullable — Value of the product option.
      - `value` unknown
    - `price` CommerceRuntimeProductPrice — Price of the product with any sale and discounts applied.
      - `creditValue` number, double, nullable — Credit Value when the product happens to be a gift card or similar product
      - `isOverRidePriceSalePrice` boolean, nullable — Indicate that External Price (TenantOverridePrice) is a Sale Price. And is used to calculate the line item discounts.
      - `msrp` number, double, nullable — MSRP of product.
      - `price` number, double, nullable — Price of the product. This is the price that the merchant intends to sell the product if no sale price is present.
      - `priceListCode` string, nullable — Pricelist code for the product
      - `priceListEntryMode` string, nullable — Pricelist entry mode of the product. Note: possible values are below 1. null : Product doesn't participate in pricelist 2. Bulk : Bulk volume price available(unit price vary based on quantity) 3. Simple:
      - `salePrice` number, double, nullable — Current sale price of the product, which is a specific numerical amount (not a percentage off).
      - `tenantOverridePrice` number, double, nullable — An override price applied on the product by the tenant.
    - `productCode` string, nullable — Merchant-created code that uniquely identifies the product.
    - `productReservationId` integer, nullable — Reservation ID associated with this product in the bundle.
    - `productType` string, nullable — Type of product, which can be a product with configurable options, a product with stand-alone options, or a simple product with no options.
    - `productUsage` string, nullable — Usage of the product, primarily used to indicate a bundle in this context
    - `properties` CommerceRuntimeProductProperty[], nullable — If the product contains properties, the list of properties that the shopper selected for this product.
      - `attributeFQN` string, nullable
      - `dataType` string, nullable
      - `isMultiValue` boolean
      - `name` string, nullable
      - `values` CommerceRuntimeProductPropertyValue[], nullable
        - `stringValue` string, nullable
        - `value` unknown
    - `serialNumber` string, nullable — Serial Number
    - `sku` string, nullable — Product Identifier specific to the store
    - `stock` ProductStock
      - `aggregateInventory` integer, nullable
      - `availableDate` string, date-time, nullable
      - `availableFutureInventories` integer
      - `futureInventories` CommerceRuntimeFutureInventory[], nullable
        - `allocated` integer, nullable
        - `available` integer, nullable
        - `createDate` string, date-time, nullable
        - `deliveryDate` string, date-time, nullable
        - `futureInventoryID` integer, nullable
        - `onhand` integer, nullable
        - `pending` integer, nullable
      - `isOnBackOrder` boolean
      - `isSubstitutable` boolean, nullable
      - `manageStock` boolean
      - `stockAvailable` integer, nullable
      - `totalAvailableStock` integer
    - `upc` string, nullable — Universal Product Code of the product.
    - `variationProductCode` string, nullable — For configurable products, the unique identifier of the product variation that has been selected.
  - `productDiscount` CommerceRuntimeAppliedLineItemProductDiscount
    - `appliesToSalePrice` boolean, nullable — Determines if the discount applies to the sale price of the order
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
  - `productDiscounts` CommerceRuntimeAppliedLineItemProductDiscount[], nullable — A list of discounts applied to the product
    - `appliesToSalePrice` boolean, nullable — Determines if the discount applies to the sale price of the order
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
  - `purchaseLocation` string, nullable — The location where the product is being purchased.. default is null. Products can have different prices by purchaseLocation via custom priceListResolution...
  - `quantity` integer — Number of products ordered.
  - `shippingAmountBeforeDiscountsAndAdjustments` number, double, nullable — Shipping amount before Discounts and adjustments
  - `shippingDiscounts` CommerceRuntimeAppliedLineItemShippingDiscount[], nullable — A discount applied to the shipping
    - `discount` CommerceRuntimeAppliedDiscount — Discount applied to the order, which is a negative number to be subtracted from the original price to get the final price. If multiple discounts for the order exist, this is the value most advantageous to the shopper.
      - `couponCode` string, nullable — Code of the coupon associated with the discount if a coupon code is required to get the discount.
      - `data` object, nullable — Stores any custom data sent from external discounts.
      - `discount` CommerceRuntimeDiscount — Discounts that apply to the order, if any. For example, when the subtotal of the order exceeds a certain amount, or for free shipping.
        - `expirationDate` string, date-time, nullable — Date when the discount expires. Default is null (no expiration date).
        - `hasMultipleTargetProducts` boolean — Indicates that the discount targets more than a product. Used primarily for BoGa discounts with multiple targets.
        - `id` integer — Unique identifier of the discount.
        - `itemIds` string[], nullable — List of discounts for each order item.
        - `name` string, nullable — Name of the discount in the language specified by LocaleCode.
      - `excluded` boolean, nullable — Determines whether or not this discount is set up to be ignored by the pricing runtime.
      - `groupId` string, nullable — Group identifier for the discount.
      - `impact` number, double, nullable — Value of the discount applied. This is a negative number to be subtracted from the original price to get the final price.
    - `discountQuantity` integer — The number of the line item that can be used for this particular discount.
    - `impactPerUnit` number, double — The impact of this discount pur discount quantity.
    - `methodCode` string, nullable — Unique identifier of the shipping method discount.
  - `shippingTaxTotal` number, double, nullable — Total price of taxes that apply to the shipping of this item.
  - `shippingTotal` number, double, nullable — Total price of shipping that apply to this item.
  - `subscription` SubscriptionInfo
    - `frequency` Frequency
      - `unit` string, nullable
      - `value` integer
    - `required` boolean, nullable — Indicates commerce item is subscribed or not.
    - `trial` Trial
      - `duration` integer — Trial duration in days
      - `enabled` boolean — Indicates if the trial is enabled
      - `substituteProductCode` string, nullable — Product code to substitute once the trial period is finished.
      - `substituteProductOptions` CommerceRuntimeProductOption[], nullable — Configurable Options to substitute once the trial period is finished.
        - `attributeFQN` string, nullable — Value of the product option.
        - `dataType` string, nullable — Value of the product option.
        - `name` string, nullable — Name of the product option that appears with the order item in the language specified by LocaleCode.
        - `shopperEnteredValue` unknown
        - `stringValue` string, nullable — Value of the product option.
        - `value` unknown
      - `substituteProductQuantity` integer — Product quantity to substitute once the trail period is finished.
      - `substituteVariationProductCode` string, nullable — Variation product code to substitute once the trail period is finished.
  - `substituteInfo` SubstituteInfo
    - `optIn` string, nullable — Determines if and when substitution is allowed. Allowed values are `None`, `Yes`, `No`, or `OnlyAtFulfillment`. Default is `None`.
    - `substituteProductCode` string, nullable — Allows user to provide a specific product that should be substituted if substitution occurs.
    - `substituteVariantCode` string, nullable — Allows user to provide a specific variant that should be substituted if substitution occurs.
  - `subtotal` number, double, nullable — Line item subtotal (quantity multiplied by price) before discounts.
  - `taxData` object, nullable — Storage for any additional/custom tax data.
  - `taxableTotal` number, double, nullable — Line item subtotal (quantity multiplied by price) before discounts.
  - `total` number, double, nullable — Total price of this cart item taking into account any discounts.
  - `totalWithWeightedShippingAndHandling` number, double, nullable — Line item total with line item, Tax, Weighted Tax with Weighted shipping and handling costs
  - `totalWithoutWeightedShippingAndHandling` number, double, nullable — Taxable Subtotal including Weighted Order amounts
  - `unitPrice` CommerceUnitPrice — Pricing details for the product listed on a cart item, including the original price, discount amount, and final price.
    - `extendedAmount` number, double, nullable — Extended amount, this is in order of precedence: OverrideAmount, SaleAmount, ListAmount
    - `listAmount` number, double, nullable — Product list amount.
    - `overrideAmount` number, double, nullable — Amount as manually overridden by the Merchant
    - `saleAmount` number, double, nullable — Sale amount indicated on the product.
  - `weightedOrderAdjustment` number, double, nullable — Order Level Manual Adjustment applied to this Item
  - `weightedOrderDiscount` number, double, nullable — Order Level Discount applied to this Item
  - `weightedOrderDuty` number, double, nullable — Order Level Duty applied to this Item
  - `weightedOrderHandlingAdjustment` number, double, nullable — Order-level handling manual adjustment allocated to this item.
  - `weightedOrderHandlingFee` number, double, nullable — Order-level handling fee allocated to this item (e.g. flat handling fee spread across all items). This is separate from product-level handling in Mozu.CommerceRuntime.Contracts.Commerce.CommerceItem.HandlingAmount. Total handling on the shipment = HandlingAmount + WeightedOrderHandlingFee.
  - `weightedOrderHandlingFeeDiscount` number, double, nullable — Order-level handling fee discount allocated to this item.
  - `weightedOrderHandlingFeeTax` number, double, nullable — Total handling tax for this item (covers both product-level and order-level handling tax combined). On the shipment item, this is split into: HandlingTax (total) and WeightedOrderHandlingFeeTax (order-level portion only).
  - `weightedOrderShipping` number, double, nullable — Order Level Shipping applied to this Item
  - `weightedOrderShippingDiscount` number, double, nullable — Order Level Shipping discount applied to this Item
  - `weightedOrderShippingManualAdjustment` number, double, nullable — Order Level Shipping Manual Adjustment applied to this Item
  - `weightedOrderShippingTax` number, double, nullable — Order Level Shipping Tax applied to this Item
  - `weightedOrderTax` number, double, nullable — Order Level tax applied to this Item

---

[API](https://skmtc.net/kibocommerce/apis/customer.md) · [All operations](https://skmtc.net/kibocommerce/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kibocommerce/customer/versions/47c0cf7b75ab/schema)
