[-]
System Settings
 [-]
   
   
   
  
  
  
  
  
[+]
Programs
[+]
[+]
Reports
 
[+]
Administration
 
 
 
Updated on 11/8/2018
Direct link to topic in this publication:
iikoCard
iikoCard5 Connection

Once you register on iiko.biz, you have to set up connection to iikoCard5 system.

Warning Information given in this section is relevant for version 5.1 and later. In older versions of iikoRMS, connection to iikoCard5 shall be set up in the payment type properties see Create payment type.

IikoRMS connection

To set up connection to iikoCard5 in iikoRMS, follow this:

  1. Go to iikoCard5 > iikoCard5 Setup.
  2. On the General Settings tab:
    1. Check Enable iikoCard5. You will have other tabs used to configure connection parameters available. If unchecked, you will not be able to work with iikoCard5.
    2. Insert a link to the iikCard5 main server in the Address bar in the following format: http://<iikoCard5 server name>. iiko server address is specified in this bar by default. You can use this address to work with iikoCard5 system. If you want to set up and configure your server, specify its address in this bar.
    3. Set up connection to RabbitMQ. Here you can configure connection to RabbitMQ server used by POS server to exchange data with the main iikoCard5 server. If you use the main iiko server, check Use default values.
    4. If you use local iikoCard5 server, then you have to install RabbitMQ as well. In this case, uncheck Use default data and enter:
  • RabbitMQ address in the following format: <server name RabbitMQ>.
  • The username and password created in RabbitMQ. On how to do it, see iikoCard5 Administrator Guide.


  1. Use POS Server For Cash Registers tab to configure connection of store’s iikoFront to POS server. Select one of the following options in the POS server installed field:
  • On the main cash register. iikoFront will automatically connect to POS server (since it knows the main cash register address).
  • On POS server. Select this option, if POS server is installed on the iikoRMS server. In this case, iikoFront will find the address automatically.
  • Enter address manually. Use this option, if you installed POS server in any other location, e.g., on a separate server. Specify address in the http://<POS server name> format and connection port. Localhost (or 127.0.0.1) is forbidden address.


  1. Configure call center connection to POS server on the POS Server for Call Center tab. Here we have two options:
  • On server - in case POS is installed on the call center server. Address will be determined automatically.
  • Enter address manually. Go for this option, if POS is installed on a separate server. In such case, specify address in the http://<POS server name> format and connection port.


  1. You can make settings on the Comparison of iikoCard5 Special Offers and Discounts tab at a later time. For the detailed description, see the corresponding section.
  2. Click Connect to iikoCard5.   

iikoChain connection

If you have a chain of stores, then you can set up connection by means of iikoChain. They replicate for the units and you can modify them in iikoRMS.

To set up connection in iikoChain, follow this:

  1. Go to iikoCard5 > iikoCard5 Setup.
  2. On the General Settings tab:
    1. Check Enable iikoCard5. You will have other tabs used to configure connection parameters available. If unchecked, you will not be able to work with iikoCard5.
    2. Insert a link to the iikCard5 main server in the Address bar in the following format: http://<iikoCard5 server name>. Iiiko server address is specified in this bar by default. You can connect and use this address to work with iikoCard5 system. If you want to set up and configure your server, specify its address in this bar.
    3. Set up connection to RabbitMQ. Here you can configure connection to RabbitMQ server used by POS server to exchange data with the main iikoCard5 server. If you use the main iiko server (i.e. you haven’t modified the Address field), check Use default values.
    4. In case you use your own iikoCard5 server, uncheck Use default data and enter:
  • RabbitMQ address in the following format: <server name RabbitMQ>.
  • Username and password specified at installation of RabbitMQ.


  1. Use POS Server For Cash Registers tab to configure connection of store’s iikoFront to POS server. In iikoChain, you can customize parameters for each unit:
    1. Select a unit on the company’s tree.
    2. Select one of the following options in the POS server installed field:
  • On the main cash register. iikoFront will automatically connect to POS server (since it knows the main cash register address).
  • On POS server. Select this option, if POS server is installed on the iikoRMS server. In this case, iikoFront will find the address automatically.
  • Enter address manually. Use this option, if you installed POS server in any other location, e.g., on a separate server. Specify address in the http://<POS server name> format and connection port. Localhost (or 127.0.0.1) is a forbidden address.


  1. Configure call center connection to POS server on the POS Server for Call Center tab. Here we have two connection options:
  • On server - in case POS is installed on iikoRMS server. Address will be determined automatically.
  • Enter address manually. Go for this option, if POS is installed on a separate server. Specify address in the http://<POS server name> format and connection port.


  1. You can make settings on the Comparison of iikoCard5 Special Offers and Discounts tab at a later time. For the detailed description, see the corresponding section.
  2. Click Connect to iikoCard5.  

Connection to the POS Server

Subject to iikoRMS version, connection of cash registers to POS server can be configured in iikoCard5 connection settings or payment type options.

You can configure an individual POS server connection for each cash register. For this purpose, specify its address in the configuration file of the iikoCard5 plugin. You can find it in the following folder: %appdata%\iiko\CashServer\PluginConfigs\Resto.Front.Api.PaymentSystem.iikoCard5. Key address into the line <posServerAddress>http://<pos-url.ru>:7001</posServerAddress>.

Information Note.  The settings of the iikoCard5 plugin configuration file have a higher priority as compared to the payment type settings.