Package promotions are applied to one or more items selected by the user.
To install Package 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.
Select Package 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 you want to create Package Trade Promotions for.
- Modify the Items Scope of the Transaction Types you installed the Package Trade Promotions on, in the Pepperi Studio back office.
- Check internal delimiter
- Create Items list
- Create a shortcut button to the editor for the user who will be configuring the trade promotions (marketing manager, sales manager etc.)
- Advanced: Run the Package Promotion Editor Setup
- Advanced: Setting Custom Transaction Fields
Detailed instructions for each step appear below.
The Package Trade Promotions Add on will be added. For Package Trade Promotions to be configured, you must run the installation for each Transaction Type you wish to have Package Trade Promotions for. or example: B2B Transaction, Sales Rep Order, etc.
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 on Package Trade Promotion
Select the Transaction Type that will support Package 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_PackagePromotion'
- User defined fields in the selected transaction type with the prefix of PPI_PackagePromotion' (in addition to any existing custom fields you already may have in this Transaction)
You'll need to modify the Transaction Type as follows:
Navigate to the 'Settings' tab in the selected Transaction type and add the following rule to the 'Transaction Items Scope' setting:
PPI_PackagePromotion_ShowPackageItem isEqual True
Note: If a Items Scope rule already exists then the above should be added with an 'And' operator to the current rule.
One more thing to check in the Studio: make sure your internal delimiter is set to a semi-colon ( ; ) under Settings -> ERP Integration -> Configuration
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 Package 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
Package Promotions may be defined in multiple phases, for example:
Purchase 5 items from a list of items (phase 1) -> and select 2 items for free from another list (phase 2)
The Package Promotion Editor Setup is required to set which transaction will be used as the first phase in the Package, and which will be used as the "next" or additional phase.
Select Package promotions editor setup from the menu:
The default Package transactions will be selected - one Transaction from the Package item transaction column for the first phase, and one from the Additional items transaction column for the "next" or additional phase.
You can add more transactions for either of the phases with your own configurations for the views and settings.
For example: if you're selling kits with pre-defined quantities (user cannot change), you'll need to add a transaction type with the Unit Quantity field set to Read Only (because in the default packages, the user can select the quantities they want for each item).
Adding a Package Promotion Transaction Type
The Package Promotion Transaction Types are not created like the others under Sales Activities. To add these kinds of transactions go to:
Settings -> Pricing Policy -> Campaigns
Enter the name, description, and select "PPI_PackagePromotion" template and Save.
(If you wanted to have an "Additional free or discounted items (phase 2)" option with read only quantities for any of your packages, then you need to create an Additional Items phase (phase 2) with a read-only Unit Quantity, by choosing the PPI_PackagePromotion_AdditionalItems template.
Edit the new Transaction, and select Edit Campaign Transaction Type from the Actions menu. Note the Transaction ID number which you'll use later to enable this transaction for use in the Editor.
You will now be in a regular Transaction Type editing view, where you can edit any aspect of the transaction as you do your Sales Order and other transactions.
You should go to the General Tab and enter a name and description that will make it easy to recognize by the user creating packages in the Package editor.
The Name MUST START WITH PPI_PackagePromotion
Append a descriptive word after this mandatory prefix, for example PPI_PackagePromotion_Kit
Then edit the Order Center views enabled in the transaction so that the units quantity field will be marked Read Only.
Edit the Unit Quantity to be Read only:
You will also need to select this transaction in the Package promotions editor setup, so that it can be used when creating your packages in the Editor. You'll see the name you entered that starts with PPI_PackagePromotion:
Now, when a user creates new Packages in the editor, they will have an additional option to indicate which package to use: the default (PPI_PackagePromotion) or the new type you created for the kits (in this example "Predefined Kit"):
The PPI_PackagePromotion Transaction Types which display the phase 1 and phase 2 items are connected to the Default Catalog. If you are using multiple catalogs, and have limited your Default catalog not to include items that you may want in those phases, then you'll need to edit those Package Promotion Transaction Types to be assigned to the relevant Catalogs. To edit these Transaction Types you will need to access them via:
Pricing Policy ->Campaigns
Actions -> Edit Campaign Transaction Type
(as described above in the Package Kit instructions)
Go to the Settings tab to connect the catalogs relevant for those phases:
If you have Transaction line-item custom fields in the original transaction (ie your "Sales Order") and you wish them to have values for the items which were added in the package (additional items) you will need to add those fields to the Merge action in both package transactions (Package item and Additional items).