Contents

    JTL-POS ERPConnected - the POS system for JTL-Wawi

    Connecting JTL-POS to JTL-Wawi

    Your task/initial situation

    This is for those who would like to use JTL-Wawi to manage items and categories offered via JTL-POS.
    Please note: Items and categories can only be edited in JTL-Wawi. If you have already created test items and categories in JTL-POS and later connect JTL-POS to JTL-Wawi, you can no longer edit or delete these items and categories. If you have already created items in JTL-POS for testing purposes and would now like to use JTL-POS productively with JTL-Wawi, we recommend that you do not transfer the demo database to your operational system. When the demo version is converted to an operational version, you are automatically asked whether you want to keep the database. If you have run tests on an operational version, back up the database if necessary, uninstall JTL-POS, and then reinstall it. You can thus start with a new database that contains only items from JTL-Wawi, for which you have enabled synchronisation.

    Requirements/Restrictions

    • From JTL-POS 1.0 on, at least JTL-Wawi version 1.5.14.3. Versions 1.5.55.2, 1.6.38.2, or higher are strongly recommended.
    • The Android device on which you want to use JTL-POS must be logged in to the same network as the JTL-Wawi server. Alternatively, the JTL-Wawi server must be publicly accessible, like JTL-Wawi Cloud.
    • The JTL-Wawi servers must each be assigned a static IP address. The IP may not be 127.0.0.1 (localhost).

    Firewall settings

    Please note: If you are working with Windows Defender and have local admin rights, you can skip this step as the correct firewall settings will be set automatically by JTL-Wawi. JTL-Wawi also tries to define the settings for other firewall programs. Depending on the permissions offered by the program, you have to adjust the settings manually as described in this documentation. Even if your system is managed by a system administrator, for example, the administrator must abide by the documentation. Depending on the configuration of your system, the optimal configuration of your firewall may differ from this description. In order to avoid security gaps in your company’s network, please consult the administrator who manages your network and firewall settings.

    Adding inbound/outbound rules

    The following description applies to both the creation of an inbound rule and an outbound rule.

    1. From the client or server on which the JTL-Wawi database is located, open the Firewall and network protection dialogue box via the Windows menu > Settings > Network and internet > Status > Windows Firewall.
    2. Click on Advanced settings.
    3. On the left, select Inbound rules. If you have already created the inbound rule, select Outbound rules.
    4. On the right side, select the menu item New rule….
    5. For the rule type, select Custom and click Next.
    6. In the next step, under Program, select All programs and then click Next.
    7. Select TCP as the protocol type.
    8. Under Local port, select Specific ports and enter 443 as the port.
    9. Under Remote port, select Specific ports and enter 443 as the port.
    10. Click Next.
    11. Under Which local IP addresses does this rule apply to?, select These IP addresses and click on Add.
    12. Select These IP addresses, enter the IP address of the JTL-Wawi server and click OK.
    13. Under Which remote IP addresses does this rule apply to?, select the option Any IP address.
    14. Click Next.
    15. In the Action step, select Allow the connection and click Next.
    16. In the Profile step, select the Firewall profiles to which this rule applies and click Next.
    17. Lastly, in the Name step, enter a unique name for the rule in the Name field and, optionally, enter a description.
    18. Then click Finish.

    Once you have created the inbound rule, repeat steps 1–18 to create an outbound rule. However, in Step 3, select Outbound rules from the menu.

    Connecting JTL-POS to JTL-Wawi

    Changing settings in JTL-Wawi

    Please note: You need Windows administrator rights for the following steps. You must log in once as a Windows administrator during the setup and give JTL-Wawi the authorisation to make the required changes. You can then continue working as a Windows user without administrator rights.
    1. Open JTL-Wawi, version 1.4.30.2 or higher.
    2. Go to Admin > Global settings, and the Global settings dialogue box will open.
    3. Switch to the Server settings tab.
    4. Click on Configure server. The dialogue box Interface configuration for JTL-POS will open.
    5. Enter the IP address of the JTL-Wawi server in the field IP address. If there are several options available, please do not select 127.0.0.1 (localhost).
    6. Enter the 443 port into the Port field.
    7. If necessary, create a new certificate by clicking on Create certificate.
    8. Confirm with OK.
    Please note: As a rule, it is best to create a new certificate, as this is valid indefinitely. This applies in particular if you use JTL-Wawi Cloud, as the certificate from ecomDATA is by default valid for one year and would otherwise have to be renewed annually.
    1. Make sure that the option Start REST server when starting JTL-Worker is enabled (see next step).
    1. Switch to the Processes tab.
    2. In the Orders/Invoices area, select the Show transactions from external POS systems in JTL-Wawi check box.
    1. Click on Save to save the settings.
    2. Restart JTL-Wawi for the changes to take effect.

    Opening JTL-Worker

    1. Open JTL-Worker as an administrator via the Windows start menu.
    2. Switch to the JTL-POS server tab. In this window, you can see current connection information. It should be displayed that the REST server has been started.
    1. Do not close the window, just minimize it. You do not need to make any further adjustments to the JTL-Worker.

    Connecting JTL-POS to JTL-Wawi

    1. Go to Admin > JTL-POS settings to open the dialogue box JTL-POS.
    2. Click Add. A new cash register will be created.
    1. Complete the information in the tab Branch office.
    Please note: By clicking on the Open queue button, the JTL-POS-Queue dialogue box will open. This dialogue box displays order processes that failed during import from JTL-POS. This dialogue window is used by JTL support as a means of analysing errors.
    1. Click on Connect cash register. The dialogue box JTL-POS will open. Here, you will see the important connection data to be entered into JTL-POS.
    2. In JTL-POS, go to Settings > JTL-Wawi and the dialogue box Data synchronisation with JTL-Wawi.
    3. Enable Edit mode, by clicking on the pen icon and enter the data displayed in JTL-Wawi.
    4. Tap on Establish connection.
    1. In the dialogue box Connecting a POS system in JTL-Wawi, click Save to apply all settings.
    2. If you have entered the data correctly, JTL-Wawi will display the message The cash register has been successfully connected. Click OK to exit the window.
    3. In JTL-POS, tap on Save. Your data will then be saved.

    JTL-POS is now connected to JTL-Wawi. As a next step, you can enable your categories and items in JTL-Wawi for JTL-POS and perform a data synchronisation.

    Please note: If you want to connect several cash registers to JTL-Wawi, read the following guide: Connecting multiple cash registers to JTL-Wawi.

    Enabling categories/items for JTL-POS

    To import categories and items into JTL-POS with data synchronisation, you first need to enable the respective categories and items for the synchronisation with JTL-POS. For more information on this topic, click here: Enabling categories and items for JTL-POS.

    JTL-POS ERPConnected - the POS system for JTL-Wawi