This page is part of the Da Vinci Payer Data Exchange (v0.1.0: STU 1 Ballot 1) based on FHIR R4. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions

6-3 PDex Hooks

Section Guide:
• 6 CDS-Hooks
• 6-1 Support for FHIR R4
• 6-2 Additional or Modified Hooks
• 6-3 PDex Hooks
• 6-4 Hook Configuration
• 6-5 Systems
• 6-6 Workflow Examples
• 6-6-1 First Visit with New Provider
• 6-6-2 Return Visit with Provider
• 6-6-3 FHIR Profiles and CDS Hooks Context
• 6-7 Handling Data Provenance

Sharing of Member health information via PDex SHALL use the CDS Hooks specification. Connection to health plan systems SHALL be supported via the following hook:

• appointment-book

The overall flow of the SMART-on-FHIR and CDS-Hooks interaction is summarized in the diagram below:

It is possible that this hook will change over the course of the review/approval process, including changes to the names of the hooks, their context parameters or other information. Future versions of this implementation guide will be updated to align with such changes. Additional hooks may also be added.

This IG defines an extension to the appointment-book hook. The additional optional context fields are:

• MemberId (optional): The number that identifies the unique person in the health plan system

NOTE: Even pre-existing hooks are not yet locked down as normative and similar changes are possible, though perhaps less likely.

A sample of the CDS Hook for appointment-book is included below:

{
  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
  "fhirServer": "http://fhir.example.com",
  "fhirAuthorization" : {
       "access_token" : "some-opaque-fhir-access-token",
       "token_type" : "Bearer",
       "expires_in" : 300,
       "scope" : "patient/Patient.read patient/Observation.read",
       "subject" : "cds-service4"
     },
  "hook": "appointment-book",
  "user": "Practitioner/example",
  "context": {
    "userId" : "Practitioner/A12365498",
    "patientId" : "EMR1239876",
    "encounterId" : "654",
    "appointments" : [],
    "memberId" : "HP567123489",
		}
  }

SubscriberId SHOULD be taken from the FHIR Coverage record for the Patient, or MAY be entered manually by the provider via the SMART-on-FHIR App.

• Previous
• Next