FHIR Chat · Endpoints · Da+Vinci+PDex+Plan-Net

Stream: Da+Vinci+PDex+Plan-Net

Topic: Endpoints

Saul Kravitz (Aug 18 2020 at 14:23):

Question from a friend:

Related documentations at: https://build.fhir.org/ig/HL7/davinci-pdex-plan-net/StructureDefinition-plannet-Endpoint.html and https://www.hl7.org/fhir/endpoint.html

1.    These resources have endpoint in the data model:

Organization
PractitionerRole
HealthcareService
OrganizationAffiliation
Location
InsurancePlan
(Practitioner data model don’t have endpoint data field)

2.    These resources supposed to have search by endpoint parameter:

Organization
PractitionerRole
HealthcareService

(The second link above says:

 This is not a description of details of the current system, as found in CapabilityStatement, but of another (potentially external) system.

but it also says

The endpoint is distinct from a capability statement in that the CapabilityStatement statement describes the entire capability of a server (and in the metadata case, just this server). Where the endpoint resource describes the technical details for how to connect, and for what purposes (which could be a small sub-set of the server's capabilities, and might not be a FHIR endpoint).


Any guidance on the below will be greatly appreciated:

Is it applicable and required for our provider FHIR directory service to implement this endpoint?
What kind of information should be included in this resource in our case?
One thought I had was to expose this endpoint with one object for each of the endpoints (including the davinci-plannet profile links) – does it make sense?
Why is it not included in Practitioner & included in other resources?
Why only 3 of the resources included for search by endpoint?
 ```
.

Saul Kravitz (Aug 18 2020 at 14:31):

All resources/profiles except for Practitioner (and EndPoint) have Endpoint references.
All resources that have an Endpoint reference, have an endpoint search requirement, except for InsurancePlan. (see https://build.fhir.org/ig/HL7/davinci-pdex-plan-net/CapabilityStatement-davinci-pdex-plan-net.html#resource--details). That maybe an error of omission.
The reason for these search parameters is to support _includes and _revIncludes. I doubt anybody will do a search trying to find an instance that uses a particular endpoint. The intent is to retrieve an instance AND its associated endpoint.

Supporting the Endpoint profile is required. https://build.fhir.org/ig/HL7/davinci-pdex-plan-net/CapabilityStatement-davinci-pdex-plan-net.html#endpoint

The Endpoint is there to support a digital endpoint of some type. For instances that lack an associated endpoint, don't include one.
See the examples in the IG.

Annette Kuball (Aug 18 2020 at 14:45):

Hi Saul - Thanks for your question, but I will need some help answering it. I'm new to the Da Vinci and FHIR resources within the last month so I'm still trying to figure out what an endpoint is used for. I will ask my coworker @Kate Dech to respond to your question based on her knowledge and experience.