Introduction
This lecture describes how to configure a partition so that end-users can create promotions in the Agreements & Promotions capability. When setting up a promotion, the end-users will set the contract terms with input parameters, and see the estimated impact of the promotion in the calculation results.
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Learning Path Disclaimer: Although this learning path offers comprehensive information on the mentioned capability, it lacks a Pricefx environment, that is only available in our instructor-led training, where you can interact with these features and practice using them. |
| Tip |
|---|
For further insights into the distinctions between our on-demand learning paths and instructor-led training, please click here. |
Overview
About Promotions
In marketing, a promotion or an agreement is an incentive for buyers to initiate purchases. Typically, it lowers the prices of selected products and services — for selected buyers — during a limited amount of time. For example:
...
Promotions and Agreements are different names that typically refer to the same thing, based on the use case.
Variety of Use cases
In Pricefx the Agreements & Promotions capability is often used also for quote type activities or complicated contracts, where:
Prices need to be set at the product group or customer group levels rather than just individual customer / sku
There are distinctly different types of pricing that need to be done in a single “document” – like a standard price agreement and another type of term that is managed by the same business process.
example for this: both "standard" pricing (which had several distinctly different levels) and "supplemental" agreements need to be handled as one “deal” by the sales team.
The Agreements & Promotions Capability
The Agreements & Promotions lets the end-users — typically marketeers — define promotions in one central place. Here, the end-users creates a document which specifies the terms and conditions. The document will then display estimations of how big impact the discount will have.
...
In Pricefx, contract is the technical name for a promotion or agreement document
In UnityPricefx, the labels can be changed to display Promotions — or Contracts or Agreements.
...
A line item has input parameters — which allows the end-users to specify thresholds, discounts, product ranges, etc — and element outputs — which typically contains estimations of the impact of the promotion.
...
Agreements & Promotions Types
For Agreements & Promotions you can create multiple different types. Navigate to Agreements & Promotions → Agreements & Promotions types.
...
Figure 5. Each line item (Condition) references a Condition type, and each Condition type references a calculation logic. The Condition type also has attribute1..30 columns that can be accessed by the logic.
Contract Calculation
When the end-user clicks on Recalculate, or when he/she submits the document for approval, the contract is sent to the backend for calculation. There, for each line item, the associated calculation logic is invoked and the result is saved on the line item. Thus, a big difference between quotes and contracts is that the quote’s quote type applies to the entire document, while the contract’s contract term types applies to the line item.
...
Figure 7. Schematic representation of the contract calculation which occurs when the document is saved and approved.
Accessing the Condition Type Within the Logic
Sometimes, it can be useful to access the Condition type from within the calculation logic. For example
...
| Code Block |
|---|
api.find('CTT', 0, 1, null, Filter.equal('uniqueName', contractTermTypeName)) |
Price Records
When a promotion has been set up, it needs to be used somewhere else; either in other modules, or in some external systems. Therefore, when a contract is approved, a set of price records are generated.
...
The Agreements & Promotions Price Record page only displays price records that originates from contracts. (Unity Pricefx applies a filter on the Source ID field when it queries the Price Record table).
Differences between Quote and Contract
A Quote uses one Customer on the Header and then each Line item has one product. Each line represents conditions negotiated for single product.
Whereas the Contract Header can define none, one or a group of Customers and each Line item can have different Customers too (or it can simply inherit the group of Customers from the Header). A Line item of a Contract can represent conditions for one Product, but also for a group of Products.
Summary
When end-users wants to create promotions, they need to first create a contract. Among other properties, a contract has a label, a validity date range, a header and line items.
...
The next lecture details how a promotion can be implemented in other modules, by using the price records.
References
Developer Documentation
Documentation (Classic)
Older Training Materials
...
Accelerators (credentials based access)
| Info |
|---|
NOTE: If you have any inquiries regarding the content in this section, you can utilize the following online Pricefx forums: AskPricefx community or Pricefx GenAI chatbot. |
| Tip |
|---|
For further Pricefx training and certification information, click here. |
⏲️ Time commitment: For this path you should dedicate approximately 4 hours.