OncologyMedicationDispense

Introduction

The OncologyMedicationDispense FHIR API is used to receive Medication Dispense related data from external pharmacy system which is specialized in cancer related drug preparations.Each MedicationDispense resource represents a single medication administration occasion. This profile is based on the FHIR resource MedicationDispense.

Intended Use

This profile is created as the main profile for the communication of information related to dispensation of cancer related drug data of patients.

Specific Rules and Limitations

Profile Overview

Oncology MedicationDispense Profile

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdS Σ0..1id
lastUpdatedS Σ0..1instant
sourceΣ0..1uri
profileS Σ1..1canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
containedS0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemS Σ0..1uri
valueS Σ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
partOfI0..*Reference(Procedure)
statusS Σ ?!1..1codeBinding
statusReasonCodeableConceptCodeableConcept
category0..1CodeableConceptBinding
medicationCodeableConceptCodeableConcept
subjectΣ I1..1Reference(Patient | Group)
contextI0..1Reference(Encounter | EpisodeOfCare)
supportingInformationS I1..*Reference(Resource)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
function0..1CodeableConcept
actorI1..1Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson)
locationS I0..1Reference(Location)
id0..1string
extensionI0..*Extension
referenceΣ I1..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
type0..1CodeableConcept
quantityI0..1SimpleQuantity
daysSupplyI0..1SimpleQuantity
whenPreparedΣ0..1dateTime
whenHandedOverS0..1dateTime
destinationS I0..1Reference(Location)
receiverS I0..1Reference(Patient | Practitioner)
noteS0..1Annotation
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceΣ0..1integer
textΣ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventS Σ0..1dateTime
id0..1string
extensionI0..*Extension
boundsDurationDuration
boundsRangeRange
boundsPeriodPeriod
countΣ0..1positiveInt
countMaxΣ0..1positiveInt
durationΣ0..1decimal
durationMaxΣ0..1decimal
durationUnitΣ0..1codeBinding
frequencyΣ0..1positiveInt
frequencyMaxΣ0..1positiveInt
periodΣ0..1decimal
periodMaxΣ0..1decimal
periodUnitΣ0..1codeBinding
dayOfWeekΣ0..*codeBinding
timeOfDayS Σ0..1time
whenΣ0..*codeBinding
offsetΣ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
codingS Σ0..1Coding
textΣ0..1string
id0..1string
extensionI0..*Extension
codingS Σ0..1Coding
textΣ0..1string
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
doseQuantitySimpleQuantity
rateQuantitySimpleQuantity
maxDosePerPeriodΣ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
wasSubstituted1..1boolean
type0..1CodeableConcept
reason0..*CodeableConcept
responsiblePartyI0..*Reference(Practitioner | PractitionerRole)
detectedIssueI0..*Reference(DetectedIssue)
eventHistoryI0..*Reference(Provenance)

Versions

COS version Profile version Required COSMIC version Date Description
4.1.0 1.0.0 COSMIC 3.12.0 March 2024 Initial version

Statuses

FHIR status Status Description
Preparation FHIR status "Preparation" should be sent when drug preparation is planned but has not yet started.
In progress FHIR status "In progress" should be sent when preparation has begun.
Stopped FHIR status "Stopped" should be sent when preparation work being permanently stopped.
Completed FHIR status "Completed" should be sent when preparation is done and and the prepared drug is ready to be shipped.
Entered-in-error FHIR status "Entered-in-error" should be sent when previous MedicationDispense status was entered in error and therefore nullified.

ValueSet

The profile includes bindings to the following FHIR defined value sets:

CodeSystem

Dispense status

ValueSet

substance Administration

ValueSet

Substance administration status reason

ValueSet

External value sets/Code systems used

http://electronichealth.se/fhir/NamingSystem/nplid

https://nsl.mpa.se

http://www.whocc.no/atc

http://unitsofmeasure.org

https://www.gs1.org/gtin

http://ehalsomyndigheten.se/attributes/pharmacyIdentifier

Supported Operations

HTTP Methods

Method Description
POST Support for updating occassion related information for a patient.

Query Operations

Query Parameters

N/A

Supported Queries

  1. POST [baseURL]/api/open/fhir/MedicationDispense

Supported Operations

Supported SearchInclude Operations

N/A

Supported RevInclude Operations

N/A

Error Codes

No specific error codes for MedicationDispenseDoseDispensing. For common codes, refer to Error handling section.