Point of sale (POS) device activation

This article explains the new guided device activation for Cloud POS and Modern POS, and explains the client simplifications that help users easily activate devices without having to manually enter register and device ID information.

Checklist to follow before activation

  1. Complete the Validate devices for activation check in Headquarters (HQ), and make sure that the device passes validation.

  2. On the client machine where you're activating the device, access the Commerce Scale Unit URL health check, and make sure that the health check is passed. Use the following format: https://clxtestax404ret.cloud.test.dynamics.com/en/healthcheck?testname=ping.

  3. The worker must be mapped to a Microsoft Azure Active Directory (AAD) account (under External identity).

  4. The AAD account to map must belong to the same tenant.

  5. To map the worker to the AAD account, sign in to HQ by using the Admin account for Microsoft Dynamics Lifecycle Services (LCS).

  6. Make sure that the worker is set up as a user in the Manager role (checked by validation).

  7. Make sure that the channel is published (checked by validation).

  8. Make sure that the channel database has the synced data from HQ, and that download jobs are running. To check this, run the following command in the channel database for the store.

    select * from crt.STORAGELOOKUPVIEW

    Make sure that data is returned, and that the result isn't empty.

  9. Set up the hardware profile under Register (checked by validation).

  10. Make sure that the register and store have a screen layout (checked by validation).

  11. Make sure that a primary address is set up for the legal entity.

  12. Make sure that the language is set up for the Commerce Data Exchange: Real-time Service user profile (JBB in the demo data).

  13. Make sure that the Real-time Service profile has the correct access.

  14. Make sure that the electronic funds transfer (EFT) configuration value is present.

Activate a Modern POS or Cloud POS device by using guided activation

  1. Open the initial device activation page for Modern POS or Cloud POS. You're prompted to sign in.

  2. On the Before you start page, follow the instructions, and then click Next.

    POS Wizard, before you start page.

  3. Start Cloud POS or Modern POS.

  4. Use your AAD credentials to sign in. The AAD account must already be mapped. For instructions, see Configure, install, and activate Modern POS (MPOS). For Cloud POS, the server URL is automatically entered in the address bar. For Modern POS, you must copy and paste the server URL.

    POS Wizard, add server URL page.

  5. Click Next to populate the list of stores.

  6. Select the correct store in the list.

    POS Wizard, select the store page.

  7. Select the correct register and device.


    The device can be Pending, De-activated, or Activated. Alternatively, if you turned on the HQ Allow devices to be associated to registers from store setting, you might see a list of registers that have no device associated with them.

    POS Wizard, select register and device page.

  8. Click Activate. The device should be activated.

    POS Wizard, device activated page.

Create a device ID from Modern POS and Cloud POS

We have added features to create a device (that is, automatically generate a device ID) from Modern POS or Cloud POS, so that the device can be associated with a register that doesn't yet have devices mapped to it. This functionality can be used in Modern POS only if you set the HQ settings as follows.

  1. Go to Retail and Commerce > Headquarters setup > Parameters > Commerce shared parameters > General.
  2. Under Devices, set Allow register association from device to Yes.
  3. In the Modern POS client, you can now add a device when you select a register that is listed as No associated devices in the guided activation flow.
  4. After you select the register, you can either select a device that doesn't have register mapping or use the Or, Add a Device link.
  5. Click the Or, Add a Device link, and then either enter the new device ID or select Automatically create a new device ID for me.
  6. Click Activate to create a new device ID, associate it with the selected register, and complete the activation.

Activate the device for Modern POS by using a configuration file

IT Pros can now easily configure device activation for Modern POS by using a configuration file that can be downloaded together with Modern POS. This file is now available on the Devices page for the appropriate Modern POS device (Retail and Commerce > Channel setup > POS setup > Devices).

Configuration file download.

The configuration file is used to enter the Commerce Scale Unit URL, device ID, and register number for device activation. During installation, the installer selects this file and populates the values for device activation.


The user must put the file in the same folder as the Modern POS self-service package and run the .exe file.

Configuration file.

Modern POS starts in Manual entry mode, and the Commerce Scale Unit URL, device ID, and register ID are pre-populated for activation.

Activate the device for Cloud POS by using syntactic sugar

IT Pros can now configure device activation for Cloud POS by providing the device ID and register ID as the part of the Cloud POS URL. The link is available in the Cloud POS URL field on the Devices page. (Retail and Commerce > Channel setup > POS setup > Devices).

Cloud POS starts in Manual entry mode, and the Commerce Scale Unit URL, device ID, and register ID are pre-populated for activation.

Cloud POS URL field.