Items promotions are applied to a specific item based on quantity or price tiers.
To install Item Trade Promotions, log in to the Pepperi Webapp (you must log in via the new login) as an Admin user.
Click on Settings ⚙ -> Tools Setup -> Add
NOTE: If you have a custom Webapp Main Bar configured in the webapp, the Settings gear will not be visible. You will need to remove the custom Main Bar for the Admin profile only (add the Admin profile to the Webapp Main Bar customization with no file selected). This will not affect the view of buyers or other profiles using the webapp.
One more thing to check in the Studio: make sure your internal delimiter is set to a semi-colon ( ; ) under Settings -> ERP Integration -> Configuration
Select Item Trade Promotions -> OK
(If you don't see the add-on you want in the list or get a notification that you don't have access to install this Add on, contact us to enable it)
Steps to completing the installation
To complete the installation, the admin must complete the following steps. Once the admin completes these steps, then any user can use the promotions editor to create the promotions themselves.
- Run the installation for each Transaction Type where Item Trade Promotions should be applied.
- Define Promotion Types in the Types Editor
- Create at least one Items list
- Create a shortcut button to the editor for the user who will be configuring the trade promotions (marketing manager, sales manager etc.)
Detailed instructions for each step appear below.
After installation the Item Trade Promotions Add on will be added. For Item Trade Promotions to be configured, you must run the installation for each Transaction Type where Item Trade Promotions should be applied.
For example: B2B Transaction, Sales Rep Order, etc.
Note: Best practice!
It is best practice to first duplicate the transaction you use - for example duplicate your Sales Order Transaction to "Sales Order with Promotions" - and install the promotion on the duplicated transaction. That way you can use the new transaction (with the promotions) during the configuration and testing period and once done, run the installation again on the original transaction. (Keep in mind, you may need modify any promotion types you created that limit promotions by Transaction Type to the "Sales Order with Promotions" to apply to the original "Sales Order" as well. Promotion types are explained below.)
To run the installation click the green arrow:
Select the Transaction Type that will support Item Trade Promotions (note the best practice tip above before selecting your transaction).
After the installation, the following objects will be created in your Pepperi back office.
NOTE: Do not delete or change these objects otherwise the promotion will not work properly.
- User defined tables with the prefix of 'PPI_ItemPromotion'
- Custom Transaction Line-Item fields in the selected Transaction Type with the prefix of 'PPI_ItemPromotion' (in addition to any existing custom fields you already may have in this Transaction)
In order to use Item Trade Promotions, you must first define the combinations of properties that the item promotions apply to. These are called "Item Promotion Types", and they are defined in the Item Promotions Types Editor. Their values will later be selected in the Promotions Editor to define the promotions themselves.
Here are some examples:
|Promotion Applies to||
Properties to add to the Item Promotion Type
(Object -> Property)
|Medium sized Accounts, and Items of Brand "X"||
Account -> Size
Item ->Main Category
|Small customers located in City "A", and Items in SubCategory "S" only when buyers are ordering on Pepperi B2B eCommerce site||
Account -> Size
Account -> City
Item -> SubCategory
Transaction -> Type
Items in SubCategory "F", only when sales reps are ordering on the app for all customers
Item -> SubCategory
Transaction -> Type
In the Type definition, you define which fields will be used, and not the values of the fields to be filtered. (You will define the values in the Item Promotion editor).
Select the Item promotion types editor, and click +Add, to define a type.
Description - name the Promotion Type, make it a descriptive name so that it is clear to the person who will need to select the type in the Promotions Editor.
Priority - give a priority to each type. If there is more than one Item Promotion that applies to certain Items, then the promotions will be applied in order of their priority.
The priority is relevant only if you don't want to apply multiple promotions.
Apply multiple promotions -
- Yes, continue to the next promotion - means that all promotions will apply on top of each other. In this case, the Priority does not matter, enter "1" for Priority.
- No - means that if more than one Item Promotion applies to the Item, then no additional promotions will be applied after the current one.
Example: There is an Item of Brand A with a discount, and Brand A itself also has a discount
Brand discount - Priority=1
Item discount - Priority=2
If you choose "Yes, continue to next promotion" on Brand promotion type - the customer gets both discounts
If you choose "No" on the Brand promotion type - they get only the Brand discount, will not continue to the next promotion
Object Type - Select the object of the Promotion Type fields - Account, Item, or Transaction
Property - Select the field for the Object type, includes custom fields.
Click Add + to add more properties.
Continue to add all the types that you will need Item Trade Promotions defined for.
Before configuring Trade Promotions in the editor, the admin will need to create at least one Items List . (If you've already created the Items List for another type of Trade Promotion, no need to do it again. The same list can be used to configure all Promotion types).
To create an Items List - Item Lists
When creating the list, make sure to include fields in the table layout, and properties in the Smart Search of each list that will enable quick filtering of the lists, so that it's easier to find the Items that the promotions will apply to.
The user who will configure the promotions in the editor will need access to the editor page (they won't have access via the Tools Add-ons if they are not an Admin). Copy the editor page link and add it as an Online Add-on shortcut button to the user's Pepperi home screen.
If you want the user to have access to the editors for all 3 types of Trade Promotions - Item, Order, and Package - you will need to create 3 shortcuts (each editor has its own link. Instructions for each editor are in the installation guide for that editor).
To copy the link: click on the Items Promotions Editor in the Add-on menu
When the editor loads, copy the URL. It will look like this (with your ID):
Then add it as an online add-on button on the user's home screen - How to add shortcuts to links on the App Home Screen and Menus
User's home screen with Promotion Editor shortcut buttons