Self-Service Checkout (SCO)

April 17, 2025

On this page

The Self-Service Checkout is located at https://sco.erply.com or download the Self-service checkout launcher HERE.
Unzip the downloaded file on your computer and create a shortcut for more convenient access to the self-service checkout. To use the self-service checkout, contact customer support at abi@erply.com 

We recommend creating a completely separate user and register in Back Office for the Self-Service Checkout, to better monitor sales statistics etc.

Setting up a self-service checkout

For setup, it is necessary to download the Self-Checkout POS settings application from the Erply App Store.

  1. Navigate to the Back Office -> Apps
  2. Search for the Self-Checkout POS settings.
  3. Click “Install”

Click on “Open” button.
Click on “Edit” button.

General settings

Set versions

The field 'Version' is not editable. Each time when you will save SCO configuration the system will create a new version automatically and number will be changed in this field.

The ‘Version name’ filed can be empty. 

'Application version': Always use the latest version of application to use always up-to-date version. If you noticed some important issue on the particular version, in this case you can the version of application to enable more stable version.

Languages

Enter languages that you would like to use in SCO application. 
For example: if you are located in Estonia, put en, et.

Employee discount

Select in which mode to enable the employee discount: Cashier, Full, Lite.

Toggle the “Supervisor” if you like to ask a supervisor approval. 

Manual promotions

Enable modes where you like to use manual promotions: Cashier, Full, Lite.

Additional information

Transaction Product Line Limit - by default the maximum number of product lines is 50, if you need more lines, you can set it here.

Manual Voucher Input

Transaction MOP Limit - limit of different payment methods per transaction (split payment).

Gift Card Item Code - gift card item code.

Gift Card Activation Limit - gift card activation limit, does not allow adding more gift cards to the transaction

Transaction Timeout - transaction timeout time in seconds

Scan Customer Card Timeout 

Receipt Timeout

EFT - payment integration (for Swedbank put swedbankIngenico; forAdyen - adyenms).

Bag Item Code - the product code of the shopping bag, if you want the quick selection button for the shopping bag at checkout

Unknown Item Code - Product code that is used when the product is not found in the database

Price Decimals - Number of decimal places

Thousands separator

Cash In Limit - Cash deposit limit

Cash Out Limit - Cash payout limit

ODS

ODS - Local product database (offline-product-database micro-service). Need to set the url where (default: http://localhost:7779) This is intended for use with a large number of products (more than 100,000).

Receipt type title

Setup the title for different types of transactions: Sale, Refund, Duplicate(duplicate doucument).

Imported Item Info

Setting the welcome text and transaction completion text

In the end of General settings you can find another options that can be also enabled:

Setting up printing and payment integrations

Step 1

Install the Installer app from the https://posow.erply.com/. The full guide can be found HERE. 

Step 2

Install required microservices in https://posow.erply.com/. Login with your Erply account.

Set up the Printing micro-service

From the Wizard, choose Hardware -> Installer App -> Micro-service Manager

After which it'll display Add new micro-service where you can choose printing-micro-service from the dropdown list

Press Continue

After that it'll display printing microservice configuration view. There is status “Not installed” on the red background.

Click on the Install latest (blue button)

Not the micro-service status is “Installed but stopped” on the yellow background

Click on the green Start button. Then Start button becomes Stop (yellow) and micro-service status is “Installed and running” on the green background.

Now the printing microservice is running and you can proceed with printer configuration.

Set up the Printer

In the Wizard navigate to the Hardware -> Integrations and choose if you want to connect the printer to the company, warehouse or POS(cash register). 

Select needed company, warehouse or POS from the dropdown list

Click on the Printer

Press Continue

Choose Golang printing micro-service and press on the slider to activate the setting (should become blue). 

Afterwards click on the Golang printing micro-service row.

Check the Get full printer list box and choose the correct printer. After that, press Save.

Set up the Payment integration

From the Wizard, choose Hardware -> Installer App -> Micro-service Manager

After which it'll display ADD NEW MICRO-SERVICE where you can choose needed payment integration (if there is no integration that you need check it from UPDATE EXISTING MICRO-SERVICE)

Once payment integration is selected - press Continue

After that it'll display printing microservice configuration view. There is status “Not installed” on the red background.

Click on the Install latest (blue button)

Not the micro-service status is “Installed but stopped” on the yellow background

Click on the green Start button. Then Start button becomes Stop (yellow) and micro-service status is “Installed and running” on the green background.

Now the printing microservice is running and you can proceed with printer configuration!

Set up the Payment terminal

In the Wizard naviagte to the Hardware -> Integrations and choose the category POS

Select a POS from the dropdown list

Click on the Payment Terminal

Press Continue

Under the Available integrations for POS level, choose needed payment integration

If the needed payment micro-service is not displayed there then select it from the “Add New Integration” list:

Click Add

Then the payment terminal configuration view is opened.

Fill all the fields in this view and press Save.

Step 3

Configre Payment integration in Self-Service Checkout

First you have to write Additional information in the EFT field in the Self-Checkout POS configuration app.

  1. Navigate to the Back Office -> Apps
  2. Open “Self-Checout POS" from Ground Control column
  3. In the Configuration view click “Edit”
  4. Open General configuration tab
  5. Scoll down and find the EFT field under Additional information

6. Enter the swedbankIngenico if you will use Swedbank payment integration; enter adyenms in case of Adyen payment integration.

Configure Swedbank payment integration

If the Installer app and Swedbank micro-service are installed and terminal is configured in the Wizard you can proceed with other required configuration steps.

Swedbank integration needs extra parameters to be configured.
In order to add them go to Back Office -> Settings -> Configuration Admin.
Now you are in the App Configuration view.

Select self_checkout_pos from the list and press + ADD NEW CONFIGURATION:

 

Fill the following fields:

  • Level: Company
  • Name: swedbankingenico
  • Value Type: JSON

Value:

“attendedMerchant”: “REFUND”

“unattendedMerchant”: “DEFAULT”

 

 

Logging in to the Self-service checkout

 

To log in to the self-service checkout, select sco.erply.com in your browser

Add a shortcut to the screen for convenient entry into the self-service checkout.

Enter customer code, username and password.

Then the day's opening window opens. If you don't want to use cash payments at all, start the day with 0 euros.

The administrator's menu in the self-service checkout

 

The employee has the opportunity to change some settings at the checkout. To enter the administrator's menu, it is necessary to first assign a PIN code to the employee on the Erplys user card.

Possible settings/options:

  • Add product - you can search for a product only by code or by scanning. Product search by name is available in the customer view.
  • Save sale - using this, the sale remains saved but unconfirmed and can be confirmed later in Erply. Sales recorded but not confirmed at the end of the day are automatically cancelled.
  • Checkout in/out - used only if cash sales are allowed at the self-service checkout. Requires reason codes set up in accounting software.
  • Return - the shopping cart view opens, where you can select the product to be returned. NB the quantities in the shopping cart are automatically minus. It is necessary to select a reason code. A credit note will be created. There is no need to have a base invoice when returning goods through the self-service checkout.
  • Recent sales - here you can see the latest deals. From there you can print a purchase receipt, send it to an email or print out a gift voucher.
  • Cash drawer - the possibility to open the cash drawer (if it is available for cash transactions)
  • Change quick options - you can change their order and position by dragging the buttons. The cross in the corner of the button removes the product from the self-service checkout selection.
  • Customize the user interface - see below
  • Log out - logs out and closes the current session
  • X-report - X-report is displayed on the screen
  • Close day - A confirmation window opens to close the day. Pressing the "Confirm" button closes the cash register and displays the x-report on the screen. If cash sales at the checkout are not allowed, then the expected cash amount is not displayed either

Edit UI has the following subsections:

 

Company Setup:

  • Colors: Can change the color displayed in the header.
  • Home screen: you can add a home screen image and welcome text, also in Russian and English, if desired.
  • Fonts: This is where you set the size of the text on the hotkeys.
  • Status bar steps: can be shown or hidden in the "scan-pay-done" header

Checkout setting:

 

  • Payment methods: you can choose the payment methods used in the self-service checkout.
  • Shopping bag: A product card must be created for the shopping bag in Erply beforehand. To display at the self-service checkout, enter the product code and add a checkmark to display the shopping bag in the customer panel. Save.
  • Printing: option to choose whether the receipt printing is enabled by default or not.

Usage

Customers can move on the touch screen as they wish, and in the left corner it is possible to change the language if desired. Products can be entered into the shopping cart with a barcode reader, searched by product code or using the quick selection buttons.

When all the required products have been added to the shopping cart, the customer proceeds to pay. The possible payment methods depend on how the checkout is set up. If only card payment is allowed, then only card payment is also available. Cash payments are possible only with the help of the employee. This means that the customer selects "Cash" and the employee must go to the self-service cash register, log in with his code, take money from the customer and complete the transaction.

After making the payment, the customer has the option to choose whether to send the receipt to an email, print it or refuse it altogether. If the customer does not choose anything and leaves the self-service cash register first, a timer with the set time will appear on the screen, and when it reaches 0, the self-service cash register page will be displayed on the screen again.