Product updated message

Custom payload definition of the following Delivery Configuration message namespaces:

  • sitecore.ordercloud.messages.product.updated.

Models

Product

NameTypeDescription
UserContextUserContextThe user context.
ProductIDstringThe product identifier.
MarketplacestringThe marketplace identifier.
OwnerIDstringUsed to specify the identifier of the user or organization that owns or manages the product. Typically used to assign ownership or responsibility for a product to a specific entity.
NamestringThe name of the product.
DescriptionstringThe description of the product.
IsParentbooleanUsed to define if a product is a Parent.
ParentIDstringID of the parent.
QuantityMultiplierintFor reference only. Used to indicate an amount per quantity
ShipWeightdecimalThe shipping weight.
ShipHeightdecimalThe shipping height.
ShipWidthdecimalThe shipping width.
ShipLengthdecimalThe shipping length.
ActivebooleanIndicates if the product is active. When false, the product will not be visible to shoppers.
AutoForwardbooleanIf true, when this product is ordered by a Buyer, it will automatically be added to a new Order from the Marketplace Owner to the Default Supplier and submitted. Requires a valid DefaultSupplierID.
SpecCountintThe number of specs for this product.
VariantCountintThe number of variants for this product.
ShipFromAddressIDstringThe ID of the address this product will ship from.
DefaultSupplierIDstringThe ID of the default supplier of the product.
AllSuppliersCanSellbooleanIndicates that all suppliers can sell this product.
ReturnablebooleanIndicates that this product can be returned after purchase.
DefaultPriceScheduleIDstringThe default price schedule for this product.
InventoryInventoryThe inventory of the product.
DefaultPriceSchedulePriceScheduleThe default price schedule of the product.
PartyPriceSchedulesPartyPriceSchedule[]Used to define pricing rules or schedules for specific parties within the platform. A party can refer to a buyer, supplier, or any other entity involved in the order and commerce process. PartyPriceSchedules allow you to set up custom pricing structures based on various criteria.
SellerDefaultPriceSchedulesSellerDefaultPriceSchedule[]Used to define pricing rules or schedules specifically for sellers. A seller typically represents a supplier or a group of suppliers within the OrderCloud platform. Allows you to set up custom pricing structures for products or services offered by sellers based on various criteria.
Catalogsstring[]List of catalogs this product is associated with.
Suppliersstring[]List of suppliers of this product.
Buyersstring[]List of companies that can see this product.
CategoriesCategory[]List of categories this product is assigned to.
UserGroupsstring[]List of user groups that can see this product.
SpecsSpec[]List of product specs.
xpdynamicDynamic properties assigned by the owner of the product.

If you are using Sitecore Discover for product synchronization, you can include xp.ThumbnailImageUrl with a value. That will enable showing the product thumbnail image in CEC.

PriceSchedule

NameTypeDescription
OwnerIDstringOwner of the price schedule.
IDstringThe price schedule identifier.
NamestringThe name of the price schedule.
ApplyTaxbooleanIndicates if tax is to be applied.
ApplyShippingbooleanUsed to specify whether the pricing rules defined in a price schedule should be applied to the shipping costs associated with an order.
MinQuantityintThe minimum quantity allowed per order.
MaxQuantityintThe maximum quantity allowed per order.
UseCumulativeQuantityboolIf true, line items will be aggregated by product id when determining which price break applies, and when min/max quantities are met.
RestrictedQuantitybooleanIf true, then product can only be ordered in quantities that exactly match once of the price breaks.
CurrencystringThe currency.
SalesStartDateTimeOffsetStart date/time of the price breaks.
SalesEndDateTimeOffsetEnd date/time of the price breaks.
IsOnSalebooleanIndicates if the item is on sale.
PriceBreaksPriceBreak[]List of price breaks associated with the price schedule.
xpdynamicDynamic properties assigned by the marketplace owner.

PriceBreak

NameTypeDescription
QuantityintQuantity this price break applies too.
PricedecimalPrice of the product.
SalePricedecimalIf specified, specifies the on sale price.
SubscriptionPricedecimalPer unit price when purchased as a recurring subscription.

PartyPriceSchedule

NameTypeDescription
SellerstringOptional seller identifier.
PartystringParty identifier.
PartyTypeintType of the party identifier:
1- User
2- UserGroup
3- Company
PriceSchedulePriceScheduleAssociated price schedule.

SellerDefaultPriceSchedule

NameTypeDescription
SellerstringSeller company identifier.
PriceSchedulePriceScheduleAssociated price schedule.

Category

NameTypeDescription
IDstringThe category identifier.
NamestringName of the category.
ActivebooleanTrue if the category is currently active.
ListOrderintThe order in which the category appears underneath the parent or catalog (if root level).

Spec

NameTypeDescription
IDstringThe spec identifier.
ListOrderintThe order in which this spec is shown.
NamestringThe name of the spec.
DefaultValuestringIf no Spec.Value is passed in the LineItemSpec, this value will be used.
RequiredboolIndicates if the spec is required.
AllowOpenTextboolFor Spec options that are not pre-defined, such as FirstName for a business card.
DefaultOptionIDstringThe default option.
DefinesVariantboolIf true, each unique combinations of this Spec's Options should map to a unique Product Variant.
OptionCountintThe number of options.
OptionsSpecOption[]List of spec options.
xpJson

SpecOption

NameTypeDescription
IDstringThe spec option identifier.
ValuestringName of the option.
ListOrderintThe order in which the option is shown.
IsOpenTextbool
PriceMarkupTypePriceMarkupTypeUsed to change the price of a product when a specific Spec Option is selected. It will be one of the following values:
0 - NoMarkup
1 - AmountPerQuantity
2 - AmountTotal
3 - Percentage
PriceMarkupdecimalPrice markup.
xpJson
If you have suggestions for improving this article, let us know!