Setting up the EMIS and Joy Integration - Common Issues

📍 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:

Portal access: Enabled
Require logon details: Yes
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:

Click the EMIS ball 👇
Choose “System Tools” 👇
Choose “EMAS Manager” 👇
Choose "Partner API" 👇 from the bottom left
Find and then select "Joy" 👇 from the list
Double-check Joy is activated, Joy ✔️ will have a green tick beside the name once it’s been activated
Make sure "Joy" is selected
Click “Edit Users” 👇
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.
Tick the box next to their name ☑️ as shown in the image below:
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: