Consolidated CDA (C-CDA)
4.0.0-ballot - STU4 Ballot United States of America flag

Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-ccda/ and changes regularly. See the Directory of published versions

Logical Model: MedicationDispense - Detailed Descriptions

Draft as of 2024-12-19

Definitions for the MedicationDispense logical model.

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

0. Supply
Logical ContainerClinicalDocument (CDA Class)
ValidationInstance of this type are validated by templateId
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsshould-text-ref-value: SHOULD contain text/reference/@value (text.reference.value.exists())
should-effectiveTime: SHOULD contain effectiveTime (effectiveTime.exists())
should-repeatNumber: SHOULD contain repeatNumber (repeatNumber.exists())
should-quantity: SHOULD contain quantity (quantity.exists())
2. Supply.templateId
Control1..?
SlicingThis element introduces a set of slices on Supply.templateId. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ root
  • value @ extension
  • 4. Supply.templateId:med-dispense
    Slice Namemed-dispense
    Control1..1
    6. Supply.templateId:med-dispense.root
    Control1..?
    Pattern Value2.16.840.1.113883.10.20.22.4.18
    8. Supply.templateId:med-dispense.extension
    Control1..?
    Pattern Value2023-05-01
    10. Supply.classCode
    Comments

    SHALL contain exactly one [1..1] @classCode="SPLY" (CodeSystem: HL7ActClass urn:oid:2.16.840.1.113883.5.6 STATIC) (CONF:4537-7451).

    12. Supply.moodCode
    Comments

    SHALL contain exactly one [1..1] @moodCode="EVN" (CodeSystem: HL7ActMood urn:oid:2.16.840.1.113883.5.1001 STATIC) (CONF:4537-7452).

    Fixed ValueEVN
    14. Supply.id
    Comments

    SHALL contain at least one [1..*] id (CONF:4537-7454).

    Control1..?
    16. Supply.code
    ShortThe CDA base standard limits codes that can be used at CDA supply.statusCode which do not represent typical medication dispense statuses. In order to provide correct domain vocabulary and align with FHIR, CDA supply.statusCode is fixed to completed and the FHIR MedicationDispense status value set is used at supply.code.
    Comments

    SHALL contain exactly one [1..1] code, which SHALL be selected from ValueSet MedicationDispense Status Codes urn:oid:2.16.840.1.113883.4.642.3.1312 DYNAMIC (CONF:4537-32974).

    Control1..?
    BindingThe codes SHALL be taken from MedicationDispenseStatusCodes
    (required to http://hl7.org/fhir/ValueSet/medicationdispense-status)
    18. Supply.text
    ShortSHOULD reference the portion of section narrative text corresponding to this entry
    20. Supply.text.reference
    Invariantsvalue-starts-octothorpe: If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative (value.exists() implies value.startsWith('#'))
    22. Supply.statusCode
    Comments

    SHALL contain exactly one [1..1] statusCode (CONF:4537-7455).

    Control1..?
    24. Supply.statusCode.code
    Comments

    This statusCode SHALL contain exactly one [1..1] @code="completed" Completed (CodeSystem: HL7ActStatus urn:oid:2.16.840.1.113883.5.14 STATIC) (CONF:4537-32361).

    Control1..?
    Fixed Valuecompleted
    26. Supply.effectiveTime
    Comments

    SHOULD contain zero or one [0..1] effectiveTime (CONF:4537-7456).

    Control0..1
    28. Supply.repeatNumber
    ShortIn "EVN" (event) mood, the repeatNumber is the number of dispenses. For example, a repeatNumber of "3" indicates the third dispense.
    Comments

    SHOULD contain zero or one [0..1] repeatNumber (CONF:4537-7457).

    30. Supply.quantity
    Comments

    SHOULD contain zero or one [0..1] quantity (CONF:4537-7458).

    32. Supply.product
    Control1..?
    34. Supply.product.manufacturedProduct
    Comments

    The product, if present, SHALL contain exactly one [1..1] Medication Information (identifier: urn:hl7ii:2.16.840.1.113883.10.20.22.4.23:2014-06-09) (CONF:4537-15607).

    Typehttp://hl7.org/cda/stds/core/StructureDefinition/ManufacturedProduct(Medication Information, Immunization Medication Information)
    36. Supply.performer
    Comments

    MAY contain zero or one [0..1] performer (CONF:4537-7461).

    Control0..1
    38. Supply.performer.assignedEntity
    Comments

    The performer, if present, SHALL contain exactly one [1..1] assignedEntity (CONF:4537-7467).

    Invariantsshould-addr: SHOULD contain addr (addr.exists())
    40. Supply.performer.assignedEntity.addr
    Comments

    This assignedEntity SHOULD contain zero or one [0..1] US Realm Address (AD.US.FIELDED) (identifier: urn:oid:2.16.840.1.113883.10.20.22.5.2) (CONF:4537-7468).

    Control0..1
    Typehttp://hl7.org/cda/stds/core/StructureDefinition/AD(US Realm Address)
    42. Supply.entryRelationship
    Comments

    MAY contain zero or one [0..1] entryRelationship (CONF:4537-7473) such that it

    SlicingThis element introduces a set of slices on Supply.entryRelationship. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • profile @ supply
    • value @ typeCode
    • 44. Supply.entryRelationship:entryRelationship1
      Slice NameentryRelationship1
      ShortentryRelationship
      Control0..1
      46. Supply.entryRelationship:entryRelationship1.typeCode
      Comments

      SHALL contain exactly one [1..1] @typeCode="REFR" (CodeSystem: HL7ActRelationshipType urn:oid:2.16.840.1.113883.5.1002 STATIC) (CONF:4537-7474).

      Fixed ValueREFR
      48. Supply.entryRelationship:entryRelationship1.supply
      Comments

      SHALL contain exactly one [1..1] Medication Supply Order (identifier: urn:hl7ii:2.16.840.1.113883.10.20.22.4.17:2014-06-09) (CONF:4537-15606).

      Control1..?
      Typehttp://hl7.org/cda/stds/core/StructureDefinition/Supply(Medication Supply Order)