Printing and Payment Terminal Microservice Setup

March 26, 2024


Setup the Printing for Barzil POS

Install the Installer App

In order to download and install the Installer App please refer to the following article

Enable printing microservice

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

Press Continue

After that it'll display printing microservice micro-service view


Click on the Install latest (blue button)

The following view is displayed:

Click on the Start button

Integrating the Receipt Printer

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

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. 

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. 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.

 

Perform connection test

Navigate to the POS https://epos.erply.com/
Login with Erply credentials (client code, username, password)
In order to test the printing is properly configured and working please make a test sale. In the end of transaction when the Finish Sale popup appears click on the Print button:

 

Also the receipt printing can be tested by printing an existing receipt in the Recent Sales:

Click on the Pending Sales grid button

Choose any sale and click on the “paper and printer” button:

Setup the Payment integration for Barzil POS

To integrate the payment terminal to Brazil POS, make sure that the terminal is in the same network as the computer is!!!

Enabled 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 any payment interation

Once payment integration is selected - press Continue


After that the payment microservice view is displayed:

Click on the Install latest button:

Then you will see the following view:

Click on the Start button:

Now that payment micro-service is running!

Integrating the Payment terminal

Naviagte to the Hardware -> Integrations and choose if you want to connect the terminal to the company, warehouse or cash register.

Select needed company, warehouse or POS from the dropdown list

Click on the Payment Terminal

Press Continue
Under the Available integrations, 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 following view will be opened:

Fill your terminal IP into Device IP field
Back to the Wizard. Enter the Device Port - 4445

Press Save

Configure payment integration in the Brazil POS

When you've finished setting up in Wizard, navigate to the Brazil POS https://epos.erply.com/
Click on the gear button 

 

The POS Settings are opened -> Payment configuration -> Setup Payment gateways and check if the needed payment integration is selected (if not please select it from the Select current integration dropdown list):

Check that Allow fallback to external integration box is ticked (if not please check it!):

Make sure that other payment integration fields are filled. If yes, please Save configuration.

Just in case, refresh the POS page:

 

Make a test sale using a card payment in order to make sure that the payment micro service is running and a payment terminal is properly configured and connected with a POS.

Updating Printing and Payment terminal microservice

From the Wizard, navigate to the Hardware -> Installer App -> Micro-service Manager, after which you'll choose the microservice you'd like to update from the Update existing micro-service dropdown menu. 
Once microservice is selected press Continue.
Here you can see the info regarding the microservice and if it's running

In order to update the microservice, click on the Update to latest button:

Refresh the Wizard page