Examples
Medication
For the scope of M1, a dummy Medication resource is created for every Substance resource created with a reference to it.
Note: In FHIR STU3 there is no identifier element in the Medication resource. So only the internal id serves as the unique identifier. For M1, a Medication reosurce should only be created when a Substance resource is created. i.e. there will be one Medication resource for each substance resource. When we implement the next milestones, we may need to consider other elements for defining de-duplication rules.
{
"resourceType": "Medication",
"id": "medicationB02BC05", // ATC code will be used for dummy medication
"meta": {
"profile": [
"http://roche.com/fhir/rdc/StructureDefinition/medication"
]
},
"ingredient": [
{
"itemReference": {
"reference": "Substance/substanceB02BC05" // active substances are linked
}
}
]
}
For the scope of M3, a Medication resource is created for commercial medications and relevant existing Substance (including compound substance available in database) resource in fhirserver will be reference to it.
{
"resourceType": "Medication",
"id": "medication209247", // Rxcui code will be used for branded
"meta": {
"profile": [
"http://roche.com/fhir/rdc/StructureDefinition/medication"
]
},
"isBrand": true,
"code": {
"text": "acarbose 50 MG Oral Tablet [Precose]", // branded name will be mapped
},
"ingredient": [
{
"itemReference": {
"reference": "Substance/substanceA10BF01" // active or compound substances are linked
}
}
]
}
Medication Request
The below sample describes a Medication request
Note: The FHIR standard allows many different formats for the timing element. However, in this implementation the timing format assumed is "frequency" times in a particular "period" between "boundsPeriod". For example, 3 times a day between 2020-08-03 and 2020-08-06. If other formats are also required please let us know.
{
"resourceType": "MedicationRequest",
"meta": { //url of the profile to which this resource conforms to
"profile": [
"http://roche.com/fhir/rdc/StructureDefinition/practitioner-recorded-medicationrequest"
]
},
"identifier": [
{
"system": "http://roche.com/fhir/rdc/sid/medicationrequest/therapies", //static value - system for the identifier
"value": "<organization-id>/<patient-id>/<authoredOn>" //should contain the unique identifier from the source for the medication request
}
],
"status": "active", //possible values - active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown
"intent": "plan", //possible values - proposal | order | instance-order
"medicationReference": {
"reference": "Medication/medicationB02BC05" //reference to the medication resource
},
"subject": {
"reference": "Patient/1234" //reference to the patient resource
},
"authoredOn": "2020-08-03T12:15:00.000Z", //timestamp when the prescription was initially made
"requester": {
"agent": {
"identifier": {
"system": "http://roche.com/rdc/sid/organization", // organization/CenterId identifier system
"value": "285995" // organization/CenterId identifier value
}
}
},
"note": [ //General note about the Medication request by the practitioner
{
"time": "2020-08-03T12:15:00.000Z",
"text": "Patient needs to take medication to aliviate pain"
}
],
"dosageInstruction": [ // there can be one or more dosageInstructions
{
"patientInstruction": "before meals", //specific notes for that particular dosage instruction
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-08-03", //start date of the dosage
"end": "2020-08-06" //end date of the dosage
},
"frequency": 3, //frequency of the dose per "period". In this sample 3 times in 1 day
"period": 1, //period considered for the frequency
"periodUnit": "d" //unit of the period. In this sample days.
}
},
"route": { //possible routes are available in the table below
"coding": [
{
"system": "http://snomed.info/sct",
"code": "738956005",
"display": "Oral (intended site)"
}
]
},
"doseQuantity": {
"value": "50", //quantity of dose
"unit": "mg", //possible units are available in the table below
"system": "http://unitsofmeasure.org",
"code": "mg" //same as unit above
}
}
],
"extension": [
{
"url": "http://roche.com/fhir/rdc/StructureDefinition/provenance-channel",
"valueString": "<channel-name>"
},
{
"url": "http://roche.com/fhir/rdc/StructureDefinition/provenance-source",
"valueString": "<source-name>"
}
]
}
Codes for possible routes
| Route | system | code | display |
|---|---|---|---|
| Implant | http://snomed.info/sct | 827107003 | Implant (administration method) |
| Inhalation | http://snomed.info/sct | 740666001 | Inhale (administration method) |
| Instillation | http://snomed.info/sct | 738994005 | Instill (administration method) |
| nasal | http://snomed.info/sct | 738948007 | Nasal (intended site) |
| oral | http://snomed.info/sct | 738956005 | Oral (intended site) |
| parenteral | http://snomed.info/sct | 738984000 | Parenteral (intended site) |
| rectal | http://snomed.info/sct | 738986003 | Rectal (intended site) |
| sublingual/buccal/oromucosal | http://snomed.info/sct | 738982001 | Oromucosal (intended site) |
| transdermal | http://snomed.info/sct | 738987007 | Transdermal (intended site) |
| vaginal | http://snomed.info/sct | 738989005 | Vaginal (intended site) |
Codes for possible units
| Unit | system | code |
|---|---|---|
| g | http://unitsofmeasure.org | g |
| mg | http://unitsofmeasure.org | mg |
| mcg (microgram) | http://unitsofmeasure.org | ug |
| U | http://unitsofmeasure.org | U |
| TU (Thousand units) | http://unitsofmeasure.org | kU |
| MU (Million units) | http://roche.com/fhir/rdc/cs | MU |
| mmol | http://unitsofmeasure.org | mmol |
| ml | http://unitsofmeasure.org | mL |
Substance
The below sample describes a substance which is a reference to Medication resource.
NOTE : For the scope of M1, substance resource will store only simple substances with ATC codes.
{
"resourceType": "Substance",
"id": "substanceB02BC05",
"meta": {
"profile": [
"http://roche.com/fhir/rdc/StructureDefinition/substance"
]
},
"identifier": [
{
"system": "http://roche.com/fhir/rdc/sid/substance/therapies",
"value": "B02BC05"
}
],
"status": "active",
"code": {
"coding": [
{
"system": "http://www.whocc.no/atc",
"code": "B02BC05",
"display": "adrenalone"
}
]
}
}
Practitioner
The Practitioner resource stored on FHIRSTACK is an empty resource having only the FHIR ID.