Patient medication uses several FHIR bundles to cover all aspects-
- Medication with name, description, identifier (PZN)
- MedicationStatement (permanent medication) with relation between medication and patient
- MedicationRequest (prescription) with dosage, dispense, substitution (aut-idem) and physician authorization
Medication
Medication represents a pharmaceutical product assigned to a patient. Medications are assigned to a patient and may be searched. A search request for patient medication returns a bundle of one or more FHIR items of type KBV_PR_AW_Medikament.
{{baseURL}}/{{tenant}}/Medication?page=1&subject=Patient/6006
Example: this search requests fetches all Medications of patient 6006 using paging to limit the number of results
Data of a specific medication may be fetched using a read request with the identifier of the specific medication. The request returns a FHIR item of type KBV_PR_AW_Medikament.
{{baseURL}}/{{tenant}}/Medication/egMNGiQHERUmzlrP
Example: this read request returns the FHIR item for a medication item with ID egMNGiQHERUmzlrP. The ID may be retrieved by a search request sent before this request.
<Medication xmlns="http://hl7.org/fhir"> <id value="egMNGiQHERUmzlrP"/> <meta> <versionId value="1"/> <lastUpdated value="2022-08-03T18:44:24+00:00"/> <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Medikament|1.2.0"/> </meta> <text> <status value="extensions"/> <div xmlns="http://www.w3.org/1999/xhtml">Medikament von PatientLuca Fink</div> </text> <code> <coding> <system value="http://fhir.de/CodeSystem/ifa/pzn"/> <code value="01231440"/> </coding> <text value="SINUPRET DRAGEES 2X10X50St"/> </code> <form> <coding> <system value="https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_KBV_DARREICHUNGSFORM"/> <code value="UTA"/> </coding> </form> <amount> <numerator> <value value="1000"/> <unit value="St"/> </numerator> <denominator> <value value="1"/> </denominator> </amount> </Medication>
Medication Statement
A medication statement represents a relation between a pharmaceutical product and a patient if the patients uses this product as part of his permanent medication. Medications Statements are assigned to a patient and may be searched. A search request for patient medication returns a bundle of one or more FHIR items of type KBV_PR_AW_Dauermedikation.
{{baseURL}}/{{tenant}}/MedicationStatement?page=1&subject=Patient/6006
Example: this search requests fetches all Medications of patient 6006 using paging to limit the number of results
As medication statement does not contain any relevant information but the reference between medication and patient we currently do nor provide a read request for a specific statement.
<MedicationStatement xmlns="http://hl7.org/fhir"> <id value="Zemu6XkBDrpsrArZE1A46I7EAgEKNLAS"/> <meta> <versionId value="1"/> <lastUpdated value="2022-08-03T18:51:45+00:00"/> <profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Dauermedikation|1.2.0"/> </meta> <text> <status value="extensions"/> <div xmlns="http://www.w3.org/1999/xhtml">Dauermedikation von Patient Luca Fink</div> </text> <extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_Base_Additional_Comment"> <valueString value=""/> </extension> <status value="active"/> <medicationReference> <reference value="Medication/egMNGiQHERUmzlrP"/> </medicationReference> <subject> <reference value="Patient/6tVbNJZq1buNwKmp6UKpd8CpLceNDlRF/_history/1"/> </subject> </MedicationStatement>