Before a pharmacy’s orders for a resident can come into ALIS, you have to map, or link, that resident to their applicant or resident profile in ALIS. Until a resident is mapped or dismissed, their orders don’t reach ALIS. This guide covers mapping a resident, what to do when ALIS can’t find a match, and dismissing messages you don’t need.
About Incoming Resident Messages
Once your pharmacy connection is set up, the pharmacy sends resident profiles and orders to your Pharmacy Inbox. Each resident profile shows up in the Incoming Residents section until someone maps it to a profile in ALIS.
You map each resident only once. After that, every order the pharmacy sends for that resident links to the right profile automatically.
You can map applicants as well as current residents. It’s a good idea to map applicants and process their orders before their physical move-in date.
If your pharmacy integration is through Prescriber’s Connection, ALIS usually maps residents for you in the background, so you may not need this guide.
How to Map Incoming Resident Messages
Step 1: Open the Incoming Residents section
- Click the Pharmacies dashboard icon. You can also access from:
- Enhanced Navigation (sidebar): Clinical > Meds > Pharmacies
- Legacy Navigation (top menu): Medications > Pharmacies
- At the top of the Pharmacy Inbox, find the blue Incoming Residents (N) bar. N is the number of residents waiting to be mapped. The section opens automatically when residents are waiting.
Tip: The Incoming Residents bar sits above the Inbox tabs, so you can address unmapped residents right away. When no residents are waiting to be mapped, it stays collapsed and shows no count.
Step 2: Match the profiles
On the Match Profile step, you confirm that the pharmacy’s profile and the ALIS profile belong to the same person.
- Next to the resident name, click Map to ALIS Resident.
- Compare the Incoming Profile on the left with the Best Matches on the right. ALIS suggests a match based on name, SSN, and date of birth.
- If the match is correct, click Next Step.
If no Best Match appears, see If a Best Match is not detected below.
Step 3: Merge the profile and complete mapping
On the Merge Profile step, the pharmacy’s details are on the left and the ALIS profile is on the right. Use this step to bring the two records in line.
- Review the pharmacy’s details on the left. If anything is wrong, write it down and ask the pharmacy to correct it. Birthdates are a common example.
- On the right, fill in any accurate details from the pharmacy that the ALIS profile is missing.
- Select the resident’s Med Cart.
- Click Complete Resident Mapping.
Tip: Updating the information on the right updates the corresponding fields on the ALIS profile (e.g., Health Profile > Primary Diagnosis) immediately once you complete the mapping. You can set the Med Cart at this stage or later. See How to Assign and Use Medication Carts (Med Carts).
If a Best Match is not detected
When ALIS can’t suggest a match, it’s usually for one of two reasons:
- The pharmacy spelled the resident’s name differently than ALIS does, or
- the applicant or resident profile doesn’t exist in ALIS yet.
Search for Profile
- On the Match Profile step, click Search For Profile.
- Type the resident’s name in the search field.
- If it appears, select the profile and click Next Step. Then finish Step 3 above.
Tip: You can still complete mapping successfully even if the pharmacy has the name spelled incorrectly. Just ask the pharmacy to update their records afterwards.
Create the profile if it doesn’t exist
- Click Cancel. This takes you back to the Pharmacy Inbox with the Incoming Residents section open.
- Check the All Residents page to confirm the profile really doesn’t exist. If it doesn’t, create it. See Guide to Adding New Residents, “Manually add Applicant profiles” section.
- Go back to the Incoming Residents section and click Map to ALIS Resident for that resident again. As long as the names match, the new profile shows up as the Best Match.
Dismiss Messages
Clear out messages that don’t need to be mapped, such as residents who no longer live at your community or “stock” and “supply” orders.
- In the Incoming Residents section, click the dropdown arrow next to Map to ALIS Resident, then click Dismiss to History.
- In the pop-up, choose one of these options:
- Dismiss Message: Clears the message for now. If the pharmacy sends it again, it comes back. Use this when the resident is on extended leave, has transferred, or has moved out but may return.
- Dismiss All Future Messages: Blocks future incoming messages for this resident. Use this only when the resident won’t be returning.
Warning: A dismissal can't be undone. If you dismiss a resident who still lives at your community, their pharmacy orders will not flow into ALIS. If a dismissal occurs in error, contact our ALIS Customer Support Team for assistance.
What to Expect After Mapping
Once a resident is mapped, their orders from the pharmacy show up in the Incoming Orders tab, ready to process. See How to Process Incoming Order Messages.