Medication Request

Concept

A medication request is a prescriber’s proposal for a patient to use medication. A request to discontinue the use of medication is also a medication request.

Purpose

The goal of the medication request is to provide insight into the agreements reached between the prescriber and the patient on the use of medication.

Profiles

zib-MedicationAgreement

The FHIR resource MedicationRequest is defined as MedicationAgreement by the Dutch Health and Care Information models or HCIM/ZIB (Dutch: Zorginformatiebouwsteen or ZIB) MedicationAgreement

The MedicationRequest resource in NCare is exchanged according to the FHIR HCIM MedicationAgreement profile

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textI0..1Narrative
contained0..*Resource
periodOfUseI0..1Extension
usageDurationI0..1Extension
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodeableConcept0..1CodeableConceptBinding
medicationTreatmentI0..1Extension
nl-core-episodeofcareI0..*Extension
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodeableConcept0..1CodeableConceptBinding
repeatPeriodCyclicalSchedule?! I0..1Extension
identifier0..*Identifier
definitionΣ I0..*Reference(http://hl7.org/fhir/StructureDefinition/ActivityDefinition | http://hl7.org/fhir/StructureDefinition/PlanDefinition)
basedOnΣ I0..*Reference(http://hl7.org/fhir/StructureDefinition/CarePlan | http://hl7.org/fhir/StructureDefinition/MedicationRequest | http://hl7.org/fhir/StructureDefinition/ProcedureRequest | http://hl7.org/fhir/StructureDefinition/ReferralRequest)
groupIdentifierΣ0..1Identifier
statusΣ ?!0..1codeBinding
intentΣ ?!1..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ0..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
priorityΣ0..1codeBinding
medicationReferenceΣ1..1Reference(http://nictiz.nl/fhir/StructureDefinition/zib-Product)
subjectΣ I1..1Reference(http://fhir.nl/fhir/StructureDefinition/nl-core-patient | http://hl7.org/fhir/StructureDefinition/Group)
contextI0..1Reference(http://nictiz.nl/fhir/StructureDefinition/zib-Encounter | http://fhir.nl/fhir/StructureDefinition/nl-core-episodeofcare)
supportingInformationI0..*Reference(http://hl7.org/fhir/StructureDefinition/Resource)
authoredOnΣ1..1dateTime
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
practitionerRoleI0..1Extension
referenceΣ I0..1string
identifierΣ0..1Identifier
displayΣ0..1string
onBehalfOfΣ I0..1Reference(http://fhir.nl/fhir/StructureDefinition/nl-core-organization)
id0..1string
practitionerRoleI0..1Extension
referenceΣ I0..1string
identifierΣ0..1Identifier
displayΣ0..1string
reasonCode0..*CodeableConceptBinding
reasonReferenceI0..*Reference(http://hl7.org/fhir/StructureDefinition/Observation | http://nictiz.nl/fhir/StructureDefinition/zib-Problem)
note0..*Annotation
dosageInstruction0..*http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
validityPeriodI0..1Period
numberOfRepeatsAllowed0..1positiveInt
quantityI0..1http://hl7.org/fhir/StructureDefinition/SimpleQuantity
expectedSupplyDurationI0..1Duration
performerI0..1Reference(http://hl7.org/fhir/StructureDefinition/Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
allowed?!1..1boolean
reason0..1CodeableConcept
priorPrescriptionI0..1Reference(http://hl7.org/fhir/StructureDefinition/MedicationRequest)
detectedIssueI0..*Reference(http://hl7.org/fhir/StructureDefinition/DetectedIssue)
eventHistoryI0..*Reference(http://hl7.org/fhir/StructureDefinition/Provenance)

Custom rules

Supported properties

The properties of zib-MedicationAgreement that we support are:

  • extension.periodOfUse
  • extension.usageDuration
  • status
  • intent
  • category
  • medicationReference
  • subject
  • authoredOn
  • requester
  • note
  • dosageInstruction

From the property dosageInstruction, only the following sub-properties are supported:

  • additionalInstruction
  • timing.repeat.bounds
  • timing.repeat.frequency
  • timing.repeat.period
  • timing.repeat.periodUnit
  • timing.repeat.dayOfWeek
  • timing.repeat.timeOfDay
  • asNeededCodeableConcept
  • route
  • doseQuantity

REST API

API Supported Command Comment
read yes GET /MedicationRequest/
vread no If a version is specified, we ignore it, the latest version is always returned
update no
update with optimistic locking no
update (conditional) no
patch no
patch (conditional) no
delete no
delete (conditional) no
history no
create no
create (conditional) no
search yes GET /MedicationRequest?[search parameters] See Overview of FHIR Search.
chained search no chained searches are not supported atm
reverse chained search no chained searches are not supported atm
batch no
transaction no
paging no
intermediaries no

Example

{
    "resourceType": "MedicationRequest",
    "id": "50556",
    "meta": {
        "lastUpdated": "2021-10-04T09:22:44.367+02:00",
        "profile": [
            "http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement"
        ],
        "versionId": "ticks/637689361643670000"
    },
    "extension": [
        {
            "url": "http://nictiz.nl/fhir/StructureDefinition/zib-Medication-PeriodOfUse",
            "valuePeriod": {
                "start": "2021-10-04T09:22:44.39+02:00",
                "end": "2021-10-31T00:00:00+02:00"
            }
        },
        {
            "url": "http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse-Duration",
            "valueDuration": {
                "value": 26.6092084490741,
                "unit": "day",
                "system": "http://unitsofmeasure.org",
                "code": "d"
            }
        }
    ],
    "status": "active",
    "intent": "order",
    "category": {
        "coding": [
            {
                "system": "http://hl7.org/fhir/medication-request-category",
                "code": "inpatient"
            }
        ]
    },
    "medicationReference": {
        "reference": "Medication/ArticleGroup.3931",
        "display": "PARACETAMOL KAUWTABLET 120MG"
    },
    "subject": {
        "reference": "Patient/20422306",
        "display": "Engel"
    },
    "authoredOn": "2021-10-04T10:22:44.367+02:00",
    "requester": {
        "agent": {
            "reference": "User/3975",
            "display": "_michael"
        }
    },
    "note": [
        {
            "text": "Volg schema"
        }
    ],
    "dosageInstruction": [
        {
            "additionalInstruction": [
                {
                    "coding": [
                        {
                            "system": "https://referentiemodel.nhg.org/tabellen/nhg-tabel-25-gebruiksvoorschrift#aanvullend-numeriek",
                            "code": "193"
                        }
                    ],
                    "text": "De tablet mag worden fijngemalen"
                }
            ],
            "timing": {
                "repeat": {
                    "boundsPeriod": {
                        "start": "2021-10-04T09:22:44.39+02:00",
                        "end": "2021-10-31T00:00:00+02:00"
                    },
                    "frequency": 1,
                    "period": 1.00,
                    "periodUnit": "d",
                    "timeOfDay": [
                        "12:00"
                    ]
                }
            },
            "asNeededCodeableConcept": {
                "coding": [
                    {
                        "system": "https://referentiemodel.nhg.org/tabellen/nhg-tabel-25-gebruiksvoorschrift#aanvullend-numeriek",
                        "code": "1137"
                    }
                ],
                "text": "zo nodig"
            },
            "route": {
                "coding": [
                    {
                        "system": "urn:oid:2.16.840.1.113883.2.4.4.9",
                        "code": "9"
                    }
                ],
                "text": "ORAAL"
            },
            "doseQuantity": {
                "value": 1.00,
                "unit": "STUK",
                "system": "urn:oid:2.16.840.1.113883.2.4.4.1.900.2",
                "code": "245"
            }
        }
    ]
}