FHIR Human Services Directory, published by HL7 Human and Social Services Work Group. This is not an authorized publication; it is the continuous build for version 1.0.0). This version is based on the current content of https://github.com/HL7/FHIR-IG-Human-Services-Directory/ and changes regularly. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
Human Services Directory Capability Statement |
Describes the expected capabilities of the Human Services Directory Server actor responsible for providing responses to the queries submitted by the Human Services Directory Requestors. The complete list of FHIR profiles, RESTful operations, and search parameters supported by Human Services Directory Servers are defined. Systems implementing this capability statement should meet the CMS FInal Rule requirement for provider directory access. Human Services Directory Clients can use the required capabilities to access necessary data based on their local use cases and other contextual requirements. |
These define the properties by which a RESTful server can be searched. They can also be used for sorting and including related resources.
healthcareservice-active |
Select Human and social services by the specified active status |
healthcareservice-communication |
Select Human and Social services that can be delivered by the organization in the specified language |
healthcareservice-location |
Select Human and social services offered at the specified location |
healthcareservice-name |
Select HealthcareServices with the specified name |
healthcareservice-organization |
Select Human and Social services offered by the specified organization |
healthcareservice-program |
Select Human and Social services offered under the specified program |
healthcareservice-service-category |
Select Human and social services by the specified category |
healthcareservice-service-type |
Select Human and social services by the specified type |
location-accessibility |
Select locations by the specified accessibility options offered by the location. |
location-address |
Select locations within the specified address |
location-address-city |
Select locations within the specified city |
location-address-country |
Select locations by the country specified in the address |
location-address-postalcode |
Select locations within the specified postal code |
location-address-state |
Select locations within the specified state |
location-hoursofoperation |
Select locations by the country specified in the address |
location-name |
Select locations with the specified name |
location-organization |
Select locations managed by the specified organization |
organization-address |
Select organizations with the specified address (matches any of the string elements of an address) |
organization-address-city |
Select organizations within the specified city |
organization-address-country |
Select organizations by the country specified in an address |
organization-address-postalcode |
Select organizations within the specified postal code |
organization-address-state |
Select organizations within the specified state |
organization-identifier |
Select organizations with the specified identifier (Tax ID) supported as an organization identifier |
organization-name |
Select organizations by (a portion of) the organization’s name |
organization-type |
Select organizations by (a code for) the type of organization |
These define constraints on FHIR resources for systems conforming to this implementation guide.
HSDHealthcareService |
The HSD HealthcareService profile was introduced in STU 1 of this guide to allow example value sets that are used to search human and social service directories, because based on guidance from the human and social services community, existing human and social services taxonomies have not been deemed suitable for use in the relevant value sets. This profile isbased on the R4 HealthcareService resource, and fully aligned (as opposed to derived from) the Plan-Net HealthcareService profile which enforces use of extensible bindings to the category and type elements. This profile describes the way a human/social service can be contacted to assist patients and clients with unmet social needs. Examples include food, housing/shelter, income & employment, public transportation, public education, legal services, disability and aging and mental and physical health. |
HSDLocation |
The HSDLocation resource describes the physical place where community-based services are provided, practitioners are employed, organizations are based, etc. Locations can range in scope from a room in a building to a geographic region/area. |
HSDOrganization |
The HSDOrganization resource is a formal or informal grouping of people or organizations set up to assist people in coping with issues related to various social issues, including but not limited to: adequate housing, substance abuse, domestic conflict, mental health and/or personal/familial problems. Guidance: When the contact is a department name, rather than a human (e.g., patient help line), include a blank family and given name, and provide the department name in contact.name.text. |
These define constraints on FHIR data types for systems conforming to this implementation guide.
Community-Based Organization Contacts |
An extension to describe the additional details for named contacts for organizations not included in the contact.telecom element. |
Community-Based Services Contacts |
An extension to describe the additional details for named contacts for services not included in the telecom element. |
Qualification |
An extension to add qualifications for an organization (e.g. accreditation). |
These define sets of codes used by systems conforming to this implementation guide.
Human Service Category VS |
This example value set includes a subset of codes included in the Plan-Net Healthcare Service Category value set (HealthcareServiceCategoryVS). |
Human Service Characteristic VS |
This example value set includes codes that describe unique features that can be associated with community-based social services delivered at particular locations. |
Human Service Program VS |
This example value set includes codes that describe Programs under which community-based organizations can organize the social services they deliver. |
Human Service Type VS |
This example value set includes an subset of service-types codes included in the Plan-Net Healthcare Service Type value set (HealthcareServiceTypeVS). |
Non-Individual Specialties |
Non-Individual Specialties from National Uniform Claim Committee (NUCC) Health Care Provider Taxonomy code set copied from Plan-Net used to allow example value set binding in HSDOrganization profile. |
These define new code systems used by systems conforming to this implementation guide.
Human Service Characteristic |
This example code system provides an example set of codes that describe unique features that can be associated with community-based social services delivered at particular locations. |
Human Service Program |
This example code system provides an example set of codes that describe Programs under which community-based organizations can organize the social services they deliver. |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
FoodBank |
Community-Based Organization that provides food pantry services. Since the HSDS source for Organizations does not include organization address, address information has been omitted from the examples. Address information is associated with the locations at which services provided by community-based organizations are provided. In addition, information that is mapped from the HSDS Contact table is mapped to a new extension: OrgContactInfo. |
FoodBankLocation |
Locations associated with services provided by the Redwood Food Bank |
FoodPantryService |
Food Pantry Services provided by a Community-Based Organization (CBO) |
MealsOnWheels |
Food assistance provided to the elderly and low income at their homes. |
MealsOnWheelsLocation |
Locations associated with services provided by Meals on Wheels |
SF9114AllLocation |
Locations associated with crisis and domestic violence services provided by Whistlestop Wheels |
SFCrisisAndDomesticHotline |
Community-Based Organization that provides emergency crisis hotline services. Since the HSDS source for Organizations does not include organization address, address information has been omitted from the examples. Address information is associated with the locations at which services provided by community-based organizations are provided. In addition, information that is mapped from the HSDS Contact table is mapped to a new extension: OrgContactInfo. |
SFCrisisAndDomesticHotlineServices |
Crisis Hotline Services provided by the Crisis Hotline of San Francisco |
WhistlestopTransportationService |
Transportation services for the disabled and elderly. |
WhistlestopWheels |
Community-Based Organization that provides food pantry services. Since the HSDS source for Organizations does not include organization address, address information has been omitted from the examples. Address information is associated with the locations at which services provided by community-based organizations are provided. In addition, information that is mapped from the HSDS Contact table is mapped to a new extension: OrgContactInfo. |
WhistlestopwheelsLocation |
Locations associated with transportation services provided by Whistlestop Wheels |