Pennsylvania: Configure FFS EVV Aggregation
The Pennsylvania Department of Human Services (DHS) administers the PA Medicaid program and oversees the use of EVV in programs that provide certain home-and community-based services. DHS has certified HHAeXchange to submit Electronic Visit Verification (EVV) data on behalf of providers who render Personal Care Services (PCS) and/or Home Health Care Services (HHCS). Providers are subject to DHS EVV guidelines and must ensure visits are recorded in the aggregator.

Providers must complete the steps outlined below to configure HHAeXchange for EVV Aggregation. Failure to comply may result in no data sent to the aggregator.
-
Go to Admin > Contract Setup > New Contract.
Skip this step if an FFS contract already exists in the system.
-
Select the appropriate Contract Type value: PAOLTL, PAODP, or PAOMAP.
Contract Type Configuration
Contract Type
Payer Program/Waiver Name
PAOLTL
The Office of Long-Term Living (OLTL)
PAODP The Office of Developmental Programs (ODP) PAOMAP
The Office of Medical Assistance Programs (OMAP)
-
If a Contract Type is not found, go to Admin > Reference Table Management > Contract Type.
Refer to the Reference Table Management topic for steps on how to add a Contract Type.
-
Go to Admin > Reference Table Management > Contract Service Code to enter a valid Service Code in the Export Code field.
Repeat this step for each contract. Refer to the Reference Table Management topic for steps on how to add a Contract Service Code.
Refer to the PA EVV Contract Service Codes to view a full list of PA In-Scope Service Codes.
If an Export Code is associated to an incorrect Contract Type, then the EVV visit data associated to the Export Code is not sent to the aggregator. Only the confirmed visits associated to the In-Scope Service Codes with the correct Contract Type are aggregated.
-
Go to Admin > Reference Table Management > Visit Edit Reason to configure valid Reason Codes.
Refer to the Reference Table Management topic for steps on how to add a Reason Code.
Reason Code
Description
Note Required? 10 Direct Care Worker Error No
20 Participant Unavailable No 30 Mobile Device Issue No 40 Telephony Issue No 50 Participant Refusal Yes 60 Service Outside the Home No 70 Other Yes A default value of Other is exported with the visit when the Reason Code differs from the table above.
-
Review all Member Profiles to ensure the Member details are entered correctly.
Members must be identified by First Name, Last Name, and Medicaid ID. Member Medicaid IDs must be entered in the Member Profile > Medicaid ID field. Medicaid ID must be a 10-digit numeric value. Member Phone Number and Address are also required.
-
Review all Caregiver profiles to ensure that the Caregiver details are entered correctly.
Caregivers must be identified by First Name, Last Name, and Last 5-digits of the Social Security number (SSN). Providers can enter the full 9-digit SSN or the last 5-digits using the following format: 000-0X-XXXX.
Member and Caregiver names can consist of alpha letters, hyphens, periods, and apostrophes. All other special characters cause the record to reject.
-
Once complete, create a ticket via the Client Support Portal > State EVV Aggregation queue to set up the PA FFS EVV Aggregation interface.
Once confirmation is received, proceed to State Aggregation Report for steps on how to review exported EVV data.

Service Code Mapping | |||
---|---|---|---|
Contract Type | HCPCS Code | Modifiers | Service Code Description |
PAODP | T2025 |
GN, U1 |
Speech/Language Therapy-15 Mins - ECS |
PAODP | T2025 | GN, U2 | Speech/Language Therapy - 15 mins - AAW |
PAODP | T2025 | GN | Speech/Language Therapy-15 Mins |
PAODP | T2025 | GO, U1 | Occupational Therapy-15 Mins - ECS |
PAODP | T2025 | GO, U2 | Occupational Therapy - 15 mins - AAW |
PAODP | T2025 | GO | Occupational Therapy-15 Mins |
PAODP | T2025 | GP, U1 | Physical Therapy-15 Mins - ECS |
PAODP | T2025 | GP | Physical Therapy-15 Mins |
PAODP | T2025 | HE | Therapies - Counseling |
PAODP | T2025 | TD, U1 | Nursing - (1:1) RN-15 Mins -ECS |
PAODP | T2025 | TD, UN , U1 | Nursing (1:2) RN - ECS |
PAODP | T2025 | TD, UN | Nursing (1:2) RN |
PAODP | T2025 | TD | Nursing - (1:1) RN-15 Mins |
PAODP | T2025 | TE, U1 | Nursing - (1:1) LPN-15 Mins - ECS |
PAODP | T2025 | TE, UN, U1 | Nursing (1:2) LPN - ECS |
PAODP | T2025 | TE, UN | Nursing (1:2) LPN |
PAODP | T2025 | TE | Nursing - (1:1) LPN-15 Mins |
PAODP |
W1724 |
U1 | Companion Basic (1:3) - ECS |
PAODP | W1724 | Companion Basic (1:3) | |
PAODP | W1725 | U1 | Companion Level 1 (1:2) - ECS |
PAODP | W1725 | Companion Level 1 (1:2) | |
PAODP | W1726 | U1 | Companion Level 2 (1:1) - ECS |
PAODP | W1726 | U4 | Companion Level 2 (1:1) – No Benefit Allowance |
PAODP | W1726 | Companion Level 2 (1:1) | |
PAODP | W1726 | U4, U1 | Companion Level 2 (1:1) - No Benefit Allowance - ECS |
PAODP | W7058 | U1 | IHCS Basic (1:3) - ECS |
PAODP | W7058 | IHCS Basic (1:3) | |
PAODP | W7059 | U1 | IHCS Level 1 (1:2) - ECS |
PAODP | W7059 | IHCS Level 1 (1:2) | |
PAODP | W7060 | U1 | IHCS Level 2 (1:1) - ECS |
PAODP | W7060 | U4 | IHCS Level 2 (1:1) - No Benefit Allowance |
PAODP | W7060 | IHCS Level 2 (1:1) | |
PAODP | W7060 | U4, U1 | IHCS Level 2 (1:1) - No Benefit Allowance - ECS |
PAODP | W7061 | TD | IHCS Level 2 (1:1) Enhanced - RN |
PAODP | W7061 | TE | IHCS Level 2 (1:1) Enhanced - LPN |
PAODP | W7061 | U1 | IHCS Level 2 (1:1) Enhanced - ECS |
PAODP | W7061 | U4 | IHCS Level 2 (1:1) Enhanced - No Benefit Allowance |
PAODP | W7061 | IHCS Level 2 (1:1) Enhanced | |
PAODP | W7061 | TD, U1 | IHCS Level 2 (1:1) Enhanced - RN - ECS |
PAODP | W7061 | TD, U4 | IHCS Level 2 (1:1) Enhanced - RN - No Benefit Allowance |
PAODP | W7061 | TE, U1 | IHCS Level 2 (1:1) Enhanced - LPN - ECS |
PAODP | W7061 | TE, U4 | IHCS Level 2 (1:1) Enhanced - LPN - No Benefit Allowance |
PAODP | W7061 | U4, U1 | IHCS Level 2 (1:1) Enhanced - No Benefit Allowance - ECS |
PAODP | W7061 | TD, U4, U1 | IHCS Level 2 (1:1) Enhanced - RN - No Benefit Allowance - ECS |
PAODP | W7061 | TE, U4, U1 | IHCS Level 2 (1:1) Enhanced - LPN - No Benefit Allowance - ECS |
PAODP | W7068 | U1 | IHCS Level 3 (2:1) - ECS |
PAODP | W7068 | U4 | IHCS Level 3 (2:1) - No Benefit Allowance |
PAODP | W7068 | IHCS Level 3 (2:1) | |
PAODP | W7068 | U4, U1 | IHCS Level 3 (2:1) - No Benefit Allowance - ECS |
PAODP | W7069 | TD | IHCS Level 3 (2:1) Enhanced - RN |
PAODP | W7069 | TE | IHCS Level 3 (2:1) Enhanced - LPN |
PAODP | W7069 | U1 | IHCS Level 3 (2:1) Enhanced - ECS |
PAODP | W7069 | U4 | IHCS Level 3 (2:1) Enhanced - No Benefit Allowance |
PAODP | W7069 | IHCS Level 3 (2:1) Enhanced | |
PAODP | W7069 | TD, U1 | IHCS Level 3 (2:1) Enhanced - RN - ECS |
PAODP | W7069 | TD, U4 | IHCS Level 3 (2:1) Enhanced - RN - No Benefit Allowance |
PAODP | W7069 | TE, U1 | IHCS Level 3 (2:1) Enhanced - LPN - ECS |
PAODP | W7069 | TE, U4 | IHCS Level 3 (2:1) Enhanced - LPN - No Benefit Allowance |
PAODP | W7069 | U4, U1 | IHCS Level 3 (2:1) Enhanced - No Benefit Allowance - ECS |
PAODP | W7069 | TD, U4, U1 | IHCS Level 3 (2:1) Enhanced - RN - No Benefit Allowance - ECS |
PAODP | W7069 | TE, U4, U1 | IHCS Level 3 (2:1) Enhanced - LPN - No Benefit Allowance - ECS |
PAODP | W7201 | Specialized Skill Development (1:1) | |
PAODP | W7204 | Specialized Skill Development (1:2) | |
PAODP | W7205 | Specialized Skill Development (1:3) | |
PAODP | W7213 | Respite - Agency Managed In Home | |
PAODP | W7283 | U4 | Homemaker - Permanent - 1 Hour - No Benefit Allowance |
PAODP | W7283 | UA | Homemaker - Temporary - 1 Hour |
PAODP | W7283 | Homemaker-1 Hour | |
PAODP | W7283 | UA, U4 | Homemaker - Temporary - 1 Hour - No Benefit Allowance |
PAODP | W8095 | TD | Respite Unlicensed Level 4 (2:1) RN-15 Mins |
PAODP | W8095 | TE | Respite Unlicensed Level 4 (2:1) LPN-15 Mins |
PAODP | W8095 | U1 | Respite – Unlicensed Level 4 (2:1) Enhanced) – ECS – 15 Mins |
PAODP | W8095 | U4 | Respite-Unlic Level 4 (2:1) Enh-No Benefit Allowance-15 Mins |
PAODP | W8095 | Respite Unlicensed Level 4 (2:1) Enhanced-15 Mins | |
PAODP | W8095 | TD, U1 | Respite Unlicensed Level 4 (2:1) RN ECS-15 Mins |
PAODP | W8095 | TD, U4 | Respite Unlicensed Level 4 (2:1) RN-No Benefit Allowance-15 Mins |
PAODP | W8095 | TE, U1 | Respite Unlicensed Level 4 (2:1) LPN-ECS-15 Mins |
PAODP | W8095 | TE, U4 | Respite Unlic Level 4 (2:1) LPN-No Benefit Allowance-15 Mins |
PAODP | W8095 | U4, U1 | Respite–Unlic Level 4 (2:1) Enh-No Benefit Allow–ECS–15 Mins |
PAODP | W8095 | TD, U4, U1 | Respite Unlicensed Level 4 (2:1) RN-No Benefit Allowance-ECS-15 Mins |
PAODP | W8095 | TE, U4, U1 | Respite Unlic Level 4 (2:1) LPN-No Benefit Allowance-ECS-15 Mins |
PAODP | W8096 | U1 | Respite -15 Mins Basic (1:4) - ECS |
PAODP | W8096 | Respite -15 Mins Basic (1:4) | |
PAODP | W9596 | Respite - Agency Managed Out of Home - 15 Mins | |
PAODP | W9795 | U1 | Respite Unlicensed Basic (1:4)-ECS-Day |
PAODP | W9795 | Respite Unlicensed Basic (1:4)-Day | |
PAODP | W9796 | U1 | Respite Unlicensed Level 1 (1:3)-ECS-Day |
PAODP | W9796 | Respite Unlicensed Level 1 (1:3)-Day | |
PAODP | W9797 | U1 | Respite Unlicensed Level 2 (1:2)-ECS-Day |
PAODP | W9797 | Respite Unlicensed Level 2 (1:2)-Day | |
PAODP | W9798 | U1 | Respite Unlicensed Level 3 (1:1)-ECS-Day |
PAODP | W9798 | U4 | Respite Unlicensed Level 3 (1:1)-No Benefit Allowance-Day |
PAODP | W9798 | Respite Unlicensed Level 3 (1:1)-Day | |
PAODP | W9798 | U4, U1 | Respite Unlicensed Level 3 (1:1)-No Benefit Allowance-ECS-Day |
PAODP | W9799 | TD | Respite Unlicensed Level 3 (1:1) - Enhanced - RN - Day |
PAODP | W9799 | TE | Respite Unlicensed Level 3 (1:1) - Enhanced - LPN - Day |
PAODP | W9799 | U1 | Respite Unlicensed Level 3 (1:1) - Enhanced - LPN - Day |
PAODP | W9799 | U4 | Respite Unlic Level 3 (1:1) Enhanced-No Benefit Allowance-Day |
PAODP | W9799 | Respite Unlicensed Level 3 (1:1) Enhanced-Day | |
PAODP | W9799 | TD, U1 | Respite Unlicensed Level 3 (1:1) - Enhanced - RN - ECS - Day |
PAODP | W9799 | TD, U4 | Respite Unlicensed Level 3 (1:1) -Enh-RN-No Benefit Allowance-Day |
PAODP | W9799 | TE, U1 | Respite Unlicensed Level 3 (1:1) - Enhanced - LPN - ECS - Day |
PAODP | W9799 | TE, U4 | Respite Unlicensed Level 3 (1:1) Enh-LPN-No Benefit Allowance-Day |
PAODP | W9799 | U4, U1 | Respite Unlic Level 3 (1:1) Enhanced-No Benefit Allowance-ECS-Day |
PAODP | W9799 | TD, U4, U1 | Respite Unlic Level 3 (1:1) Enh-RN-No Benefit Allowance-ECS-Day |
PAODP | W9799 | TE, U4, U1 | Respite Unlic Level 3 (1:1) Enh-LPN-No Benefit Allowance-ECS-Day |
PAODP | W9800 | U1 | Respite Unlicensed Level 4 (2:1) ECS-Day |
PAODP | W9800 | U4 | Respite Unlicensed Level 4 (2:1) No Benefit Allowance-Day |
PAODP | W9800 | Respite Unlicensed Level 4 (2:1)-Day | |
PAODP | W9800 | U4, U1 | Respite Unlicensed Level 4 (2:1) No Benefit Allowance-ECS-Day |
PAODP | W9801 | TD | Respite Unlicensed Level 4 (2:1) Enhanced - RN - Day |
PAODP | W9801 | TE | Respite Unlicensed Level 4 (2:1) - Enhanced - LPN - Day |
PAODP | W9801 | U1 | Respite Unlicensed Level 4 (2:1) Enhanced - ECS - Day |
PAODP | W9801 | U4 | Respite Unlic Level 4 (2:1) Enhanced-No Benefit Allowance-Day |
PAODP | W9801 | Respite Unlicensed Level 4 (2:1) Enhanced-Day | |
PAODP | W9801 | TD, U1 | Respite Unlicensed Level 4 (2:1) Enhanced - RN - ECS - Day |
PAODP | W9801 | TD, U4 | Respite Unlic Level 4 (2:1) Enh – RN - No Benefit Allowance - Day |
PAODP | W9801 | TE, U1 | Respite Unlicensed Level 4 (2:1) - Enhanced - LPN - ECS - Day |
PAODP | W9801 | TE, U4 | Respite Unlic Level 4 (2:1) - Enh - LPN-No Benefit Allowance-Day |
PAODP | W9801 | U4, U1 | Respite Unlic Level 4 (2:1) Enhanced-No Benefit Allowance-ECS-Day |
PAODP | W9801 | TD, U1, U4 | Respite Unlic Level 4 (2:1) Enh - RN-No Benefit Allowance-ECS-Day |
PAODP | W9860 | TE, U1, U4 | Respite Unlic Level 4 (2:1) Enh-LPN-No Benefit Allowance-ECS-Day |
PAODP | W9860 | U1 | Respite Unlicensed Level 1 (1:3)-ECS-15 Mins |
PAODP | W9860 | Respite Unlicensed Level 1 (1:3)-15 Mins | |
PAODP | W9861 | U1 | Respite Unlicensed Level 2 (1:2)-ECS-15 Mins |
PAODP | W9861 | Respite Unlicensed Level 2 (1:2)-15 Mins | |
PAODP | W9862 | U1 | Respite Unlicensed Level 3 (1:1)-ECS-15 Mins |
PAODP | W9862 | U4 | Respite Unlicensed Level 3 (1:1)-No Benefit Allowance-15 Mins |
PAODP | W9862 | Respite Unlicensed Level 3 (1:1)-15 Mins | |
PAODP | W9862 | U4, U1 | Respite Unlicensed Level 3 (1:1)-No Benefit Allowance-ECS-15 Mins |
PAODP | W9863 | TD | Respite Unlicensed Level 3 (1:1) Enhanced – RN - 15 Mins |
PAODP | W9863 | TE | Respite Unlicensed Level 3 (1:1) Enhanced- LPN-15 Mins |
PAODP | W9863 | U1 | Respite Unlicensed Level 3 (1:1) Enhanced-ECS-15 Mins |
PAODP | W9863 | U4 | Respite Unlic Level 3 (1:1) Enhanced-No Benefit Allowance-15 Mins |
PAODP | W9863 | Respite Unlicensed Level 3 (1:1) Enhanced-15 Mins | |
PAODP | W9863 | TD, U1 | Respite Unlicensed Level 3 (1:1) Enhanced RN-ECS-15 Mins |
PAODP | W9863 | TD, U4 | Respite Unlic Level 3 (1:1) Enh-RN-No Benefit Allowance-15 Mins |
PAODP | W9863 | TE, U1 | Respite Unlicensed Level 3 (1:1) Enhanced – LPN -ECS -15 Mins |
PAODP | W9863 | TE, U4 | Respite Unlic Level 3(1:1)Enh-LPN-No Benefit Allowance-15 Mins |
PAODP | W9863 | U4, U1 | Respite Unlic Level 3 (1:1) Enh-No Benefit Allowance-ECS-15 Mins |
PAODP | W9863 | TD, U1, U4 | Respite Unlic Level 3(1:1)Enh-RN-No Benefit Allowance-ECS-15 Mins |
PAODP | W9863 | TE, U1. U4 | Respite Unlic Level 3(1:1)Enh-LPN-No Benefit Allow-ECS-15 Mins |
PAODP | W9864 | U1 | Respite Unlicensed Level 4 (2:1)-ECS-15 Mins |
PAODP | W9864 | U4 | Respite Unlicensed Level 4 (2:1)-No Benefit Allowance-15 Mins |
PAODP | W9864 | Respite Unlicensed Level 4 (2:1)-15 Mins | |
PAODP | W9864 | U4, U1 | Respite Unlic Level 4 (2:1)-No Benefit Allowance-ECS-15 Mins |
PAOLTL | S5150 | TU | Respite - Consumer Overtime |
PAOLTL | S5150 | Respite - Consumer | |
PAOLTL | T1002 | SE | Home Health - Nursing (RN), 15 Mins - SE |
PAOLTL | T1003 | SE | Home Health - Nursing (LPN), 15 Mins - SE |
PAOLTL | T1005 | Respite - Agency | |
PAOLTL | T2025 | GN | Speech/Language Therapy-15 Mins |
PAOLTL | T2025 | GO, U4 | Home Health - Occupational Therapy Assist. |
PAOLTL | T2025 | GO | Occupational Therapy-15 Mins |
PAOLTL | T2025 | GP, U4 | Physical Therapy Assistant -15 Mins |
PAOLTL | T2025 | GP | Physical Therapy-15 Mins |
PAOLTL | W1792 | TU | Personal Assistance Services - Consumer Overtime |
PAOLTL | W1792 | Personal Assistance Services - Consumer | |
PAOLTL | W1793 | Personal Assistance Services - Agency | |
PAOLTL | W1900 | Participant-Directed Community Supports | |
PAOMAP | 92551 | Screening Test, Pure Tone, Air Only | |
PAOMAP | 92552 | Pure tone audiometry (threshold); Air Only | |
PAOMAP | 99500 | AT | Home Visit Prenatal (Non HBP) Assessment |
PAOMAP | 99501 | AT | Home Visit Postnatal (Non HBP) Follow-up Care |
PAOMAP | G0108 | Diabetes Outpatient Training Service, individual | |
PAOMAP | G0109 | Diabetes Outpatient Training, group | |
PAOMAP | G0151 | UD, SC | Physical Therapy (Day 29 & beyond) by a PT, PE |
PAOMAP | G0151 | UD | Physical Therapy (Day 29 and beyond) by a PT |
PAOMAP | G0151 | Physical Therapy (Day 1-28) by a PT | |
PAOMAP | G0152 | UD, SC | Occupational Therapy (Day 29 & beyond) by a OT, PE |
PAOMAP | G0152 | UD | Occupational Therapy (Day 29 and beyond) by a OT |
PAOMAP | G0152 | Occupational Therapy (Day 1-28) by a OT | |
PAOMAP | G0153 | UD, SC | Speech Therapy (Day 29 & beyond) by a ST, PE |
PAOMAP | G0153 | UD | Speech Therapy (Day 29 and beyond) by a ST |
PAOMAP | G0153 | Speech Therapy (Day 1-28) by a ST | |
PAOMAP | G0156 | U8, UD, SC | HHA visit to patient’s home (Day 29 & beyond) by a HH Aide, PE |
PAOMAP | G0156 | U8, UD | HHA visit to patient's home (Day 29 and beyond) by a HH Aide |
PAOMAP | G0156 | U8 | HHA visit to patient's home (Day 1-28) by a HH Aide |
PAOMAP | G0156 | U7 | Services of home health/hospice aide - 15 Mins |
PAOMAP | G0156 | U7, SC | Services of home health/hospice aide - LRR - 15 Mins |
PAOMAP | G0299 | U8, UD, SC | HHA visit to a patient’s home (Day 29 & beyond) by a RN, PE |
PAOMAP | G0299 | U8, UD | HHA visit to patient's home (Day 29 and beyond) by a RN |
PAOMAP | G0299 | U8 | HHA visit to a patient's home (Day 1-28) by a RN |
PAOMAP | G0300 | U8, UD, SC | HHA visit to a patient’s home (Day 29 & beyond) by a LPN, PE |
PAOMAP | G0300 | U8, UD | HHA visit to patient's home (Day 29 and beyond) by a LPN |
PAOMAP | G0300 | U8 | HHA visit to a patient's home (Day 1-28) by a LPN |
PAOMAP | S9123 | Home Health - Nursing (RN), Hr | |
PAOMAP | S9124 | Home Health - Nursing (LPN), Hr | |
PAOMAP | T1002 | Home Health - Nursing (RN), 15 Mins | |
PAOMAP | T1003 | Home Health - Nursing (LPN), 15 Mins |