Patient Registration Fields for UDS Reporting

To support Federally Qualified Health Centers (FQHC) in the collection UDS reporting data, athenaCollector has added implementation settings that expose new fields in the Patient Registration Page. APIs have been modified to reflect this change. The following fields can now be accessed, be added and modified using existing API calls: 

Federal Poverty Level Data

  • Family size
  • Income 
  • Income pay period

Social Determinant Data:

  • Homeless status (and options if "Yes")
  • Agricultural worker (and options if "No")
  • School-based health center patient
  • Veteran status

Activation:

In production, a practice will activate the required settings. However, in Preview, users should reach out to their athenahealth point of contact. 

  1. Go to Admin > Implementation > Settings (under Practice Links > Client Functions)
  2. Turn ON the 'Population Demographics - Federal Poverty Level Fields', for being able to add or modify Poverty Level Data.  
  3. Turn ON the 'Population Demographics - Social Determinant Fields', for being able to add or modify Social Determinant Data
  4. Turn ON the 'Population Demographics - Social Determinant Fields (Agricultural Worker Specificity)', for being able to specify Agricultural Worker Type
  5. Turn ON the 'Population Demographics - Social Determinant Fields (Homeless Specificity)', for being able to specify Homeless Type

Each FQHC (except Federal Poverty Level Fields) has the option to configure the patient UDS reporting questions as 'OFF', 'ON - Required at Check-in' or 'ON - Not Required'. Please confirm with your client contact how these setting are implemented for their practice.

In addition to 'OFF', Federal Poverty Level Fields can be configured to 'ON - Not Required: Income Level (Exact)', 'ON - Required at Check-In: Income Level (Exact)' and 'ON - Always Required: Income Level (Exact)',  'ON - Not Required: Income Level (Range)', 'ON - Required at Check-In: Income Level (Range)' and 'ON - Always Required: Income Level (Range), all of which are supported by APIs. 

How to retrieve and update this data:

This data, if not null, is automatically included in the GET /patient, GET /patient/{patientid} and other calls that retrieve patient demographic information. 

Use PUT /patient/{patientid} call to add or modify this data. A POST /patients call can be used as well. Note that the above mentioned settings should be Active to successfully save changes made to the fields.

Here's a sample result, for GET  /patients/{patientid} call, showing Poverty Level and Social Determinant Data for a test patient:

[
   {
      "address1" : "8762 Stoneridge Ct",
      "agriculturalworker" : "Y",
      "agriculturalworkertype" : "Migrant",
      "caresummarydeliverypreference" : "PORTAL",
      "city" : "COTTAGE GROVE",
      "consenttocall" : "true",
      "contacthomephone" : null,
      "contactmobilephone" : null,
      "countrycode" : "USA",
      "countrycode3166" : "US",
      "departmentid" : "1",
      "dob" : "10\/02\/2007",
      "driverslicense" : "false",
      "employerphone" : null,
      "ethnicitycode" : null,
      "firstname" : "Waldo",
      "guarantoraddress1" : "8762 Stoneridge Ct",
      "guarantoraddresssameaspatient" : "true",
      "guarantorcity" : "COTTAGE GROVE",
      "guarantorcountrycode" : "USA",
      "guarantorcountrycode3166" : "US",
      "guarantordob" : "04\/06\/2008",
      "guarantorfirstname" : "Ilona",
      "guarantorlastname" : "Shultz",
      "guarantorphone" : "5555121974",
      "guarantorrelationshiptopatient" : "1",
      "guarantorssn" : null,
      "guarantorstate" : "OR",
      "guarantorzip" : "97424",
      "hasmobile" : "true",
      "homebound" : "false",
      "homeless" : "Y",
      "homelesstype" : "Other",
      "homephone" : "5555821676",
      "industrycode" : null,
      "language6392code" : null,
      "lastname" : "Shultz",
      "maritalstatus" : "S",
      "maritalstatusname" : "SINGLE",
      "nextkinphone" : null,
      "occupationcode" : null,
      "patientid" : "2117",
      "patientphoto" : "false",
      "portalaccessgiven" : "true",
      "portaltermsonfile" : "false",
      "povertylevelcalculated" : "24.48",
      "povertylevelfamilysize" : "2",
      "povertylevelincomepayperiod" : "2 Weeks",
      "povertylevelincomeperpayperiod" : "550",
      "primarydepartmentid" : "1",
      "primaryproviderid" : "71",
      "privacyinformationverified" : "true",
      "race" : [],
      "schoolbasedhealthcenter" : "N",
      "sex" : "M",
      "ssn" : "*****8698",
      "state" : "OR",
      "status" : "active",
      "veteran" : "N",
      "zip" : "97424"
   }
] 
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit