BeyondERP.Newsletter
Menu

Setup step on the Templates page · Sales and marketing

Set up the trade allowance template for one-time promotions

Use this page to keep new agreements consistent and to let the deduction workbench settle unmatched deductions as one-time promotions.

Used by
Marketing manager, Accounts receivable clerk, Sales manager
Business process
Manage trade allowances
Menu item
TAMTemplateListPage
Main table
TAMTradePromotion
Data entity
TAMTradeAllowanceAgreementHeaderEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA page where you set up trade allowance templates with default values for new trade allowance agreements.
What you do hereUse this page to keep new agreements consistent with the organization's marketing objectives.
ExampleFor example, BEAT's customer BEAT-000310 deducts 450.00 from a payment for in-store display costs with no approved rebate to match. The collections manager settles it as a one-time promotion; the new agreement takes its currency and period from template ONE-TIME.
Templates page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up the trade allowance template for one-time promotions

Use this page to keep new agreements consistent and to let the deduction workbench settle unmatched deductions as one-time promotions.

Steps from Microsoft

  1. Go to Sales and marketing > Trade allowances > Templates.
  2. On the Action Pane, select New.
  3. Enter the information that new agreements should get from the template.
  4. On the Customers FastTab, in the Hierarchy field, select a hierarchy level.
  5. Select the customer and select the right arrow button to add it.
  6. Set the remaining fields and close the page.
  7. Go to Trade allowance management parameters, and on the Overview tab select the template in the One-time promotion template field.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
HierarchyThe customer hierarchy level used to pick the customers for the template.Microsoft Learn BEAT by region
CurrencyThe currency used with the template.Microsoft Learn USDCurrency
Trade allowance agreement periodThe default agreement period, or specific order dates.Microsoft Learn Q1 2027

Common errors and fixes

MessageWhat to do
Settle deduction as one-time promotion doesn't create the agreement.Select the template in One-time promotion template on the Overview tab of Trade allowance management parameters, make sure the customer is in the template's Trade allowance agreement customers, and enter funds whose percentages total 100 percent. Microsoft Learn

Test checklist

  1. Create a template, pick a level in Hierarchy on the Customers FastTab and move the customer that has an unmatched deduction to Trade allowance agreement customers.
  2. In Trade allowance management parameters, on the Overview tab, select the template in One-time promotion template.
  3. On the Deduction workbench, mark that customer's deduction and select Maintain > Settle deduction as one-time promotion, with funds that total 100 percent.
  4. Check that a new trade allowance agreement with a lump sum merchandising event is created with the template's values and that the deduction is matched.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up the trade allowance template for one-time promotionsKeep one template for one-time promotions, with the customers that can take unmatched deductions, and select it in One-time promotion template in Trade allowance management parameters.The one-time promotion feature creates a new trade allowance agreement with a lump sum event from this template and matches the lump sum to the deduction.Leaving the customer with the unmatched deduction out of the template's Trade allowance agreement customers.Test: A deduction is settled as a one-time promotion from the template

Feature management and licence

Licence or add-inOn the live system, Sales manager, Marketing manager and Accounts receivable clerk use this page.

Checked in Dynamics 365

Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: Changes affect agreements created later.
If you change it laterThe template's values are copied into each agreement created from it, including the agreement with a lump sum merchandising event that Settle deduction as one-time promotion creates on the deduction workbench. Changing it affects new agreements only. Microsoft Learn
Technical architect

6Technical

Menu itemTAMTemplateListPage Checked in Dynamics 365
FormTAMTemplateListPage Checked in Dynamics 365
TableTAMTradePromotionShown as “Trade allowance” in Record infoChecked in Dynamics 365
Data entitiesTAMTradeAllowanceAgreementHeaderEntityTrade allowance agreement headers Microsoft data model
Who can open itPrivilegesMaintain trade allowance list pages TAMTemplateListPageMaintainDutiesMaintain trade allowances TAMMaintain
3 security rolesMarketing manager CRMMarketingManagerAccounts receivable clerk CustInvoiceAccountsReceivableClerkSales manager TradeSalesManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSales manager TradeSalesManagerMarketing manager CRMMarketingManagerAccounts receivable clerk CustInvoiceAccountsReceivableClerkGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=TAMTemplateListPage
Integrate withTAMTradeAllowanceAgreementHeaderEntity data entity Microsoft data model
Data migrationTAMTradeAllowanceAgreementHeaderEntity (Trade allowance agreement headers): templates share the trade allowance table; check the template flag when loading.Load order: No default configuration template places this entity. Load templates after the customer category hierarchies, then select the one-time promotion template in Trade allowance management parameters.Load first: Customer category hierarchyMicrosoft Learn
Table definitionTAMTradePromotion columns and relations Microsoft data model
Everyone

8Sources