BeyondERP.Newsletter
Menu

Setup step on the Vendor's product numbers page · Retail and Commerce

Set up Vendor's product numbers

Use this page to record the external item number a vendor uses for a product, link it to your item number and vendor, and add the vendor-specific description and dimensions so vendor catalog files and vendor documents can use the vendor's numbering.

Used by
Retail catalog manager, Retail merchandising manager, Retail service
Business process
Manage sales channels
Menu item
RetailCustVendExternalItem_Vend
Main table
CustVendExternalItem
Data entity
PurchVendorProductDescriptionV2Entity
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 (External item descriptions) that maps a vendor's own item number, description and variant dimensions to one of your internal products.
What you do hereUse this page to record the external item number a vendor uses for a product, link it to your item number and vendor, and add the vendor-specific description and dimensions so vendor catalog files and vendor documents can use the vendor's numbering.
ExampleFor example, print invoices that show the product numbers and descriptions a particular vendor uses instead of your internal ones.
Vendor's product numbers 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 › Products and categories › Vendor catalog import › Vendor's product numbers
Set up firstReleased products by category Microsoft Learn
Used next byVendor catalogs (catalog import) Microsoft Learn
Related pagesVendor sales price margin setup Microsoft Learn
In this process Set up Channel navigation categories · Set up Override permissions
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 Vendor's product numbers

Use this page to record the external item number a vendor uses for a product, link it to your item number and vendor, and add the vendor-specific description and dimensions so vendor catalog files and vendor documents can use the vendor's numbering.

Steps from Microsoft

  1. Go to Retail and Commerce > Products and categories > Vendor catalog import > Vendor's product numbers.
  2. Select an existing external item number, or select New to create one.
  3. In the External item number field, enter the vendor's identifier for the product.
  4. In the Item number field, select the internal product, and in the Vendor field select the vendor.
  5. Enter the item description and select the inventory dimensions (configuration, size, colour, style) as appropriate.
  6. Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
External item numberThe vendor's original item number for the product.Microsoft Learn ExternalItemId
Item numberYour internal item linked to the external number.Microsoft Learn ItemId
VendorThe vendor the external item is bought from.Microsoft Learn CustVendRelation
External item textA free-text description of the vendor's item.Microsoft Learn ExternalItemTxt
ConfigurationThe configuration dimension the mapping applies to.Microsoft Learn configId
SizeThe size dimension the mapping applies to.Microsoft Learn InventSizeId
ColorThe colour dimension the mapping applies to.Microsoft Learn InventColorId
StyleThe style dimension the mapping applies to.Microsoft Learn InventStyleId

Test checklist

  1. Create a record linking your item number to a vendor with an External item number and External item text.
  2. Create a purchase order for that vendor and item.
  3. Print or preview the purchase order and check the vendor's item number and text appear.
  4. Repeat in a second legal entity and confirm the record must be set up there too.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Vendor's product numbersOne record per vendor and released product (and variant where needed); use an external item description vendor group when many vendors share the same numbersExternal identifiers can be kept by released product, variant, vendor or vendor group, and must be set up in each legal entity. Vendor groups simplify maintenance when vendors use the same item numbers.Expecting the vendor's number to show on core pages. It appears on external documents such as purchase orders and invoices; the only core-page exception is the Product information dialog when a default vendor is set.
Solution architect

5Design impact

Can it be undoneReversible: External item descriptions can be changed at any time; they are printed on external documents created afterwards.
Technical architect

6Technical

Menu itemRetailCustVendExternalItem_Vend Checked in Dynamics 365
FormRetailCustVendExternalItem Checked in Dynamics 365
TableCustVendExternalItemShown as “EXTERNAL ITEM DESCRIPTIONS” in Record infoChecked in Dynamics 365
Data entitiesPurchVendorProductDescriptionV2EntityExternal item descriptions for vendors V2 Microsoft data model SalesCustomerProductDescriptionV2EntityExternal item descriptions for customers V2 Microsoft data model
Who can open itPrivilegesMaintain external item numbers and descriptions RetailExtItemNumbersDescriptionsMaintMaintain retail item packages RetailVendorsItemNumbersMaintainDutiesMaintain retail product reference data RetailItemReferenceDataMaintainMaintain retail product reference data RetailProductReferenceDataMaintain
3 security rolesRetail catalog manager RetailCatalogManagerRetail merchandising manager RetailMerchandisingManagerRetail service RetailService
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceRetail merchandising manager RetailMerchandisingManagerRetail catalog manager RetailCatalogManagerGive 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=RetailCustVendExternalItem_Vend
Integrate withPurchVendorProductDescriptionV2Entity data entity Microsoft data model
Data migrationPurchVendorProductDescriptionV2Entity (External item descriptions for vendors V2): loaded for each company, in Microsoft's default template 320 - Procurement and sourcing.SalesCustomerProductDescriptionV2Entity (External item descriptions for customers V2): loaded for each company, in Microsoft's default template 330 - Sales and marketing.Load order: Microsoft's default template 320 - Procurement and sourcing loads External item descriptions for vendors V2 at execution unit 1, level 320, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: External item description vendor groups, Vendors V2, Released products V2, the default templates at lower levels (System setup to Product management)Microsoft Learn
Table definitionCustVendExternalItem columns and relations Microsoft data model
Everyone

8Sources

To cite this step: RC-VENDCAT-030, Set up Vendor's product numbers. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/RC-VENDCAT-030