Data Exchange For Quality Measures Implementation Guide
4.0.0 - STU4 United States of America

This page is part of the Da Vinci Data Exchange for Quality Measures (DEQM) FHIR IG (v4.0.0: STU4 (v4.0.0)) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: Detailed Care Gap Guidance Response

Official URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/gaps-guidanceresponse-detailedcaregap Version: 4.0.0
Active as of 2023-10-03 Computable Name: DetailedCareGapGuidanceResponse

Derived from the GuidanceResponse resource, the Detailed Care Gap Guidance Response profile supports the functionality of providing reason for guidance and detailed guidance to help address care gaps and close open gaps.

More guidance can be found here.

Mandatory Data Elements and Terminology

The following data-elements are mandatory (i.e data MUST be present).

Each must have:

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from GuidanceResponse

NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse GuidanceResponse
... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail
... dataRequirement
.... valueFilter 0..*(Complex)What values are expected
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-valueFilter

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)
NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse 0..*GuidanceResponseThe formal response to a guidance request
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... module[x] Σ1..1What guidance was requested
.... moduleUriuri
.... moduleCanonicalcanonical(Any)
.... moduleCodeableConceptCodeableConcept
... status ?!Σ1..1codesuccess | data-requested | data-required | in-progress | failure | entered-in-error
Binding: GuidanceResponseStatus (required): The status of a guidance response.

... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
GuidanceResponse.statusrequiredGuidanceResponseStatus
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)
NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse 0..*GuidanceResponseThe formal response to a guidance request
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... requestIdentifier Σ0..1IdentifierThe identifier of the request associated with this response, if any
... identifier Σ0..*IdentifierBusiness identifier
... module[x] Σ1..1What guidance was requested
.... moduleUriuri
.... moduleCanonicalcanonical(Any)
.... moduleCodeableConceptCodeableConcept
... status ?!Σ1..1codesuccess | data-requested | data-required | in-progress | failure | entered-in-error
Binding: GuidanceResponseStatus (required): The status of a guidance response.

... subject 0..1Reference(Patient | Group)Patient the request was performed for
... encounter 0..1Reference(Encounter)Encounter during which the response was returned
... occurrenceDateTime 0..1dateTimeWhen the guidance response was processed
... performer 0..1Reference(Device)Device returning the guidance
... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... reasonReference 0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)Why guidance is needed
... note 0..*AnnotationAdditional notes about the response
... evaluationMessage 0..*Reference(OperationOutcome)Messages resulting from the evaluation of the artifact or artifacts
... outputParameters 0..1Reference(Parameters)The output parameters of the evaluation, if any
... result 0..1Reference(CarePlan | RequestGroup)Proposed actions, if any
... dataRequirement 0..*DataRequirementAdditional required data
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... valueFilter 0..*(Complex)What values are expected
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-valueFilter
.... type Σ1..1codeThe type of the required data
Binding: FHIRAllTypes (required): A list of all the concrete types defined in this version of the FHIR specification - Abstract Types, Data Types and Resource Types.

.... profile Σ0..*canonical(StructureDefinition)The profile of the required data
.... subject[x] Σ0..1E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a data requirement (E.g., Patient, Practitioner, Organization, Location, etc.).

..... subjectCodeableConceptCodeableConcept
..... subjectReferenceReference(Group)
.... mustSupport Σ0..*stringIndicates specific structure elements that are referenced by the knowledge module
.... codeFilter ΣC0..*ElementWhat codes are expected
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ0..1stringA code-valued attribute to filter on
..... searchParam Σ0..1stringA coded (token) parameter to search on
..... valueSet Σ0..1canonical(ValueSet)Valueset for the filter
..... code Σ0..*CodingWhat code is expected
.... dateFilter ΣC0..*ElementWhat dates/date ranges are expected
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ0..1stringA date-valued attribute to filter on
..... searchParam Σ0..1stringA date valued parameter to search on
..... value[x] Σ0..1The value of the filter, as a Period, DateTime, or Duration value
...... valueDateTimedateTime
...... valuePeriodPeriod
...... valueDurationDuration
.... limit Σ0..1positiveIntNumber of results
.... sort Σ0..*ElementOrder of the results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ1..1stringThe name of the attribute to perform the sort
..... direction Σ1..1codeascending | descending
Binding: SortDirection (required): The possible sort directions, ascending or descending.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
GuidanceResponse.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
GuidanceResponse.statusrequiredGuidanceResponseStatus
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)
GuidanceResponse.dataRequirement.typerequiredFHIRAllTypes
GuidanceResponse.dataRequirement.subject[x]extensibleSubjectType
GuidanceResponse.dataRequirement.sort.directionrequiredSortDirection

Differential View

This structure is derived from GuidanceResponse

NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse GuidanceResponse
... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail
... dataRequirement
.... valueFilter 0..*(Complex)What values are expected
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-valueFilter

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse 0..*GuidanceResponseThe formal response to a guidance request
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... module[x] Σ1..1What guidance was requested
.... moduleUriuri
.... moduleCanonicalcanonical(Any)
.... moduleCodeableConceptCodeableConcept
... status ?!Σ1..1codesuccess | data-requested | data-required | in-progress | failure | entered-in-error
Binding: GuidanceResponseStatus (required): The status of a guidance response.

... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
GuidanceResponse.statusrequiredGuidanceResponseStatus
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. GuidanceResponse 0..*GuidanceResponseThe formal response to a guidance request
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... requestIdentifier Σ0..1IdentifierThe identifier of the request associated with this response, if any
... identifier Σ0..*IdentifierBusiness identifier
... module[x] Σ1..1What guidance was requested
.... moduleUriuri
.... moduleCanonicalcanonical(Any)
.... moduleCodeableConceptCodeableConcept
... status ?!Σ1..1codesuccess | data-requested | data-required | in-progress | failure | entered-in-error
Binding: GuidanceResponseStatus (required): The status of a guidance response.

... subject 0..1Reference(Patient | Group)Patient the request was performed for
... encounter 0..1Reference(Encounter)Encounter during which the response was returned
... occurrenceDateTime 0..1dateTimeWhen the guidance response was processed
... performer 0..1Reference(Device)Device returning the guidance
... reasonCode 0..*CodeableConceptWhy guidance is needed
Binding: Care Gap Reasons Value Set (preferred)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... detail 0..1(Complex)Which data element attribute is the cause of the care gap
URL: http://hl7.org/fhir/us/davinci-deqm/StructureDefinition/reasonDetail
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... reasonReference 0..*Reference(Condition | Observation | DiagnosticReport | DocumentReference)Why guidance is needed
... note 0..*AnnotationAdditional notes about the response
... evaluationMessage 0..*Reference(OperationOutcome)Messages resulting from the evaluation of the artifact or artifacts
... outputParameters 0..1Reference(Parameters)The output parameters of the evaluation, if any
... result 0..1Reference(CarePlan | RequestGroup)Proposed actions, if any
... dataRequirement 0..*DataRequirementAdditional required data
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... valueFilter 0..*(Complex)What values are expected
URL: http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/cqfm-valueFilter
.... type Σ1..1codeThe type of the required data
Binding: FHIRAllTypes (required): A list of all the concrete types defined in this version of the FHIR specification - Abstract Types, Data Types and Resource Types.

.... profile Σ0..*canonical(StructureDefinition)The profile of the required data
.... subject[x] Σ0..1E.g. Patient, Practitioner, RelatedPerson, Organization, Location, Device
Binding: SubjectType (extensible): The possible types of subjects for a data requirement (E.g., Patient, Practitioner, Organization, Location, etc.).

..... subjectCodeableConceptCodeableConcept
..... subjectReferenceReference(Group)
.... mustSupport Σ0..*stringIndicates specific structure elements that are referenced by the knowledge module
.... codeFilter ΣC0..*ElementWhat codes are expected
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ0..1stringA code-valued attribute to filter on
..... searchParam Σ0..1stringA coded (token) parameter to search on
..... valueSet Σ0..1canonical(ValueSet)Valueset for the filter
..... code Σ0..*CodingWhat code is expected
.... dateFilter ΣC0..*ElementWhat dates/date ranges are expected
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ0..1stringA date-valued attribute to filter on
..... searchParam Σ0..1stringA date valued parameter to search on
..... value[x] Σ0..1The value of the filter, as a Period, DateTime, or Duration value
...... valueDateTimedateTime
...... valuePeriodPeriod
...... valueDurationDuration
.... limit Σ0..1positiveIntNumber of results
.... sort Σ0..*ElementOrder of the results
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... path Σ1..1stringThe name of the attribute to perform the sort
..... direction Σ1..1codeascending | descending
Binding: SortDirection (required): The possible sort directions, ascending or descending.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
GuidanceResponse.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
GuidanceResponse.statusrequiredGuidanceResponseStatus
GuidanceResponse.reasonCodepreferredCareGapReasons (a valid code from Care Gap Reasons Code System)
GuidanceResponse.dataRequirement.typerequiredFHIRAllTypes
GuidanceResponse.dataRequirement.subject[x]extensibleSubjectType
GuidanceResponse.dataRequirement.sort.directionrequiredSortDirection

 

Other representations of profile: CSV, Excel, Schematron