commerce/orders

Use the Orders resource to manage all components of order processing, payment, and fulfillment.

JSON Example

Order Properties

Property Description
acceptedDate

type: DateTime

The date and time the order was accepted by the tenant.

acceptsMarketing

type: bool

Indicates if the customer account is opted to receive marketing materials. If true, the customer account is opted in for receiving the content.

adjustment

type: adjustment

Properties of an ad-hoc price adjustment for an order.

adjustment.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

adjustment.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

adjustment.internalComment

type: string

Administrator notes associated with the order adjustment. These comments are not shopper facing.

amountAvailableForRefund

type: decimal

The amount of the order the shopper can receive in the event of a return. This amount represents the amount captured at the time the order was submitted, not when the order was returned.

amountRefunded

type: decimal

A counter for how much money has been issued in refunds. This calculated field does NOT include refunds issued in returns.

amountRemainingForPayment

type: decimal

The total amount of the order not currently associated with a payment. The shopper must create one or more payments to satisfy this amount before the order can be fully paid.

attributes

type: list of orderAttribute

Collection of attributes that may be paged list or a list, depending on the usage per object and API type.

orderAttribute.attributeDefinitionId

type: int

Unique identifier of the attribute definition.

orderAttribute.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

orderAttribute.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

orderAttribute.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

orderAttribute.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

orderAttribute.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

orderAttribute.fullyQualifiedName

type: string

Fully qualified name of the attribute for the order or customer.

orderAttribute.values

type: list of object

List of value data for objects.

auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

billingInfo

type: billingInfo

Properties for the customer's billing information associated with an order or specific payment.

billingInfo.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

billingInfo.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

billingInfo.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

billingInfo.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

billingInfo.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

billingInfo.billingContact

type: contact

The cardholder's billing contact information, including addresses.

billingInfo.contact.address

type: address

Address information to supply for a contact.

billingInfo.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

billingInfo.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

billingInfo.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

billingInfo.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

billingInfo.contact.address.addressType

type: string

The type of address, which is commercial or residential.

billingInfo.contact.address.cityOrTown

type: string

The entered city or town for the address.

billingInfo.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

billingInfo.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

billingInfo.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

billingInfo.contact.address.stateOrProvince

type: string

The entered state or province for an address.

billingInfo.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

billingInfo.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

billingInfo.contact.firstName

type: string

The full first name of a customer or contact name.

billingInfo.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

billingInfo.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

billingInfo.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

billingInfo.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

billingInfo.contact.phone.home

type: string

Home phone number.

billingInfo.contact.phone.mobile

type: string

Mobile phone number.

billingInfo.contact.phone.work

type: string

Work phone number.

billingInfo.card

type: paymentCard

Properties of a credit card used to submit payment for an order.

billingInfo.paymentCard.bin

type: string

The bin number of a branded credit card.

billingInfo.paymentCard.cardNumberPartOrMask

type: string

The masked credit card number part returned from the payment gateway.

billingInfo.paymentCard.expireMonth

type: short

The two-digit month a credit card expires for a payment method.

billingInfo.paymentCard.expireYear

type: short

The four-digit year the credit card expires for a payment method.

billingInfo.paymentCard.isCardInfoSaved

type: bool

If true, the credit card information is saved to the customer account for future use.

billingInfo.paymentCard.isUsedRecurring

type: bool

If true, the credit card is used for a recurring order payment.

billingInfo.paymentCard.nameOnCard

type: string

The full name printed on a credit card. The name should match what is printed on the card exactly, used in validation during a payment.

billingInfo.paymentCard.paymentOrCardType

type: string

The type of credit card, such as Visa or Amex.

billingInfo.paymentCard.paymentServiceCardId

type: string

Unique identifier of the credit card from the payment service.

billingInfo.check

type: checkPayment

Information about the check used in the billing information, if it exists.

billingInfo.checkPayment.checkNumber

type: string

If applicable, the check number associated with the payment action or interaction.

billingInfo.customCreditType

type: string

Indicates a custom reward type.

billingInfo.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the billing service.

billingInfo.externalTransactionId

type: string

Holds the transaction ID for an external payment type service.

billingInfo.isSameBillingShippingAddress

type: bool

If true, the system overrides the customer's billing address information with the supplied fulfillment information.

billingInfo.paymentType

type: string

The type of payment, such as credit card, check, or PayPal Express. Additional payment types will be supported in future releases.

billingInfo.paymentWorkflow

type: string

Identifies a specific workflow the payment goes through. This is used to define a workflow for external payment services.

billingInfo.purchaseOrder

type: purchaseOrderPayment

The purchase order payment details.

billingInfo.purchaseOrderPayment.customFields

type: list of purchaseOrderCustomField

Details of the custom text fields associated with the purchase order.

Refer to Custom Text Fields in the Purchase Order guides topic for more information.

billingInfo.purchaseOrderPayment.purchaseOrderCustomField.code

type: string

The unique identifier of the object.

billingInfo.purchaseOrderPayment.purchaseOrderCustomField.label

type: string

Descriptive text used as a label for objects, such as field names, facets, date ranges, contact information, and package information.

billingInfo.purchaseOrderPayment.purchaseOrderCustomField.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

billingInfo.purchaseOrderPayment.paymentTerm

type: purchaseOrderPaymentTerm

The details of the payment terms. The payment terms are made up of a code and a description.

Refer to Payment Terms in the Purchase Order guides topic for more information.

billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.code

type: string

The unique identifier of the object.

billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

billingInfo.purchaseOrderPayment.purchaseOrderNumber

type: string

The purchase order number.

Note:  Kibo eCommerce does not validate the purchase order number by default; however, you can add validation functionality using Arc.js. Refer to Validate Purchase Orders During the Checkout Process in the Arc.js Guides for more information and examples.

billingInfo.storeCreditCode

type: string

The code that identifies the store credit to apply to the order.

billingInfo.storeCreditType

type: string

A payment referring to a store credit or gift card.

  • StoreCredit
  • GiftCard
  • Custom

StoreCredit and GiftCard are internally managed by Kibo eComm. Use Custom for externally managed gift cards or reward systems. If Custom is used, provide the name for the custom type in the CustomCreditType field.

billingInfo.token

type: paymentToken

The token to access billing information.

billingInfo.paymentToken.paymentServiceTokenId

type: string

The identifier of the payment service token.

billingInfo.paymentToken.type

type: string

The type of scope, which is a developer account or production tenant.

cancelledDate

type: DateTime

Date when the order was cancelled. System-supplied and read-only.

changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

changeMessage.appKey

type: string

The application's key.

changeMessage.appName

type: string

The application's name.

changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

changeMessage.userFirstName

type: string

The user's first name.

changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

changeMessage.userLastName

type: string

The user's last name.

changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

channelCode

type: string

Code that identifies the channel associated with the site for the shopper's created shopping cart, order, and return.

closedDate

type: DateTime

Date when the order was closed. Closed order is an order that has been processed and the items shipped. System-supplied and read-only.

couponCodes

type: list of string

Array list of coupon codes associated with a shopping cart and the associated order. These codes are entered by a shopper when proceeding to checkout.

currencyCode

type: string

The localized currency code for the monetary amount.

customerAccountId

type: int

Unique identifer of the customer account. This ID is used to associate numerous types of data and object with the customer account, including orders, returns, wish lists, and in-store credit.

customerInteractionType

type: string

The type of customer interaction used to create this shopping cart. Possible values are Website, Call, Store, or Unknown.

customerTaxId

type: string

The tax identification number (TIN) of the customer who submitted the order. If the customer who submitted the order has a customer account defined for the tenant, the system sets this value when the order is submitted.

data

type: Mozu.Core.Api.Contracts.Json

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

digitalPackages

type: list of digitalPackage

Specifies the fulfillment of digital packages associated with this order.

digitalPackage.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

digitalPackage.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

digitalPackage.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

digitalPackage.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

digitalPackage.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

digitalPackage.availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

digitalPackage.changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

digitalPackage.changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

digitalPackage.changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

digitalPackage.changeMessage.appKey

type: string

The application's key.

digitalPackage.changeMessage.appName

type: string

The application's name.

digitalPackage.changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

digitalPackage.changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

digitalPackage.changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

digitalPackage.changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

digitalPackage.changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

digitalPackage.changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

digitalPackage.changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

digitalPackage.changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

digitalPackage.changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

digitalPackage.changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

digitalPackage.changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

digitalPackage.changeMessage.userFirstName

type: string

The user's first name.

digitalPackage.changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

digitalPackage.changeMessage.userLastName

type: string

The user's last name.

digitalPackage.changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

digitalPackage.changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

digitalPackage.code

type: string

The unique identifier of the object.

digitalPackage.fulfillmentDate

type: DateTime

Date and time when a shipment completes fulfillment by delivery to a customer's physical address, picked up by a customer at a store, or delivered digitally for downloadable products.

digitalPackage.fulfillmentLocationCode

type: string

The code that identifies the location used to fulfill the cart/cart item or order/order item. This code can include physical store locations for in-store pickup, warehouse locations providing the products for shipment, or the location for the digital file(s).

digitalPackage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

digitalPackage.items

type: list of digitalPackageItem

A list of requested items. All returned data is provided in an items array.

For a failed request, the returned response may be success with an empty item array.

digitalPackage.digitalPackageItem.fulfillmentItemType

type: string

This specifies the fulfillment type of digital package item.

digitalPackage.digitalPackageItem.giftCardCode

type: string

Specifies the gift card code for the digital package item.

digitalPackage.digitalPackageItem.lineId

type: int

The line id associated with the fulfillment.

digitalPackage.digitalPackageItem.optionAttributeFQN

type: string

Fully qualified name of the selected option's attribute. Bundledproducts result from a static bundle or are dynamically added as a result of the shopper selecting products as extras. When the bundled item is dynamic, it includes the attribute's fully qualified name of the extra that it came from. When `optionAttributeFQN `is null, the bundled item was statically defined. When not null, the item came from an extra selection.

digitalPackage.digitalPackageItem.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

digitalPackage.digitalPackageItem.quantity

type: int

The specified quantity of objects and items. This property is used for numerous object types including products, options, components within a product bundle, cart and order items, returned items, shipping line items, items in a digital product. and items associated with types and reservations.

digitalPackage.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

discountedSubtotal

type: decimal

The aggregate total for all items in the cart, including costs associated with shopper-defined options or extras and any applied discounts.

discountedTotal

type: decimal

The subtotal of the cart, order, and wishlist items, including any applied discount calculations. Wishlist subtotals may change depending on the length of time, available discounts, and stock amounts of products at the time of review by shoppers.

discountThresholdMessages

type: list of thresholdMessage

Saves threshold message settings for the Cart and Checkout pages.

thresholdMessage.discountId

type: int

The unique identifier of the discount.

thresholdMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

thresholdMessage.requiresCouponCode

type: bool

Boolean field indicating whether or not threshold message requires the customer entering a coupon code to display.

thresholdMessage.showInCart

type: bool

Boolean field indicating whether or not the threshold message should be displayed on the Cart page.

thresholdMessage.showOnCheckout

type: bool

Boolean field indicating whether or not the threshold message should display on the Checkout page

thresholdMessage.thresholdValue

type: decimal

Numerical value representing the Cart minimum total to be satisfied in order to display the threshold message.

discountTotal

type: decimal

Estimated amount of discounts applied to all items in the carts and orders. System-supplied and read-only. This value will be available at the wish list, cart item, order item, and wish list item level at a later time.

dutyAmount

type: decimal

Order level duty or tariff amount. Does not take into account duties or tariffs specifically on items on the order

dutyTotal

type: decimal

Duties or tariffs for the Order as well as OrderItems (e.g. if the Order has a $5 duty or tariff for any reason and an OrderItem has a $2 duty or tariff then the value in this property would be $7)

email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

extendedProperties

type: list of extendedProperty

Extra properties (key-value pairs) that extend the primary object. Think of this as a property bag of string keys and string values.

extendedProperty.key

type: string

Key used for metadata defined for objects, including extensible attributes, custom attributes associated with a shipping provider, and search synonyms definitions. This content may be user-defined depending on the object and usage.

For search synonym definitions, refer to Synonym Expansion Types for more information about the key usage.

extendedProperty.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

externalId

type: string

Unique identifier used by an external program to identify a Kibo eCommerce order, customer account, or wish list.

feeTotal

type: decimal

The monetary sum of all fees incurred in the cart, order, line item in a cart, or line item in an order. This value is not calculated for wish lists at this time.

fulfillmentInfo

type: fulfillmentInfo

Properties of the information required to fulfill the cart, order, or wish list. Shoppers can fulfill ordered items by using in-store pickup or direct shipping.

fulfillmentInfo.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

fulfillmentInfo.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

fulfillmentInfo.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

fulfillmentInfo.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

fulfillmentInfo.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

fulfillmentInfo.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the shipping service.

fulfillmentInfo.fulfillmentContact

type: contact

The contact information of the person receiving the shipment or performing the pickup.

fulfillmentInfo.contact.address

type: address

Address information to supply for a contact.

fulfillmentInfo.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

fulfillmentInfo.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

fulfillmentInfo.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

fulfillmentInfo.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

fulfillmentInfo.contact.address.addressType

type: string

The type of address, which is commercial or residential.

fulfillmentInfo.contact.address.cityOrTown

type: string

The entered city or town for the address.

fulfillmentInfo.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

fulfillmentInfo.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

fulfillmentInfo.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

fulfillmentInfo.contact.address.stateOrProvince

type: string

The entered state or province for an address.

fulfillmentInfo.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

fulfillmentInfo.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

fulfillmentInfo.contact.firstName

type: string

The full first name of a customer or contact name.

fulfillmentInfo.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

fulfillmentInfo.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

fulfillmentInfo.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

fulfillmentInfo.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

fulfillmentInfo.contact.phone.home

type: string

Home phone number.

fulfillmentInfo.contact.phone.mobile

type: string

Mobile phone number.

fulfillmentInfo.contact.phone.work

type: string

Work phone number.

fulfillmentInfo.isDestinationCommercial

type: bool

If true, the shipping destination for a shipment is a commercial address.

fulfillmentInfo.shippingMethodCode

type: string

The code associated with a carrier's shipping method service type, used during fulfillment of packages and shipments. Service type codes include a prefix that indicates the carrier. For example: FEDEX_INTERNATIONAL_STANDARD and UPS_GROUND.

If using a custom rate, this property corresponds to the Custom Code field in Admin when you navigate to System > Shipping > Carriers, and then click on an existing rate or on Create New Custom Rate.

fulfillmentInfo.shippingMethodName

type: string

The carrier-supplied name for the shipping service type, such as "UPS Ground" or "2nd Day Air".

If using a custom rate, this property corresponds to the Name field in Admin when you navigate to System > Shipping > Carriers, and then click on an existing rate or on Create New Custom Rate.

fulfillmentStatus

type: string

The current fulfillment status of the order, which is "Fulfilled," "NotFulfilled," or "PartiallyFulfilled." The order is considered fulfilled when all packages are shipped or all pickups are picked up.

handlingAdjustment

type: adjustment

The amount to adjust the order handling fee.

adjustment.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

adjustment.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

adjustment.internalComment

type: string

Administrator notes associated with the order adjustment. These comments are not shopper facing.

handlingAmount

type: decimal

The combined price for all handling costs calculated together for shipped orders, not for digital or in-store pickup. This includes all handling costs per the product line items and options, excluding taxes and discounts.

handlingDiscounts

type: list of appliedDiscount

The list of historically-applied handling discounts. The active one will have IsExcluded == false

appliedDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

appliedDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

appliedDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

appliedDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

appliedDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

appliedDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

appliedDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

appliedDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

handlingSubTotal

type: decimal

Handling fees for the Order as well as OrderItems (e.g. if the Order has a $5 handling fee and an OrderItem has a $2 handling fee per item quantity then the value in this property would be $9)

handlingTaxTotal

type: decimal

Calculated total tax amount for handling costs if the cart/order is subject to sales tax.

handlingTotal

type: decimal

This total represents the handling amount value with any applied discounts.

hasDraft

type: bool

If true, the order has a draft that may include one or more uncommitted changes to the order or its components.

id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

importDate

type: DateTime

The date and time an order or wish list is imported into Kibo eCommerce. This is not the date and time it was created in the external application.

invalidCoupons

type: list of invalidCoupon

The list of invalid coupons the shopper attempted to enter for the cart or order. These coupons may no longer be valid or incorrectly entered.

invalidCoupon.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

invalidCoupon.createDate

type: DateTime

The date and time in UTC format set when the object was created.

invalidCoupon.discountId

type: int

The unique identifier of the discount.

invalidCoupon.reason

type: string

The reason description for an action, including item return, coupon not valid, and item is taxed.

invalidCoupon.reasonCode

type: int

A code indicating the reason why a facet is invalid.

ipAddress

type: string

A captured and stored IP address. IP addresses are stored for the origin location of submitted orders and the tenant domain.

isDraft

type: bool

If true, this version of the order is a draft that might contain uncommitted changes.

isEligibleForReturns

type: bool

If true, the shopper can return any of the items in this order to the tenant.

isImport

type: bool

Indicates if this object/data was imported from an outside source such as a data import or synchronization via an app or service. If true, this data was originally imported into Kibo eCommerce and accessible through your store database. Examples of imported objects/data include orders and customer accounts.

isPartialOrder

type: bool

True if the order is one of multiple orders created to fulfill as parent order that supports shipping to multiple adresses.

isTaxExempt

type: bool

If true, the order is exempt from applied sales tax.

items

type: list of orderItem

A list of requested items. All returned data is provided in an items array.

For a failed request, the returned response may be success with an empty item array.

orderItem.adjustedLineItemSubtotal

type: decimal

The adjusted subtotal of the line item, including all manual adjustments, discounts, shipping charges and discounts, and duty or any other additional line item fees.

orderItem.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

orderItem.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

orderItem.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

orderItem.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

orderItem.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

orderItem.autoAddDiscountId

type: int

If an item was automatically added as a result of a BOGA discount (i.e. this is the free item), this field will be populated with the corresponding BOGA discount ID.

orderItem.data

type: Mozu.Core.Api.Contracts.Json

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

orderItem.destinationId

type: string

The destination the order item will ship to.

orderItem.discountedTotal

type: decimal

The subtotal of the cart, order, and wishlist items, including any applied discount calculations. Wishlist subtotals may change depending on the length of time, available discounts, and stock amounts of products at the time of review by shoppers.

orderItem.discountTotal

type: decimal

Estimated amount of discounts applied to all items in the carts and orders. System-supplied and read-only. This value will be available at the wish list, cart item, order item, and wish list item level at a later time.

orderItem.dutyAmount

type: decimal

Duty or Tariff for this item

orderItem.extendedTotal

type: decimal

Represents the total price of the cart item extended to the shopper. This begins with the Unit Price, then uses any of the following prices if they are defined, in the following order: Override Amount, Sale Amount, List Amount. This value is not calculated for wish lists at this time.

orderItem.feeTotal

type: decimal

The monetary sum of all fees incurred in the cart, order, line item in a cart, or line item in an order. This value is not calculated for wish lists at this time.

orderItem.fulfillmentLocationCode

type: string

The code that identifies the location used to fulfill the cart/cart item or order/order item. This code can include physical store locations for in-store pickup, warehouse locations providing the products for shipment, or the location for the digital file(s).

orderItem.fulfillmentMethod

type: string

The method used to fulfill this cart or order item. The method includes direct ship or in-store pickup. The available methods depend on the supported fulfillment types for the product.

orderItem.handlingAmount

type: decimal

The combined price for all handling costs calculated together for shipped orders, not for digital or in-store pickup. This includes all handling costs per the product line items and options, excluding taxes and discounts.

orderItem.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderItem.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

orderItem.isTaxable

type: bool

Indicates if the item is subject to taxation, used by products, options, extras, cart and order items, line items, and wish lists. If true, the entity is subject to tax based on the relevant tax rate and rules.

orderItem.itemTaxTotal

type: decimal

The total amount of calculated tax for items, used by carts, orders, and wish lists.

orderItem.lineId

type: int

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.

orderItem.localeCode

type: string

The two character locale code, per the country code provided. This code determines the localized content to use and display.

orderItem.originalCartItemId

type: string

The unique identifier of the item when it was applied to a cart, prior to checkout, when the cart became an order.

orderItem.product

type: product

The properties of a product, referenced and used by carts, orders, wish lists, and returns.

orderItem.product.allocationExpiration

type: DateTime

Allocation ID associated with this product on this order.

orderItem.product.allocationId

type: int

Allocation ID associated with this product on this order.

orderItem.product.bundledProducts

type: list of bundledProduct

Properties of a collection of component products that make up a single product bundle with its own product code. Tenants can define product bundles for any product type that supports the Bundle product usage.

orderItem.product.bundledProduct.allocationExpiration

type: DateTime

Allocation ID associated with this product on this order.

orderItem.product.bundledProduct.allocationId

type: int

Allocation ID associated with this product on this order.

orderItem.product.bundledProduct.creditValue

type: decimal

The credit value of the product or bundled product. When the `goodsType `is `DigitalCredit`, this value is populated to indicate the value of the credit. This is used to create store credit in the fulfillment of gift cards.

orderItem.product.bundledProduct.deltaPrice

type: decimal

If the product is in relative pricing mode, this is the difference between associated prices for a product, variation option, or extra. The difference is calculated by subtracting the base price from the associated price with this product, option, and/or extra. For example, if a product with a defined monogram extra costs an additional $10, the `deltaPrice `value is "10". Between options, a price for a medium may be $10 and a large $12 giving a `deltaPrice `value of "2".

Refer to Product Variant Pricing and Weight in the Products guides topic for more information.

orderItem.product.bundledProduct.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

orderItem.product.bundledProduct.fulfillmentStatus

type: string

Fulfillment status of the product.

orderItem.product.bundledProduct.goodsType

type: string

The type of goods in a bundled product. A bundled product is composed of products associated to sell together. Possible values include “Physical” and “DigitalCredit”. This comes from the `productType `of the product. Products are defaulted to a Physical `goodsType`. Gift cards have a `goodsType `of DigitalCredit.

orderItem.product.bundledProduct.isPackagedStandAlone

type: bool

Indicates if the product must be shipped alone in a container. This is used for products and products within a bundle. If true, this product cannot be shipped in a package with other items and must ship in a package by itself.

orderItem.product.bundledProduct.measurements

type: packageMeasurements

Dimensional properties (height, length, and width) of packages, products and bundles.

orderItem.product.bundledProduct.packageMeasurements.height

type: measurement

Height of the package in imperial units of feet and inches.

orderItem.product.bundledProduct.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.bundledProduct.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.bundledProduct.packageMeasurements.length

type: measurement

Length of the package in imperial units of feet and inches.

orderItem.product.bundledProduct.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.bundledProduct.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.bundledProduct.packageMeasurements.weight

type: measurement

Weight of the package in imperial units of pounds and ounces.

orderItem.product.bundledProduct.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.bundledProduct.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.bundledProduct.packageMeasurements.width

type: measurement

Width of the package in imperial units of feet and inches.

orderItem.product.bundledProduct.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.bundledProduct.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.bundledProduct.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.product.bundledProduct.optionAttributeFQN

type: string

Fully qualified name of the selected option's attribute. Bundledproducts result from a static bundle or are dynamically added as a result of the shopper selecting products as extras. When the bundled item is dynamic, it includes the attribute's fully qualified name of the extra that it came from. When `optionAttributeFQN `is null, the bundled item was statically defined. When not null, the item came from an extra selection.

orderItem.product.bundledProduct.optionValue

type: object

The value of the option attribute. These values are associated and used by product bundles and options.

orderItem.product.bundledProduct.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

orderItem.product.bundledProduct.productReservationId

type: int

Unique identifier of the product reservation associated with the component product in a product bundle or item in a cart/order. System-supplied and read only.

orderItem.product.bundledProduct.quantity

type: int

The specified quantity of objects and items. This property is used for numerous object types including products, options, components within a product bundle, cart and order items, returned items, shipping line items, items in a digital product. and items associated with types and reservations.

orderItem.product.categories

type: list of category

The list of all categories associated with the product. These categories contain products, can have discounts associated, and define the grouping of products to display on the storefront.

orderItem.product.category.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderItem.product.category.parent

type: Mozu.CommerceRuntime.Contracts.Products.Category

If applicable, the parent category in the category tree. This can be associated to a product as the parent category.

orderItem.product.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

orderItem.product.discountsRestricted

type: bool

Indicates if the discount is restricted. If true, the system cannot apply any discounts to this product. Discount restrictions are defined at the master catalog level. Client administrators cannot override discount restrictions at the catalog level, but they can limit the restriction to a defined time interval.

For price list entries, specifies whether discounts are restricted for the specific entry if discountRestrictedMode is set to Overridden.

Refer to Discount Restriction in the Price Lists guides topic for more information.

orderItem.product.discountsRestrictedEndDate

type: DateTime

The date and time on which the discount restriction period ends.

orderItem.product.discountsRestrictedStartDate

type: DateTime

The date and time on which the discount restriction period starts.

orderItem.product.fulfillmentStatus

type: string

Fulfillment status of the product.

orderItem.product.fulfillmentTypesSupported

type: list of string

List of supported types of fulfillment for the product or variation. The types include direct ship, in-store pickup, or both.

orderItem.product.goodsType

type: string

The type of goods in a bundled product. A bundled product is composed of products associated to sell together. Possible values include “Physical” and “DigitalCredit”. This comes from the `productType `of the product. Products are defaulted to a Physical `goodsType`. Gift cards have a `goodsType `of DigitalCredit.

orderItem.product.imageAlternateText

type: string

The alternate image description defined for the product, in the language specified in the locale code for the storefront.

orderItem.product.imageUrl

type: string

The URL link for the image file associated with a product or category.

orderItem.product.isPackagedStandAlone

type: bool

Indicates if the product must be shipped alone in a container. This is used for products and products within a bundle. If true, this product cannot be shipped in a package with other items and must ship in a package by itself.

orderItem.product.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

orderItem.product.isTaxable

type: bool

Indicates if the item is subject to taxation, used by products, options, extras, cart and order items, line items, and wish lists. If true, the entity is subject to tax based on the relevant tax rate and rules.

orderItem.product.measurements

type: packageMeasurements

Dimensional properties (height, length, and width) of packages, products and bundles.

orderItem.product.packageMeasurements.height

type: measurement

Height of the package in imperial units of feet and inches.

orderItem.product.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.packageMeasurements.length

type: measurement

Length of the package in imperial units of feet and inches.

orderItem.product.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.packageMeasurements.weight

type: measurement

Weight of the package in imperial units of pounds and ounces.

orderItem.product.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.packageMeasurements.width

type: measurement

Width of the package in imperial units of feet and inches.

orderItem.product.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

orderItem.product.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.mfgPartNumber

type: string

The manufacturer's part number for the product.

orderItem.product.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.product.options

type: list of productOption

List of option attributes configured for an object. These values are associated and used by products, product bundles, and product types.

orderItem.product.productOption.attributeFQN

type: string

The fully qualified name of the attribute. The attributeDefiniteId may be used to generate this name.

orderItem.product.productOption.dataType

type: string

The data type of the source product property, typically of type Bool, DateTime, Number, or String.

orderItem.product.productOption.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.product.productOption.shopperEnteredValue

type: object

The value a shopper entered for an attribute that requires additional input for the product on a storefront. This entered value is a selected option or entered content for an extra, such as selecting a color or entering content for a monogram.

orderItem.product.productOption.stringValue

type: string

If the object value is a String, this value provides that string value, used by vocabulary property values, products, and options.

orderItem.product.productOption.value

type: object

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.price

type: productPrice

The price of either the product or shipping.

This amount can be affected by discounts and/or fees. For products, this amount can also be affected by price lists.

orderItem.product.productPrice.creditValue

type: decimal

The credit value of the product or bundled product. When the `goodsType `is `DigitalCredit`, this value is populated to indicate the value of the credit. This is used to create store credit in the fulfillment of gift cards.

orderItem.product.productPrice.msrp

type: decimal

The manufacturer's suggested retail price (MSRP) for the product. This content may be defined by the supplier.

orderItem.product.productPrice.price

type: decimal

The price of either the product or shipping.

This amount can be affected by discounts and/or fees. For products, this amount can also be affected by price lists.

orderItem.product.productPrice.priceListCode

type: string

If the product's price comes from a price list, this property is the code of the price list with which the product is associated.

orderItem.product.productPrice.priceListEntryMode

type: string

The price list entry mode of the product. This property is for future funtionality and currently should only be Simple.

orderItem.product.productPrice.salePrice

type: decimal

The set sale price for a product consisting of a price with a discount already applied.

For price list entries, this property is the product's sale price if the priceListEntryPrice.salePriceMode is set to Overridden.

orderItem.product.productPrice.tenantOverridePrice

type: decimal

The override price defined by the tenant for this cart or order item.

orderItem.product.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

orderItem.product.productReservationId

type: int

Unique identifier of the product reservation associated with the component product in a product bundle or item in a cart/order. System-supplied and read only.

orderItem.product.productType

type: string

A product type is like a product template.

orderItem.product.productUsage

type: string

The usage type that applies to this product, which is Standard (a single product without configurable options), Configurable (a product that includes configurable option attributes), Bundle (a collection of products sold as a single entity), or Component (an invididual product that represents a component in a bundle).

orderItem.product.properties

type: list of productProperty

Collection of property attributes defined for the object. Properties are associated to all objects within Kibo eCommerce, including documents, products, and product types.

orderItem.product.productProperty.attributeFQN

type: string

The fully qualified name of the attribute. The attributeDefiniteId may be used to generate this name.

orderItem.product.productProperty.dataType

type: string

The data type of the source product property, typically of type Bool, DateTime, Number, or String.

orderItem.product.productProperty.isMultiValue

type: bool

Indicates if the object has or can have multiple properties or values. If true, the object can have more than one value, selectable by shoppers through the storefront or configurable through the catalogs.

orderItem.product.productProperty.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.product.productProperty.values

type: list of productPropertyValue

List of value data for objects.

orderItem.product.productProperty.productPropertyValue.stringValue

type: string

If the object value is a String, this value provides that string value, used by vocabulary property values, products, and options.

orderItem.product.productProperty.productPropertyValue.value

type: object

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

orderItem.product.upc

type: string

The universal product code (UPC) is the barcode defined for the product. The UPC is unique across all sales channels.

orderItem.product.variationProductCode

type: string

Merchant-created code associated with a specific product variation. Variation product codes maintain an association with the base product code.

orderItem.productDiscount

type: appliedLineItemProductDiscount

The applicable product discount for an associated cart, order, or wish list.

orderItem.appliedLineItemProductDiscount.appliesToSalePrice

type: bool

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

orderItem.appliedLineItemProductDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

orderItem.appliedLineItemProductDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

orderItem.appliedLineItemProductDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

orderItem.appliedLineItemProductDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderItem.appliedLineItemProductDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

orderItem.appliedLineItemProductDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.appliedLineItemProductDiscount.discountQuantity

type: int

The number of the line items that are used for this particular discount.

orderItem.appliedLineItemProductDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

orderItem.appliedLineItemProductDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

orderItem.appliedLineItemProductDiscount.impactPerUnit

type: decimal

The impact of a discount for each discount quantity.

orderItem.appliedLineItemProductDiscount.productQuantity

type: int

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

orderItem.productDiscounts

type: list of appliedLineItemProductDiscount

List of product-level discounts projected to apply to a cart, order, or wish list.

orderItem.appliedLineItemProductDiscount.appliesToSalePrice

type: bool

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

orderItem.appliedLineItemProductDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

orderItem.appliedLineItemProductDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

orderItem.appliedLineItemProductDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

orderItem.appliedLineItemProductDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderItem.appliedLineItemProductDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

orderItem.appliedLineItemProductDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.appliedLineItemProductDiscount.discountQuantity

type: int

The number of the line items that are used for this particular discount.

orderItem.appliedLineItemProductDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

orderItem.appliedLineItemProductDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

orderItem.appliedLineItemProductDiscount.impactPerUnit

type: decimal

The impact of a discount for each discount quantity.

orderItem.appliedLineItemProductDiscount.productQuantity

type: int

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

orderItem.purchaseLocation

type: string

The location where the item was purchased.

orderItem.quantity

type: int

The specified quantity of objects and items. This property is used for numerous object types including products, options, components within a product bundle, cart and order items, returned items, shipping line items, items in a digital product. and items associated with types and reservations.

orderItem.shippingAmountBeforeDiscountsAndAdjustments

type: decimal

The total shipping amount for the line item before discounts and adjustments.

orderItem.shippingDiscounts

type: list of appliedLineItemShippingDiscount

List of shipping discounts projected to apply to carts, orders, and wish lists and items at checkout.

orderItem.appliedLineItemShippingDiscount.discount

type: appliedDiscount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderItem.appliedLineItemShippingDiscount.appliedDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

orderItem.appliedLineItemShippingDiscount.appliedDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

orderItem.appliedLineItemShippingDiscount.discountQuantity

type: int

The number of the line items that are used for this particular discount.

orderItem.appliedLineItemShippingDiscount.impactPerUnit

type: decimal

The impact of a discount for each discount quantity.

orderItem.appliedLineItemShippingDiscount.methodCode

type: string

Carrier-supplied, unique code that represents the shipping method service type associated with the shipping discount.

orderItem.shippingTaxTotal

type: decimal

The total amount of tax incurred on the shipping charges in the cart and order. This property is not calculated at this time for wish lists.

orderItem.shippingTotal

type: decimal

The calculated total shipping amount estimated for carts or orders, including tax. This amount is not calculated for wish lists at this time.

orderItem.subtotal

type: decimal

Estimated amount of the cart or order without sales tax, shipping costs, and other fees. This amount is not calculated for wish lists at this time.

orderItem.taxableTotal

type: decimal

The monetary amount of an item in the cart that is subject to tax. This amount typically represents the line item subtotal before applied discounts for an order.

orderItem.taxData

type: Mozu.Core.Api.Contracts.Json

Leverage this property within a tax Arc.js action to supplement the tax information for this item or object with custom JSON data.

orderItem.total

type: decimal

Total is used to indicate the monetary, estimated total amount of the cart or order, including items, sales tax, shipping costs, and other fees. Totals are not estimated for wish lists at this time.

orderItem.totalWithoutWeightedShippingAndHandling

type: decimal

The total charge for the line item without any weighted order level shipping and handling charges.

orderItem.totalWithWeightedShippingAndHandling

type: decimal

The total charge for the line item with all weighted order level shipping and handling charges.

orderItem.unitPrice

type: commerceUnitPrice

Properties of the price per unit of a product, associated with cart and order items. This price is not used for wish lists at this time.

orderItem.commerceUnitPrice.extendedAmount

type: decimal

Represents the total price of the line item extended to the shopper. This begins with the Unit Price, then uses any of the following prices if they are defined, in the following order: Override Amount, Sale Amount, List Amount.

orderItem.commerceUnitPrice.listAmount

type: decimal

The price the item is listed for in the storefront.

orderItem.commerceUnitPrice.overrideAmount

type: decimal

The override price of the item set by the merchant for a given order.

orderItem.commerceUnitPrice.saleAmount

type: decimal

The sale price set for the item.

orderItem.weightedOrderAdjustment

type: decimal

The total weighted order level manual adjustment amount.

orderItem.weightedOrderDiscount

type: decimal

The total weighted order level discount amount.

orderItem.weightedOrderDuty

type: decimal

The total weighted order level duty charges.

orderItem.weightedOrderHandlingAdjustment

type: decimal

The weighted order handling adjustment.

orderItem.weightedOrderHandlingFee

type: decimal

The total weighted order level handling fee amount.

orderItem.weightedOrderHandlingFeeDiscount

type: decimal

The total weighted order handling fee discount amount.

orderItem.weightedOrderHandlingFeeTax

type: decimal

The total weighted order level handling fee tax amount.

orderItem.weightedOrderShipping

type: decimal

The total weighted order level shipping charge.

orderItem.weightedOrderShippingDiscount

type: decimal

The total weighted order level shipping discount amount.

orderItem.weightedOrderShippingManualAdjustment

type: decimal

The total weighted order level shipping manual adjustment amount.

orderItem.weightedOrderShippingTax

type: decimal

The total weighted order level shipping tax amount.

orderItem.weightedOrderTax

type: decimal

The total weighted order level tax amount.

itemTaxTotal

type: decimal

The total amount of calculated tax for items, used by carts, orders, and wish lists.

lastValidationDate

type: DateTime

The date in UTC Date/Time when the items in the cart were last validated against the site's product catalog. System-supplied and read-only.

lineItemSubtotalWithOrderAdjustments

type: decimal

The total charge for the line item with all weighted order level manual adjustments.

locationCode

type: string

The unique, user-defined code that identifies a location. This location can be the location where the order was entered, location for newly in-stock products, and where products are returned.

notes

type: list of orderNote

Paged list collection of note content for objects including customers, orders, and returns.

orderNote.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

orderNote.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

orderNote.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

orderNote.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

orderNote.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

orderNote.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

orderNote.text

type: string

The text content of the order note.

orderDiscounts

type: list of appliedDiscount

List of order-level discounts projected to apply to the cart at checkout or order.

appliedDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

appliedDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

appliedDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

appliedDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

appliedDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

appliedDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

appliedDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

appliedDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

orderNumber

type: int

The order number that displays on the storefront which differs from the order ID.

originalCartId

type: string

Identifier of the cart prior to the customer proceeding to checkout.

packages

type: list of package

Array list of physical packages shipped for a specified order.

package.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

package.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

package.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

package.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

package.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

package.availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

package.changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

package.changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

package.changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

package.changeMessage.appKey

type: string

The application's key.

package.changeMessage.appName

type: string

The application's name.

package.changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

package.changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

package.changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

package.changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

package.changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

package.changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

package.changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

package.changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

package.changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

package.changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

package.changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

package.changeMessage.userFirstName

type: string

The user's first name.

package.changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

package.changeMessage.userLastName

type: string

The user's last name.

package.changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

package.changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

package.code

type: string

The unique identifier of the object.

package.fulfillmentDate

type: DateTime

Date and time when a shipment completes fulfillment by delivery to a customer's physical address, picked up by a customer at a store, or delivered digitally for downloadable products.

package.fulfillmentLocationCode

type: string

The code that identifies the location used to fulfill the cart/cart item or order/order item. This code can include physical store locations for in-store pickup, warehouse locations providing the products for shipment, or the location for the digital file(s).

package.hasLabel

type: bool

If there is a shipping label present for this Package, this will be set to true

package.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

package.items

type: list of packageItem

A list of requested items. All returned data is provided in an items array.

For a failed request, the returned response may be success with an empty item array.

package.packageItem.fulfillmentItemType

type: string

This specifies the fulfillment type of digital package item.

package.packageItem.lineId

type: int

The line id associated with the fulfillment.

package.packageItem.optionAttributeFQN

type: string

Fully qualified name of the selected option's attribute. Bundledproducts result from a static bundle or are dynamically added as a result of the shopper selecting products as extras. When the bundled item is dynamic, it includes the attribute's fully qualified name of the extra that it came from. When `optionAttributeFQN `is null, the bundled item was statically defined. When not null, the item came from an extra selection.

package.packageItem.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

package.packageItem.quantity

type: int

The specified quantity of objects and items. This property is used for numerous object types including products, options, components within a product bundle, cart and order items, returned items, shipping line items, items in a digital product. and items associated with types and reservations.

package.measurements

type: packageMeasurements

Dimensional properties (height, length, and width) of packages, products and bundles.

package.packageMeasurements.height

type: measurement

Height of the package in imperial units of feet and inches.

package.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

package.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

package.packageMeasurements.length

type: measurement

Length of the package in imperial units of feet and inches.

package.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

package.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

package.packageMeasurements.weight

type: measurement

Weight of the package in imperial units of pounds and ounces.

package.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

package.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

package.packageMeasurements.width

type: measurement

Width of the package in imperial units of feet and inches.

package.packageMeasurements.measurement.unit

type: string

The unit of measurement, such as length or weight.

package.packageMeasurements.measurement.value

type: decimal

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

package.packagingType

type: string

The package type associated with this physical package. Possible values include Tube, Letter, Pak, Carrier_Box_Small, Carrier_Box_Medium, Carrier_Box_Large, or Custom.

package.shipmentId

type: string

The read-only, system-generated ID of the shipment associated with the shipment. When a package is first created, it is not associated with a shipment. However, once the CreatePackageShipments operation runs, it creates a shipment for the package (and any other packages that are part of the shipment) and generates shipping labels.

package.shippingMethodCode

type: string

The code associated with a carrier's shipping method service type, used during fulfillment of packages and shipments. Service type codes include a prefix that indicates the carrier. For example: FEDEX_INTERNATIONAL_STANDARD and UPS_GROUND.

If using a custom rate, this property corresponds to the Custom Code field in Admin when you navigate to System > Shipping > Carriers, and then click on an existing rate or on Create New Custom Rate.

package.shippingMethodName

type: string

The carrier-supplied name for the shipping service type, such as "UPS Ground" or "2nd Day Air".

If using a custom rate, this property corresponds to the Name field in Admin when you navigate to System > Shipping > Carriers, and then click on an existing rate or on Create New Custom Rate.

package.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

package.trackingNumber

type: string

Tracking number for the package or shipment, supplied by the shipping carrier to track the shipment until fulfillment completes. The tracking number format may differ between carriers.

parentCheckoutId

type: string

The unique identifier of the checkout that created the parent order (if the order is one of multiple orders created to fulfill a parent order that support shipping to multiple addresses).

parentCheckoutNumber

type: int

The checkout number from the checkout that created the parent order (if the order is one of multiple orders created to fulfill a parent order that support shipping to multiple addresses).

parentOrderId

type: string

If this Order has a parent Order, the parent Order ID is recorded here.

parentOrderNumber

type: int

If the Order has a parent Order, the order number is recorded here.

parentReturnId

type: string

If this order was created to fulfill an item replacement as part of a return merchandise authorization (RMA), the unique identifier of the return.

parentReturnNumber

type: int

If the Order has a parent Order with a return, the return number is recorded here.

partialOrderCount

type: int

The number of partial orders that make up the parent order.

partialOrderNumber

type: int

The order number for the partial order.

payments

type: list of payment

Wrapper for a collection of payments associated with an order or return. An order can include a number of payments until the full total is covered.

payment.amountCollected

type: decimal

The total monetary amount collected in this payment transaction for the order.

payment.amountCredited

type: decimal

If the payment transaction is a shopper store credit, the total monetary amount credited in this payment transaction for the order.

payment.amountRequested

type: decimal

The total amount originally requested for this payment.

payment.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

payment.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

payment.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

payment.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

payment.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

payment.availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

payment.billingInfo

type: billingInfo

Properties for the customer's billing information associated with an order or specific payment.

payment.billingInfo.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

payment.billingInfo.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

payment.billingInfo.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

payment.billingInfo.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

payment.billingInfo.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

payment.billingInfo.billingContact

type: contact

The cardholder's billing contact information, including addresses.

payment.billingInfo.contact.address

type: address

Address information to supply for a contact.

payment.billingInfo.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

payment.billingInfo.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

payment.billingInfo.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

payment.billingInfo.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

payment.billingInfo.contact.address.addressType

type: string

The type of address, which is commercial or residential.

payment.billingInfo.contact.address.cityOrTown

type: string

The entered city or town for the address.

payment.billingInfo.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

payment.billingInfo.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

payment.billingInfo.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

payment.billingInfo.contact.address.stateOrProvince

type: string

The entered state or province for an address.

payment.billingInfo.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

payment.billingInfo.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

payment.billingInfo.contact.firstName

type: string

The full first name of a customer or contact name.

payment.billingInfo.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

payment.billingInfo.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

payment.billingInfo.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

payment.billingInfo.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

payment.billingInfo.contact.phone.home

type: string

Home phone number.

payment.billingInfo.contact.phone.mobile

type: string

Mobile phone number.

payment.billingInfo.contact.phone.work

type: string

Work phone number.

payment.billingInfo.card

type: paymentCard

Properties of a credit card used to submit payment for an order.

payment.billingInfo.paymentCard.bin

type: string

The bin number of a branded credit card.

payment.billingInfo.paymentCard.cardNumberPartOrMask

type: string

The masked credit card number part returned from the payment gateway.

payment.billingInfo.paymentCard.expireMonth

type: short

The two-digit month a credit card expires for a payment method.

payment.billingInfo.paymentCard.expireYear

type: short

The four-digit year the credit card expires for a payment method.

payment.billingInfo.paymentCard.isCardInfoSaved

type: bool

If true, the credit card information is saved to the customer account for future use.

payment.billingInfo.paymentCard.isUsedRecurring

type: bool

If true, the credit card is used for a recurring order payment.

payment.billingInfo.paymentCard.nameOnCard

type: string

The full name printed on a credit card. The name should match what is printed on the card exactly, used in validation during a payment.

payment.billingInfo.paymentCard.paymentOrCardType

type: string

The type of credit card, such as Visa or Amex.

payment.billingInfo.paymentCard.paymentServiceCardId

type: string

Unique identifier of the credit card from the payment service.

payment.billingInfo.check

type: checkPayment

Information about the check used in the billing information, if it exists.

payment.billingInfo.checkPayment.checkNumber

type: string

If applicable, the check number associated with the payment action or interaction.

payment.billingInfo.customCreditType

type: string

Indicates a custom reward type.

payment.billingInfo.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the billing service.

payment.billingInfo.externalTransactionId

type: string

Holds the transaction ID for an external payment type service.

payment.billingInfo.isSameBillingShippingAddress

type: bool

If true, the system overrides the customer's billing address information with the supplied fulfillment information.

payment.billingInfo.paymentType

type: string

The type of payment, such as credit card, check, or PayPal Express. Additional payment types will be supported in future releases.

payment.billingInfo.paymentWorkflow

type: string

Identifies a specific workflow the payment goes through. This is used to define a workflow for external payment services.

payment.billingInfo.purchaseOrder

type: purchaseOrderPayment

The purchase order payment details.

payment.billingInfo.purchaseOrderPayment.customFields

type: list of purchaseOrderCustomField

Details of the custom text fields associated with the purchase order.

Refer to Custom Text Fields in the Purchase Order guides topic for more information.

payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.code

type: string

The unique identifier of the object.

payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.label

type: string

Descriptive text used as a label for objects, such as field names, facets, date ranges, contact information, and package information.

payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

payment.billingInfo.purchaseOrderPayment.paymentTerm

type: purchaseOrderPaymentTerm

The details of the payment terms. The payment terms are made up of a code and a description.

Refer to Payment Terms in the Purchase Order guides topic for more information.

payment.billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.code

type: string

The unique identifier of the object.

payment.billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

payment.billingInfo.purchaseOrderPayment.purchaseOrderNumber

type: string

The purchase order number.

Note:  Kibo eCommerce does not validate the purchase order number by default; however, you can add validation functionality using Arc.js. Refer to Validate Purchase Orders During the Checkout Process in the Arc.js Guides for more information and examples.

payment.billingInfo.storeCreditCode

type: string

The code that identifies the store credit to apply to the order.

payment.billingInfo.storeCreditType

type: string

A payment referring to a store credit or gift card.

  • StoreCredit
  • GiftCard
  • Custom

StoreCredit and GiftCard are internally managed by Kibo eComm. Use Custom for externally managed gift cards or reward systems. If Custom is used, provide the name for the custom type in the CustomCreditType field.

payment.billingInfo.token

type: paymentToken

The token to access billing information.

payment.billingInfo.paymentToken.paymentServiceTokenId

type: string

The identifier of the payment service token.

payment.billingInfo.paymentToken.type

type: string

The type of scope, which is a developer account or production tenant.

payment.changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

payment.changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

payment.changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

payment.changeMessage.appKey

type: string

The application's key.

payment.changeMessage.appName

type: string

The application's name.

payment.changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

payment.changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

payment.changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

payment.changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

payment.changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

payment.changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

payment.changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

payment.changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

payment.changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

payment.changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

payment.changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

payment.changeMessage.userFirstName

type: string

The user's first name.

payment.changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

payment.changeMessage.userLastName

type: string

The user's last name.

payment.changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

payment.changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

payment.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the payment service.

payment.externalTransactionId

type: string

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

payment.groupId

type: paymentActionTarget

The parent group Id that this payment belongs to. This will refer to the parent checkout in the case of a multi-ship order, or the parent order in the case of a non-multi-ship order. This will (eventually) allow us to find all payments associated with a checkout, even if the payment is added directly to one of the child orders.

payment.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

payment.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

payment.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

payment.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

payment.interactions

type: list of paymentInteraction

Container for the interactions associated with the payment, which includes details for each action performed for the payment.

payment.paymentInteraction.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

payment.paymentInteraction.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

payment.paymentInteraction.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

payment.paymentInteraction.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

payment.paymentInteraction.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

payment.paymentInteraction.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

payment.paymentInteraction.checkNumber

type: string

If applicable, the check number associated with the payment action or interaction.

payment.paymentInteraction.currencyCode

type: string

The localized currency code for the monetary amount.

payment.paymentInteraction.gatewayAuthCode

type: string

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

payment.paymentInteraction.gatewayAVSCodes

type: string

AVS (Address Verification Service) codes supplied by the payment gateway. The codes indicate partial to complete or failed matches against the billing address for the shopper against the financial institute data through the gateway.

payment.paymentInteraction.gatewayCVV2Codes

type: string

CVV2 (Card Verification Value) codes supplied by the payment gateway. The codes indicate a verified or failed match of the encrypted code entered against the financial institution data through the gateway.

payment.paymentInteraction.gatewayInteractionId

type: int

Unique identifier of the payment interaction from the payment gateway.

payment.paymentInteraction.gatewayResponseCode

type: string

Response code from the gateway associated with the payment interaction. The response code is unique to the gateway.

The response code is associated with the gatewayResponseText, which contains the textual response message.

Refer to Gateway Response Code and Text in the API Guides for more information.

payment.paymentInteraction.gatewayResponseData

type: list of paymentGatewayResponseData

Additional response data from the gateway that's unique to each gateway.

This is a list of key value pairs.

Refer to Gateway Response Data in the API Guides for more information.

payment.paymentInteraction.paymentGatewayResponseData.key

type: string

Key used for metadata defined for objects, including extensible attributes, custom attributes associated with a shipping provider, and search synonyms definitions. This content may be user-defined depending on the object and usage.

For search synonym definitions, refer to Synonym Expansion Types for more information about the key usage.

payment.paymentInteraction.paymentGatewayResponseData.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

payment.paymentInteraction.gatewayResponseText

type: string

Textual message returned by the payment gateway for the associated gatewayResponseCode.

Refer to Gateway Response Code and Text in the API Guides for more information.

payment.paymentInteraction.gatewayTransactionId

type: string

Unique identifier of the gateway transaction associated with the payment interaction.

payment.paymentInteraction.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

payment.paymentInteraction.interactionDate

type: DateTime

Date and time of a payment interaction, including handling and processing a payment and validating and completing a payment with a payment gateway.

payment.paymentInteraction.interactionType

type: string

The type of payment interaction. The payment can be Capture or CheckReceived. The value also includes customer payment interactions such as Website, Call, Store, or Unknown.

payment.paymentInteraction.isManual

type: bool

If true, the payment interaction was manually defined s part of offline order processing.

payment.paymentInteraction.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

payment.paymentInteraction.note

type: string

User-entered notation content for an object, used to save information such as payment, return, account, and order notes.

payment.paymentInteraction.orderId

type: string

Unique identifier of the order associated with the payment.

payment.paymentInteraction.paymentEntryStatus

type: string

The status of the payment prior to the interaction being performed, which enables manual rollback of previous transactions.

payment.paymentInteraction.paymentId

type: string

Unique identifier of the payment associated with this transaction.

payment.paymentInteraction.paymentTransactionInteractionIdReference

type: int

Unique identifier of previous interaction that this payment interaction is modifying. For example, when refunding a payment, the crediting interaction would reference the capture interaction.

payment.paymentInteraction.refundId

type: string

The unique identifier of the refund for a given interaction.

payment.paymentInteraction.returnId

type: string

The unique identifier of the return associated with a given interaction.

payment.paymentInteraction.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

payment.paymentInteraction.target

type: paymentActionTarget

Targets represent the object, such as an item to apply discounts to(products or orders) or a view field for content. Targets are the dot notations that link to the source document property. For example, firstitem for the direct level or firstitem.seconditem.thirditem for a deeper property.

payment.paymentInteraction.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

payment.paymentInteraction.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

payment.paymentInteraction.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

payment.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

payment.orderId

type: string

Unique identifier of the order associated with the payment.

payment.paymentServiceTransactionId

type: string

The transaction ID supplied by the payment service to associate with this order payment.

payment.paymentType

type: string

The type of payment, such as credit card, check, or PayPal Express. Additional payment types will be supported in future releases.

payment.paymentWorkflow

type: string

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

payment.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

payment.subPayments

type: list of subPayment

List of sub-payments that correspond to child orders in case of multiship orders. Used for tracking each order's portion of a shared payment.

payment.subPayment.amountCollected

type: decimal

The amount collected for that portion of the payment.

payment.subPayment.amountCredited

type: decimal

The amount credited back for that portion of the payment.

payment.subPayment.amountRefunded

type: decimal

The amount refunded for that portion of the payment.

payment.subPayment.amountRequested

type: decimal

The amount requested for that portion of the payment.

payment.subPayment.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

payment.subPayment.target

type: paymentActionTarget

Targets represent the object, such as an item to apply discounts to(products or orders) or a view field for content. Targets are the dot notations that link to the source document property. For example, firstitem for the direct level or firstitem.seconditem.thirditem for a deeper property.

payment.subPayment.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

payment.subPayment.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

payment.subPayment.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

paymentStatus

type: string

Status of the payment for the specified order.

pickups

type: list of pickup

Array list of the in-store pickups defined for the order.

pickup.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

pickup.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

pickup.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

pickup.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

pickup.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

pickup.availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

pickup.changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

pickup.changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

pickup.changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

pickup.changeMessage.appKey

type: string

The application's key.

pickup.changeMessage.appName

type: string

The application's name.

pickup.changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

pickup.changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

pickup.changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

pickup.changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

pickup.changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

pickup.changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

pickup.changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

pickup.changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

pickup.changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

pickup.changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

pickup.changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

pickup.changeMessage.userFirstName

type: string

The user's first name.

pickup.changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

pickup.changeMessage.userLastName

type: string

The user's last name.

pickup.changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

pickup.changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

pickup.code

type: string

The unique identifier of the object.

pickup.fulfillmentDate

type: DateTime

Date and time when a shipment completes fulfillment by delivery to a customer's physical address, picked up by a customer at a store, or delivered digitally for downloadable products.

pickup.fulfillmentLocationCode

type: string

The code that identifies the location used to fulfill the cart/cart item or order/order item. This code can include physical store locations for in-store pickup, warehouse locations providing the products for shipment, or the location for the digital file(s).

pickup.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

pickup.items

type: list of pickupItem

A list of requested items. All returned data is provided in an items array.

For a failed request, the returned response may be success with an empty item array.

pickup.pickupItem.fulfillmentItemType

type: string

This specifies the fulfillment type of digital package item.

pickup.pickupItem.lineId

type: int

The line id associated with the fulfillment.

pickup.pickupItem.optionAttributeFQN

type: string

Fully qualified name of the selected option's attribute. Bundledproducts result from a static bundle or are dynamically added as a result of the shopper selecting products as extras. When the bundled item is dynamic, it includes the attribute's fully qualified name of the extra that it came from. When `optionAttributeFQN `is null, the bundled item was statically defined. When not null, the item came from an extra selection.

pickup.pickupItem.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

pickup.pickupItem.quantity

type: int

The specified quantity of objects and items. This property is used for numerous object types including products, options, components within a product bundle, cart and order items, returned items, shipping line items, items in a digital product. and items associated with types and reservations.

pickup.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

priceListCode

type: string

If the order is associated with a price list, this is the unique code of the price list.

refunds

type: list of refund

Refunds associated with this order. A refund is a single exchange of money from merchant to customer that either encapsulates a refund to a credit card or an issuance of a store credit. Refunds does not reduce the 'amount collected' on an order and it is possible for refunds to exceed the total order amount.

refund.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

refund.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

refund.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

refund.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

refund.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

refund.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

refund.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

refund.orderId

type: string

Unique identifier of the order associated with the payment.

refund.payment

type: payment

The payment associated with this refund (if applicable).

refund.payment.amountCollected

type: decimal

The total monetary amount collected in this payment transaction for the order.

refund.payment.amountCredited

type: decimal

If the payment transaction is a shopper store credit, the total monetary amount credited in this payment transaction for the order.

refund.payment.amountRequested

type: decimal

The total amount originally requested for this payment.

refund.payment.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

refund.payment.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

refund.payment.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

refund.payment.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

refund.payment.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

refund.payment.availableActions

type: list of string

Available actions you can complete for an order. These actions may differ depending on the status of the order, such as actions required to enter a payment, return of a package, and fulfillment of a shipment.

refund.payment.billingInfo

type: billingInfo

Properties for the customer's billing information associated with an order or specific payment.

refund.payment.billingInfo.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

refund.payment.billingInfo.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

refund.payment.billingInfo.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

refund.payment.billingInfo.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

refund.payment.billingInfo.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

refund.payment.billingInfo.billingContact

type: contact

The cardholder's billing contact information, including addresses.

refund.payment.billingInfo.contact.address

type: address

Address information to supply for a contact.

refund.payment.billingInfo.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

refund.payment.billingInfo.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

refund.payment.billingInfo.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

refund.payment.billingInfo.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

refund.payment.billingInfo.contact.address.addressType

type: string

The type of address, which is commercial or residential.

refund.payment.billingInfo.contact.address.cityOrTown

type: string

The entered city or town for the address.

refund.payment.billingInfo.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

refund.payment.billingInfo.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

refund.payment.billingInfo.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

refund.payment.billingInfo.contact.address.stateOrProvince

type: string

The entered state or province for an address.

refund.payment.billingInfo.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

refund.payment.billingInfo.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

refund.payment.billingInfo.contact.firstName

type: string

The full first name of a customer or contact name.

refund.payment.billingInfo.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

refund.payment.billingInfo.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

refund.payment.billingInfo.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

refund.payment.billingInfo.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

refund.payment.billingInfo.contact.phone.home

type: string

Home phone number.

refund.payment.billingInfo.contact.phone.mobile

type: string

Mobile phone number.

refund.payment.billingInfo.contact.phone.work

type: string

Work phone number.

refund.payment.billingInfo.card

type: paymentCard

Properties of a credit card used to submit payment for an order.

refund.payment.billingInfo.paymentCard.bin

type: string

The bin number of a branded credit card.

refund.payment.billingInfo.paymentCard.cardNumberPartOrMask

type: string

The masked credit card number part returned from the payment gateway.

refund.payment.billingInfo.paymentCard.expireMonth

type: short

The two-digit month a credit card expires for a payment method.

refund.payment.billingInfo.paymentCard.expireYear

type: short

The four-digit year the credit card expires for a payment method.

refund.payment.billingInfo.paymentCard.isCardInfoSaved

type: bool

If true, the credit card information is saved to the customer account for future use.

refund.payment.billingInfo.paymentCard.isUsedRecurring

type: bool

If true, the credit card is used for a recurring order payment.

refund.payment.billingInfo.paymentCard.nameOnCard

type: string

The full name printed on a credit card. The name should match what is printed on the card exactly, used in validation during a payment.

refund.payment.billingInfo.paymentCard.paymentOrCardType

type: string

The type of credit card, such as Visa or Amex.

refund.payment.billingInfo.paymentCard.paymentServiceCardId

type: string

Unique identifier of the credit card from the payment service.

refund.payment.billingInfo.check

type: checkPayment

Information about the check used in the billing information, if it exists.

refund.payment.billingInfo.checkPayment.checkNumber

type: string

If applicable, the check number associated with the payment action or interaction.

refund.payment.billingInfo.customCreditType

type: string

Indicates a custom reward type.

refund.payment.billingInfo.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the billing service.

refund.payment.billingInfo.externalTransactionId

type: string

Holds the transaction ID for an external payment type service.

refund.payment.billingInfo.isSameBillingShippingAddress

type: bool

If true, the system overrides the customer's billing address information with the supplied fulfillment information.

refund.payment.billingInfo.paymentType

type: string

The type of payment, such as credit card, check, or PayPal Express. Additional payment types will be supported in future releases.

refund.payment.billingInfo.paymentWorkflow

type: string

Identifies a specific workflow the payment goes through. This is used to define a workflow for external payment services.

refund.payment.billingInfo.purchaseOrder

type: purchaseOrderPayment

The purchase order payment details.

refund.payment.billingInfo.purchaseOrderPayment.customFields

type: list of purchaseOrderCustomField

Details of the custom text fields associated with the purchase order.

Refer to Custom Text Fields in the Purchase Order guides topic for more information.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.code

type: string

The unique identifier of the object.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.label

type: string

Descriptive text used as a label for objects, such as field names, facets, date ranges, contact information, and package information.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderCustomField.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

refund.payment.billingInfo.purchaseOrderPayment.paymentTerm

type: purchaseOrderPaymentTerm

The details of the payment terms. The payment terms are made up of a code and a description.

Refer to Payment Terms in the Purchase Order guides topic for more information.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.code

type: string

The unique identifier of the object.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderPaymentTerm.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

refund.payment.billingInfo.purchaseOrderPayment.purchaseOrderNumber

type: string

The purchase order number.

Note:  Kibo eCommerce does not validate the purchase order number by default; however, you can add validation functionality using Arc.js. Refer to Validate Purchase Orders During the Checkout Process in the Arc.js Guides for more information and examples.

refund.payment.billingInfo.storeCreditCode

type: string

The code that identifies the store credit to apply to the order.

refund.payment.billingInfo.storeCreditType

type: string

A payment referring to a store credit or gift card.

  • StoreCredit
  • GiftCard
  • Custom

StoreCredit and GiftCard are internally managed by Kibo eComm. Use Custom for externally managed gift cards or reward systems. If Custom is used, provide the name for the custom type in the CustomCreditType field.

refund.payment.billingInfo.token

type: paymentToken

The token to access billing information.

refund.payment.billingInfo.paymentToken.paymentServiceTokenId

type: string

The identifier of the payment service token.

refund.payment.billingInfo.paymentToken.type

type: string

The type of scope, which is a developer account or production tenant.

refund.payment.changeMessages

type: list of changeMessage

Collection (list or paged) of change messages logged for each modification made by a shopper to their carts, wishlists, orders, package, payment, pickup, and returns. Change log messages are system-supplied based on shopper actions and read only.

refund.payment.changeMessage.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

refund.payment.changeMessage.appId

type: string

Unique identifier of an app available in your Kibo eCommerce tenant or within Kibo eCommerce Dev Center. This ID is unique across all apps installed, initialized, and enabled in the Admin and those in development through the Dev Center Console.

refund.payment.changeMessage.appKey

type: string

The application's key.

refund.payment.changeMessage.appName

type: string

The application's name.

refund.payment.changeMessage.correlationId

type: string

The unique identifier of the API request associated with the event action, which might contain multiple actions.

refund.payment.changeMessage.createDate

type: DateTime

The date and time in UTC format set when the object was created.

refund.payment.changeMessage.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

refund.payment.changeMessage.identifier

type: string

Identifier for the object associated with the change message, which can represent a cart, cart item, or an order.

refund.payment.changeMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

refund.payment.changeMessage.metadata

type: object

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

refund.payment.changeMessage.newValue

type: string

The new value of the object affected by the change, such as the new price of the product. System-supplied and read-only.

refund.payment.changeMessage.oldValue

type: string

The prior value of the object affected by the change, such as the price of the product when it was added to the cart. System-supplied and read-only.

refund.payment.changeMessage.subject

type: string

The text that appears on the subject line of the message, such as "The product price has changed."

refund.payment.changeMessage.subjectType

type: string

Represents the type of object affected by the change, such as Cart Item or Product. System-supplied and read-only.

refund.payment.changeMessage.success

type: bool

If true, the change associated with the message executed successfully.

refund.payment.changeMessage.userFirstName

type: string

The user's first name.

refund.payment.changeMessage.userId

type: string

Unique identifier of the customer account (shopper or system user). System-supplied and read-only. If the shopper user is anonymous, the user ID represents a system-generated user ID string.

refund.payment.changeMessage.userLastName

type: string

The user's last name.

refund.payment.changeMessage.userScopeType

type: string

The user type (e.g. Shopper, Admin, etc.).

refund.payment.changeMessage.verb

type: string

The action associated with this message. For example, if the price of a product changes, the verb could be "Increased" or "Decreased". If the product is no longer available, the verb could be "Invalidated". System-supplied and read-only.

refund.payment.data

type: Mozu.Core.Api.Contracts.Json

Custom data originated by the payment service.

refund.payment.externalTransactionId

type: string

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

refund.payment.groupId

type: paymentActionTarget

The parent group Id that this payment belongs to. This will refer to the parent checkout in the case of a multi-ship order, or the parent order in the case of a non-multi-ship order. This will (eventually) allow us to find all payments associated with a checkout, even if the payment is added directly to one of the child orders.

refund.payment.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

refund.payment.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

refund.payment.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

refund.payment.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

refund.payment.interactions

type: list of paymentInteraction

Container for the interactions associated with the payment, which includes details for each action performed for the payment.

refund.payment.paymentInteraction.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

refund.payment.paymentInteraction.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

refund.payment.paymentInteraction.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

refund.payment.paymentInteraction.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

refund.payment.paymentInteraction.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

refund.payment.paymentInteraction.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

refund.payment.paymentInteraction.checkNumber

type: string

If applicable, the check number associated with the payment action or interaction.

refund.payment.paymentInteraction.currencyCode

type: string

The localized currency code for the monetary amount.

refund.payment.paymentInteraction.gatewayAuthCode

type: string

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

refund.payment.paymentInteraction.gatewayAVSCodes

type: string

AVS (Address Verification Service) codes supplied by the payment gateway. The codes indicate partial to complete or failed matches against the billing address for the shopper against the financial institute data through the gateway.

refund.payment.paymentInteraction.gatewayCVV2Codes

type: string

CVV2 (Card Verification Value) codes supplied by the payment gateway. The codes indicate a verified or failed match of the encrypted code entered against the financial institution data through the gateway.

refund.payment.paymentInteraction.gatewayInteractionId

type: int

Unique identifier of the payment interaction from the payment gateway.

refund.payment.paymentInteraction.gatewayResponseCode

type: string

Response code from the gateway associated with the payment interaction. The response code is unique to the gateway.

The response code is associated with the gatewayResponseText, which contains the textual response message.

Refer to Gateway Response Code and Text in the API Guides for more information.

refund.payment.paymentInteraction.gatewayResponseData

type: list of paymentGatewayResponseData

Additional response data from the gateway that's unique to each gateway.

This is a list of key value pairs.

Refer to Gateway Response Data in the API Guides for more information.

refund.payment.paymentInteraction.paymentGatewayResponseData.key

type: string

Key used for metadata defined for objects, including extensible attributes, custom attributes associated with a shipping provider, and search synonyms definitions. This content may be user-defined depending on the object and usage.

For search synonym definitions, refer to Synonym Expansion Types for more information about the key usage.

refund.payment.paymentInteraction.paymentGatewayResponseData.value

type: string

The value of a property, used by numerous objects within Kibo eCommerce including facets, attributes, products, localized content, metadata, capabilities (Kibo eCommerce and third-party), location inventory adjustment, and more. The value may be a string, integer, or double. Validation may be run against the entered and saved values depending on the object type.

refund.payment.paymentInteraction.gatewayResponseText

type: string

Textual message returned by the payment gateway for the associated gatewayResponseCode.

Refer to Gateway Response Code and Text in the API Guides for more information.

refund.payment.paymentInteraction.gatewayTransactionId

type: string

Unique identifier of the gateway transaction associated with the payment interaction.

refund.payment.paymentInteraction.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

refund.payment.paymentInteraction.interactionDate

type: DateTime

Date and time of a payment interaction, including handling and processing a payment and validating and completing a payment with a payment gateway.

refund.payment.paymentInteraction.interactionType

type: string

The type of payment interaction. The payment can be Capture or CheckReceived. The value also includes customer payment interactions such as Website, Call, Store, or Unknown.

refund.payment.paymentInteraction.isManual

type: bool

If true, the payment interaction was manually defined s part of offline order processing.

refund.payment.paymentInteraction.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

refund.payment.paymentInteraction.note

type: string

User-entered notation content for an object, used to save information such as payment, return, account, and order notes.

refund.payment.paymentInteraction.orderId

type: string

Unique identifier of the order associated with the payment.

refund.payment.paymentInteraction.paymentEntryStatus

type: string

The status of the payment prior to the interaction being performed, which enables manual rollback of previous transactions.

refund.payment.paymentInteraction.paymentId

type: string

Unique identifier of the payment associated with this transaction.

refund.payment.paymentInteraction.paymentTransactionInteractionIdReference

type: int

Unique identifier of previous interaction that this payment interaction is modifying. For example, when refunding a payment, the crediting interaction would reference the capture interaction.

refund.payment.paymentInteraction.refundId

type: string

The unique identifier of the refund for a given interaction.

refund.payment.paymentInteraction.returnId

type: string

The unique identifier of the return associated with a given interaction.

refund.payment.paymentInteraction.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

refund.payment.paymentInteraction.target

type: paymentActionTarget

Targets represent the object, such as an item to apply discounts to(products or orders) or a view field for content. Targets are the dot notations that link to the source document property. For example, firstitem for the direct level or firstitem.seconditem.thirditem for a deeper property.

refund.payment.paymentInteraction.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

refund.payment.paymentInteraction.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

refund.payment.paymentInteraction.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

refund.payment.isRecurring

type: bool

Indicates if the product in a cart, order, or wish list is purchased on a recurring schedule. If true, the item can be purchased or fulfilled at regular intervals, such as a monthly billing cycle. For example, digital or physical product subscriptions are recurring cart items. This property is not used at this time and is reserved for future functionality.

refund.payment.orderId

type: string

Unique identifier of the order associated with the payment.

refund.payment.paymentServiceTransactionId

type: string

The transaction ID supplied by the payment service to associate with this order payment.

refund.payment.paymentType

type: string

The type of payment, such as credit card, check, or PayPal Express. Additional payment types will be supported in future releases.

refund.payment.paymentWorkflow

type: string

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

refund.payment.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

refund.payment.subPayments

type: list of subPayment

List of sub-payments that correspond to child orders in case of multiship orders. Used for tracking each order's portion of a shared payment.

refund.payment.subPayment.amountCollected

type: decimal

The amount collected for that portion of the payment.

refund.payment.subPayment.amountCredited

type: decimal

The amount credited back for that portion of the payment.

refund.payment.subPayment.amountRefunded

type: decimal

The amount refunded for that portion of the payment.

refund.payment.subPayment.amountRequested

type: decimal

The amount requested for that portion of the payment.

refund.payment.subPayment.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

refund.payment.subPayment.target

type: paymentActionTarget

Targets represent the object, such as an item to apply discounts to(products or orders) or a view field for content. Targets are the dot notations that link to the source document property. For example, firstitem for the direct level or firstitem.seconditem.thirditem for a deeper property.

refund.payment.subPayment.paymentActionTarget.targetId

type: string

The Id of the checkout/order to target.

refund.payment.subPayment.paymentActionTarget.targetNumber

type: int

The number of the checkout/order to target.

refund.payment.subPayment.paymentActionTarget.targetType

type: string

Specifies if the TargetId is a checkout Id or order Id.

refund.reason

type: string

The reason description for an action, including item return, coupon not valid, and item is taxed.

returnStatus

type: string

Status of any returns associated with this order after it was completed.

shipments

type: list of shipment

Array list of the shipments defined to fulfill items in this order using the direct ship fulfillment method.

shipment.auditInfo

type: auditInfo

Basic audit info about the object, including date, time, and user account. This data may be captured when creating, updating, and removing data.

shipment.auditInfo.createBy

type: string

Identifier of the user that created the object. System created and read only.

shipment.auditInfo.createDate

type: DateTime

The date and time in UTC format set when the object was created.

shipment.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

shipment.auditInfo.updateDate

type: DateTime

The date and time in UTC format the object was updated most recently.

shipment.cost

type: decimal

The cost of the product to the retailer, as specified through API or using the Cost field of the Product editor in Admin. This is not the price that the shopper sees on the storefront (which is usually higher).

For price lists entries, this property specifies the cost of the product if costMode is set to Overridden.

shipment.currencyCode

type: string

The localized currency code for the monetary amount.

shipment.destinationAddress

type: contact

The physical address orders are sent to as a shipping destination. This address may contain multiple lines, city, state/province, country, and zip/postal code. The destination is used to calculate shipping costs.

shipment.contact.address

type: address

Address information to supply for a contact.

shipment.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

shipment.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

shipment.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

shipment.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

shipment.contact.address.addressType

type: string

The type of address, which is commercial or residential.

shipment.contact.address.cityOrTown

type: string

The entered city or town for the address.

shipment.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

shipment.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

shipment.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

shipment.contact.address.stateOrProvince

type: string

The entered state or province for an address.

shipment.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

shipment.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

shipment.contact.firstName

type: string

The full first name of a customer or contact name.

shipment.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

shipment.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

shipment.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

shipment.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

shipment.contact.phone.home

type: string

Home phone number.

shipment.contact.phone.mobile

type: string

Mobile phone number.

shipment.contact.phone.work

type: string

Work phone number.

shipment.id

type: string

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

shipment.originAddress

type: contact

The physical address from which the order or shipment will ship.

shipment.contact.address

type: address

Address information to supply for a contact.

shipment.contact.address.address1

type: string

Physical or mailing address line one. Usually includes the street number and street name or it could be a P.O. Box. Max length: 200.

shipment.contact.address.address2

type: string

Physical or mailing address line two. Usually supplements the main street address with apartment, floor, suite, building, or unit information. Max length: 200.

shipment.contact.address.address3

type: string

Physical or mailing address line three. Max length: 200.

shipment.contact.address.address4

type: string

Physical or mailing address line four. Max length: 200.

shipment.contact.address.addressType

type: string

The type of address, which is commercial or residential.

shipment.contact.address.cityOrTown

type: string

The entered city or town for the address.

shipment.contact.address.countryCode

type: string

The 2-letter geographic code representing the country for the physical or mailing address. Currently limited to the US.

shipment.contact.address.isValidated

type: bool

Indicates if the address has been validated. If true, the address has been verified by an address validation service.

shipment.contact.address.postalOrZipCode

type: string

The entered zip or postal code for an address.

shipment.contact.address.stateOrProvince

type: string

The entered state or province for an address.

shipment.contact.companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

shipment.contact.email

type: string

The email address for the customer account and contact. This email may be used for login to the storefront, receiving in-stock product notifications, and subscription mailing lists.

shipment.contact.firstName

type: string

The full first name of a customer or contact name.

shipment.contact.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

shipment.contact.lastNameOrSurname

type: string

The full last name or surname of a customer or contact name.

shipment.contact.middleNameOrInitial

type: string

Character string of the middle name or initial for the customer.

shipment.contact.phoneNumbers

type: phone

List of phone numbers associated with the customer account contact. The phone numbers include area codes.

shipment.contact.phone.home

type: string

Home phone number.

shipment.contact.phone.mobile

type: string

Mobile phone number.

shipment.contact.phone.work

type: string

Work phone number.

shipment.packageIds

type: list of string

Array list of unique IDs of packages in a shipment planned for or finished a shipping fulfillment action.

shipment.shippingMethodCode

type: string

The code associated with a carrier's shipping method service type, used during fulfillment of packages and shipments. Service type codes include a prefix that indicates the carrier. For example: FEDEX_INTERNATIONAL_STANDARD and UPS_GROUND.

If using a custom rate, this property corresponds to the Custom Code field in Admin when you navigate to System > Shipping > Carriers, and then click on an existing rate or on Create New Custom Rate.

shipment.signatureRequired

type: bool

If true, a shopper signature is required to deliver this shipment.

shipment.trackingNumber

type: string

Tracking number for the package or shipment, supplied by the shipping carrier to track the shipment until fulfillment completes. The tracking number format may differ between carriers.

shippingAdjustment

type: adjustment

Properties of an ad-hoc price adjustment made for an order.

adjustment.amount

type: decimal

The amount of the order-level adjustment, which can be a positive or negative amount.

adjustment.description

type: string

The localized description in text for the object, displayed per the locale code. For example, descriptions are used for product descriptions, attributes, and pre-authorization transaction types.

adjustment.internalComment

type: string

Administrator notes associated with the order adjustment. These comments are not shopper facing.

shippingAmountBeforeDiscountsAndAdjustments

type: decimal

The total shipping amount for the order before discounts and adjustments.

shippingDiscounts

type: list of shippingDiscount

List of shipping discounts projected to apply to carts, orders, and wish lists and items at checkout.

shippingDiscount.discount

type: appliedDiscount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

shippingDiscount.appliedDiscount.couponCode

type: string

The coupon code that a shopper uses to redeem an associated discount on a purchase. This is also the unique identifier of the coupon itself.

shippingDiscount.appliedDiscount.discount

type: discount

Name of the discount added and applied to a shopping cart and order for a shopper's purchase.

shippingDiscount.appliedDiscount.discount.expirationDate

type: DateTime

Date and time in UTC format when a discount, credit, wish list, or cart expires. An expired discount no longer can be redeemed. An expired wish list is no longer available. An expired credit can no longer be redeemed for a purchase. Acart becomes inactive and expired based on a system-calculated interval. For example, if an anonymous shopper has 14 days of inactivity, the cart is considered abandoned after that period of inactivity. System-supplied and read-only.

shippingDiscount.appliedDiscount.discount.id

type: int

Unique identifier of the source property, such as a catalog, discount, order, or email template.

For a product field it will be the name of the field.

For a category ID, must be a positive integer not greater than 2000000. By default, Kibo eCommerce auto-generates a category ID when categories are created. If you want to specify an ID during creation (which preserves category link relationships when migrating tenant data from one sandbox to another), you must also include the useProvidedId query string in the endpoint. For example, api/commerce/catalog/admin/categories/?useProvidedId=true. Then, use the id property to specify the desired category ID.

For a product attribute it will be the Attribute FQN.

For a document, the ID must be specified as a 32 character, case-insensitive, alphanumeric string. You can specify the ID as 32 sequential characters or as groups separated by dashes in the format 8-4-4-4-12. For example, bba0a1a885e2413bb097ceacf7bac366
or
bba0a1a8-85e2-413b-b097-ceacf7bac366.

For email templates, the ID must be one of the following values:
BackInStock
OrderChanged
OrderShipped
OrderFulfillmentDetailsChanged
ShopperLoginCreated
ShopperPasswordReset
ReturnCreated
ReturnAuthorized
ReturnUpdated
ReturnRejected
ReturnCancelled
ReturnClosed
RefundCreated
StoreCreditCreated
StoreCreditUpdated
GiftCardCreated

shippingDiscount.appliedDiscount.discount.itemIds

type: list of string

List of cart or order items to which the discount applies, if applicable.

shippingDiscount.appliedDiscount.discount.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

shippingDiscount.appliedDiscount.excluded

type: bool

Indicates if a discount is not used for the product or product line item in an order. If true, the system ignores this discount when pricing the order.

shippingDiscount.appliedDiscount.impact

type: decimal

The value of the discount applied to the cart or order, represented as a negative currency amount to apply to the original price.

shippingDiscount.methodCode

type: string

Carrier-supplied, unique code that represents the shipping method service type associated with the shipping discount.

shippingSubTotal

type: decimal

The shipping subtotal amount calculated without any applied discounts for line item and entire amounts of carts and orders. This property is not calculated for wish lists at this time.

shippingTaxTotal

type: decimal

The total amount of tax incurred on the shipping charges in the cart and order. This property is not calculated at this time for wish lists.

shippingTotal

type: decimal

The calculated total shipping amount estimated for carts or orders, including tax. This amount is not calculated for wish lists at this time.

shopperNotes

type: shopperNotes

A paged list collection of shopper notes for the order.

shopperNotes.comments

type: string

Notes entered and saved with an order. These notes may be entered by a shopper on a wishlist or for an order. Comments may also be entered by Kibo eCommerce Admins on an order that may be visible only to authorized shoppers and users.

shopperNotes.giftMessage

type: string

Shopper-entered gift message for the associated order.

siteId

type: int

Unique identifier for the site. This ID is used at all levels of a store, catalog, and tenant to associate objects to a site.

sourceDevice

type: string

The device from which the order originated in the case of offline orders.

status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

submittedDate

type: DateTime

The date and time the order was submitted. System-supplied and read-only.

subtotal

type: decimal

Estimated amount of the cart or order without sales tax, shipping costs, and other fees. This amount is not calculated for wish lists at this time.

suggestedDiscounts

type: list of suggestedDiscount

Refers to the BOGA discounts that are currently satisfied but whose free item has not yet been added.

suggestedDiscount.autoAdd

type: bool

Indicates whether the free BOGA item should automatically be added to cart. If the free item has been added before and the shopper removed the free item (rejected it), the value will be false.

suggestedDiscount.discountId

type: int

The unique identifier of the discount.

suggestedDiscount.productCode

type: string

The unique, user-defined product code of a product, used throughout Kibo eCommerce to reference and associate to a product.

taxData

type: Mozu.Core.Api.Contracts.Json

Leverage this property within a tax Arc.js action to supplement the tax information for this item or object with custom JSON data.

Note:  The API displays order taxes grouped by fulfillment method and origin location, so you may see multiple tax payloads on one order. For example, you may see an object that looks like:

{ Ship_Warehouse_A : { CustomTax: 11.00 }, Pickup_Store_B : { CustomTax: 23.00 } }

taxTotal

type: decimal

The total monetary sum of sales tax estimated for a cart or order.

tenantId

type: int

Unique identifier for the tenant.

total

type: decimal

Total is used to indicate the monetary, estimated total amount of the cart or order, including items, sales tax, shipping costs, and other fees. Totals are not estimated for wish lists at this time.

totalCollected

type: decimal

The total amount collected to date for the order.

type

type: string

The type of scope, which is a developer account or production tenant.

validationResults

type: list of orderValidationResult

Response returned by an order validation capability application.

orderValidationResult.createdDate

type: DateTime

DateTime that this validation result was created

orderValidationResult.messages

type: list of orderValidationMessage

Array list of validation and status messages associated with shipping rates, orders, and product purchasable state.

orderValidationResult.orderValidationMessage.message

type: string

The text of the change message, such as "This product is no longer available." System-supplied and read-only.

orderValidationResult.orderValidationMessage.messageType

type: string

The type of message returned by the order validation capability, such as "Fraud Score."

orderValidationResult.orderValidationMessage.orderItemId

type: string

Unique identifier of the order item associated with a validation message, order, or return.

orderValidationResult.status

type: string

The current status of the object.

This value is read only. Valid values for this field are: "Active", "Expired", and "Inactive".

orderValidationResult.validationId

type: string

Read-only identifier defined by the order validation capability that uniquely identifies this validation operation.

orderValidationResult.validatorName

type: string

Read-only name of this order validator supplied by the capability.

orderValidationResult.validatorType

type: string

The type of order validator supplied by the capability. At this time, the only supported validator type is Fraud.

version

type: string

The current version number of the order, wish list, document list, or document type list.

visitId

type: string

Unique identifier of the customer visit in which the cart was created or last modified.

webSessionId

type: string

Unique identifier of the web session in which the cart, order, return, or wish list was created or last modified.

Operations

Operation Name Request URI Description
ChangeOrderPriceList PUT %7borderId%7d%2fpriceList%3fupdatemode%3d%7bupdateMode%7d%26version%3d%7bversion%7d%26responseFields%3d%7bresponseFields%7d

Changes the price list associated with an order. The desired price list code should be specified in the ApiContext.

ChangeOrderUserId PUT %7borderId%7d%2fusers%3fresponseFields%3d%7bresponseFields%7d

Updates the user ID of the shopper who placed the order to the current user.

CreateOrder POST %3fresponseFields%3d%7bresponseFields%7d

Creates a new order for no-cart quick-ordering scenarios.

CreateOrderFromCart POST %3fcartId%3d%7bcartId%7d%26responseFields%3d%7bresponseFields%7d

Creates a new order from an existing cart when the customer chooses to proceed to checkout.

DeleteOrderDraft PUT %7borderId%7d%2fdraft%3fversion%3d%7bversion%7d

Deletes the current draft version of the order, which also deletes any uncommitted changes made to the order in draft mode.

GetAvailableActions GET %7borderId%7d%2factions

Retrieves the actions available to perform for an order based on its current status.

GetOrder GET %7borderId%7d%3fdraft%3d%7bdraft%7d%26includeBin%3d%7bincludeBin%7d%26responseFields%3d%7bresponseFields%7d

Retrieves the details of an order specified by the order ID.

GetOrders GET %3fstartIndex%3d%7bstartIndex%7d%26pageSize%3d%7bpageSize%7d%26sortBy%3d%7bsortBy%7d%26filter%3d%7bfilter%7d%26q%3d%7bq%7d%26qLimit%3d%7bqLimit%7d%26includeBin%3d%7bincludeBin%7d%26responseFields%3d%7bresponseFields%7d

Retrieves a list of orders according to any specified filter criteria and sort options.

GetTaxableOrders GET %7borderId%7d%2ftaxableorders

Retrieves an order for the purpose of splitting it into multiple taxable orders in order to fulfill the order in multiple locations.

PerformOrderAction POST %7borderId%7d%2factions%3fresponseFields%3d%7bresponseFields%7d

Perform the specified action for an order. The actions you can perform depend on the current status of the order.

PriceOrder POST price%3frefreshShipping%3d%7brefreshShipping%7d%26responseFields%3d%7bresponseFields%7d

Prices an order payload without requiring the order to be persisted.

ProcessDigitalWallet PUT %7borderId%7d%2fdigitalWallet%2f%7bdigitalWalletType%7d%3fresponseFields%3d%7bresponseFields%7d

Processes a digital wallet (used to hold 3rd party payment and shipping information).

ResendOrderConfirmationEmail PUT %7borderId%7d%2femail%2fresend

Triggers an order confirmation email to be resent.

UpdateOrder PUT %7borderId%7d%3fupdatemode%3d%7bupdateMode%7d%26version%3d%7bversion%7d%26responseFields%3d%7bresponseFields%7d

Updates the specified order when additional order information, such as shipping or billing information, is modified during the checkout process.

UpdateOrderDiscount PUT %7borderId%7d%2fdiscounts%2f%7bdiscountId%7d%3fupdatemode%3d%7bupdateMode%7d%26version%3d%7bversion%7d%26responseFields%3d%7bresponseFields%7d

Update the properties of a discount applied to an order.