This page is part of the PACIO Advance Directive Information Implementation Guide (v0.1.0: STU 1 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions
| Defining URL: | http://hl7.org/fhir/us/pacio-adi/StructureDefinition/PADI-DocumentReference | 
| Version: | 0.1.0 | 
| Name: | PADIDocumentReference | 
| Title: | PACIO ADI Document Reference | 
| Status: | Active as of 12/6/21 8:50 PM | 
| Definition: | This profile defines constraints that represent the information needed to register an advance directive information document on a FHIR server.  | 
| Publisher: | HL7 Patient Empowerment Working Group | 
| Source Resource: | XML / JSON / Turtle | 
The official URL for this profile is:
http://hl7.org/fhir/us/pacio-adi/StructureDefinition/PADI-DocumentReference
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from USCoreDocumentReferenceProfile
This structure is derived from USCoreDocumentReferenceProfile
| Name | Flags | Card. | Type | Description & Constraints![]()  | 
|---|---|---|---|---|
![]()  | 0..* | USCoreDocumentReferenceProfile | A reference to a document | |
![]() ![]()  | 1..1 | CodeableConcept | Advance Directive Categories | |
![]() ![]()  | 1..* | CodeableConcept | Categorization of document Binding: US Core DocumentReference Category (extensible)  | |
![]() ![]()  | 1..1 | Reference(US Core Patient Profile) | Patient | |
![]() ![]()  | 0..* | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) | legalAuthenticator | |
![]() ![]()  | S | 0..1 | Reference(US Core Organization Profile) | Organization which maintains the document | 
  Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints![]()  | 
|---|---|---|---|---|
![]()  | 0..* | USCoreDocumentReferenceProfile | A reference to a document | |
![]() ![]()  | Σ | 0..1 | string | Logical id of this artifact | 
![]() ![]()  | Σ | 0..1 | Meta | Metadata about the resource | 
![]() ![]()  | ?!Σ | 0..1 | uri | A set of rules under which this content was created | 
![]() ![]()  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language.  | |
![]() ![]()  | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
![]() ![]()  | 0..* | Resource | Contained, inline Resources | |
![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]()  | ?! | 0..* | Extension | Extensions that cannot be ignored | 
![]() ![]()  | Σ | 0..1 | Identifier | Master Version Specific Identifier | 
![]() ![]()  | SΣ | 0..* | Identifier | Other identifiers for the document | 
![]() ![]()  | ?!SΣ | 1..1 | code | current | superseded | entered-in-error Binding: DocumentReferenceStatus (required)  | 
![]() ![]()  | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): Status of the underlying document.  | 
![]() ![]()  | SΣ | 1..1 | CodeableConcept | Advance Directive Categories Binding: US Core DocumentReference Type (required) Min Binding: US Core Clinical Note Type: All LOINC values whose SCALE is DOC in the LOINC database and the HL7 v3 Code System NullFlavor concept 'unknown'  | 
![]() ![]()  | SΣ | 1..* | CodeableConcept | Categorization of document Binding: US Core DocumentReference Category (extensible)  | 
![]() ![]()  | SΣ | 1..1 | Reference(US Core Patient Profile) | Patient | 
![]() ![]()  | SΣ | 0..1 | instant | When this document reference was created | 
![]() ![]()  | SΣ | 0..* | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) | legalAuthenticator | 
![]() ![]()  | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Who/what authenticated the document | |
![]() ![]()  | S | 0..1 | Reference(US Core Organization Profile) | Organization which maintains the document | 
![]() ![]()  | Σ | 0..* | BackboneElement | Relationships to other documents | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents.  | 
![]() ![]() ![]()  | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | 
![]() ![]()  | Σ | 0..1 | string | Human-readable description | 
![]() ![]()  | Σ | 0..* | CodeableConcept | Document security-tags Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.  | 
![]() ![]()  | SΣ | 1..* | BackboneElement | Document referenced | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | SΣI | 1..1 | Attachment | Where to access the document us-core-6: DocumentReference.content.attachment.url or DocumentReference.content.attachment.data or both SHALL be present.  | 
![]() ![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url  | |
![]() ![]() ![]() ![]()  | SΣ | 1..1 | code | Mime type of the content, with charset etc. Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language. Example General: en-AU  | 
![]() ![]() ![]() ![]()  | SI | 0..1 | base64Binary | Data inline, base64ed | 
![]() ![]() ![]() ![]()  | SΣI | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | dateTime | Date attachment was first created | 
![]() ![]() ![]()  | SΣ | 0..1 | Coding | Format/content rules for the document Binding: DocumentReferenceFormatCodeSet (extensible)  | 
![]() ![]()  | SΣ | 0..1 | BackboneElement | Clinical context of document | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | S | 0..1 | Reference(US Core Encounter Profile) | Context of the document  content | 
![]() ![]() ![]()  | 0..* | CodeableConcept | Main clinical acts documented Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented.  | |
![]() ![]() ![]()  | SΣ | 0..1 | Period | Time of service that is being documented | 
![]() ![]() ![]()  | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: FacilityTypeCodeValueSet (example): XDS Facility Type.  | |
![]() ![]() ![]()  | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty).  | |
![]() ![]() ![]()  | 0..1 | Reference(Patient) | Patient demographics from source | |
![]() ![]() ![]()  | 0..* | Reference(Resource) | Related identifiers or resources | |
  Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints![]()  | 
|---|---|---|---|---|
![]()  | 0..* | USCoreDocumentReferenceProfile | A reference to a document | |
![]() ![]()  | Σ | 0..* | Identifier | Other identifiers for the document | 
![]() ![]()  | ?!Σ | 1..1 | code | current | superseded | entered-in-error Binding: DocumentReferenceStatus (required)  | 
![]() ![]()  | Σ | 1..1 | CodeableConcept | Advance Directive Categories Binding: US Core DocumentReference Type (required) Min Binding: US Core Clinical Note Type: All LOINC values whose SCALE is DOC in the LOINC database and the HL7 v3 Code System NullFlavor concept 'unknown'  | 
![]() ![]()  | Σ | 1..* | CodeableConcept | Categorization of document Binding: US Core DocumentReference Category (extensible)  | 
![]() ![]()  | Σ | 1..1 | Reference(US Core Patient Profile) | Patient | 
![]() ![]()  | Σ | 0..1 | instant | When this document reference was created | 
![]() ![]()  | Σ | 0..* | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) | legalAuthenticator | 
![]() ![]()  | 0..1 | Reference(US Core Organization Profile) | Organization which maintains the document | |
![]() ![]()  | Σ | 1..* | BackboneElement | Document referenced | 
![]() ![]() ![]()  | ΣI | 1..1 | Attachment | Where to access the document us-core-6: DocumentReference.content.attachment.url or DocumentReference.content.attachment.data or both SHALL be present.  | 
![]() ![]() ![]() ![]()  | Σ | 1..1 | code | Mime type of the content, with charset etc. Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.  | 
![]() ![]() ![]() ![]()  | I | 0..1 | base64Binary | Data inline, base64ed | 
![]() ![]() ![]() ![]()  | ΣI | 0..1 | url | Uri where the data can be found | 
![]() ![]() ![]()  | Σ | 0..1 | Coding | Format/content rules for the document Binding: DocumentReferenceFormatCodeSet (extensible)  | 
![]() ![]()  | Σ | 0..1 | BackboneElement | Clinical context of document | 
![]() ![]() ![]()  | 0..1 | Reference(US Core Encounter Profile) | Context of the document  content | |
![]() ![]() ![]()  | Σ | 0..1 | Period | Time of service that is being documented | 
  Documentation for this format | ||||
This structure is derived from USCoreDocumentReferenceProfile
Differential View
This structure is derived from USCoreDocumentReferenceProfile
| Name | Flags | Card. | Type | Description & Constraints![]()  | 
|---|---|---|---|---|
![]()  | 0..* | USCoreDocumentReferenceProfile | A reference to a document | |
![]() ![]()  | 1..1 | CodeableConcept | Advance Directive Categories | |
![]() ![]()  | 1..* | CodeableConcept | Categorization of document Binding: US Core DocumentReference Category (extensible)  | |
![]() ![]()  | 1..1 | Reference(US Core Patient Profile) | Patient | |
![]() ![]()  | 0..* | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) | legalAuthenticator | |
![]() ![]()  | S | 0..1 | Reference(US Core Organization Profile) | Organization which maintains the document | 
  Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints![]()  | 
|---|---|---|---|---|
![]()  | 0..* | USCoreDocumentReferenceProfile | A reference to a document | |
![]() ![]()  | Σ | 0..1 | string | Logical id of this artifact | 
![]() ![]()  | Σ | 0..1 | Meta | Metadata about the resource | 
![]() ![]()  | ?!Σ | 0..1 | uri | A set of rules under which this content was created | 
![]() ![]()  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language.  | |
![]() ![]()  | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
![]() ![]()  | 0..* | Resource | Contained, inline Resources | |
![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]()  | ?! | 0..* | Extension | Extensions that cannot be ignored | 
![]() ![]()  | Σ | 0..1 | Identifier | Master Version Specific Identifier | 
![]() ![]()  | SΣ | 0..* | Identifier | Other identifiers for the document | 
![]() ![]()  | ?!SΣ | 1..1 | code | current | superseded | entered-in-error Binding: DocumentReferenceStatus (required)  | 
![]() ![]()  | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): Status of the underlying document.  | 
![]() ![]()  | SΣ | 1..1 | CodeableConcept | Advance Directive Categories Binding: US Core DocumentReference Type (required) Min Binding: US Core Clinical Note Type: All LOINC values whose SCALE is DOC in the LOINC database and the HL7 v3 Code System NullFlavor concept 'unknown'  | 
![]() ![]()  | SΣ | 1..* | CodeableConcept | Categorization of document Binding: US Core DocumentReference Category (extensible)  | 
![]() ![]()  | SΣ | 1..1 | Reference(US Core Patient Profile) | Patient | 
![]() ![]()  | SΣ | 0..1 | instant | When this document reference was created | 
![]() ![]()  | SΣ | 0..* | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile) | legalAuthenticator | 
![]() ![]()  | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Who/what authenticated the document | |
![]() ![]()  | S | 0..1 | Reference(US Core Organization Profile) | Organization which maintains the document | 
![]() ![]()  | Σ | 0..* | BackboneElement | Relationships to other documents | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents.  | 
![]() ![]() ![]()  | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | 
![]() ![]()  | Σ | 0..1 | string | Human-readable description | 
![]() ![]()  | Σ | 0..* | CodeableConcept | Document security-tags Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.  | 
![]() ![]()  | SΣ | 1..* | BackboneElement | Document referenced | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | SΣI | 1..1 | Attachment | Where to access the document us-core-6: DocumentReference.content.attachment.url or DocumentReference.content.attachment.data or both SHALL be present.  | 
![]() ![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url  | |
![]() ![]() ![]() ![]()  | SΣ | 1..1 | code | Mime type of the content, with charset etc. Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred) Max Binding: AllLanguages: A human language. Example General: en-AU  | 
![]() ![]() ![]() ![]()  | SI | 0..1 | base64Binary | Data inline, base64ed | 
![]() ![]() ![]() ![]()  | SΣI | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo  | 
![]() ![]() ![]() ![]()  | Σ | 0..1 | dateTime | Date attachment was first created | 
![]() ![]() ![]()  | SΣ | 0..1 | Coding | Format/content rules for the document Binding: DocumentReferenceFormatCodeSet (extensible)  | 
![]() ![]()  | SΣ | 0..1 | BackboneElement | Clinical context of document | 
![]() ![]() ![]()  | 0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]()  | 0..* | Extension | Additional content defined by implementations | |
![]() ![]() ![]()  | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | 
![]() ![]() ![]()  | S | 0..1 | Reference(US Core Encounter Profile) | Context of the document  content | 
![]() ![]() ![]()  | 0..* | CodeableConcept | Main clinical acts documented Binding: v3 Code System ActCode (example): This list of codes represents the main clinical acts being documented.  | |
![]() ![]() ![]()  | SΣ | 0..1 | Period | Time of service that is being documented | 
![]() ![]() ![]()  | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: FacilityTypeCodeValueSet (example): XDS Facility Type.  | |
![]() ![]() ![]()  | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: PracticeSettingCodeValueSet (example): Additional details about where the content was created (e.g. clinical specialty).  | |
![]() ![]() ![]()  | 0..1 | Reference(Patient) | Patient demographics from source | |
![]() ![]() ![]()  | 0..* | Reference(Resource) | Related identifiers or resources | |
  Documentation for this format | ||||
Other representations of profile: CSV, Excel, Schematron
| Path | Conformance | ValueSet | 
| DocumentReference.language | preferred | CommonLanguages Max Binding: AllLanguages  | 
| DocumentReference.status | required | DocumentReferenceStatus | 
| DocumentReference.docStatus | required | CompositionStatus | 
| DocumentReference.type | required | USCoreDocumentReferenceType Min Binding: US Core Clinical Note Type  | 
| DocumentReference.category | extensible | USCoreDocumentReferenceCategory | 
| DocumentReference.relatesTo.code | required | DocumentRelationshipType | 
| DocumentReference.securityLabel | extensible | All Security Labels | 
| DocumentReference.content.attachment.contentType | required | Mime Types | 
| DocumentReference.content.attachment.language | preferred | CommonLanguages Max Binding: AllLanguages  | 
| DocumentReference.content.format | extensible | DocumentReferenceFormatCodeSet | 
| DocumentReference.context.event | example | ActCode | 
| DocumentReference.context.facilityType | example | FacilityTypeCodeValueSet | 
| DocumentReference.context.practiceSetting | example | PracticeSettingCodeValueSet | 
| Id | Path | Details | Requirements | 
| us-core-6 | DocumentReference.content.attachment | DocumentReference.content.attachment.url or  DocumentReference.content.attachment.data or both SHALL be present. : url.exists() or data.exists()  |