commerce/catalog/admin/attributedefinition/producttypes/properties

Use the Properties subresource to define how property product attributes are used for a specific product type. Product attribute definitions are unique for each associated product type.

JSON Example

AttributeInProductType Properties

Property Description
attributeDetail

type: attribute

The product attribute details common between all attribute types - properties, options, and extras.

attribute.adminName

type: string

The administrator name associated with the object/data.

attribute.attributeCode

type: string

Merchant-defined code for an extensible attribute. This code may be used to generate an object's fully qualified name, such as for products.

attribute.attributeDataTypeSequence

type: int

Generated sequence that increments for each attribute and data type combination created. This value is system-supplied and read-only.

attribute.attributeFQN

type: string

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

attribute.attributeMetadata

type: list of attributeMetadataItem

List of metadata key-value pairs defined for an extensible attribute.

attribute.attributeMetadataItem.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.

attribute.attributeMetadataItem.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.

attribute.attributeSequence

type: int

Generated sequence that increments for each product attribute created. This value is system-supplied and read-only.

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

attribute.auditInfo.createBy

type: string

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

attribute.auditInfo.createDate

type: DateTime

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

attribute.auditInfo.updateBy

type: string

Identifier of the user that updated the entity most recently.

attribute.auditInfo.updateDate

type: DateTime

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

attribute.content

type: attributeLocalizedContent

Localizable content (such as a name and/or description) for an attribute. The content may be localized when displayed according to the locale code specified by the master catalog. Content can include descriptive text for product extensible attributes, catalog-level descriptions (displayed if isContentOverriden is true), product bundles, and customer account notes.

attribute.attributeLocalizedContent.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.

attribute.attributeLocalizedContent.localeCode

type: string

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

attribute.attributeLocalizedContent.name

type: string

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

attribute.dataType

type: string

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

attribute.inputType

type: string

The type of input selection used to define a value for the attribute, including Yes/No, Date, DateTime, List, TextBox, or TextArea.

attribute.isExtra

type: bool

If true, the product attribute is an add-on configuration made by the shopper that does not represent a product variation, such as a monogram.

attribute.isOption

type: bool

If true, the product attribute is a merchant- or shopper-configurable option, such as size or color, that represents a product variation.

attribute.isProperty

type: bool

If true, the product attribute describes aspects of the product that do not represent an option configurable by the shopper, such as screen resolution or brand.

attribute.localizedContent

type: list of attributeLocalizedContent

The localized content associated with the object.

attribute.attributeLocalizedContent.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.

attribute.attributeLocalizedContent.localeCode

type: string

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

attribute.attributeLocalizedContent.name

type: string

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

attribute.masterCatalogId

type: int

Unique identifier for the master catalog.

attribute.namespace

type: string

The namespace for the accessible APIs and source capabilities in the core of Kibo eCommerce APIs.

attribute.searchSettings

type: attributeSearchSettings

The settings to control product search and indexing behavior.

attribute.attributeSearchSettings.allowFilteringAndSortingInStorefront

type: bool

Indicates whether the attribute should be able to be used in filters, facets, and sorting on the public storefront.

attribute.attributeSearchSettings.customWeightInStorefrontSearch

type: bool

When set to true, enables you to set a custom search weight for a product attribute in search-settings.

attribute.attributeSearchSettings.indexValueWithCase

type: bool

Specifies whether to create a case-sensitive Solr search index. The default is false.

attribute.attributeSearchSettings.searchableInAdmin

type: bool

Indicates whether the attribute value is searchable in the merchant catalog admin.

attribute.attributeSearchSettings.searchableInStorefront

type: bool

Indicates if the attribute value is searchable on the public storefront.

attribute.attributeSearchSettings.searchDisplayValue

type: bool

Indicates what kind of values search queries and returns. If true, the system indexes the display value of string attributes instead of the canonical value for searching. Always use the canonical value for filtering. This does not apply for non-string attributes.

attribute.validation

type: attributeValidation

Properties used when validating a value entered for an object, including extensible attributes, products attributes, and database entries.

attribute.attributeValidation.maxDateValue

type: DateTime

The maximum date allowed including month, day, and year. System-supplied and read-only.

attribute.attributeValidation.maxNumericValue

type: decimal

The maximum number that can be entered as a value for an extensible attribute.

attribute.attributeValidation.maxStringLength

type: int

The maximum character length possible for a string value entered for an extensible attribute.

attribute.attributeValidation.minDateValue

type: DateTime

The minimum date allowed including month, day, and year. System-supplied and read-only.

attribute.attributeValidation.minNumericValue

type: decimal

The minimum numeric value required to validate an extensible attribute.

attribute.attributeValidation.minStringLength

type: int

The minimum character length possible for a string value entered for an extensible attribute.

attribute.attributeValidation.regularExpression

type: string

Regular expression used to process and validate an extensible attribute value that require special formatting, such as phone numbers.

attribute.valueType

type: string

An attribute value type is either predefined vocabulary set by the admin during attribute set up, or user-defined with an appropriate type (AdminEntered or ShopperEntered, depending on the user). These types are used by products and attributes. To use a predefined value, you can set this parameter as "predefined" and whatever the admin entered in the Product Attributes > Create New Attribute interface menu will become the predefined value on the attribute. AdminEntered and ShopperEntered are values that are entered rather than system-supplied and are not stored in the database, but captured during a live commerce operations such as during an order.

attribute.vocabularyValues

type: list of attributeVocabularyValue

List of valid vocabulary values defined for an attribute.

attribute.attributeVocabularyValue.content

type: attributeVocabularyValueLocalizedContent

Localizable content (such as a name and/or description) for an attribute. The content may be localized when displayed according to the locale code specified by the master catalog. Content can include descriptive text for product extensible attributes, catalog-level descriptions (displayed if isContentOverriden is true), product bundles, and customer account notes.

attribute.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.localeCode

type: string

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

attribute.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.stringValue

type: string

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

attribute.attributeVocabularyValue.displayOrder

type: int

The order in which the attribute value displays. If you omit a value for this property, Kibo eCommerce infers the display order from the attribute value's position the list.

attribute.attributeVocabularyValue.localizedContent

type: list of attributeVocabularyValueLocalizedContent

The localized content associated with the object.

attribute.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.localeCode

type: string

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

attribute.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.stringValue

type: string

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

attribute.attributeVocabularyValue.productName

type: string

The name of the product that represents a line item in a taxable order or product bundle.

attribute.attributeVocabularyValue.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.

attribute.attributeVocabularyValue.valueSequence

type: int

The number that denotes the order of the entity value within a list of entity values.

attributeFQN

type: string

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

displayInfo

type: attributeInProductTypeDisplayInfo

Defines the intended display of this attribute in the storefront. Options include Drop Down, Image Picker, and Radio Buttons.

attributeInProductTypeDisplayInfo.displayIntention

type: string

Defines the intended display of this attribute in the storefront. Options include Drop Down, Image Picker, and Radio Buttons.

isAdminOnlyProperty

type: bool

If true, this property is not available on the storefront. If false, this property will be available on storefront. The IsHiddenProperty hides the property from the customer, but is still available from the API.

isHiddenProperty

type: bool

If true, this property is hidden on the storefront. If false, this property is not hidden from the storefront.

isInheritedFromBaseType

type: bool

If true, this entity is inherited from the base type. If false, this entity is not inherited from the base type.

isMultiValueProperty

type: bool

If true, this attribute has more than one possible value.

isProductDetailsOnlyProperty

type: bool

If True this property will not be returned storefront product listings (Search,GetProduct) it will still be returned on GetProduct, ValidateProduct...)

isRequiredByAdmin

type: bool

If true, the entity is required by the admin. If false, the entity is not required by the admin.

order

type: int

Integer that represents the sequence order of the attribute.

vocabularyValues

type: list of attributeVocabularyValueInProductType

List of valid vocabulary values defined for an attribute.

attributeVocabularyValueInProductType.displayInfo

type: attributeVocabularyValueDisplayInfo

Defines the intended display of this attribute in the storefront. Options include Drop Down, Image Picker, and Radio Buttons.

attributeVocabularyValueInProductType.attributeVocabularyValueDisplayInfo.cmsId

type: string

The identifier of the image in the Kibo eCommerce CMS. Supply a value for either the CMS ID or Image URL parameter.

attributeVocabularyValueInProductType.attributeVocabularyValueDisplayInfo.colorValue

type: string

Hex value for a color to display in a color picker. This is an HTML supported code for color.

attributeVocabularyValueInProductType.attributeVocabularyValueDisplayInfo.imageUrl

type: string

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

attributeVocabularyValueInProductType.order

type: int

Integer that represents the sequence order of the attribute.

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

attributeVocabularyValueInProductType.vocabularyValueDetail

type: attributeVocabularyValue

Navigates vocabulary value details for an attribute defined for a product type.

attributeVocabularyValueInProductType.attributeVocabularyValue.content

type: attributeVocabularyValueLocalizedContent

Localizable content (such as a name and/or description) for an attribute. The content may be localized when displayed according to the locale code specified by the master catalog. Content can include descriptive text for product extensible attributes, catalog-level descriptions (displayed if isContentOverriden is true), product bundles, and customer account notes.

attributeVocabularyValueInProductType.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.localeCode

type: string

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

attributeVocabularyValueInProductType.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.stringValue

type: string

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

attributeVocabularyValueInProductType.attributeVocabularyValue.displayOrder

type: int

The order in which the attribute value displays. If you omit a value for this property, Kibo eCommerce infers the display order from the attribute value's position the list.

attributeVocabularyValueInProductType.attributeVocabularyValue.localizedContent

type: list of attributeVocabularyValueLocalizedContent

The localized content associated with the object.

attributeVocabularyValueInProductType.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.localeCode

type: string

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

attributeVocabularyValueInProductType.attributeVocabularyValue.attributeVocabularyValueLocalizedContent.stringValue

type: string

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

attributeVocabularyValueInProductType.attributeVocabularyValue.productName

type: string

The name of the product that represents a line item in a taxable order or product bundle.

attributeVocabularyValueInProductType.attributeVocabularyValue.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.

attributeVocabularyValueInProductType.attributeVocabularyValue.valueSequence

type: int

The number that denotes the order of the entity value within a list of entity values.

Operations

Operation Name Request URI Description
AddProperty POST %7bproductTypeId%7d%2fProperties%3fresponseFields%3d%7bresponseFields%7d

Assigns a property attribute to the specified product type, according to the information defined in the request.

DeleteProperty DELETE %7bproductTypeId%7d%2fProperties%2f%7battributeFQN%7d

Removes a property attribute previously defined for the specified product type.

GetProperties GET %7bproductTypeId%7d%2fProperties

Retrieves a list of product property attributes defined for a product type.

GetProperty GET %7bproductTypeId%7d%2fProperties%2f%7battributeFQN%7d%3fresponseFields%3d%7bresponseFields%7d

Retrieves a product property attribute definition for the specified product type.

UpdateProperty PUT %7bproductTypeId%7d%2fProperties%2f%7battributeFQN%7d%3fresponseFields%3d%7bresponseFields%7d

Updates the definition of a property attribute for the specified product type.