RIVO-Noord Zorgviewer Implementation Guide
1.11.0 - sprint49 Netherlands flag

This page is part of the RIVO-Noord Zorgviewer Implementation Guide (v1.11.0: Release) based on FHIR (HL7® FHIR® Standard) R3. 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: AdvanceDirective - Detailed Descriptions

Active as of 2025-01-20

Definitions for the AdvanceDirective resource profile.

Guidance on how to interpret the contents of this table can be found here

0. Consent
Definition

A record of a healthcare consumer’s policy choices, which permits or denies identified recipient(s) or recipient role(s) to perform one or more actions within a given policy context, for specific purposes and periods of time.

ShortLivingWillA healthcare consumer's policy choices to permits or denies recipients or roles to perform actions for specific purposes and periods of time
Comments

Broadly, there are 3 key areas of consent for patients: Consent around sharing information (aka Privacy Consent Directive - Authorization to Collect, Use, or Disclose information), consent for specific treatment, or kinds of treatment, and general advance care directives.

Control0..*
Alternate NamesWilsverklaring
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
dom-4: 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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
ppc-1: Either a Policy or PolicyRule (policy.exists() or policyRule.exists())
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
dom-4: 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-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
ppc-1: Either a Policy or PolicyRule (policy.exists() or policyRule.exists())
2. Consent.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element.

This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

Control0..1
Typeuri
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
4. Consent.extension:disorder
Slice Namedisorder
Definition

The problem or disorder to which the living will applies.

ShortDisorder
Control0..*
This element is affected by the following invariants: ele-1
TypeExtension(HCIM AdvanceDirective Disorder) (Extension Type: Reference)
Alternate NamesAandoening
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. Consent.extension:comment
Slice Namecomment
Definition

An Extension

ShortComment
Control0..1
This element is affected by the following invariants: ele-1
TypeExtension(Comment) (Extension Type: string)
Alternate NamesToelichting
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
8. Consent.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the resource, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order 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 is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

ShortExtensions that cannot be ignored
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Alternate Namesextensions, user content
10. Consent.status
Definition

Indicates the current state of this consent.

Shortdraft | proposed | active | rejected | inactive | entered-in-error
Comments

This element is labeled as a modifier because the status contains the codes rejected and entered-in-error that mark the Consent as not currently valid.

Control1..1
BindingThe codes SHALL be taken from ConsentStatehttp://hl7.org/fhir/ValueSet/consent-state-codes
(required to http://hl7.org/fhir/ValueSet/consent-state-codes)

Indicates the state of the consent

Typecode
Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Requirements

The Consent Directive that is pointed to might be in various lifecycle states, e.g., a revoked Consent Directive.

12. Consent.category
Definition

A classification of the type of consents found in the statement. This element supports indexing and retrieval of consent statements.

ShortClassification of the consent statement - for indexing/retrieval
Control20..*
BindingFor example codes, see Consent Category Codeshttp://hl7.org/fhir/ValueSet/consent-category
(example to http://hl7.org/fhir/ValueSet/consent-category)

A classification of the type of consents found in a consent statement

TypeCodeableConcept
Summarytrue
SlicingThis element introduces a set of slices on Consent.category. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ $this
  • 14. Consent.category:livingWill
    Slice NamelivingWill
    Definition

    Category SNOMED code used for indexing/retrieval of the HCIM AdvanceDirective.


    A classification of the type of consents found in the statement. This element supports indexing and retrieval of consent statements.

    ShortLiving will and advance directive recordClassification of the consent statement - for indexing/retrieval
    Control10..1*
    BindingFor example codes, see Consent Category Codeshttp://hl7.org/fhir/ValueSet/consent-category
    (example to http://hl7.org/fhir/ValueSet/consent-category)

    A classification of the type of consents found in a consent statement

    TypeCodeableConcept
    Summarytrue
    Pattern Value{
      "coding" : [{
        "system" : "http://snomed.info/sct",
        "code" : "11341000146107"
      }]
    }
    16. Consent.category:typeOfLivingWill
    Slice NametypeOfLivingWill
    Definition

    List of the different types of living wills.


    A classification of the type of consents found in the statement. This element supports indexing and retrieval of consent statements.

    ShortTypeOfLivingWillClassification of the consent statement - for indexing/retrieval
    Control10..1*
    BindingThe codes SHALL be taken from For example codes, see WilsverklaringTypeCodelijsthttp://hl7.org/fhir/ValueSet/consent-category
    (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.7.15.1--20171231000000)

    List of the different types of living wills.


    A classification of the type of consents found in a consent statement

    TypeCodeableConcept
    Must Supporttrue
    Summarytrue
    Alternate NamesWilsverklaringType
    18. Consent.category:typeOfLivingWill.coding
    Definition

    A reference to a code defined by a terminology system.

    ShortCode defined by a terminology system
    Comments

    Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

    Control10..*
    TypeCoding
    Summarytrue
    Requirements

    Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

    20. Consent.category:typeOfLivingWill.coding.system
    Definition

    The identification of the code system that defines the meaning of the symbol in the code.

    ShortIdentity of the terminology system
    Comments

    The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

    Control10..1
    Typeuri
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to be unambiguous about the source of the definition of the symbol.

    22. Consent.category:typeOfLivingWill.coding.code
    Definition

    A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

    ShortSymbol in syntax defined by the system
    Control10..1
    Typecode
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need to refer to a particular code in the system.

    24. Consent.patient
    Definition

    The patient/healthcare consumer to whom this consent applies.

    ShortWho the consent applies to
    Comments

    Commonly, the patient the consent pertains to is the author, but for young and old people, it may be some other person.

    Control1..1
    TypeReference(nl-core-patient, Patient)
    Summarytrue
    26. Consent.dateTime
    Definition

    The date on which the living will was recorded.


    When this Consent was issued / created / indexed.

    ShortLivingWillDateWhen this Consent was created or indexed
    Comments

    This is not the time of the original consent, but the time that this statement was made or derived.

    Control10..1
    TypedateTime
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Must Supporttrue
    Summarytrue
    Alternate NamesWilsverklaringDatum
    28. Consent.consentingParty
    Definition

    The person who is the legal representative or is appointed as the authorized representative in the signed authorization.


    Either the Grantor, which is the entity responsible for granting the rights listed in a Consent Directive or the Grantee, which is the entity responsible for complying with the Consent Directive, including any obligations or limitations on authorizations and enforcement of prohibitions.

    ShortRepresentativeWho is agreeing to the policy and exceptions
    Comments

    Commonly, the patient the consent pertains to is the consentor, but particularly for young and old people, it may be some other person - e.g. a legal guardian.

    Control0..1*
    TypeReference(nl-core-relatedperson, Organization, Patient, Practitioner, RelatedPerson)
    Must Supporttrue
    Summarytrue
    Alternate Namesconsentor, Vertegenwoordiger
    30. Consent.source[x]
    Definition

    The source on which this consent statement is based. The source might be a scanned original paper form, or a reference to a consent that links back to such a source, a reference to a document repository (e.g. XDS) that stores the original consent document.

    ShortLivingWillDocumentSource from which this consent is taken
    Comments

    The source can be contained inline (Attachment), referenced directly (Consent), referenced in a consent repository (DocumentReference), or simply by an identifier (Identifier), e.g. a CDA document id.

    Control0..1
    TypeAttachment, Identifier, Reference(Consent, DocumentReference, Contract, QuestionnaireResponse)
    [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
    Summarytrue
    Alternate NamesWilsverklaringDocument
    SlicingThis element introduces a set of slices on Consent.source[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators:
    • type @ $this
    • 32. Consent.source[x]:sourceAttachment
      Slice NamesourceAttachment
      Definition

      The source on which this consent statement is based. The source might be a scanned original paper form, or a reference to a consent that links back to such a source, a reference to a document repository (e.g. XDS) that stores the original consent document.

      ShortLivingWillDocumentSource from which this consent is taken
      Comments

      The source can be contained inline (Attachment), referenced directly (Consent), referenced in a consent repository (DocumentReference), or simply by an identifier (Identifier), e.g. a CDA document id.

      Control0..1
      TypeAttachment, Identifier, Reference(Consent, DocumentReference, Contract, QuestionnaireResponse)
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      Must Supporttrue
      Summarytrue
      Alternate NamesWilsverklaringDocument
      34. Consent.source[x]:sourceAttachment.data
      Definition

      The actual data of the attachment - a sequence of bytes. In XML, represented using base64.

      ShortData inline, base64ed
      Comments

      The base64-encoded data SHALL be expressed in the same character set as the base resource XML or JSON.

      Control0..1
      Typebase64Binary
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Must Supporttrue
      Requirements

      The data needs to able to be transmitted inline.