v1

latestOpenAPI 3.0.12026-07-26381328555.2 KB
Checkout

Add Checkout Item

Adds a product or other item to the checkout of the current shopper.

post/commerce/checkouts/{checkoutId}/items

Path parameters

checkoutIdstring required

ID of the checkout to add an item to.

Query parameters

responseFieldsstring

limits which fields are returned in the response body

Request body

adjustedLineItemSubtotalnumber double nullable

Order Level taxable sub total

autoAddDiscountIdinteger nullable

Track the discoutid from which the item was auto added

callOffOrderItemIdstring nullable

Identifier of the originating Call-Off Order line item, if this item was released from a Call-Off Order line. Null for standard order items.

childItemIdsstring[] nullable

List of Child Item Ids for this order item

dataobject nullable

Custom data for a given vendor set within the commerce process.

destinationIdstring nullable

The destination associated with this item when used with a multi-ship checkout.

discountTotalnumber double nullable

How much the shopper saves with the applied discount or sale price. This is a negative number.

discountedTotalnumber double nullable

Subtotal minus any discounts.

dutyAmountnumber double nullable

Duty or Tariff for this item

expectedDeliveryDatestring date-time nullable

Expected Delivery Date of shipment

extendedTotalnumber double nullable

Line item extended total (quantity multiplied by unit extended price) before discounts.

feeTotalnumber double nullable

Not implemented. Total cost of fees that apply to this item.

fulfillmentLocationCodestring nullable

Location code from which to obtain this item

fulfillmentMethodstring nullable

Fulfillment method used to fulfill this item

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

idstring nullable

Unique identifier of the order line item. System-supplied and read-only.

isAssemblyRequiredboolean

Assembly Required for this order item

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

isReservationEnabledboolean

Flag to indicate reserve inventory in cart

isTaxableboolean nullable

Not implemented. If true, the cart item is eligible for tax.

itemTaxTotalnumber double nullable

Total price of taxes that apply to products in this item.

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

lineItemAdjustmentnumber double nullable
localeCodestring 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.

originalCartItemIdstring nullable

Unique identifier of the cart item that is associated with this line item. (This is the original Cart Item ID expressed as a GUID.)

parentItemIdstring nullable

Indicates Parent Item Id for this order item

priceModestring nullable

Determines if the item is using external or internal(catalog) pricing

purchaseLocationstring nullable

The location where the product is being purchased.. default is null. Products can have different prices by purchaseLocation via custom priceListResolution...

quantityinteger

Number of products ordered.

shippingAmountBeforeDiscountsAndAdjustmentsnumber double nullable

Shipping amount before Discounts and adjustments

shippingMethodCodestring nullable

Code that uniquely identifies the shipping method.

shippingMethodNamestring nullable

Readable name of the shipping method.

shippingTaxTotalnumber double nullable

Total price of taxes that apply to the shipping of this item.

shippingTotalnumber double nullable

Total price of shipping that apply to this item.

subtotalnumber double nullable

Line item subtotal (quantity multiplied by price) before discounts.

taxDataobject nullable

Storage for any additional/custom tax data.

taxableTotalnumber double nullable

Line item subtotal (quantity multiplied by price) before discounts.

totalnumber double nullable

Total price of this cart item taking into account any discounts.

totalWithWeightedShippingAndHandlingnumber double nullable

Line item total with line item, Tax, Weighted Tax with Weighted shipping and handling costs

totalWithoutWeightedShippingAndHandlingnumber double nullable

Taxable Subtotal including Weighted Order amounts

weightedOrderAdjustmentnumber double nullable

Order Level Manual Adjustment applied to this Item

weightedOrderDiscountnumber double nullable

Order Level Discount applied to this Item

weightedOrderDutynumber double nullable

Order Level Duty applied to this Item

weightedOrderHandlingAdjustmentnumber double nullable

Order-level handling manual adjustment allocated to this item.

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

weightedOrderHandlingFeeDiscountnumber double nullable

Order-level handling fee discount allocated to this item.

weightedOrderHandlingFeeTaxnumber 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).

weightedOrderShippingnumber double nullable

Order Level Shipping applied to this Item

weightedOrderShippingDiscountnumber double nullable

Order Level Shipping discount applied to this Item

weightedOrderShippingManualAdjustmentnumber double nullable

Order Level Shipping Manual Adjustment applied to this Item

weightedOrderShippingTaxnumber double nullable

Order Level Shipping Tax applied to this Item

weightedOrderTaxnumber double nullable

Order Level tax applied to this Item

Response

OK

acceptsMarketingboolean nullable

Does the customer accept marketing

amountRemainingForPaymentnumber double

A counter for how much of the total has not been claimed by payments. This is computed by Total - (sum of Payments where State is not Voided/Declined)

availableActionsstring[] nullable
channelCodestring nullable

Unique identifier of the channel for this item.

couponCodesstring[] nullable

Coupon codes associated with this order.

currencyCodestring nullable

ISO Currency Code.

customerAccountIdinteger nullable

Unique identifier of the customer account.

customerInteractionTypestring nullable

Determines the interaction type that a customer will use to create this object. Valid values are: Website, Store, Call, Unknown

customerTaxIdstring nullable

The customers tax ID. If Customer Account ID exists in the system, will set this.

dataobject nullable

Custom data for a given vendor set within the commerce process.

dutyTotalnumber double nullable

Total duty fees

emailstring nullable

Email address for checkout

feeTotalnumber double

Total Fees

handlingSubTotalnumber double

Pre-Discounted Handling Subtotal of the CommerceAggregate and its Items. Returns null if the calculated value is negative.

handlingTaxTotalnumber double

Total tax on handling.

handlingTotalnumber double

Overall handling total, accounting for line and order-level handling costs, any handling discounts, and handling tax.

idstring nullable

Unique identifier.

ipAddressstring nullable

IP address of the user placing the order. (User or customer?)

isTaxExemptboolean nullable

Unique identifier of the customer account.

itemLevelHandlingDiscountTotalnumber double

The total value of item-level handling discounts.

itemLevelProductDiscountTotalnumber double

The total value of item-level product discounts.

itemLevelShippingDiscountTotalnumber double

The total value of item-level shipping discounts.

itemTaxTotalnumber double

Total tax on products.

itemTotalnumber double

The total product cost, accounting for discounts and tax.

locationCodestring nullable

Identifies the location at which the order was placed if the order was placed externally.

numberinteger nullable

A checkout number that is only assigned after the checkout is placed.

orderLevelHandlingDiscountTotalnumber double

The total value of order-level (group-level) handling discounts.

orderLevelProductDiscountTotalnumber double

The total value of order-level (group-level) product discounts.

orderLevelShippingDiscountTotalnumber double

The total value of order-level (group-level) shipping discounts.

originalCartIdstring nullable

Unique identifier for the cart that was converted to checkout.

priceListCodestring nullable

Pricelist code for the checkout

shippingSubTotalnumber double

Shipping does not appear on cart.

shippingTaxTotalnumber double

Total tax on shipping.

shippingTotalnumber double

Overall shipping total, accounting for item and order-level shipping costs, any shipping discounts, and shipping tax.

siteIdinteger

Unique identifier of the Site.

sourceDevicestring nullable

Source device of the user placing the order. (User or customer?)

subTotalnumber double

Subtotal before any coupon codes, taxes, fees, etc.

submittedDatestring date-time nullable

When the customer placed (submitted) the order.

taxDataobject nullable

Storage for any additional/custom tax data.

tenantIdinteger

Unique identifier of the Tenant.

totalnumber double

Final total

typestring nullable

Is this Order Online or Offline? Online means shopper entered at checkout, offline means a phone order.

visitIdstring nullable

Identifies the Visit ID that was current when the order was placed or when the cart was last updated.

webSessionIdstring nullable

Identifies the web session used to place the order or last update the cart.