BeyondERP.Newsletter
Menu

Setup step on the Trade allowance agreement period page · Sales and marketing

Set up Trade allowance agreement period

Use this page to set the date windows that orders, shipments, receipts and performance must fall in to qualify for a promotion.

Used by
Marketing manager, Accounts receivable clerk, Sales manager
Business process
Manage trade allowances
Menu item
TAMPromotionPeriod
Main table
TAMPromotionPeriod
Data entity
SalesTradeAllowanceAgreementPeriodEntity
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 setup page where you create the periods during which a promotion or sale is active, with separate order, ship, receipt and performance dates.
What you do hereUse this page to set the date windows that orders, shipments, receipts and performance must fall in to qualify for a promotion.
ExampleBEAT sets up period NEWYEAR-27: orders from 12/26/2026 to 1/5/2027, requested ship dates up to 1/10/2027 and performance until 1/31/2027. A customer order of 3,400.00 placed on 12/28/2026 and shipped on 1/8/2027 qualifies for the bill back.
Trade allowance agreement period 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.

Step by step, with screenshots

Set up Trade allowance agreement period1 screen

Use this page to set the date windows that orders, shipments, receipts and performance must fall in to qualify for a promotion.

  1. Screen 1

    Create a trade allowance agreement period

    Go to Sales and marketing > Setup > Trade allowance > Trade allowance agreement period

    1. Select New
    2. Enter the period name
    3. Under Dates, enter the order from and to dates
    4. Enter the requested receipt, requested ship and performance dates that apply
    5. Select Save
    6. Select the period on trade allowance agreements
    1Trade allowance agreement periodBEAT-TAP
    2Order from11/1/2026
    3Order to11/30/2026
    4Performance from11/1/2026
    5Performance to12/31/2026
    Create a trade allowance agreement period (zoomed on the outlined fields)
    Show the full screenCreate a trade allowance agreement period
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to Sales and marketing > Setup > Trade allowance > Trade allowance agreement period.
  2. Select New and enter the name of the period, for example Summer sale.
  3. On the Dates FastTab, in the Order field group, enter the first and last order dates.
  4. In the Request field group, enter the first and last ship dates.
  5. In the Requested receipt field group, enter the first and last receipt dates.
  6. In the Performance field group, enter the first and last dates for actions that earn a lump sum payout.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
OrderThe first and last dates on which a customer can order to qualify for the promotion.Microsoft Learn 11/1/2026 - 11/30/2026
RequestThe first and last dates on which an item can ship to qualify.Microsoft Learn 11/1/2026 - 12/10/2026
Requested receiptThe first and last receipt dates that qualify.Microsoft Learn 11/3/2026 - 12/15/2026
PerformanceThe first and last dates for the actions that earn a lump sum payout.Microsoft Learn 11/1/2026 - 12/31/2026
Trade allowance agreement periodThe name of the period, selected on trade allowance agreements.Microsoft Learn NEWYEAR-27PromotionPeriod
Order fromThe first order date that qualifies.Microsoft Learn 11/1/2026OrderStartDate
Order toThe last order date that qualifies.Microsoft Learn 11/30/2026OrderEndDate
Performance fromThe first date of the performance window for lump sums.Microsoft Learn 11/1/2026PerformanceStartDate
Performance toThe last date of the performance window for lump sums.Microsoft Learn 12/31/2026PerformanceEndDate

Common errors and fixes

MessageWhat to do
An order inside the promotion gets no bill backCheck that the order's dates fall inside the agreement's Order from and Order to, and that the agreement status is Confirmed. Microsoft Learn

Test checklist

  1. Create period NEWYEAR-27 with order dates 12/26/2026 to 1/5/2027.
  2. Use it on a trade allowance agreement and check that the agreement's Order from and Order to show those dates.
  3. Check that an order dated 1/6/2027 gets no bill back on Price details (0.00) and one dated 12/28/2026 does.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Trade allowance agreement periodOne named period per recurring promotion window, with the order, ship, receipt and performance windows agreed with sales before agreements are created.The period holds the date windows that orders, shipments, receipts and performance must fall in, and an agreement only applies to orders between its order dates.Should periods be reusable or per agreement?Setting only the order window and leaving the performance window too short, so lump sum performance after the order window doesn't count.Test: Order dates decide qualification

Feature management and licence

Licence or add-inOn the live system, Marketing manager, Accounts receivable clerk and Sales manager 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: Periods can be edited; existing claims aren't recalculated.
If you change it laterThe period sets the date windows an agreement is valid for: orders outside Order from and Order to don't get the promotion. Changing a period affects agreements created from it afterwards; check existing agreements' dates separately. Microsoft Learn
Technical architect

6Technical

Menu itemTAMPromotionPeriod Checked in Dynamics 365
FormTAMPromotionPeriod Checked in Dynamics 365
TableTAMPromotionPeriodShown as “Trade allowance agreement period” in Record infoChecked in Dynamics 365
Data entitiesSalesTradeAllowanceAgreementPeriodEntityTrade allowance agreement periods Microsoft data model
Who can open itPrivilegesMaintain trade allowance periods TAMPromotionPeriodMaintainDutiesMaintain 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=TAMPromotionPeriod
Integrate withSalesTradeAllowanceAgreementPeriodEntity data entity Microsoft data model
Data migrationSalesTradeAllowanceAgreementPeriodEntity (Trade allowance agreement periods): loaded for each company.Load order: Load periods before the trade allowance agreements that refer to them.Checked in Dynamics 365
Table definitionTAMPromotionPeriod columns and relations Microsoft data model
Everyone

8Sources

To cite this step: SM-SETUP-710, Set up Trade allowance agreement period. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SM-SETUP-710