Support for network peripherals

Articol
08/08/2024

This article provides an overview of network peripherals supported by the Microsoft Dynamics 365 Commerce Store Commerce apps for Windows, Android, and iOS.

Key terms

Term	Description
Register	The entity that is used to configure an instance of a point of sale (POS) register.
Device	A representation of the physical instance of a POS register and the Store Commerce app that is assigned to it.
Dedicated hardware station	The hardware station business logic that is built into the Store Commerce apps for Windows, Android, and iOS.
Drawer kick (DK) port	A traditional method for connecting a cash drawer to a receipt printer.
Network peripherals	Built-in support for network-enabled payment terminals, receipt printers, and cash drawers.
ESC/P	Epson Standard Code for Printers (also known as "Escape/P") is printer a control language created by Epson that is commonly used to send commands to point of sale printers.

Supported POS clients and devices

Functionality for network peripherals is supported by the Store Commerce apps for Windows, Android, and iOS.

This functionality supports network-enabled payment terminals and receipt printers. You can provide cash drawer support by connecting the cash drawer to the network-enabled receipt printer via the DK port.

Out-of-box support for network-enabled payment terminals is provided by the Microsoft Dynamics 365 Payment Connector for Adyen. Other payment connectors might be supported via customizations. For more information on extending payment integrations, see Create an end-to-end payment integration for a payment terminal.

Out-of-box support for network-enabled receipt printers is provided for network protocols for Epson and Star Micronics receipt printers. Cash drawers that are connected to those printers via the DK port are supported via Epson Standard Code for Printers (ESC/P) protocols.

Set up network peripherals

Adyen payment terminal

For information about how to set up an Adyen payment terminal, see the "POS payment terminal" section in Set up Dynamics 365 Payment Connector for Adyen.

Epson or Star Micronics receipt printer and a cash drawer

For Commerce to support network peripherals, you must implement communication protocols that are unique for each manufacturer. If a printing protocol isn't listed here, it isn't supported out-of-box and requires customization.

Note

For network-enabled printers, Store Commerce only supports using the "en-us" locale identifier. Other locale identifiers, including those that specify right-to-left text direction, aren't supported.
To use a locale identifier other than "en-us", set up the POS printer as a "Windows driver device" (only supported with Interprocess Communications [IPC] hardware stations) or as an "OPOS device". For configuration details, see OPOS device setup and configuration and IPC (built-in) hardware station configuration.

Epson prerequisite

If your printer supports Epson ePOS-Print, see your Epson product manual for information on how to access the Epson printers configuration website. On the configuration website, enable ePOS-Print and ensure that the printer is set up to transmit data to port 80. When ePOS-Print is configured, after a power cycle the printer prints a chit that shows the printer's IP address.

Note

If the printer is producing an ePOS payload (or garbage), this could indicate that ePOS printing isn't enabled on the network printer, or that the incorrect port might be configured.
For Epson network printers, port 9100 is designated for RAW printing and shouldn't be used for printing with Store Commerce. Ensure that the printer is set up to transmit data to port 80. When configuring the IP address of the networking printer in Dynamics 365 Commerce, leave the port number field empty to default to port 80.
If printing to the default port results in an HTTP 404 error, this could indicate that either ePOS printing isn't enabled on the printer, or it isn't supported by the printer.

Star Micronics prerequisite

Network-enabled Star Micronics printers that support Ethernet can be configured to use network protocols through the Star Micronics Printer Utility. For information about how to set up Star Micronics devices to support network printing, see the documentation that is provided by Star Micronics. When a device is correctly configured, the IP address of the printer can be obtained through the user interface (UI) of the printer utility.

Set up a hardware profile

In Dynamics 365 Commerce headquarters, go to Retail and Commerce > Channel setup > POS setup > POS profiles > Hardware profiles.
Select New.
Assign a hardware profile number, and then enter a description.

On the FastTabs for different device types, set up the following device types.

Device	Type	Device name	Additional details
Printer	Network	Epson or Star	The device name is case-sensitive. Assign a Receipt profile ID.
Cash drawer	Network	Epson or Star	The device name is case-sensitive. Set the Use shared shift option to Yes if the cash drawer is shared by multiple POS devices.

Select Save.

Enable a dedicated or shared hardware station

To enable a dedicated hardware station, follow these steps in Commerce headquarters for each store for which you want to configure network-enabled receipt printers and cash drawers.

Go to Retail and Commerce > Channels > Stores > All stores and select the store for which you're configuring a network-enabled receipt printer or cash drawer.
On the Hardware Station FastTab, select Add.
For Hardware Station type, select Dedicated.
Enter a description, but don't specify a hardware profile or set any other values for this hardware station.
Select Save to save changes to the store.
Search for Distribution schedules.
Select distribution schedule 1070 (Channels job), and then select Run now.

To enable a shared hardware station, follow these steps in Commerce headquarters for each store for which you want to configure network-enabled receipt printers and cash drawers.

Go to Retail and Commerce > Channels > Stores > All stores and select the store for which you're configuring a network-enabled receipt printer or cash drawer.
Select the store by selecting its Retail Channel Id value, and then select Edit.
On the Hardware stations FastTab, select Add.
Set the Hardware station type field to Shared.
Enter a description. This hardware station can be shared by multiple POS clients, including POS clients that have built-in hardware station logic.
Enter a host name for the hardware station.
In the Hardware profile field, use the drop-down arrow to assign the hardware profile for the network-enabled peripherals you created to this hardware station.
Select Save to save changes to the store.
Search for Distribution schedules.
Select distribution schedule 1070 (Channels job), and then select Run now.

For detailed information about how to set up shared hardware stations, see Configure and install Retail hardware station.

Note

Store Commerce for web does not support dedicated (built-in) hardware station logic. If you're configuring peripherals for Store Commerce for web, you must set up a shared hardware station and configure each peripheral's IP address at the store level.
Network-enabled receipt printers and cash drawers can be shared by multiple POS devices. To share them, you can use a shared hardware station to broker the connection to the devices. Alternatively, if you're using Store Commerce for Windows, Android, or iOS, you can configure the same devices directly in the register properties.
Payment terminals can only be shared if a shared hardware station is deployed to broker the connection to the payment terminal. You can't share a payment terminal by setting the same payment terminal IP address directly at the register level. If you try to use this approach, you'll encounter issues when individual POS clients try to lock and claim the payment terminal.

Set up a Dynamics 365 Commerce register

For a setup that uses dedicated (in-built) hardware station, follow these steps.

In headquarters, go to Retail and Commerce > Channel setup > POS setup > Registers.
Select the register you want to configure by selecting the register number, and then select Edit.
Assign the hardware profile for the network-enabled peripherals that you created to the register.
Select Save.
On the Action Pane, on the Registers tab, select Configure IP addresses.
On the Printer FastTab, enter the IP address of the printer. Leave the field for the port number blank.
On the Cash drawer FastTab, enter the IP address of the printer. Leave the field for the port number blank.
Select Save.
Search for Distribution schedules.
Select distribution schedule 1090, and then select Run now.
Select distribution schedule 1070, and then select Run now.

For a setup that uses shared hardware station, follow these steps.

Note

Peripheral IP address configuration can be done at the store level.
If you're using Store Commerce for Web, peripheral IP address configuration must be done at the store level.

In headquarters, go to Retail and Commerce > Channels > Stores > All stores*.
Select the store by selecting its Retail Channel Id value, and then select Edit.
On the Hardware stations FastTab, select the shared hardware station that you configured.
While the hardware station for the receipt printer and cash drawer is selected, select Configure IP addresses.
On the Printer FastTab, enter the IP address of the printer. Leave the field for the port number blank.
On the Cash drawer FastTab, enter the IP address of the printer. Leave the field for the port number blank.
Select Save
Search for Distribution schedules.
Select distribution schedule 1090, and then select Run now.
Select distribution schedule 1070, and then select Run now.