How to Map Incoming Resident Messages

Mapping incoming resident messages in your Pharmacy inbox is a necessary first step to ensuring pharmacy-sent resident orders are linked to the correct resident in ALIS. Once an incoming resident message is mapped to the ALIS profile, their orders will become available for processing. 

About Incoming Resident Messages

Once your pharmacy connection is established in ALIS, your pharmacy will send resident profiles and orders in bulk to your Pharmacy Inbox. 

• The first time the pharmacy sends orders through your ALIS connection, you will need to start in the Incoming Residents tab, which will contain line items representing applicant or resident profiles sent from the pharmacy. Your job will be to map these profiles to your applicant or current resident profiles in ALIS in order for resident orders to be available for verification and processing in your Incoming Orders tab. For more information on processing resident orders, refer to this How to Process Incoming Order Messages guide. 
• Mapping the pharmacy-sent profile to the ALIS profile is done for your residents one time only, and the purpose is to ensure that the order messages the pharmacy sends via your pharmacy connection will be continually linked to the correct resident in ALIS.
• Mapping can be completed for applicants or current residents. Mapping applicant profiles and processing orders ahead of their physical move-in date is always recommended. 
• Note that if your pharmacy integration is with Prescriber's Connection, you may not need to complete this step as the linking most often will be done automatically in the background. 

How to Map Incoming Messages

To get started, select either the Pharmacies dashboard icon or use the Medications dropdown menu at the top of the page.

1. In your Pharmacy Inbox page, click the Incoming Residents tab.
   • When you have first established the pharmacy connection, each of your current residents (and applicants, if applicable) should display here.
   • After you map each profile, you will only use complete the mapping process in this tab to map any new residents in your community.
2. For the first resident you want to map, click the Map to ALIS Resident button.
3. In the Match Profile step, you need to verify the incoming pharmacy profile on the left matches an existing applicant or resident profile in ALIS.
   • Most often, this is an automatic process where ALIS detects a "Best Match" and connects the profiles based on the resident name, SSN, and/or DOB. Refer to the If a "Best Match" is not detected section for steps to take if this does not occur. 
4. Once you verify that the information on the left side and right sides of the page are for the same person, click Next Step. 
5. In the Merge Profile step, the page displays more resident details to verify. The goals of this step  are to review the information in ALIS to align with the information the pharmacy has, and for the ALIS profile to be as complete as possible. 
   • The pharmacy information is shown on the left. If the pharmacy profile contains accurate information that the ALIS profile does not yet have, then you can add those details to the applicable fields on the right side of the screen to be saved in ALIS once mapping is complete.
   • If any of the information the pharmacy has is incorrect (left side), you should make note of the details and contact the pharmacy so that they can correct any inaccuracy. A somewhat common occurrence is inaccurate resident birthdates.
   • There is no need for concern if the information on the pharmacy side is empty. This does not mean that the pharmacy does not have the information. However, you can always contact your pharmacy directly to make sure all information is up-to-date. 
6. Once you have reconciled the pharmacy information with the information saved in ALIS, click the green Complete Resident Mapping button at the bottom right.  

If a "Best Match" is not detected

It is possible that when you attempt to map a resident message that ALIS is unable to detect a "Best Match". This could be due to either of the following reasons:

1. Either the pharmacy profile has a different spelling for the resident's first or last name than you have stored on the ALIS resident profile, OR
2. The applicant or resident profile has not yet been created in ALIS so there is no profile for ALIS to identify and map pharmacy information to.

1 - Search for the Resident

First try searching for the resident's name. Type the accurate spelling of the resident's name into the search field, and ALIS will begin to identify if there are any potential matches. If the correct profile does not automatically appear below for you to select, click Search For Profile. 

If the correct profile does appear, click on it and then go to Next Step. It is okay to go ahead and complete the mapping step even if the name on the pharmacy profile is incorrect, just be sure to contact your pharmacy to have them update their records accordingly.

2 - Create New Profile (if applicable)

If you search but are unable to locate a matching profile, this likely means that the profile has not yet been created in ALIS and therefore there is nothing that can be mapped to the pharmacy profile.

Click Cancel and/or navigate to your All Residents page to ensure the profile does not exist and to create a new one if needed. Review the "Manually add Applicant profiles" section of this Guide to Adding New Residents article for more information.

As soon as the profile exists in ALIS, and as long as the resident name matches the profile you just created, you can return to your Pharmacy Inbox to restart the mapping process. The matching profile will now automatically populate in the Match Profile step. 

Dismiss Incoming Resident Messages

In your Incoming Residents tab, it is possible that you will see line items of resident messages for residents that are no longer at your community and therefore do not need be mapped. You may also occasionally see messages that appear as "stock" or "supply" orders, which you will want to clear from this tab.

1. For any of these incoming resident messages that do not need to be mapped, use the dropdown arrow to the right of the Map to ALIS Resident button and click Dismiss to History.
2. This makes a pop-up appear in which you need to choose whether to select Dismiss Message or Dismiss All Future Messages.
   • • Dismiss Message allows you to dismiss this message and clear it from the queue for the time being but not indefinitely. This option is commonly used if you have had a resident on leave for an extended period of time, transfer, or move out with the potential of returning to your community in the future. 
     • Dismiss All Future Messages means that you are essentially blocking the pharmacy from being able to send this incoming message again. This option is commonly used if the resident will not be returning to your community. 

After Mapping 

Once the resident message has been mapped to a resident in ALIS, the order messages will start to appear in the Medication Messages section of the main Pharmacies page for you to begin processing. For more information about processing the Medication Messages, read this How to Process Incoming Order Messages guide.

Related Articles:

• Pharmacy Integrations Reference Guide
• How to Process Incoming Order Messages

For more assistance with Pharmacy Inbox,

Contact our ALIS Customer Success Team

888.404.2547 or support@go-alis.com