Pricing Management in D365FO SCM: Discount + Free Item with Coupon Setup

 The Unified Pricing Management (UPM) module in Dynamics 365 Supply Chain Management (SCM) replaces legacy trade agreement workarounds with a true omnichannel pricing engine. Setting up a "Buy X, Get Y Free" promotion triggered by a coupon requires linking a Free item discount rule directly to a Coupon code.

Note on UI Navigation: To serve as a direct functional replacement for visual screenshots, this manual provides exact system navigation paths (Modules > ...), FastTab names, Action Pane buttons, and field-by-field configuration tables so you can execute the setup directly in your environment.

Prerequisites & Architectural Setup

Before building the discount rule, verify that your foundational UPM pricing components are active:

Element	Navigation Path	Requirement
Price Attribute Groups	Pricing management > Setup > Price attribute groups	Ensure header and line attribute groups are configured for sales orders.
Price Component Code	Pricing management > Setup > Price component codes	A code with Price component type set to Free item discount must exist.
Price Structure	Pricing management > Setup > Price structures	Verify your free item price component code is embedded in your active company price tree.

Configuration & Implementation Guide

1.Create the Free Item Discount Header:Navigation: Pricing management | During-sales pricing | Discounts | Free item.

Navigate to the Free item discounts form and click New on the Action Pane to initialize a new pricing rule.

• Discount / Adjustment ID: Enter a unique identifier (e.g., FREE-001) or allow your number sequence to generate it automatically.

• Name: Enter a descriptive administrative label (e.g., Summer Promo - Buy 10 Get 1 Free).

• Price component code: Select your free item component code from the lookup (e.g., FreeItemDisc).

• Concurrency mode: Set to Exclusive to prevent other discounts from overriding this deal, or Compounded if it should stack with standard trade agreement pricing.

2.Define Calculation and Reward Rules:FastTab: Price/discount.

Expand the Price/discount FastTab on the discount record. This section dictates the math behind the promotion and specifies the exact gift product.

Field	Target Setting	System Behavior
Criteria type	Quantity	Evaluates order qualification based on unit count rather than dollar amount.
Calculation type	Normal	Applies standard threshold logic (use Stepped for multi-tier rewards).
Repeatable	Repeatable by line	If a customer buys 20 qualifying units instead of 10, they receive 2 free items.
Supplementary item	[Select Gift SKU]	The exact item number of the free product being rewarded.
Supplementary quantity	1	The number of gift items awarded per qualifying threshold reached.
Discount percentage	100%	Sets the unit price of the supplementary item line to $0.00.

3.Specify Qualifying Trigger Products:FastTab: Lines.

Expand the Lines FastTab to designate what the customer must purchase to trigger the reward. Click Add line on the FastTab toolbar.

• Header/Line attribute group: Select the product grouping hierarchy (e.g., All products or a specific Item group).

• Product: Select the qualifying item SKU (e.g., Item-A).

• Quantity limit: Enter the minimum purchase threshold required to trigger the deal (e.g., 10).

• Save the record using Ctrl+S. Leave the Publish status as Draft for now.

4.Create and Restrict the Coupon Code:Navigation: Pricing management | During-sales pricing | Coupons.

Navigate to the Coupons form to generate the promotional code and bind it to your newly created discount rule. Click New on the Action Pane.

• Coupon code: Enter the alphanumeric code entered by the sales rep or customer (e.g., FREEGIFT2026).

• Description: Enter an internal tracking description.

• Usage limit type: Select No limit, Total usage limit, or Customer usage limit depending on your campaign governance.

• Total usage limit: If restricted, enter the global redemption cap (e.g., 500 total uses).

• Expand the Discounts FastTab at the bottom of the form, click Add, and select the discount rule created in Step 1 (FREE-001).

5.Activate the Discount Rule and Coupon:Action Pane: Activate.

Both records must be explicitly published to the pricing engine before they can be called by sales orders.

1. Return to Pricing management > During-sales pricing > Discounts > Free item, select FREE-001, and click Activate on the Action Pane. Verify that Publish status updates to Active.

2. Return to Pricing management > During-sales pricing > Coupons, select FREEGIFT2026, and click Activate on the Action Pane. Verify the status updates to Active.

6.Validate Setup via Price Simulator:Navigation: Pricing management | During-sales pricing | Price simulator.

Always test pricing rules in the simulator before releasing them to live sales environments.

1. In the Header section of the simulator, select a test Customer account.

2. In the Coupons header tab, enter FREEGIFT2026.

3. In the Lines section, add your trigger product (Item-A) and set the quantity to 10 (or higher).

4. Click Calculate price on the Action Pane.

5. Verification: The system will generate a secondary order line for your Supplementary item with a quantity of 1, a Unit Price of $0.00, and the FREE-001 rule ID explicitly listed in the Price component breakdown pane.

Troubleshooting Common Implementation Errors

If the free item does not inject during simulation or sales order entry, check these three common configuration pitfalls:

• Missing Line Attribute Group: If the item on the sales order line doesn't match the price attribute group defined on your price component code, the pricing engine will bypass the rule entirely. Verify your item mapping under Product information management > Products > Released products.

• Concurrency Conflicts: If an active Simple Discount or Trade Agreement has its Concurrency Mode set to Exclusive and sits higher in your Price Structure tree than the Free Item component, it will consume the line and block the free item from triggering.

• Supplementary Item Inventory: Ensure the free gift SKU has active released product configurations in the order's specific Site and Warehouse. If the gift item lacks valid inventory dimensions or is stopped for sales, D365FO will suppress the line generation silently.