BeyondERP.Newsletter
Menu

Setup step on the Connector for Microsoft Dynamics AX page · Retail and Commerce

Set up Connector for Microsoft Dynamics AX

Use this page to create one profile per AX 2012 R3 Real-time Service server (server, port, web application name, protocol, certificate name, passphrase and language), to download the N-1 installers and their configuration files, and to reset metadata synchronization at cutover.

Used by
Retail operations manager, Retail service, Retail store IT and 2 more roles
Business process
Manage sales channels
Menu item
RetailTransactionServiceProfile
Main table
RetailTransactionServiceProfile
Data entity
RetailTransactionServiceProfileEntity
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 N-1 profile that tells Commerce headquarters how to reach the Real-time Service installed in an AX 2012 R3 channel environment, and from which you download the Async Server Connector Service and Real-time Service installers.
What you do hereUse this page to create one profile per AX 2012 R3 Real-time Service server (server, port, web application name, protocol, certificate name, passphrase and language), to download the N-1 installers and their configuration files, and to reset metadata synchronization at cutover.
ExampleFor example, during a phased rollout you create a profile named AXConnect pointing at the store server that hosts the Real-time Service, then select it as the Real-time Service profile in Commerce shared parameters.
Connector for Microsoft Dynamics AX 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

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 Connector for Microsoft Dynamics AX

Use this page to create one profile per AX 2012 R3 Real-time Service server (server, port, web application name, protocol, certificate name, passphrase and language), to download the N-1 installers and their configuration files, and to reset metadata synchronization at cutover.

Steps from Microsoft

  1. Go to Retail and Commerce > Headquarters setup > Commerce scheduler > Support for AX 2012 R3 > Connector for Microsoft Dynamics AX.
  2. On the action pane, select New.
  3. Enter a Profile name and Description.
  4. In the Connection section, enter the Server, Port, Web application name, Protocol, Common name and Passphrase of the N-1 Real-time Service.
  5. Select the Language of the stores mapped to this service.
  6. Select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
ProfileUnique name of the N-1 profile; one per Real-time Service server.Microsoft Learn profileId
DescriptionText that identifies the profile.Microsoft Learn name
ServerServer where the N-1 Real-time Service (same as the AX 2012 R3 Real-time Service) is installed.Microsoft Learn centralTableServer
PortPort used by the N-1 Real-time Service.Microsoft Learn centralTableServerPort
Web application nameIIS application name for the N-1 Real-time Service.Microsoft Learn ServerServiceName
ProtocolProtocol (for example https) the AX 2012 R3 Real-time Service uses.Microsoft Learn protocol
Common nameFriendly name of the certificate used by the service.Microsoft Learn ServerCertificateDNS
LanguageLanguage of the stores mapped to this Real-time Service.Microsoft Learn language

Common errors and fixes

MessageWhat to do
DA3122: Sorry, something went wrong with the encryption on your device. Contact your system administrator.Check the Real-time Service profile in the CDX Backward compatibility section of the store; it must be the profile you created on this page. Microsoft Learn

Test checklist

  1. Create the profile with server, port, web application name, protocol, common name and language.
  2. Select it in Real-time Service profile on the Security tab of Commerce shared parameters.
  3. Download the Async Server Connector service and Real-time service installers with their configuration files.
  4. After installation, activate an AX 2012 R3 MPOS device and check sign-in works.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Connector for Microsoft Dynamics AXDon't set up on current versions: N-1 support ended with Commerce 10.0.40. Where still in use, one profile per AX 2012 R3 Real-time Service serverMicrosoft says to create one profile for each environment or server where the AX 2012 R3 Real-time Service is installed, and that N-1 support ends with the 10.0.40 release.Selecting Reset metadata synchronization before the AX 2012 R3 Real-time Service is shut down. It resets HQMessageDB and belongs late in the cutover sequence.

Feature management and licence

Licence or add-inConfiguration key Retail Data Commerce Exchange backward compatibility (under Commerce > Commerce scheduler)

Microsoft Learn

Solution architect

5Design impact

If you change it laterSelecting Reset metadata synchronization on this page resets the AX 2012 R3 headquarters message database (HQMessageDB); Microsoft places this step after the AX 2012 R3 Real-time Service is shut down at cutover. Microsoft Learn
Technical architect

6Technical

Menu itemRetailTransactionServiceProfile Checked in Dynamics 365
FormRetailTransactionServiceProfile Checked in Dynamics 365
TableRetailTransactionServiceProfileShown as “CONNECTOR FOR MICROSOFT DYNAMICS AX” in Record infoKey field: profileIdChecked in Dynamics 365
Data entitiesRetailTransactionServiceProfileEntityCommerce Data Exchange: Real-time Service profile Microsoft data model
Who can open itPrivilegesMaintain retail service profile RetailServiceProfileMaintainView Connector for Microsoft Dynamics AX RetailTransactionServiceProfileViewDutiesMaintain retail channels RetailChannelsMaintainMaintain Commerce Data Exchange: Real-time Service profiles RetailTransactionServiceProfilesMaintain
5 security rolesRetail operations manager RetailOperationsManagerRetail service RetailServiceRetail store IT RetailStoreITRetail store manager RetailStoreManagerInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail operations manager RetailOperationsManagerInformation technology manager SysServerITManagerTo use itRetail service RetailServiceRetail store manager RetailStoreManagerRetail store IT RetailStoreITGive people one of these roles. On this system, 5 roles can open this page.Checked in Dynamics 365
Actions on the pageDownload: Download, Download(Action Pane without tabs): Commerce scheduler parametersChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailTransactionServiceProfile
Integrate withRetailTransactionServiceProfileEntity data entity Microsoft data model
Data migrationRetailTransactionServiceProfileEntity (Commerce Data Exchange: Real-time Service profile): shared by all companies, in Microsoft's default template 500 - Retail.Load order: Microsoft's default template 500 - Retail loads Commerce Data Exchange: Real-time Service profile at execution unit 1, level 30, sequence 10. 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 definitionRetailTransactionServiceProfile columns and relations Microsoft data model
Everyone

8Sources

To cite this step: RC-CDX-090, Set up Connector for Microsoft Dynamics AX. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/RC-CDX-090