mO SharemO Share

We’re excited to announce that the latest information is now available on our new site, the Ginesys One Wiki!. Visit the site for up-to-date resources and insights. We look forward to continuing to support you there!

How To: Enable Ginesys for Zwing POS

Owned by Aparajita Basu Roy
Last updated: Apr 30, 2021 by kolba@gsl.in (Unlicensed)
3 min read

This configuration is required to ensure that data sync between Ginesys ERP and Zwing POS gets established.

Pre-requisites

Ginesys HO version should be 11.152.0 and above.

Check list

Enable Ginesys Outbound

This will allow sending of data like Item Master, GRC advice, GRT advice, etc. from Ginesys to Zwing.

A. Get client wise details from Zwing

The following information is required to be collected from Zwing before implementing its integration with Ginesys:

  1. client_id

  2. username

  3. password

  4. LicenseKey

Important

Note: LicenseKey is the organization_code uniquely generated by Zwing for each client.


B. Configure ZwingConfig.json file

  1. In Ginesys Application server, navigate to C:\GSL\GINESYS12\Shared\GDS\Notifiers\Zwing

  2. You will find ZwingConfig_Template.json file there, copy the same and rename to ZwingConfig.json.

  3. Please make sure that ZwingConfig.json has read & write access to all.

  4. Right-click - open the file in edit mode (using any text editor).

  5. Place the details received from Zwing against the respective fields.

Sample ZwingConfig.json
{ "SubscriptionName": "ZWING", "GinesysConfigPath": "..\\..\\..\\", "client_id": "A1728", "username": "abc", "password": "abc", "LicenceKey": "123", "BaseUrl": "https://api.gozwing.com/", "TokenUrl": "https://api.gozwing.com/oauth/token?grant_type=password&client_id=<client_id_given_by_zwing>&username=<username_given_by_zwing>&password=<password_given_by_zwing>", "CheckerURL": "https://api.gozwing.com/client/item/create/status", "Token": "" }

 

Please Note: On Ginesys Cloud deployments, implementers should ignore the steps of configuring Windows Tasks Schedules. Though the tasks may not be visible in Standard user login, the required tasks are pre-configured there. Implementers can verify the generating logs at C:\programdata\GINESYS\Logs\GDS.

C. Schedule a task for Zwing EventBusRunner

  1. Login to the application server as administrator.

  2. Go to Windows Task Scheduler.

  3. Click on "Create Task".

    1. General tab:

      1. Put Name as "GDS2_EventBusRunner_Zwing"

      2. Select Run whether user is logged in or not.

    2. Trigger tab:

      1. Add a new trigger.

      2. Begin the task = "On a schedule"

      3. Settings:

        • Select Daily

        • Start date = Current System Date

        • Start time = 00:01:00

      4. Advance Settings:

        • Select Repeat task every

        • Change 1 hour to 5 mins

      5. Press OK

    3. Action tab:

      1. Add a new action

      2. Action = "Start a program"

      3. Program = "C:\GSL\GINESYS12\Shared\GDS\GDS.EventBusRunner.exe"

      4. Add Arguments = "Zwing" 

D. Schedule a task for Zwing Notifier

  1. Login to the application server as administrator.

  2. Go to Windows Task Scheduler.

  3. Click on "Create Task".

    1. General tab:

      1. Put Name as "GDS2_Notifier_Zwing"

      2. Select Run whether user is logged in or not.

    2. Trigger tab:

      1. Add a new trigger.

      2. Begin the task = "On a schedule"

      3. Settings:

        • Select Daily

        • Start date = Current System Date

        • Start time = 00:02:00

      4. Advance Settings:

        • Select Repeat task every

        • Change 1 hour to 5 mins

      5. Press OK

    3. Action tab:

      1. Add a new action

      2. Action = "Start a program"

      3. Program = "C:\GSL\GINESYS12\Shared\GDS\Notifiers\Zwing\ZwingNotifier.exe"

Enable Ginesys Inbound

This will allow receiving of data like POS Bill, GRC, GRT, etc. from Zwing to Ginesys 

A. Unextinct Zwing user

  1. Go to Ginesys Web - HO - Admin - Security - User - Users.

  2. Find the user: "SYS Zwing User".

  3. Open the user in edit mode.

  4. Unextinct it & save the user.

B. Generate API Key for Zwing user

  1. Go to Ginesys Web - HO - Admin - Security - User - Users.

  2. Find the user: "SYS Zwing User".

  3. Open the user in edit mode.

  4. Click on Generate Ke & save the user.

  5. Copy the API Key.

C. Share details with Zwing

The following details needs to be shared with Zwing:

  1. API Key (copied in the previous step)

  2. Base URL: http://host_static_ip_or_cloud_address/pos
    Note: Replace host_static_ip_or_cloud_address with actual before sharing.