## Profile Comparison between http://hl7.org/fhir/uv/ipa/StructureDefinition/ipa-documentreference vs http://hl7.org/fhir/us/core/StructureDefinition/us-core-adi-documentreference

Left: | IPA-DocumentReference (http://hl7.org/fhir/uv/ipa/StructureDefinition/ipa-documentreference)
Right: | US Core ADI DocumentReference Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-adi-documentreference)

### Messages

Error | StructureDefinition.url | Values for url differ: 'http://hl7.org/fhir/uv/ipa/StructureDefinition/ipa-documentreference' vs 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-adi-documentreference'
Error | StructureDefinition.version | Values for version differ: '1.1.0' vs '9.0.0'
Information | StructureDefinition.name | Values for name differ: 'IPADocumentReference' vs 'USCoreADIDocumentReferenceProfile'
Information | StructureDefinition.title | Values for title differ: 'IPA-DocumentReference' vs 'US Core ADI DocumentReference Profile'
Information | StructureDefinition.date | Values for date differ: '2022-08-02' vs '2023-10-17'
Information | StructureDefinition.publisher | Values for publisher differ: 'HL7 International / Patient Care' vs 'HL7 International / Cross-Group Projects'
Information | StructureDefinition.jurisdiction | Removed the item 'http://unstats.un.org/unsd/methods/m49/m49.htm#001'
Information | StructureDefinition.jurisdiction | Added the item 'urn:iso:std:iso:3166#US'
Information | DocumentReference.language | Example/preferred bindings differ at DocumentReference.language using binding from IPADocumentReference
Information | StructureDefinition.short | Values for short differ: 'Additional content defined by implementations' vs 'Extension'
Information | StructureDefinition.definition | Values for definition differ: 'May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.' vs 'An Extension'
Warning | DocumentReference.identifier | Elements differ in definition for mustSupport: 'false' vs 'true'
Information | DocumentReference.type | Element minimum cardinalities differ: '0' vs '1'
Information | DocumentReference.category | Element minimum cardinalities differ: '0' vs '1'
Information | StructureDefinition.definition | Values for definition differ: 'The document or URL of the document along with critical metadata to prove content has integrity.' vs 'The document and format referenced.'
Information | DocumentReference.content.attachment.contentType | Element minimum cardinalities differ: '1' vs '0'
Information | DocumentReference.content.attachment.language | Example/preferred bindings differ at DocumentReference.content.attachment.language using binding from IPADocumentReference
Warning | DocumentReference.context | Elements differ in definition for mustSupport: 'true' vs 'false'
Warning | DocumentReference.context.encounter | Elements differ in definition for mustSupport: 'true' vs 'false'
Information | DocumentReference.context.encounter | Element maximum cardinalities differ: '1' vs '2147483647'
Warning | DocumentReference.context.period | Elements differ in definition for mustSupport: 'true' vs 'false'

### Metadata

Name | Value | Comments
--- | --- | ---
abstract | false |
baseDefinition | http://hl7.org/fhir/StructureDefinition/DocumentReference |
copyright | Used by permission of HL7 International all rights reserved Creative Commons License |  | Removed the item 'Used by permission of HL7 International all rights reserved Creative Commons License'
date | 2022-08-02 | 2023-10-17 | Values Differ
description | Minimum expectations for a DocumentReference resource when accessed via a International Patient Access API | The US Core Advance Directive Information (ADI) DocumentReference Profile inherits from the FHIR [DocumentReference](https://hl7.org/fhir/R4/documentreference.html) resource; refer to it for scope and usage definitions. It sets minimum expectations for searching and fetching patient Advance Directive Information (ADI) documents using the DocumentReference resource. Examples of advance healthcare directive documents include physician order for life sustaining treatment (POLST), do not resuscitate order (DNR), and Living Will. In addition to the document contents, it communicates the type of advance directive document, the author, the verifier, and other properties. To represent whether advance directive documents exist for a patient, see the [US Core Observation ADI Documentation Profile](StructureDefinition-us-core-observation-adi-documentation.html). This profile sets minimum expectations for searching and fetching patient ADI documents using the DocumentReference resource. It specifies which core elements, extensions, vocabularies, and value sets **SHALL** be present and constrains how the elements are used. Providing the floor for standards development for specific use cases promotes interoperability and adoption. | Values Differ
experimental | false |
fhirVersion | 4.0.1 |
jurisdiction |  |
jurisdiction[0] | http://unstats.un.org/unsd/methods/m49/m49.htm#001 |  | Removed the item 'http://unstats.un.org/unsd/methods/m49/m49.htm#001'
jurisdiction[1] |  | urn:iso:std:iso:3166#US | Added the item 'urn:iso:std:iso:3166#US'
kind | resource |
name | IPADocumentReference | USCoreADIDocumentReferenceProfile | Values Differ
publisher | HL7 International / Patient Care | HL7 International / Cross-Group Projects | Values Differ
purpose |  |
status | active |
title | IPA-DocumentReference | US Core ADI DocumentReference Profile | Values Differ
type | DocumentReference |
url | http://hl7.org/fhir/uv/ipa/StructureDefinition/ipa-documentreference | http://hl7.org/fhir/us/core/StructureDefinition/us-core-adi-documentreference | Values Differ
version | 1.1.0 | 9.0.0 | Values Differ

### Structure

Name | L Flags | L Card. | L Type | L Description & Constraints | R Flags | R Card. | R Type | R Description & Constraints | Comments
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
DocumentReference |  | 0..* | DocumentReference | A reference to a document |  | 0..* | DocumentReference | A reference to a document |
id | Σ | 0..1 | id | Logical id of this artifact | Σ | 0..1 | id | Logical id of this artifact |
meta | Σ | 0..1 | Meta | Metadata about the resource | Σ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
language |  | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
Additional Bindings | Purpose
?? | Max Binding
|  | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
Additional Bindings | Purpose
?? | Max Binding
| Example/preferred bindings differ at DocumentReference.language using binding from IPADocumentReference
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 |  | 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 |  | 0..* | Resource | Contained, inline Resources |
extension |  | 0..* | Extension | Additional content defined by implementations |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ?! | 0..* | Extension | Extensions that cannot be ignored |
masterIdentifier | Σ | 0..1 | Identifier | Master Version Specific Identifier | Σ | 0..1 | Identifier | Master Version Specific Identifier |
identifier | Σ | 0..* | Identifier | Other identifiers for the document | S Σ | 0..* | Identifier | Other identifiers for the document | Elements differ in definition for mustSupport: 'false' vs 'true'
status | ?!SO Σ | 1..1 | code | current | superseded | entered-in-error Binding: ?? (required): The status of the document reference.
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| ?!S Σ | 1..1 | code | current | superseded | entered-in-error Binding: ?? (required) |
docStatus | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): Status of the underlying document. | Σ | 0..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): Status of the underlying document. |
type | SO Σ | 0..1 | CodeableConcept | Kind of document (LOINC if possible) Binding: ?? (preferred): Precise type of clinical document.
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ | 1..1 | CodeableConcept | Kind of document (LOINC if possible) Binding: ?? (extensible): Advance Directives Content Type | Element minimum cardinalities differ: '0' vs '1'
category | SO Σ | 0..* | CodeableConcept | Categorization of document Binding: ?? (example): High-level kind of a clinical document at a macro level.
Obligations | Actor
SHALL:populate-if-known | Server
SHOULD:handle | Client
| S Σ | 1..* | CodeableConcept | Categorization of document Slice: Unordered, Open by value:$this Binding: ?? (example): High-level kind of a clinical document at a macro level. | Element minimum cardinalities differ: '0' vs '1'
subject | SO Σ | 1..1 | Reference(IPA-Patient) | Who/what is the subject of the document
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ | 1..1 | Reference(US Core Patient Profile) | Who/what is the subject of the document |
date | SO Σ | 0..1 | instant | When this document reference was created
Obligations | Actor
SHALL:populate-if-known | Server
| S Σ | 0..1 | instant | When this document reference was created |
author | SO Σ | 0..* | Reference(IPA-Practitioner | IPA-PractitionerRole | Organization | Device | IPA-Patient | RelatedPerson) | Who and/or what authored the document
Obligations | Actor
SHALL:populate-if-known | Server
SHOULD:handle | Client
| S Σ | 0..* | Reference(US Core Practitioner Profile S | US Core Organization Profile | US Core Patient Profile | US Core PractitionerRole Profile | US Core RelatedPerson Profile | US Core Device Profile) | Who and/or what authored the document |
authenticator |  | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Who/what authenticated the document |  | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Who/what authenticated the document |
custodian |  | 0..1 | Reference(Organization) | Organization which maintains the document |  | 0..1 | Reference(Organization) | Organization which maintains the document |
relatesTo | Σ | 0..* | BackboneElement | Relationships to other documents | Σ | 0..* | BackboneElement | Relationships to other documents |
id |  | 0..1 | string | Unique id for inter-element referencing |  | 0..1 | string | Unique id for inter-element referencing |
extension |  | 0..* | Extension | Additional content defined by implementations |  | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
code | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. | Σ | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. |
target | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship | Σ | 1..1 | Reference(DocumentReference) | Target of the relationship |
description | Σ | 0..1 | string | Human-readable description | Σ | 0..1 | string | Human-readable description |
securityLabel | Σ | 0..* | CodeableConcept | Document security-tags Binding: ?? (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | Σ | 0..* | CodeableConcept | Document security-tags Binding: ?? (extensible): Security Labels from the Healthcare Privacy and Security Classification System. |
content | SO Σ | 1..* | BackboneElement | Document referenced
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ | 1..* | BackboneElement | Document referenced |
id |  | 0..1 | string | Unique id for inter-element referencing |  | 0..1 | string | Unique id for inter-element referencing |
extension |  | 0..* | Extension | Additional content defined by implementations |  | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
attachment | SO Σ C | 1..1 | Attachment | Where to access the document Constraints: ipa-doc-1
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ C | 1..1 | Attachment | Where to access the document Constraints: us-core-6 |
id |  | 0..1 | string | Unique id for inter-element referencing |  | 0..1 | string | Unique id for inter-element referencing |
Slices for extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url |
contentType | SO Σ | 1..1 | code | Mime type of the content, with charset etc. Binding: ?? (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ | 0..1 | code | Mime type of the content, with charset etc. Binding: ?? (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png | Element minimum cardinalities differ: '1' vs '0'
language | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: ?? (preferred): A human language.
Additional Bindings | Purpose
?? | Max Binding
Example General: en-AU | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: ?? (preferred): A human language.
Additional Bindings | Purpose
?? | Max Binding
Example General: en-AU | Example/preferred bindings differ at DocumentReference.content.attachment.language using binding from IPADocumentReference
data | SO | 0..1 | base64Binary | Data inline, base64ed
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S C | 0..1 | base64Binary | Data inline, base64ed |
url | SO Σ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ C | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png |
size | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided) |
hash | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed) |
title | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo |
creation | Σ | 0..1 | dateTime | Date attachment was first created | Σ | 0..1 | dateTime | Date attachment was first created |
format | SO Σ | 0..1 | Coding | Format/content rules for the document Binding: ?? (preferred): Document Format Codes.
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| S Σ | 0..1 | Coding | Format/content rules for the document Binding: ?? (extensible) |
context | SO Σ | 0..1 | BackboneElement | Clinical context of document
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| Σ | 0..1 | BackboneElement | Clinical context of document | Elements differ in definition for mustSupport: 'true' vs 'false'
id |  | 0..1 | string | Unique id for inter-element referencing |  | 0..1 | string | Unique id for inter-element referencing |
extension |  | 0..* | Extension | Additional content defined by implementations |  | 0..* | Extension | Additional content defined by implementations |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
encounter | SO | 0..1 | Reference(Encounter | EpisodeOfCare) | Context of the document content
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
|  | 0..* | Reference(Encounter | EpisodeOfCare) | Context of the document content | Elements differ in definition for mustSupport: 'true' vs 'false' Element maximum cardinalities differ: '1' vs '2147483647'
event |  | 0..* | CodeableConcept | Main clinical acts documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. |  | 0..* | CodeableConcept | Main clinical acts documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. |
period | SO Σ | 0..1 | Period | Time of service that is being documented
Obligations | Actor
SHALL:populate-if-known | Server
SHALL:handle | Client
| Σ | 0..1 | Period | Time of service that is being documented | Elements differ in definition for mustSupport: 'true' vs 'false'
facilityType |  | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: ?? (example): XDS Facility Type. |  | 0..1 | CodeableConcept | Kind of facility where patient was seen Binding: ?? (example): XDS Facility Type. |
practiceSetting |  | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: ?? (example): Additional details about where the content was created (e.g. clinical specialty). |  | 0..1 | CodeableConcept | Additional details about where the content was created (e.g. clinical specialty) Binding: ?? (example): Additional details about where the content was created (e.g. clinical specialty). |
sourcePatientInfo |  | 0..1 | Reference(Patient) | Patient demographics from source |  | 0..1 | Reference(Patient) | Patient demographics from source |
related |  | 0..* | Reference(Resource) | Related identifiers or resources |  | 0..* | Reference(Resource) | Related identifiers or resources |
Documentation for this format