BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Bar code mask setup

A setup page where you define barcode masks: a mask ID, type, barcode standard, optional prefix and an ordered set of mask segments that give the format of barcodes to be generated or recognised.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Manage sales channels
Menu item
RetailBarcodeMaskSetup
Main table
RetailBarcodeMaskTable
Data entity
RetailBarcodeMaskEntity
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 setup page where you define barcode masks: a mask ID, type, barcode standard, optional prefix and an ordered set of mask segments that give the format of barcodes to be generated or recognised.
What you do hereUse this page to build the masks that Commerce uses to generate barcodes for products and other entities and to identify barcodes scanned at the POS.
ExampleFor example, create a Product mask of type Product with the Code 39 standard, prefix 22 and a 10-character product segment matching the length of your product IDs.
Bar code mask setup 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 › Bar code mask setup
Set up firstMask characters Microsoft Learn
Used next byBar code setup Microsoft Learn
Related pagesNumber sequences 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 Bar code mask setup

Use this page to build the masks that Commerce uses to generate barcodes for products and other entities and to identify barcodes scanned at the POS.

Steps from Microsoft

  1. Go to Retail and Commerce > Inventory management > Bar codes and labels > Bar code mask setup.
  2. Select New.
  3. Enter Mask ID and Description, and select a Type.
  4. In the General section, select the Barcode standard and enter a prefix if required.
  5. In the Barcode mask segment section, add the segments and their lengths.
  6. Check the mask preview under Mask and save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Mask IDThe identifier of the mask.Microsoft Learn maskId
DescriptionA description of the mask.Microsoft Learn Description
TypeThe barcode mask type, such as Product.Microsoft Learn
Barcode standardThe symbology, such as Code 39.Microsoft Learn
PrefixLeading characters that identify the barcode.Microsoft Learn Prefix
Barcode mask segmentThe segments (for example Product) and their lengths that make up the barcode.Microsoft Learn
MaskA preview of the resulting mask.Microsoft Learn Mask

Test checklist

  1. Create a Product mask with a prefix and a Product segment of the store product ID length.
  2. Assign it on a Code 39 bar code setup.
  3. Generate a barcode for a test product and check prefix and length.
  4. Scan it in POS and check the product is added.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Bar code mask setupProduct segment length equal to the product ID length used in stores; number sequence segments no longer than the mask segments, and shorter for check-digit types (EAN13, EAN8, UPCA, UPCE)Learn says the segment length should match the store product ID length, and from 10.0.32 the prefix is added after the number sequence, so sequence segments must fit inside the mask.A number sequence as long as the mask on an EAN13 mask leaves no room for the check digit, so generated barcodes don't fit the mask.Test: Number sequence fits the mask
Solution architect

5Design impact

Can it be undoneReversible: A mask can be changed, but it drives both barcode generation and POS scan recognition, so keep segment lengths in step with any number sequence that generates barcodes. Microsoft Learn
If you change it laterSegment lengths must be kept in step with any number sequence that generates barcodes from the mask: the sequence segments may not exceed the mask segments, and must be shorter where the barcode type has a check digit. Microsoft Learn
Technical architect

6Technical

Menu itemRetailBarcodeMaskSetup Checked in Dynamics 365
FormRetailBarcodeMaskSetup Checked in Dynamics 365
TableRetailBarcodeMaskTableShown as “BAR CODE MASK” in Record infoChecked in Dynamics 365
Data entitiesRetailBarcodeMaskEntityBar code mask 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=RetailBarcodeMaskSetup
Integrate withRetailBarcodeMaskEntity data entity Microsoft data model
Data migrationRetailBarcodeMaskEntity (Bar code mask): loaded for each company, in Microsoft's default template 500 - Retail.Load order: Microsoft's default template 500 - Retail loads Bar code mask at execution unit 1, level 30, sequence 20. Lower levels load first, and entities at the same level load in sequence order.Load first: the default templates at lower levels (System setup to General ledger)Microsoft Learn
Table definitionRetailBarcodeMaskTable columns and relations Microsoft data model
Everyone

8Sources