BeyondERP.Newsletter
Menu

Setup page · Pricing management

Free item

A list page that shows only free-item discount pricing rules, where you view, create, and edit them.

Used by
Retail merchandising manager, Retail operations manager, Retail service and 3 more roles
Business process
Set product prices
Menu item
GUPFreeItemDiscount
Main table
RetailPeriodicDiscount
Data entity
RetailDiscountEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA list page that shows only free-item discount pricing rules, where you view, create, and edit them.
What you do hereUse this page to set up discounts that add products to an order at no cost when the customer orders a required quantity or amount.
Free item 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

Business processIntroduce products › Set product prices
Menu pathPricing management › During-sales pricing › Discounts › Free item
Set up firstPrice component codes Microsoft Learn
Related pagesAll discounts Microsoft Learn
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 Free item

Use this page to set up discounts that add products to an order at no cost when the customer orders a required quantity or amount.

Steps from Microsoft

  1. Go to Pricing management > During-sales pricing > Discounts > Free item.
  2. Select New on the Action Pane, and then select the type of record to create.
  3. Enter a unique identifier in the Discount field and a name in the Name field.
  4. Set the fields on the General FastTab, such as Discount concurrency mode.
  5. On the Lines FastTab, add lines and enter the Required line quantity or Required line amount.
  6. Set the Status field to Enabled when the rule is ready.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
DiscountThe unique identifier of the pricing rule.Microsoft Learn OfferId
NameA common name for the pricing rule.Microsoft Learn
Required line quantityThe minimum quantity that must be ordered to qualify, when the criteria type is Quantity.Microsoft Learn LeastQuantity
Required line amountThe minimum amount that must be ordered to qualify, when the criteria type is Amount.Microsoft Learn LeastAmount
Coupon code requiredWhether a valid coupon code must be entered with the order for the discount to apply.Microsoft Learn IsDiscountCodeRequired
ClaimableWhether the discount is sponsored by a vendor and can be charged back to that vendor.Microsoft Learn

Test checklist

  1. Create a free-item discount with a line where Required line quantity is 5 for one item.
  2. Enable the rule with a validation period that includes today.
  3. Create a sales order for 4 units and check no free item is added.
  4. Change the quantity to 5 and check the free item is added at no cost.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Free itemEditing a live free-item rule. Enabled rules are read-only, and setting Status to Disabled stops the free item from being added until you enable the rule again.

Number sequences

ReferenceShared or per companyNote
DiscountPer companyNew records on this page take their Discount from the RetailOfferIdEx3 reference; BEAT uses number sequence Comm_79. Checked in Dynamics 365
Solution architect

5Design impact

Can it be undoneReversible: Disable the rule to change or stop it. Only enabled rules are used in calculations. Microsoft Learn
If you change it laterEnabled rules are read-only; to change a rule you must first set its status to Disabled, which stops it from applying until you enable it again. Microsoft Learn
Technical architect

6Technical

Menu itemGUPFreeItemDiscount Checked in Dynamics 365
FormRetailPeriodicDiscount Checked in Dynamics 365
TableRetailPeriodicDiscountShown as “PERIODIC DISCOUNT” in Record infoKey field: OfferIdChecked in Dynamics 365
Data entitiesRetailDiscountEntityPeriodic discount Microsoft data model
Who can open itPrivilegesMaintain pricing service sales discount records GUPDiscountRecordMaintainView pricing service discount agreements and records GUPDiscountRecordViewDutiesInquiries into pricing service discount agreements and records GUPDiscountInquiryMaintain pricing service sales discount records GUPDiscountMaintainMaintain pricing service sales discount records GUPDiscountRecordMaintainMaintain coupons MCRCouponMaintainMaintain retail coupons RetailCouponsMaintainMaintain retail campaign discounts RetailDiscountOfferMaintainMaintain retail campaign discounts RetailDiscountOfferView
7 security roles MCRTestUserRoleRetail merchandising manager RetailMerchandisingManagerRetail operations manager RetailOperationsManagerRetail service RetailServiceRetail store manager RetailStoreManagerSales clerk TradeSalesClerkSales manager TradeSalesManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceSales manager TradeSalesManagerRetail merchandising manager RetailMerchandisingManagerTo use itSales clerk TradeSalesClerkRetail operations manager RetailOperationsManagerRetail store manager RetailStoreManagerGive people one of these roles. On this system, 6 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): New, Price groups, Validation logs, Copy, Header price attribute group, Discount exclusion list, Fund listChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=GUPFreeItemDiscount
Integrate withRetailDiscountEntity data entity Microsoft data model
Data migrationRetailDiscountEntity (Periodic discount): loaded for each company.Microsoft Learn
Table definitionRetailPeriodicDiscount columns and relations Microsoft data model
Everyone

8Sources