National Directory of Healthcare Providers & Services (NDH) Implementation Guide
1.0.0-ballot - ballot United States of America flag

This page is part of the National Directory of Healthcare Providers and Services (NDH) Implementation Guide (v1.0.0-ballot: STU1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Exchange Examples

Exchange Examples

Social Service

Social Service diagram for example
HealthcareService Towson FoodOrgnization SocialTowson FoodLocation SocialTowson FoodHealthcareService Hope CBOOrgnization Hope CBOLocation Hope CBOprovidedByprovided atmanagingOrganizationprovidedByprovided atmanagingOrganization

PractitionerRole

PractionerRole describes the relationship between a practitioner and an organization. A practitioner provides services to the organization at a location. Practitioners also participate in healthcare provider insurance networks through their role at an organization.

Examples associated with this PractiontionerRole

Dr. Hans Solo operates a private practice within the Hans Solo Clinic, offering primary healthcare services. He is an active participant in the Blue Cross Blue Shield Connecticut PPO network, which is covered by the Blue Cross Blue Shield Connecticut Insurance Plan.

Patients can effortlessly locate Dr. Solo by searching his name, specialty, or location. The search results provide comprehensive information, including the location and type of service offered, the clinic’s working hours, acceptance of new patients, types of insurance honored, and an electronic link to access patient medical records.

Other healthcare organizations also have the ability to access Dr. Solo’s practice endpoint, providing a secure route to patient medical records or to transmit referral details.

Moreover, the Blue Cross Blue Shield PPO Network can utilize Dr. Solo’s practice endpoint to retrieve patient medical data for claim processing and pre-authorization procedures.

PractitionerRole: HansSoloRolePractitioner: HansSoloLocation: HansSoloClinicHealthcareService: HansSoloServiceInsurancePlan: BlueCrossBlueShield-CTNetwork: BlueCrossBlueShield-CT-PPOOrganization: BlueCrossBlueShield-CT-ORGEndpoint: HansSoloDirectTrustEndpointReferralsEndpoint: HansSoloPatientAccessEndpointpractitionerhealthcareServicenetworklocationendpointendpointnetworkpartOfownedBy
Practitioner and Networks.

Practitioners have the flexibility to engage in multiple insurance networks concurrently. They are also afforded the liberty to disengage from a network or integrate into a new one. The NDH has established infrastructure, utilizing PractitionerRole, to facilitate these transitions.

In the duration from June 1, 2023, to December 31, 2023, a practitioner, referred to as Network1andNetwork2 PractitionerOne, is actively involved in both the Network1 and Network2, under the administration of OMPN, an organization responsible for managing payer networks.

However, by the end of 2023, the practitioner plans to withdraw from Network1. Meanwhile, the practitioner commenced their affiliation with Network2 on June 1, 2023.

Network1Network2OrgManageNetworkPractitionerOneWithNetwork1AndNetwork2PractitionerOneNetwork1RolePractitionerOneNetwork2RoleInsurancePlanMedicare AdvantageInsurancePlanMedicare Advantage HMO
OrganizationAffliliation and Networks.

Organizations could participate in several insurance networks simultaneously. They possess the freedom to disconnect from an existing network or assimilate into a new one. The NDH has crafted an infrastructure, through OrganizationAffiliation, to streamline such transitions.

From June 1, 2023, through December 31, 2023, an organization named OrgOneWithNetwork1AndNetwork2 is actively engaged with both the Network1 and Network2 networks. This participation is supervised by OMPN, an entity tasked with overseeing payer networks.

Nevertheless, by the close of 2023, the organization anticipates severing its ties with the Network1 network. Concurrently, the organization initiated its association with the Network2 network starting on June 1, 2023.

Network1Network2OrgManageNetworkOrgOneWithNetwork1AndNetwork2OrgOneNetwork1AffiliationOrgOneNetwork2AffiliationInsurancePlanMedicare AdvantageInsurancePlanMedicare Advantage HMO
HealthcareService and Networks without InsurancePlan

Typically, healthcare service networks are tied to insurance plans. However, in the realm of social services, the delivery or subscription of services often occurs through a hub. This hub embodies a similar concept to a network, but without an insurance plan attached. To simplify the process of locating such hubs (networks), NDH offers a connection from the healthcare server to the network. For instance, the Welcome Home organization provides housing services at the Welcome Home location. This service is subscribed to through the Social Service Housing Network.

SocialServiceHousingNetworkHealthcareServiceHomelessAssistanceLocationWelcomeHomeOrganizationWelcomeHomeOrganizationManageHousingNetwork

Payer to Payer Endpoints

To establish trust connections with other payers, a payer can use the NDH to locate the organization of the payer in question. Afterward, the payer can acquire the endpoint(s) for that specific payer organization. Each endpoint comes equipped with essential certificate information, which the payer can use to create a mutual TLS connection with another payer’s endpoint.

PayerOrganization-1PayerEndpointPayerOrganization-2PayerEndpointmany payer's organizations to comePayerOrganization-nPayerEndpoint1..*1..*1..*

To find a payer organization and associate endpoints:

GET [base]/Organization?type=payer&name=Florida Blue&_include:Organization:endpoint

OrganizationAffiliation

Similar to PractitionerRole, OrganizationAffiliation describes relationships between organizations.

OrganizationAffiliation among clinic, hospital, network, and insurance plan
OrganizationAffiliation relationship diagram for example
OrganizationAffiliation: OrganizationAffiliation/BurrClinicAffilOrganization: Organization/BurrClinicNetwork: Organization/AcmeofCTStdNetOrganization: Organization/AcmeOrganization Organization/HospitalNetwork: Organization/AcmeofCTPremNetLocation: Location/HospLoc1Location: Location/HospLoc2Location: Location/StateOfLocationHealthcareService: HealthcareService/BurrClinicServicesInsurancePlan: InsurancePlan/AcmeQHPGoldEndpoint: Endpoint/AcmeOfCTPortalEndpointorganizationparticipatingOrganizationnetworklocationhealthcareServicepartOfpartOfnetwork[0]coverageAreaendpointadministeredByownedBynetwork[1]locationprovidedBymanagingOrgnization
Examples associated with this OrganizationAffiliation
OrganizationAffiliation among pharmacy chain
Pharmacy chain OrganizationAffiliation relationship diagram for example
OrganizationAffiliation: OrganizationAffiliation/PharmChainAffil1Organization: Organization/PharmChainNetwork: Organization/AcmeofCTStdNetOrganization: Organization/BigBoxOrganization: Organization/AcmeLocation: Location/PharmLoc1Location: Location/PharmLoc2Location: Location/PharmLoc3Location: Location/PharmLoc4HealthcareService: HealthcareService/PharmChainRetailServiceparticipatingOrganizationnetworklocation[1]partOflocation[0]healthcareServiceextension.fromNetworkmanagingOrganizationextension.fromNetworkmanagingOrganizationlocation[3]location[2]Location[1]location[0]provideByextension.fromNetwork
Examples associated with this OrganiztionAffiliation