Da Vinci - Documentation Templates and Rules
2.2.0 - STU 2.2

Da Vinci - Documentation Templates and Rules, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-dtr/ and changes regularly. See the Directory of published versions

## Resource Profile: DTR Supported Payers

Official URL: http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-supported-Payers | Version: 2.2.0 | Highlight text changes?
Standards status: Trial-use Active as of 2026-03-27 | Maturity Level: 2 | Computable Name: DTRSupportedPayers

A listing of payer organizations currently supported by the DTR app. The Payer Identifier used SHALL be the same as the ones that are returned by the endpoint discovery mechanism defined in HRex.§prof-2

Usages:

- Examples for this Profile: List/SupportedPayers

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List | C | 0..* | List | A list is a curated collection of resources Constraints: lst-1, lst-2, lst-3
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
status | ?!Σ | 1..1 | code | current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode | ?!Σ | 1..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
entry | S C | 1..* | BackboneElement | Entries in the list
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
List.status | Base | required | ListStatus | 📍4.0.1 | FHIR Std.
List.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | List | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | List | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | List | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | List | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | List | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
lst-1 | error | List | A list can only have an emptyReason if it is empty | `emptyReason.empty() or entry.empty()`
lst-2 | error | List | The deleted flag can only be used if the mode of the list is "changes" | `mode = 'changes' or entry.deleted.empty()`
lst-3 | error | List | An entry date can only be used if the mode of the list is "working" | `mode = 'working' or entry.date.empty()`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List |  | 0..* | List | A list is a curated collection of resources
code |  | 0..0 |  | What the purpose of this list is
subject |  | 0..0 |  | If all resources have the same subject
encounter |  | 0..0 |  | Context in which list created
entry | S | 1..* | BackboneElement | Entries in the list
flag |  | 0..0 |  | Status/Workflow information about this item
deleted |  | 0..0 |  | If this item is actually marked as deleted
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
emptyReason |  | 0..0 |  | Why list is empty
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List | C | 0..* | List | A list is a curated collection of resources Constraints: lst-1, lst-2, lst-3
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier |  | 0..* | Identifier | Business identifier
status | ?!Σ | 1..1 | code | current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode | ?!Σ | 1..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title | Σ | 0..1 | string | Descriptive name for the list Example General: Dr. Jane's Patients
date | Σ | 0..1 | dateTime | When the list was prepared
source | Σ | 0..1 | Reference(Practitioner | PractitionerRole | Patient | Device) | Who and/or what defined the list contents (aka Author)
orderedBy |  | 0..1 | CodeableConcept | What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note |  | 0..* | Annotation | Comments about the list
entry | S C | 1..* | BackboneElement | Entries in the list
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
date |  | 0..1 | dateTime | When item added to list
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
List.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
List.status | Base | required | ListStatus | 📍4.0.1 | FHIR Std.
List.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std.
List.orderedBy | Base | preferred | List Order Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | List | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | List | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | List | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | List | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | List | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
lst-1 | error | List | A list can only have an emptyReason if it is empty | `emptyReason.empty() or entry.empty()`
lst-2 | error | List | The deleted flag can only be used if the mode of the list is "changes" | `mode = 'changes' or entry.deleted.empty()`
lst-3 | error | List | An entry date can only be used if the mode of the list is "working" | `mode = 'working' or entry.date.empty()`

Summary

Mandatory: 1 element
Must-Support: 2 elements
Prohibited: 6 elements

Maturity: 2

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List | C | 0..* | List | A list is a curated collection of resources Constraints: lst-1, lst-2, lst-3
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
status | ?!Σ | 1..1 | code | current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode | ?!Σ | 1..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
entry | S C | 1..* | BackboneElement | Entries in the list
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
List.status | Base | required | ListStatus | 📍4.0.1 | FHIR Std.
List.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | List | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | List | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | List | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | List | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | List | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
lst-1 | error | List | A list can only have an emptyReason if it is empty | `emptyReason.empty() or entry.empty()`
lst-2 | error | List | The deleted flag can only be used if the mode of the list is "changes" | `mode = 'changes' or entry.deleted.empty()`
lst-3 | error | List | An entry date can only be used if the mode of the list is "working" | `mode = 'working' or entry.date.empty()`

Differential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List |  | 0..* | List | A list is a curated collection of resources
code |  | 0..0 |  | What the purpose of this list is
subject |  | 0..0 |  | If all resources have the same subject
encounter |  | 0..0 |  | Context in which list created
entry | S | 1..* | BackboneElement | Entries in the list
flag |  | 0..0 |  | Status/Workflow information about this item
deleted |  | 0..0 |  | If this item is actually marked as deleted
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
emptyReason |  | 0..0 |  | Why list is empty
Documentation for this format

Snapshot ViewView

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
List | C | 0..* | List | A list is a curated collection of resources Constraints: lst-1, lst-2, lst-3
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier |  | 0..* | Identifier | Business identifier
status | ?!Σ | 1..1 | code | current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode | ?!Σ | 1..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title | Σ | 0..1 | string | Descriptive name for the list Example General: Dr. Jane's Patients
date | Σ | 0..1 | dateTime | When the list was prepared
source | Σ | 0..1 | Reference(Practitioner | PractitionerRole | Patient | Device) | Who and/or what defined the list contents (aka Author)
orderedBy |  | 0..1 | CodeableConcept | What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note |  | 0..* | Annotation | Comments about the list
entry | S C | 1..* | BackboneElement | Entries in the list
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
date |  | 0..1 | dateTime | When item added to list
item | S | 1..1 | Reference(Organization) {c} | Reference to the supported Organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
List.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std.
List.status | Base | required | ListStatus | 📍4.0.1 | FHIR Std.
List.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std.
List.orderedBy | Base | preferred | List Order Codes | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | List | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | List | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | List | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | List | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | List | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
lst-1 | error | List | A list can only have an emptyReason if it is empty | `emptyReason.empty() or entry.empty()`
lst-2 | error | List | The deleted flag can only be used if the mode of the list is "changes" | `mode = 'changes' or entry.deleted.empty()`
lst-3 | error | List | An entry date can only be used if the mode of the list is "working" | `mode = 'working' or entry.date.empty()`

Summary

Mandatory: 1 element
Must-Support: 2 elements
Prohibited: 6 elements

Maturity: 2

Other representations of profile: CSV, Excel, Schematron