This page is part of the CCDA: Consolidated CDA Release (v4.0.0: CCDA 4.0) generated with FHIR (HL7® FHIR® Standard) v5.0.0. This is the current published version. For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/MedicationSupplyOrder | Version: 4.0.0 | |||
Draft as of 2025-06-20 | Computable Name: MedicationSupplyOrder | |||
Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:hl7ii:2.16.840.1.113883.10.20.22.4.17:2014-06-09 |
This template records the intent to supply a patient with medications.
Although open templates may contain any valid CDA content, the following templates are specifically called out by this template:
Optional EntryRelationships: InstructionObservation
Usages:
Changes since version 3.0.0:
Description of Template, Differentials, Snapshots and how the different presentations work.
This structure is derived from Supply
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..1 | Supply | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, text, statusCode, effectiveTime, priorityCode, repeatNumber, independentInd, quantity, expectedUseTime, product, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1 Base for all types and resources Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: should-text-ref-value, should-repeatNumber, should-quantity |
![]() ![]() ![]() |
1..* | II | Slice: Unordered, Open by value:root, value:extension | |
![]() ![]() ![]() ![]() |
1..1 | II | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.17 | |
![]() ![]() ![]() ![]() ![]() |
1..1 | st | Required Pattern: 2014-06-09 | |
![]() ![]() ![]() |
1..1 | cs | ||
![]() ![]() ![]() |
1..1 | cs | Fixed Value: INT | |
![]() ![]() ![]() |
1..* | II | ||
![]() ![]() ![]() |
0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
![]() ![]() ![]() ![]() |
C | 0..1 | TEL | Constraints: value-starts-octothorpe |
![]() ![]() ![]() |
1..1 | CS | ||
![]() ![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() ![]() |
1..1 | cs | Binding: ActStatus (required) | |
![]() ![]() ![]() |
0..* | SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS | Slice: Unordered, Open by exists:high | |
![]() ![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | IVXB_TS | ||
![]() ![]() ![]() |
0..1 | IVL_INT | In "INT" (intent) mood, the repeatNumber defines the number of allowed supplies. For example, a repeatNumber of "3" means that the substance can be supplied up to 3 times. | |
![]() ![]() ![]() |
0..1 | PQ | ||
![]() ![]() ![]() |
0..1 | InfrastructureRoot | ||
![]() ![]() ![]() ![]() |
1..1 | MedicationInformation, ImmunizationMedicationInformation | ||
![]() ![]() ![]() |
0..1 | Author | ||
![]() ![]() ![]() |
0..1 | EntryRelationship | ||
![]() ![]() ![]() ![]() |
1..1 | cs | Fixed Value: SUBJ | |
![]() ![]() ![]() ![]() |
1..1 | bl | Fixed Value: true | |
![]() ![]() ![]() ![]() |
1..1 | InstructionObservation | ||
![]() |
Path | Conformance | ValueSet | URI |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus |
Id | Grade | Path(s) | Details | Requirements |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Path | Conformance | ValueSet / Code | URI |
Supply.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.templateId:med-supplyOrder.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.classCode | required | Fixed Value: SPLYhttp://terminology.hl7.org/ValueSet/v3-ActClassSupply | |
Supply.moodCode | required | Fixed Value: INThttp://terminology.hl7.org/ValueSet/v3-xDocumentSubstanceMood|2.0.0 | |
Supply.code | example | ActCodehttp://terminology.hl7.org/ValueSet/v3-ActCode | |
Supply.text.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.text.compression | required | CDACompressionAlgorithmhttp://hl7.org/cda/stds/core/ValueSet/CDACompressionAlgorithm | |
Supply.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithmhttp://terminology.hl7.org/ValueSet/v3-IntegrityCheckAlgorithm|2.0.0 | |
Supply.text.mediaType | example | MediaTypehttp://terminology.hl7.org/ValueSet/v3-MediaType | |
Supply.text.representation | required | BinaryDataEncodinghttp://hl7.org/cda/stds/core/ValueSet/BinaryDataEncoding | |
Supply.statusCode | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.effectiveTime:when.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.effectiveTime:when.operator | required | CDASetOperatorhttp://hl7.org/cda/stds/core/ValueSet/CDASetOperator | |
Supply.priorityCode | example | ActPriorityhttp://terminology.hl7.org/ValueSet/v3-ActPriority | |
Supply.product.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeCode | required | Fixed Value: PRDhttp://terminology.hl7.org/ValueSet/v3-ParticipationTargetDirect | |
Supply.entryRelationship.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeCode | required | Fixed Value: SUBJhttp://terminology.hl7.org/ValueSet/v3-xActRelationshipEntryRelationship |
Id | Grade | Path(s) | Details | Requirements |
II-1 | error | Supply.typeId, Supply.product.typeId, Supply.entryRelationship.typeId | An II instance must have either a root or an nullFlavor. : root.exists() or nullFlavor.exists() | |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Path | Conformance | ValueSet / Code | URI |
Supply.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.templateId:med-supplyOrder.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.classCode | required | Fixed Value: SPLYhttp://terminology.hl7.org/ValueSet/v3-ActClassSupply | |
Supply.moodCode | required | Fixed Value: INThttp://terminology.hl7.org/ValueSet/v3-xDocumentSubstanceMood|2.0.0 | |
Supply.code | example | ActCodehttp://terminology.hl7.org/ValueSet/v3-ActCode | |
Supply.text.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.text.compression | required | CDACompressionAlgorithmhttp://hl7.org/cda/stds/core/ValueSet/CDACompressionAlgorithm | |
Supply.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithmhttp://terminology.hl7.org/ValueSet/v3-IntegrityCheckAlgorithm|2.0.0 | |
Supply.text.mediaType | example | MediaTypehttp://terminology.hl7.org/ValueSet/v3-MediaType | |
Supply.text.representation | required | BinaryDataEncodinghttp://hl7.org/cda/stds/core/ValueSet/BinaryDataEncoding | |
Supply.statusCode | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.effectiveTime:when.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.effectiveTime:when.operator | required | CDASetOperatorhttp://hl7.org/cda/stds/core/ValueSet/CDASetOperator | |
Supply.priorityCode | example | ActPriorityhttp://terminology.hl7.org/ValueSet/v3-ActPriority | |
Supply.product.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeCode | required | Fixed Value: PRDhttp://terminology.hl7.org/ValueSet/v3-ParticipationTargetDirect | |
Supply.entryRelationship.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeCode | required | Fixed Value: SUBJhttp://terminology.hl7.org/ValueSet/v3-xActRelationshipEntryRelationship |
Id | Grade | Path(s) | Details | Requirements |
II-1 | error | Supply.typeId, Supply.product.typeId, Supply.entryRelationship.typeId | An II instance must have either a root or an nullFlavor. : root.exists() or nullFlavor.exists() | |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
This structure is derived from Supply
Summary
Mandatory: 7 elements(3 nested mandatory elements)
Fixed: 3 elements
Prohibited: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Differential View
This structure is derived from Supply
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..1 | Supply | XML Namespace: urn:hl7-org:v3 Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId, @classCode, @moodCode, id, code, text, statusCode, effectiveTime, priorityCode, repeatNumber, independentInd, quantity, expectedUseTime, product, subject, specimen, performer, author, informant, participant, entryRelationship, reference, precondition, sdtcInFulfillmentOf1 Base for all types and resources Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: should-text-ref-value, should-repeatNumber, should-quantity |
![]() ![]() ![]() |
1..* | II | Slice: Unordered, Open by value:root, value:extension | |
![]() ![]() ![]() ![]() |
1..1 | II | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.17 | |
![]() ![]() ![]() ![]() ![]() |
1..1 | st | Required Pattern: 2014-06-09 | |
![]() ![]() ![]() |
1..1 | cs | ||
![]() ![]() ![]() |
1..1 | cs | Fixed Value: INT | |
![]() ![]() ![]() |
1..* | II | ||
![]() ![]() ![]() |
0..1 | ED | SHOULD reference the portion of section narrative text corresponding to this entry | |
![]() ![]() ![]() ![]() |
C | 0..1 | TEL | Constraints: value-starts-octothorpe |
![]() ![]() ![]() |
1..1 | CS | ||
![]() ![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() ![]() |
1..1 | cs | Binding: ActStatus (required) | |
![]() ![]() ![]() |
0..* | SXCM_TS, IVL_TS, EIVL_TS, PIVL_TS, SXPR_TS | Slice: Unordered, Open by exists:high | |
![]() ![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | IVXB_TS | ||
![]() ![]() ![]() |
0..1 | IVL_INT | In "INT" (intent) mood, the repeatNumber defines the number of allowed supplies. For example, a repeatNumber of "3" means that the substance can be supplied up to 3 times. | |
![]() ![]() ![]() |
0..1 | PQ | ||
![]() ![]() ![]() |
0..1 | InfrastructureRoot | ||
![]() ![]() ![]() ![]() |
1..1 | MedicationInformation, ImmunizationMedicationInformation | ||
![]() ![]() ![]() |
0..1 | Author | ||
![]() ![]() ![]() |
0..1 | EntryRelationship | ||
![]() ![]() ![]() ![]() |
1..1 | cs | Fixed Value: SUBJ | |
![]() ![]() ![]() ![]() |
1..1 | bl | Fixed Value: true | |
![]() ![]() ![]() ![]() |
1..1 | InstructionObservation | ||
![]() |
Path | Conformance | ValueSet | URI |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus |
Id | Grade | Path(s) | Details | Requirements |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Key Elements View
Path | Conformance | ValueSet / Code | URI |
Supply.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.templateId:med-supplyOrder.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.classCode | required | Fixed Value: SPLYhttp://terminology.hl7.org/ValueSet/v3-ActClassSupply | |
Supply.moodCode | required | Fixed Value: INThttp://terminology.hl7.org/ValueSet/v3-xDocumentSubstanceMood|2.0.0 | |
Supply.code | example | ActCodehttp://terminology.hl7.org/ValueSet/v3-ActCode | |
Supply.text.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.text.compression | required | CDACompressionAlgorithmhttp://hl7.org/cda/stds/core/ValueSet/CDACompressionAlgorithm | |
Supply.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithmhttp://terminology.hl7.org/ValueSet/v3-IntegrityCheckAlgorithm|2.0.0 | |
Supply.text.mediaType | example | MediaTypehttp://terminology.hl7.org/ValueSet/v3-MediaType | |
Supply.text.representation | required | BinaryDataEncodinghttp://hl7.org/cda/stds/core/ValueSet/BinaryDataEncoding | |
Supply.statusCode | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.effectiveTime:when.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.effectiveTime:when.operator | required | CDASetOperatorhttp://hl7.org/cda/stds/core/ValueSet/CDASetOperator | |
Supply.priorityCode | example | ActPriorityhttp://terminology.hl7.org/ValueSet/v3-ActPriority | |
Supply.product.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeCode | required | Fixed Value: PRDhttp://terminology.hl7.org/ValueSet/v3-ParticipationTargetDirect | |
Supply.entryRelationship.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeCode | required | Fixed Value: SUBJhttp://terminology.hl7.org/ValueSet/v3-xActRelationshipEntryRelationship |
Id | Grade | Path(s) | Details | Requirements |
II-1 | error | Supply.typeId, Supply.product.typeId, Supply.entryRelationship.typeId | An II instance must have either a root or an nullFlavor. : root.exists() or nullFlavor.exists() | |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
Snapshot View
Path | Conformance | ValueSet / Code | URI |
Supply.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.templateId:med-supplyOrder.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.classCode | required | Fixed Value: SPLYhttp://terminology.hl7.org/ValueSet/v3-ActClassSupply | |
Supply.moodCode | required | Fixed Value: INThttp://terminology.hl7.org/ValueSet/v3-xDocumentSubstanceMood|2.0.0 | |
Supply.code | example | ActCodehttp://terminology.hl7.org/ValueSet/v3-ActCode | |
Supply.text.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.text.compression | required | CDACompressionAlgorithmhttp://hl7.org/cda/stds/core/ValueSet/CDACompressionAlgorithm | |
Supply.text.integrityCheckAlgorithm | required | IntegrityCheckAlgorithmhttp://terminology.hl7.org/ValueSet/v3-IntegrityCheckAlgorithm|2.0.0 | |
Supply.text.mediaType | example | MediaTypehttp://terminology.hl7.org/ValueSet/v3-MediaType | |
Supply.text.representation | required | BinaryDataEncodinghttp://hl7.org/cda/stds/core/ValueSet/BinaryDataEncoding | |
Supply.statusCode | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.statusCode.code | required | ActStatushttp://terminology.hl7.org/ValueSet/v3-ActStatus | |
Supply.effectiveTime:when.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.effectiveTime:when.operator | required | CDASetOperatorhttp://hl7.org/cda/stds/core/ValueSet/CDASetOperator | |
Supply.priorityCode | example | ActPriorityhttp://terminology.hl7.org/ValueSet/v3-ActPriority | |
Supply.product.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.product.typeCode | required | Fixed Value: PRDhttp://terminology.hl7.org/ValueSet/v3-ParticipationTargetDirect | |
Supply.entryRelationship.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeId.nullFlavor | required | CDANullFlavorhttp://hl7.org/cda/stds/core/ValueSet/CDANullFlavor | |
Supply.entryRelationship.typeCode | required | Fixed Value: SUBJhttp://terminology.hl7.org/ValueSet/v3-xActRelationshipEntryRelationship |
Id | Grade | Path(s) | Details | Requirements |
II-1 | error | Supply.typeId, Supply.product.typeId, Supply.entryRelationship.typeId | An II instance must have either a root or an nullFlavor. : root.exists() or nullFlavor.exists() | |
should-quantity | warning | Supply | SHOULD contain quantity : quantity.exists() | |
should-repeatNumber | warning | Supply | SHOULD contain repeatNumber : repeatNumber.exists() | |
should-text-ref-value | warning | Supply | SHOULD contain text/reference/@value : text.reference.value.exists() | |
value-starts-octothorpe | error | Supply.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative : value.exists() implies value.startsWith('#') |
This structure is derived from Supply
Summary
Mandatory: 7 elements(3 nested mandatory elements)
Fixed: 3 elements
Prohibited: 1 element
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices: