Adding Product Attributes

Use the Products API to manage attributeValue information in the database. AttributeValue details include product tax code, price, size, color, image, brand, and description. The Product Attribute Values data collection defines attributes associated with a product item, such as name, value, and audit date. Each product attribute has different options associated with it. Valid values for attributeValue depend on the value used for attributeName.

The following table describes the collection of Product Attribute Values for the productAttributeValues parameter in the ProductDataAttribute data collection.

Name	Description
attributeName	Defines the name of an attribute. This parameter accepts one or more of the following values: CompanyPrefix—Defines the manufacturer's company prefix. DisableItemLevelManualDiscounts—Specifies whether or not to disable manual discounts and price changes on an item in a sale or return transaction without restricting other discounts, including AMS offers. Note This attribute requires that the NoDiscount attribute is set to false and the Amount Off, Percent Off, and Price Override buttons are configured to display on the item-related options panel of the POS application. DividendEligible—Specifies the initial status of dividend eligibility for an item. FrankLevel—Specifies whether the POS application prints item-level franking information, prints transaction-level franking information, or does not require franking. GiftCardItemFlag—Specifies whether or not an item is a gift card product code or UPC. This determines whether or not the POS initiates a gift card sale flow. ItemActivation—Determines whether or not an item requires activation. Note This attribute requires additional retailer integration. ItemBasedPromptScheme—Specifies the Info Set Names used for SKU-based prompting using comma-separated values. NoDiscount—Specifies whether or not to allow discounts on an item. PromptForPriceFlag—Specifies whether or not the POS prompts for an item price. PromptForResale—Specifies whether or not the POS prompts for a resale barcode when an item is sold. ReturnDays—Defines the number of days that an item is eligible for return. ReturnReasonNotRequired—Specifies whether or not the POS prompts for a reason code when an item is returned.
attributeValue	Defines the value for the product item attribute corresponding to the attributeName specified. Refer to the attributeValue table, below, for a description of the values accepted for each attribute name. Note attributeValue must be a properly-formatted JSON string.
attributeOldValue	Changes or updates the existing value of an attribute.
customerAuditDate	Specifies the date when the audit information of the product group was last modified.

attributeValue

The following table describes the valid values for the attributeValue parameter based on each attributeName value. The attributeName can have any value, which means that it accepts any non-defined attribute names, and these will pass through the POSLog.

attributeName	attributeValue
CompanyPrefix	Defines the manufacturer's company prefix. This prefix is used to validate GS1 Databar Manufacturer coupon entry.
DisableItemLevelManualDiscounts	Specifies the manual item-level discounts to disable using the following comma-separated values: DollarOff—Indicates that the POS disables the Amount Off button on the item-related options panel. PercentOff—Indicates that the POS disables the Percent Off button on the item-related options panel. PriceChange—Indicates that the POS disables the Price Override button on the item-related options panel.
DividendEligible	true—Indicates the initial dividend eligible status of item. false— Indicates the initial dividend eligible status of item.
FrankLevel	Item—Indicates that the POS application should print item-level franking information for the product when it is added to a sales transaction. Transaction—Indicates that the POS application should print transaction-level franking information for the product at the end of a sales transaction. None—Indicates that there are no franking requirements.
GiftCardItemFlag	true—Indicates that the item is a gift card product code or UPC. Scanning the item at the Sale Main Menu initiates a gift card sale flow. false—Indicates that the item is not a gift card product code, and the POS does not initiate a gift card sale flow at the Sale Main Menu.
ItemActivation	Type—the type of activation required for the product. Retailers can provide any type value to be sent to an external service. Properties—an optional collection of key-value pairs that can be included in the activation request to an external service. For example: “Vendor”:”VND123”
ItemBasedPromptScheme	ItemDetails—the name of the Information Set used for SKU-based prompting. This value must match the Info Set Names value specified in the Information Form Definitions options group. PaymentDetails DataCarryover—Valid values: true/false. ReturnStatus—defines whether the item can be returned or not. Valid values: 0/1. ReturnDetails—the name of the Information Set used for SKU-based prompting. This value must match the Info Set Names value specified in the Information Form Definitions options group. Example { 'ItemDetails': 'PetTrainingPrompt', 'PaymentDetails': '', 'DataCarryover': 'true', 'ReturnStatus': '0', 'ReturnDetails': 'PetTrainingReturnPrompt' }
NoDiscount	true—Indicates that the POS should not accept discounts for the item. false—Indicates that the POS should accept discounts for the item.
PromptForPriceFlag	true—Indicates that the POS prompts for the item's price. false—Indicates that the POS does not prompt for the item's price.
PromptForResale	true—Indicates that the POS prompts for a resale barcode entry when the item is sold. false—Indicates that the POS does not prompt for a resale barcode entry when the item is sold.
ReturnDays	Integer—Defines the number of days that an item is eligible for return. If this attribute is not set, then the item falls under the default (EOM) return days policy. Note This attribute is only intended for items that fall outside the default return days.
ReturnReasonNotRequired	true—Indicates that the POS does not prompt for a return reason code if the item is returned. false—Indicates that the POS prompts for a return reason code if the item is returned.