Update SubstituteInfo on CheckoutItem

put https://t{tenantId}-s{siteId}.{env}.mozu.com/api/commerce/checkouts/{checkoutId}/items/{itemId}/upsertSubstituteInfo

Response

Response body

object

string | null

Unique identifier.

siteId

int32

Unique identifier of the Site.

tenantId

int32

Unique identifier of the Tenant.

number

int32 | null

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

originalCartId

string | null

Unique identifier for the cart that was converted to checkout.

submittedDate

date-time | null

When the customer placed (submitted) the order.

type

string | null

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

items

array of objects | null

List of items in the checkout.

items

object

string | null

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

destinationId

string | null

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

originalCartItemId

string | null

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

fulfillmentLocationCode

string | null

Location code from which to obtain this item

fulfillmentMethod

string | null

Fulfillment method used to fulfill this item

dutyAmount

double | null

Indicate Duty Amount for this item.

expectedDeliveryDate

date-time | null

Expected Delivery Date of shipment

subscription

object

isReservationEnabled

boolean

Flag to indicate reserve inventory in cart

giftInfo

object

priceMode

string | null

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

returnRuleInfo

object

localeCode

string | null

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.

purchaseLocation

string | null

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

lineId

int32 | null

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.

product

object

The product as it appears on the order item.

quantity

int32

Number of products ordered.

isRecurring

boolean | null

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 | null

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

subtotal

double | null

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

extendedTotal

double | null

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

taxableTotal

double | null

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

discountTotal

double | null

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

discountedTotal

double | null

Subtotal minus any discounts.

itemTaxTotal

double | null

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

shippingTaxTotal

double | null

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

shippingTotal

double | null

Total price of shipping that apply to this item.

handlingAmount

double | null

Handling Amount for this item

feeTotal

double | null

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

total

double | null

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

unitPrice

object

Pricing details for the product listed on a cart item, including the original price, discount amount, and final price.

productDiscount

object

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.

productDiscounts

array of objects | null

A list of discounts applied to the product

productDiscounts

object

appliesToSalePrice

boolean | null

Determines if the discount applies to the sale price of the order

discountQuantity

int32

The number of the line item that can be used for this particular discount.

productQuantity

int32 | null

deprecated

Quantity of products priced. This is always one unless calculating pricing on the order or cart.

impactPerUnit

double | null

deprecated

Impact for a quantity of one product; that is, the value of the discount for one product.

impact

double | null

Value of the discount applied. This is a negative number to be subtracted from the original price to get the final price.

discount

object

Discounts that apply to the order, if any. For example, when the
subtotal of the order exceeds a certain amount, or for free shipping.

couponCode

string | null

Code of the coupon associated with the discount if a coupon code is required to get the discount.

excluded

boolean | null

Determines whether or not this discount is set up to be ignored by the pricing runtime.

data

object | null

Stores any custom data sent from external discounts.

Has additional fields

shippingDiscounts

array of objects | null

A discount applied to the shipping

shippingDiscounts

object

methodCode

string | null

Unique identifier of the shipping method discount.

discount

object

discountQuantity

int32

The number of the line item that can be used for this particular discount.

impactPerUnit

double

The impact of this discount pur discount quantity.

data

object | null

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

Has additional fields

taxData

object | null

Storage for any additional/custom tax data.

Has additional fields

auditInfo

object

shippingAmountBeforeDiscountsAndAdjustments

double | null

Shipping amount before Discounts and adjustments

weightedOrderAdjustment

double | null

Order Level Manual Adjustment applied to this Item

weightedOrderDiscount

double | null

Order Level Discount applied to this Item

adjustedLineItemSubtotal

double | null

Order Level taxable sub total

totalWithoutWeightedShippingAndHandling

double | null

Taxable Subtotal including Weighted Order amounts

weightedOrderTax

double | null

Order Level tax applied to this Item

weightedOrderShipping

double | null

Order Level Shipping applied to this Item

weightedOrderShippingDiscount

double | null

Order Level Shipping discount applied to this Item

weightedOrderShippingManualAdjustment

double | null

Order Level Shipping Manual Adjustment applied to this Item

weightedOrderShippingTax

double | null

Order Level Shipping Tax applied to this Item

weightedOrderHandlingFee

double | null

Order Level handling fee applied to this item

weightedOrderHandlingFeeTax

double | null

Order Level handling fee tax applied to this item

weightedOrderHandlingFeeDiscount

double | null

Order Level handling fee discount applied to this item

weightedOrderDuty

double | null

Order Level Duty applied to this Item

totalWithWeightedShippingAndHandling

double | null

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

weightedOrderHandlingAdjustment

double | null

Order level handling adjusment that applies to this item.

autoAddDiscountId

int32 | null

Track the discoutid from which the item was auto added

isAssemblyRequired

boolean

Assembly Required for this order item

childItemIds

array of strings | null

List of Child Item Ids for this order item

childItemIds

parentItemId

string | null

Indicates Parent Item Id for this order item

inventoryTags

array of objects | null

inventoryTags

object

name

string | null

value

string | null

lineItemAdjustment

double | null

substituteInfo

object

groupings

array of objects | null

List of checkout grouping.

groupings

object

string | null

A unique identifier for this grouping.

destinationId

string | null

The DestinationId used by items in this grouping, which may be {null}.

fulfillmentMethod

string | null

The FulfillmentMethod used by items in this grouping.

orderItemIds

array of strings | null

Identifiers of the items that make up this grouping.

orderItemIds

shippingMethodCode

string | null

Code that uniquely identifies the shipping method such as "Ground," "Overnight," or "Digital."
The site's shipping settings lists the valid shipping methods specified for this site.

shippingMethodName

string | null

Readable name of the shipping method.

standaloneGroup

boolean

Indicates whether a non ship group should combine with a ship group

shippingDiscounts

array of objects | null

shippingDiscounts

object

methodCode

string | null

Unique identifier of the shipping method discount.

discount

object

handlingDiscounts

array of objects | null

handlingDiscounts

object

impact

double | null

Value of the discount applied. This is a negative number to be subtracted from the original price to get the final price.

discount

object

Discounts that apply to the order, if any. For example, when the
subtotal of the order exceeds a certain amount, or for free shipping.

couponCode

string | null

Code of the coupon associated with the discount if a coupon code is required to get the discount.

excluded

boolean | null

Determines whether or not this discount is set up to be ignored by the pricing runtime.

data

object | null

Stores any custom data sent from external discounts.

Has additional fields

dutyAmount

double | null

Any duty fee applied directly to this group. Items can also have their own duty fee.

dutyTotal

double

Total raw duty amounts for this group.

shippingAmount

double | null

If a shipping method applies directly to this grouping (versus the items), this is the raw shipping amount for the group.

shippingSubTotal

double

The raw shipping amount minus shipping discounts.

itemLevelShippingDiscountTotal

double

The total value of item-level shipping discounts applied to this group.

orderLevelShippingDiscountTotal

double

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

shippingTax

double | null

Group-level shipping tax. Does not account for item shipping tax.

shippingTaxTotal

double

The total shipping tax for this group, accounting for both group-level and item-level shipping tax.

shippingTotal

double

The total shipping cost for this group, accounting for discounts and tax.

handlingAmount

double | null

The handling fee amount that's applicable to this grouping.

handlingSubTotal

double

The total raw handling amounts minus handling discounts.

itemLevelHandlingDiscountTotal

double

The total value of item-level handling discounts applied to this group.

orderLevelHandlingDiscountTotal

double

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

handlingTax

double | null

Group-level handling tax. Does not account for item handling tax.

handlingTaxTotal

double

The total handling tax for this group, accounting for both group-level and item-level handling tax.

handlingTotal

double

The total handling cost for this group, accounting for discounts and tax.

taxData

object | null

Has additional fields

auditInfo

object

updateDate

date-time | null

createDate

date-time | null

updateBy

string | null

createBy

string | null

destinations

array of objects | null

destinations

object

string | null

An identifier for this entry.

destinationContact

object

isDestinationCommercial

boolean | null

Indicates that the destination is commercial

data

object | null

Custom data

Has additional fields

payments

array of objects | null

Payment transaction associated with this checkout. It is the entire payment interchange between the merchant
who is forwarding the customer's payment information and the payment service who is authorizing and
capturing payment. Payment can be either by credit card, check, or PayPal.

payments

object

string | null

Unique identifier of this order transaction.

groupId

object

paymentServiceTransactionId

string | null

Unique identifier of the transaction, specified by the payment service processesing this transaction.

availableActions

array of strings | null

Actions available to the payment

availableActions

orderId

string | null

Unique identifier of the order with which this transaction is associated.

paymentType

string | null

Type of Payment

paymentWorkflow

string | null

The source of data for this payment. By default, this will be set to 'mozu'

externalTransactionId

string | null

The external/third party transaction Id for this payment. This is used to store the transaction Id from digital wallet like Visa Checkout

billingInfo

object

Customer's payment details such as payment type (credit card, check by mail, or PayPal)
and cardholder information if payment is by credit card.

data

object | null

Custom data from payment providers

Has additional fields

status

string | null

Current status of this transaction which are described by the PaymentStatusConst class.

subPayments

array of objects | null

List of sub payments that correspond to child orders in case of multiship orders.

subPayments

object

status

string | null

amountCollected

double

amountCredited

double

amountRequested

double

amountRefunded

double

target

object

interactions

array of objects | null

List of intereactions for this transaction. A transaction is created upon authorization and lasts across the payment
interchange, which can consist of multiple interactions, such as consecutive captures.

interactions

object

string | null

Unique identifier of this payment transaction interaction.

gatewayInteractionId

int32 | null

Unique identifier of the gateway interaction. Used for credit card transactions, where the
payment service creates a GatewayInteractionId for each transaction interaction.

paymentId

string | null

Unique identifier of the original transaction of which this current interaction is a part.

orderId

string | null

Unique identifier of the order with which this transaction is associated.

target

object

currencyCode

string | null

ISO currency code for the transaction. Currently, only USD is supported.

interactionType

string | null

Types of transaction interactions which can be "Authorization," "Capture," "AuthorizeAndCapture,"
"Void," or "Credit," "CheckRequested," or "CheckReceived."

checkNumber

string | null

If paying by check, the check number.

status

string | null

Status of the payment transaction interaction which can be either "Success" or "Failure."

paymentEntryStatus

string | null

Status of the payment when the transaction interaction was created

isRecurring

boolean | null

If true, the product is purchased or fulfilled at regular intervals, for example, a monthly billing or a subscription. (Not currently implemented.)

isManual

boolean

If the payment is a manual payment, this is set to true

isPending

boolean

If true, indicates payment action is still pending and not yet confirmed.

gatewayTransactionId

string | null

Unique identifier of the transaction supplied by PCIaaS.

gatewayAuthCode

string | null

If required by the payment gateway, the authorization code of the transaction. Supplied by PCIaaS.

gatewayAVSCodes

string | null

Gateway AVS Codes. Supplied by PCIaaS.

gatewayCVV2Codes

string | null

Gateway CVV2 Codes. Supplied by PCIaaS.

gatewayResponseCode

string | null

Gateway response code. Supplied by PCIaaS.

gatewayResponseText

string | null

Gateway response text. Supplied by PCIaaS.

gatewayResponseData

array of objects | null

A List of payment response data required to act on authorization when using external order management systems

gatewayResponseData

object

key

string | null

Key from payment gateway

value

string | null

Value from payment gateway

paymentTransactionInteractionIdReference

int32 | null

Unique identifier of previous PaymentTransactionInteraction that this PaymentTransactionInteraction is modifying.
For instance, when crediting a capture, set the PaymentTransactionInteractionIdReference to the capture PaymentTransactionInteractionID.

amount

double | null

Amount of funds associated with this interaction.

note

string | null

Note to be entered by merchant/application

interactionDate

date-time | null

Date the interaction occurred

auditInfo

object

returnId

string | null

Return Id, if the interaction is a Credit for a return-refund.

refundId

string | null

Refund Id, if the interaction is for a stand alone refund.

capturableShipmentsSummary

array of objects | null

Stores pairings of shipment number to shipment total for all captured shipments. This was added for generating TLogs.

capturableShipmentsSummary

object

shipmentNumber

int32

The identifying number of the shipment affected by the payment action

shipmentTotal

double

The shipment's total when the payment action occurred

amountApplied

double

The amount applied by the payment action

isRecurring

boolean

If true, the product is purchased or fulfilled at regular intervals, for example,
monthly billing or a subscription. (Not currently supported.)

amountCollected

double

Amount collected on the payment

amountCredited

double

Amount credited back to the payment.

amountRequested

double

Derived from the Amount on the initial payment create, used to help storefront determine how much can be captured for multiple payments.
See Order.AmountRemainingForPayment for an example.

changeMessages

array of objects | null

Change messages related to the payment.

changeMessages

object

string | null

Unique identifier of the message. System-supplied. Read-only.

correlationId

string | null

Correlation Id

userId

string | null

User Id that identifies the user that performed the related change

userFirstName

string | null

User First Name

userLastName

string | null

User Last Name

userScopeType

string | null

User Type (e.g. Shopper, Admin, etc.)

appId

string | null

App Id that identifies the user that performed the related change

appKey

string | null

App Key

appName

string | null

App Name

subjectType

string | null

Subject of the message, for example, "Product." System-supplied. Read-only.

success

boolean | null

Indicates if the message is related to a success or failure.

identifier

string | null

Unique identifier to what the message pertains, which can be a cart item, cart or another generic entity. System-supplied. Read-only.

subject

string | null

Text on the subject line of the message, for example, the product name. System-supplied. Read-only.

verb

string | null

Action applicable to the message. This can be "Increased," when the product price has increased, "Decreased," when the
product price has decreased, and "Invalidated," when the product is no longer available. System-supplied. Read-only.

message

string | null

Human readable message. System-supplied. Read-only.

metadata

string

Data. This property will be a JSON array that will contain 0-N items, when there is 1 item it will still be an array containing only one item. System-supplied. Read-only.

oldValue

string | null

deprecated

Original price of the item. System-supplied. Read-only.

newValue

string | null

deprecated

Current price of the item. System-supplied. Read-only.

amount

double | null

deprecated

Monetary amount that pertains to the change if applicable

createDate

date-time | null

When the message was created. System-supplied. Read-only.

attributes

object | null

Additional Data. This property will be a Dictionary of objects.

Has additional fields

auditInfo

object

gatewayGiftCard

object

installmentPlanCode

string | null

Stores the Installment Plan code. Installment is only supported on subscription orders

amountRemainingForPayment

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)

acceptsMarketing

boolean | null

Does the customer accept marketing

customerAccountId

int32 | null

Unique identifier of the customer account.

string | null

Email address for checkout

alternateContact

object

firstName

string | null

First Name of alternate contact during order process

lastNameOrSurname

string | null

Last Name of alternate contact during order process

emailAddress

string | null

Email Address of alternate contact during order process

phoneNumber

string | null

Phone Number of alternate contact during order process

customerTaxId

string | null

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

isTaxExempt

boolean | null

Unique identifier of the customer account.

currencyCode

string | null

ISO Currency Code.

priceListCode

string | null

Pricelist code for the checkout

attributes

array of objects | null

attributes

object

auditInfo

object

fullyQualifiedName

string | null

attributeDefinitionId

int32 | null

values

array | null

values

shopperNotes

object

Notes that the shopper has added to this order, for example, a gift message or other comments.

giftMessage

string | null

Gift message associated with this order.

comments

string | null

Comments associated with this order.

deliveryInstructions

string | null

DeliveryInstructions associated with this order.

availableActions

array of strings | null

availableActions

data

object | null

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

Has additional fields

taxData

object | null

Storage for any additional/custom tax data.

Has additional fields

channelCode

string | null

Unique identifier of the channel for this item.

locationCode

string | null

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

ipAddress

string | null

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

sourceDevice

string | null

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

visitId

string | null

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

webSessionId

string | null

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

customerInteractionType

string | null

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

orderDiscounts

array of objects | null

orderDiscounts

object

impact

double | null

Value of the discount applied. This is a negative number to be subtracted from the original price to get the final price.

discount

object

Discounts that apply to the order, if any. For example, when the
subtotal of the order exceeds a certain amount, or for free shipping.

couponCode

string | null

Code of the coupon associated with the discount if a coupon code is required to get the discount.

excluded

boolean | null

Determines whether or not this discount is set up to be ignored by the pricing runtime.

data

object | null

Stores any custom data sent from external discounts.

Has additional fields

couponCodes

array of strings | null

Coupon codes associated with this order.

couponCodes

invalidCoupons

array of objects | null

A list of invalid coupons that were attempted on the order.

invalidCoupons

object

couponCode

string | null

Code that identifies the coupon.

reasonCode

int32

Code that identifies the reason the coupon was invalid.

reason

string | null

Description text of the reason.

createDate

date-time

Create date of the invalid coupon.

discountId

int32

suggestedDiscounts

array of objects | null

suggestedDiscounts

object

productCode

string | null

autoAdd

boolean

discountId

int32

hasMultipleProducts

boolean

hasOptions

boolean

discountThresholdMessages

array of objects | null

List of Mozu.CommerceRuntime.Contracts.Commerce.ThresholdMessage objects that are valid for the current value of the cart/order.

discountThresholdMessages

object

discountId

int32

message

string | null

thresholdValue

double

showOnCheckout

boolean

showInCart

boolean

requiresCouponCode

boolean

dutyTotal

double | null

Total duty fees

feeTotal

double

Total Fees

subTotal

double

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

itemLevelProductDiscountTotal

double

The total value of item-level product discounts.

orderLevelProductDiscountTotal

double

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

itemTaxTotal

double

Total tax on products.

itemTotal

double

The total product cost, accounting for discounts and tax.

shippingSubTotal

double

Shipping does not appear on cart.

itemLevelShippingDiscountTotal

double

The total value of item-level shipping discounts.

orderLevelShippingDiscountTotal

double

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

shippingTaxTotal

double

Total tax on shipping.

shippingTotal

double

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

handlingSubTotal

double

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

itemLevelHandlingDiscountTotal

double

The total value of item-level handling discounts.

orderLevelHandlingDiscountTotal

double

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

handlingTaxTotal

double

Total tax on handling.

handlingTotal

double

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

total

double

Final total

Language

Credentials

Bearer

JWT

URL


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://t0-s0.sandbox.mozu.com/api/commerce/checkouts/checkoutId/items/itemId/upsertSubstituteInfo \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/json

text/plain

200Success