Installation

General

The Comarch Retail POS adapter requires:

  • ERP system engine version CIS600PB-Fix17 or higher
  • Multi-channel sales application version 2.18:6.0.0
  • Comarch Financials Enterprise application version 20.2:6.0.0 or higher

The following Java libraries are additionally required for the adapter to work properly (they must be located in the lib/ext directory):

  • jackson-core-asl-1.9.13.jar (The Apache Software License, version 2.0)
  • jackson-jaxrs-1.9.13.jar (The Apache Software License, version 2.0)
  • jackson-mapper-asl-1.9.13.jar (The Apache Software License, version 0)

This version of the Comarch Retail POS adapter in Comarch ERP Enterprise system is compatible with the following versions of Comarch mPOS application:

  • 2021.0
  • 2021.1
  • 2021.2
  • 2021.5
  • 2021.6
  • 2022.0
  • 2022.1
  • 2022.5
  • 2023.0
  • 2023.1
  • 2023.2
  • 2023.5
  • 2024.0

From version 2021.0 of Comarch mPOS, it is necessary to use a new component Comarch POS Agent for cooperation with Comarch ERP Enterprise system.

The component needs to be installed using Comarch Update Agent along with the installation of the Comarch Retail product.

  • Comarch mPOS is a mobile application supporting processes handled in the shop. The employee can conduct sales activities using a smartphone, tablet, or portable collector. The application is directed to both sellers and back office employees who handle delivery receipts and releases and the movements of items between the backroom and the sales room.
  • Comarch POS Agent service provides up-to-date information on stock levels on each workstation while issuing documents. This information is presented taking into account individual warehouses. All processes in the warehouse can be carried out without connection to the headquarters, so using this service provides full autonomy to the shop by ensuring that the stock levels are always up to date.
  • Synchronization service – with this synchronization service, synchronization between the ERP system and Comarch POS application is possible. The service’s name and port is defined in the ERP system. If the service is missing, it is not possible to work with Comarch POS application.

Requirements

Comarch mPOS requirements:

  • Android system version: 9.0
  • RAM: 4 GB (or more)
  • Internal memory: 16 GB (or more)

A device with a built-in barcode scanner will streamline the use of the application.

Recommended devices:

  • Zebra TC52
  • Zebra TC57
  • Honeywell CT40
  • Honeywell CT60
  • Unitech PA760

Installation

Comarch mPOS and Comarch POS Agent can be installed using Comarch Update Agent tool.

Note
The latest Comarch Update Agent version is required.

Installation and configuration of Comarch POS Agent service

After running Comarch Update Agent, it is necessary to perform the following actions:

  • Add the Comarch Retail product on the Configuration tab
[Products] button on Configuration tab
  • Add the Comarch POS Agent component to the Comarch Retail product
Adding component
  • Configure the Comarch POS Agent. The configuration window is opened by selecting a component and choosing the [Configuration] button from the menu. In the configuration window, it is necessary to enter data needed to establish connection with a Microsoft SQL Server Management Studio server where the POS Agent database will be installed.
[Configuration] button of Comarch POS Agent component
  • Server Name – the name and instance of the server where the database is to be created
  • Database Name – by default, the name POSAgent_[profile_code] is suggested
  • Login Data – an SQL user login and password
Comarch POS Agent component configuration window

The [Test Connection] button makes it possible to verify connection with the selected server.

  • Next, close the component configuration window by selecting [Save] and [Close].
  • Using the [Advanced Actions] button in the main window of Comarch Update Agent, download and install a relevant version of Comarch POS Agent.

[Advanced Actions] button in Comarch Update Agent main window
After the successful installation of the Comarch POS Agent component, define the code of the new agent in the Comarch Retail POS Agent application in Comarch ERP Enterprise.

Comarch Retail POS Agent application

After the [New] button is selected, header data is cleared, which allows defining particular values in the following fields:

  • Code (required) – a Comarch POS Agent service code (that needs to be entered in POS Agent Service Configuration Tool)
  • Host – the IP address of the Comarch POS Agent service (i.e. of the computer where the service has been installed). The value is non-editable and set automatically upon service registration.
  • Reconciliation timeout (s) – time (given in seconds) needed to exchange information on stock levels between the ERP system and the Comarch POS Agent service
  • Reconciliation lock time – this field provides information on the time of the last stock reconciliation process. The value is updated once another stock reconciliation process is initiated.
  • Time schedule stock reconciliation – this field makes it possible to schedule the automatic reconciliation of stock levels by Comarch POS. Schedules can be defined in the Time schedules
Note
A time schedule must be of the weekly type; the Valid on days of week and Valid from time settings determine on what days and at what time stock reconciliation is to be carried out. The parameters Active, Start date, and End date are also verified. The parameters Around the clock, Valid to time, and Interval are ignored.
  • Description – an information field allowing you to enter additional details about a given Comarch POS Agent service, for instance: POS Agent for PS1 sales channel
  • Port – the port of the Comarch POS Agent service (defined in POS Agent Service Configuration Tool). The value is non-editable and set automatically upon service registration.
  • Registered – it determines whether the Comarch POS Agent service has been registered with the parent agent. The parameter is selected automatically upon service registration.
  • Timeout (ms) for synchronization – time needed for complete synchronization between the ERP system and Comarch POS Agent (given in milliseconds); if 0 is entered in this field, it means there is no limit

Once required data is entered, the [Save] button should be selected.

Note
The code of the Comarch POS Agent service must be assigned to a given sales channel in the Sales channels application on the Comarch Retail POS tab (after selecting the Comarch Retail POS adapter).

Comarch Retail POS tab in Sales channels application

In order to export data to the mPOS workstation, run the POS export meta data application.

Once the code of Comarch POS Agent has been defined in the ERP system, proceed to the installation folder of Comarch POS Agent and run the PosAgentConfigurator.exe application.

  • After you select an application language, the application loads relevant parameters
POS Agent Service Configuration Tool – Parameter loading screen
  • Once the parameters are loaded, the configuration tool’s window opens
POS Agent Service Configuration Tool
  • Fill in the following fields in the application:
    • POS Agent Service IP Address – the IP address of the computer where the service has been installed (the Comarch POS Agent service requires a fixed IP of the computer where it has been installed)
    • POS Agent Service Port – the port entered in the ERP system
    • OMS Server Address – the default address is http://localhost:8099/DataService/
    • POS Agent Code – the POS Agent code entered in the ERP system
    • POS Agent GUID – this value is assigned automatically
  • The service is installed by selecting the [Install] button
POS Agent Service Configuration Tool – Service initialization screen
  • The correctness of entered data may be verified in advance by selecting [Verify]. In turn, the [Register] button is used to register the Comarch POS Agent service.
  • In order to verify if the process has been completed successfully, open the Comarch Retail POS Agent application in Comarch ERP Enterprise system and check whether entries in the Host, Port, and GUID fields are updated.
Correctly installed Comarch POS Agent service

Installation and configuration of Comarch mPOS

In order to complete the first installation of Comarch mPOS application, it is necessary to:

  • Add the Comarch Retail product for the parent agent of Comarch Update Agent
  • Add the Comarch mPOS component
Adding component
  • Using the [Advanced Actions] button in the main window of Comarch Update Agent, download and install a relevant version of Comarch mPOS
[Advanced Actions] button in Comarch Update Agent main window
Component version selection window
  • After downloading the component, find the zip file in C:\Comarch Update Agent\Downloads\Comarch Retail\[profile_name]\[version_number]\Comarch Retail mPOS
  • Extract the zip file

The extracted package contains a file with the APK extension. Transfer it to an appropriate mobile device, e.g. using a USB cable. Through a relevant application on the device (e.g. a file explorer), open the transferred APK file.

If the application through which you open the installation file has no permissions to install applications from unknown sources, a notification about the missing permission is displayed. The message will contain the [Settings] button that proceeds to the relevant place in the system settings. Allow the installation from that source.

Allowing application installation
Note
Granting this application the permission to process installations from unknown sources is a permanent setting.
After Comarch mPOS is installed, such consent can be undone in the system settings.

After the installation, the application will become available in the list of all applications.

Installation of certificates

In order to integrate Comarch mPOS with Comarch ERP Enterprise, it is necessary to have important certificates that allow configuring and working with Comarch mPOS application.

Certificates needed to work with the application include:

  • CEE-ROOT-CA.cer
  • CEE-SUPPORT-CA.cer
  • your-certificate.pfx

To transfer the certificates from the computer to the mobile device, it is necessary to:

  • Connect the mobile device to the computer, e.g. using a USB cable
  • Select the file transfer option
USB configuration settings
  • Copy the certificates: CEE-ROOT-CA.cer and CEE-SUPPORT-CA.cer to the internal memory folder of the mobile device
.cer certificates stored in phone’s internal memory
  • Copy the your-certificate.pfx certificate to the mPOS folder in the internal memory folder
.pfx certificate stored in mPOS folder

 

  • Open the Settings application on the mobile device, go to advanced Wi-Fi settings and find the Install certificates option
Wi-Fi settings
Advanced Wi-Fi settings
Install certificates option
  • After selecting the Install certificates option, find the .cer and .pfx certificates
.cer certificates
  • After selecting a given certificate, the certificate installation window will open, where it is necessary to:
  • Enter a desired certificate name
  • Select the option VPN and apps in the Credential use section

After installing the certificates, in order to verify the connection with the environment, open the web browser and enter the address of the Comarch ERP Enterprise environment. After the address is entered, the browser will display a certificate selection window and then the list of the ERP system databases. If the certificates have not been installed correctly, the page will not be loaded and an error notification will be displayed.

Czy ten artykuł był pomocny?