BeyondERP.Newsletter
Menu

Setup step on the Mask characters page · Retail and Commerce

Set up Mask characters

Use this page to create the mask characters that a barcode mask needs before you can define masks for generating barcodes and recognising scanned ones at the POS.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Manage sales channels
Menu item
RetailBarcodeMaskCharacter
Main table
RetailBarcodeMaskCharacter
Data entity
RetailBarcodeMaskCharacterEntity
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 define the placeholder characters (product, any number, check digit, size, colour, style, price, quantity and so on) from which barcode masks are built.
What you do hereUse this page to create the mask characters that a barcode mask needs before you can define masks for generating barcodes and recognising scanned ones at the POS.
ExampleFor example, create a Price character so that a price-embedded barcode mask can mark where the price sits in the code.
Mask characters 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 processDevelop sales policies › Manage sales channels
Menu pathRetail and Commerce › Inventory management › Bar codes and labels › Mask characters
Used next byBar code mask setup Microsoft Learn
Related pagesSet up barcodes Microsoft Learn
In this process Set up Return locations · Set up Loyalty reward points
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 Mask characters

Use this page to create the mask characters that a barcode mask needs before you can define masks for generating barcodes and recognising scanned ones at the POS.

Steps from Microsoft

  1. Go to Retail and Commerce > Inventory management > Bar codes and labels > Mask characters.
  2. Select New.
  3. Enter the character and choose what it stands for (Product, Any number, Check digit, Size digit, Price and so on).
  4. Repeat for each kind of barcode data you need.
  5. Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
ProductPlaceholder for the product ID segment.Microsoft Learn
Any numberA fixed number that appears in the barcode.Microsoft Learn
Check digitMarks that the mask uses a check digit to validate the barcode.Microsoft Learn
Size digitThe size segment for variant barcodes.Microsoft Learn
Color digitThe colour segment for variant barcodes.Microsoft Learn
PriceThe price segment in price-embedded barcodes.Microsoft Learn
QuantityThe quantity segment in quantity or random-weight barcodes.Microsoft Learn
Coupon codeThe coupon code segment used to add a discount to an order.Microsoft Learn

Test checklist

  1. Create Product, Check digit and Price mask characters.
  2. Build a price-embedded mask from them on Bar code mask setup.
  3. Scan a test price-embedded barcode in POS and check the product and price are recognised.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Mask charactersOne mask character for each kind of data your barcodes carry (Product, Check digit, Price, Quantity, Coupon code and so on); use Coupon code, not Discount codeMasks can only be built from the characters defined here, and Discount code is deprecated and replaced by Coupon code.Defining Discount code or Data entry characters: Discount code is deprecated and Data entry isn't implemented.
Solution architect

5Design impact

Can it be undoneReversible: Characters can be edited, but every mask built from a character reads barcodes with it.
Technical architect

6Technical

Menu itemRetailBarcodeMaskCharacter Checked in Dynamics 365
FormRetailBarcodeMaskCharacter Checked in Dynamics 365
TableRetailBarcodeMaskCharacterShown as “BAR CODE MASK CHARACTERS” in Record infoChecked in Dynamics 365
Data entitiesRetailBarcodeMaskCharacterEntityBar code mask characters Microsoft data model
Who can open itPrivilegesMaintain retail barcode masks RetailBarcodeMasksMaintainDutiesEnable retail barcode masks RetailBarcodeMasksEnableMaintain retail barcode masks RetailBarcodeMasksMaintain
3 security rolesRetail operations manager RetailOperationsManagerRetail service RetailServiceInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceRetail operations manager RetailOperationsManagerInformation technology manager SysServerITManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailBarcodeMaskCharacter
Integrate withRetailBarcodeMaskCharacterEntity data entity Microsoft data model
Table definitionRetailBarcodeMaskCharacter columns and relations Microsoft data model
Everyone

8Sources

To cite this step: RC-LABEL-010, Set up Mask characters. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/RC-LABEL-010