ZnanyLekarz - jHIS™ system integration

The jHIS™ system has built-in mechanisms of integration with the ZnanyLekarz website in terms of publishing free dates from the jHIS™ system on the ZnanyLekarz website and recording visits arranged via the ZnanyLekarz website in the jHIS™ system.

To start communication in the jHIS™ system with the ZnanyLekarz service, you need to take several steps.

First, you must register as an facility on the ZnanyLekarz website. To do this, go to the ZnanyLekarz website (https://www.znanylekarz.pl/) and click 'Zarejestruj się' in the menu and select 'jako placówka'.

Then you need to complete the facility's registration process on the ZnanyLekarz website, i.e. provide all necessary facility details, including service addresses, types of services performed, and doctors working at the facility. When the registration process is completed, please contact the ZnanyLekarz service advisor (via the contact form on the website). In the message you should:

  • Ask to enable mechanisms for integrating the ZnanyLekarz website with the jHIS™ system.
  • Ask for access data, i.e. login (also known as "client id") and password (also known as "secret"), which the jHIS™ system will use to authorize on the ZnanyLekarz website.
  • Ask that the ZnanyLekarz service will send notifications to the appropriate address in the jHIS™ system (this address should be copied from the field "Address to which the ZnanyLekarz service should send notifications" visible in the form that appears after selecting the "Configuration" functionality from the "Administration" menu in jHIS™ system)

After receiving a message from an advisor of the ZnanyLekarz website (containing access data), select the "Configuration" functionality in the "Administration" menu in the jHIS™ system and then enter the data received into the "Login for integration mechanisms to autorize in ZnanyLekarz service" service and "Password for integration mechanisms to autorize in ZnanyLekarz service” and save them by clicking the "Update" button at the bottom of the form.

After completing the configuration of the jHIS™ system connection with the ZnanyLekarz website, the process of data synchronization between the jHIS™ system and the ZnanyLekarz website is automatically started. As the synchronization process may take a few minutes, please wait before continuing.

When the synchronization process is completed, the data in the jHIS™ system should be linked to the data entered into the ZnanyLekarz service. To do this:

  • from the "Administration" menu in the "Dictionaries" submenu, select the "Commercial services" functionality and edit each of the services (which will operate on the ZnanyLekarz service) indicating in the "Service defined within ZnanyLekarz service" field corresponding to the service from the ZnanyLekarz
  • from the "Administration" menu, select the "Price lists" functionality and edit each of the price lists (which will operate on the ZnanyLekarz service) by checking the "Price list used for ZnanyLekarz web site" box next to such price lists (there can be only one price list marked in this way in each clinic; if a given service appears in two different price lists marked in this way, both must have the same price)
  • from the "Administration" menu in the "Organizational structure" submenu, select the "Medical care" functionality, then go to the "Units" and edit each of the unit (which will operate on the ZnanyLekarz website) indicating in the field "Facility in ZnanyLekarz service" the corresponding facility from ZnanyLekarz website
  • from the "Administration" menu in the "Organizational structure" submenu, select the "Medical care" functionality, then go to the "Clinics / Departments" tab and edit each of the clinics (which will operate on the ZnanyLekarz service) indicating in the field "Address in ZnanyLekarz service" corresponding address from the ZnanyLekarz website
  • from the "Staff" menu, select the "Staff" functionality and edit each person (which will function on the ZnanyLekarz website) indicating in the field "Person in ZnanyLekarz service " the corresponding person from the ZnanyLekarz website

Entering of the above connections completes the process of configuring integration mechanisms. From this point on, it is possible to use the integrated jHIS-ZnanyLekarz environment, which means that:

  • slots planned in timetables in jHIS™ with the field "Visibility within ZnanyLekarz web site" will be automatically transferred to the ZnanyLekarz website
  • informations about plans / transfers / cancellations of visits made within jHIS™ on slots with the field "Visibility within ZnanyLekarz web site" checked, will be automatically sent to the ZnanyLekarz website
  • informations about planning / transfering / canceling visits on ZnanyLekarz website will be automatically transferred to the jHIS™ system and patients' data with it (the patient in the jHIS system corresponding to the patient from the ZnanyLekarz website is determined based on the email address; if the patient with the given email address does not exist in jHIS, then it is automatically added to jHIS™ and marked as a patient registered by the ZnanyLekarz service and requiring verification / completion of data)

Integration of the jHIS™ system with the ZnanyLekarz website has a restriction that slots can be created / modified / deleted only on the jHIS™ system side. The creation / modification / deletion of the slot on the ZnanyLekarz site will cause the synchronization process to overwrite changes made to the ZnanyLekarz system with the actual state of the jHIS™ system.