Skip to main content

Setting up the EMIS and Joy Integration - Common Issues

This article outlines the common problems when setting up Joy within EMIS and what steps to take to resolve them.

Written by Sonja Gebhardt

📍 This article includes the following errors:

  • You see an error or ‘Kittens’ when hitting the Social Prescribing button

  • You see 'Connection Error' when you set up the integration in EMIS


❗ You see an error or ‘Kittens’ when hitting the Social Prescribing button

Details that you entered in EMIS during the setup are incorrect.

✔️ Solution: To check this please follow the below steps within EMIS
​

Select the following options:
​

1. Click the EMIS ball

2. Click "Configuration" 👇

3. Then, click "Organisation configuration" 👇

4. Click “Organisation” 👇

5. Click on your surgery and then click on “Edit” 👇

6. Find Social Prescribing in the list and click it 👇
​
​Select the following options:

  1. Portal access: Enabled

  2. Require logon details: Yes

  3. Enter your username ✍️:
    ​

    • Please check this next step carefully:

      • Joy[Your ODS code] (for example, if your ODS code is N81006, your username would be: JoyN81006)

      • Password: Monday123

        If EMIS does not allow you type Monday123 - then please enter Monday1234, press save and then re-open the window and type Monday123. It will work the second time.

4. Click "OK" 👇

5. When EMIS asks if you want to log out, choose “Yes” 👇

6. Log back in and try the steps with a test patient again

7. If you still see the Kittens error please email 📧 [email protected] with the following Subject line: EMIS Set up Error Kittens (Insert Practice name)


❗ You see 'Connection Error' when you set up the integration in EMIS

There are numerous reasons this could happen, please follow the steps below which will help resolve this issue:

✔️ Solution One: When setting this part up you may have put your ODS code into the Joy connection, instead of EMIS code

Please note that the EMIS code is usually 1 to 5 numbers, whilst the ODS is a letter followed by 5 numbers. If you have entered it incorrectly, ensure you re-enter it correctly.


​

✔️ Solution Two: You may have missed an RBAC code when you created the Joy user within your EMIS

  • To check this please revisit Creating Joy as a user in EMIS (add link when article is live)
    ​

  • Please make sure the Joy App user has all 9 of those RBAC codes added

    • In most cases, the B8029 - Managed Detailed Records does not add correctly the first time

If any codes have been missed, ensure you enter them correctly to fix this error.

✔️ Solution Three: There is a password error Part 2 of the EMIS integration

This means the user may not have been given full access.

Please follow the below steps:

  1. Click the EMIS ball 👇

  2. Choose “System Tools” 👇

  3. Choose “EMAS Manager” 👇

  4. Choose "Partner API" 👇 from the bottom left

  5. Find and then select "Joy" 👇 from the list

  6. Double-check Joy is activated, Joy ✔️ will have a green tick beside the name once it’s been activated

  7. Make sure "Joy" is selected
    ​

  8. Click “Edit Users” 👇
    ​

  9. Find the name 🔍

    • “App, Joy”

    • “Partner, API” with username APIUSER

    • And any social prescribers/health coaches/care coordinators or members of the personalised care team. Please don’t untick any users who are already ticked.
      ​

  10. Tick the box next to their name ☑️ as shown in the image below:

  11. VERY IMPORTANT: Please select 'Change Password' 👇 and Set password(s) as Monday123 ✍️

Please ensure that this password has been typed in correctly. If it hasn’t been typed in correctly, you will be unable to connect to Joy. This must be completed for:

  • APP, Joy (JOYCONNECT)

  • PARTNER, API (APIUSER) ****(only if you have this)

  • And all members of the personalised care team
    ​

12. Click OK 👇

13. Click “Log in Access” 👇 and find the name:

  • “APP, Joy” JOYCONNECT

  • “PARTNER, Api” APIUSER

  • And any social prescribers/health coaches/care coordinators.

14. Tick both boxes for “auto” ☑️ and “allow login” ☑️

Please don’t untick any users who are already ticked

15. Click “OK” 👇


16. Please log out and log back into EMIS for all changes to take effect! 🎉

Did this answer your question?