Order medication
Availability:
Environment | status |
---|---|
Test | ✅ Available |
Acceptance | ✅ Available |
Production | ✅ Available |
API specifications:
Functional summary
With the Order Medication feature patients can order medication via Spreekuur.nl. The practitioner can approve or reject the order in the XIS. The patient will be notified and can see the status of the order in Spreekuur.nl.
Note: This functionality is called "Order Medication". However, the patient can't just order new medications but repeats a previous prescribed medication. The XIS is responsible to only return medications which the patient can order / repeat.
Order medication
The flow to order medication is as follows:
- The patient requests a list of orderable medications. This XIS is responsible to only return medications which can be ordered by the patient. To give the patient an indication where the medication can be collected, Spreekuur.nl will also request the pharmacy organizations from the XIS.
- The patient can select one or more medications from the list.
- Optionally the patient can add a note to each medication in the list.
- After the patient confirms the order, Spreekuur.nl will send each chosen medication separately to the XIS. It will
first request the MedicationRequest again from the XIS and modify the following properties before sending it back:
- Remove the 'id' field
- Add property 'authoredOn' and set it to now
- Add property 'basedOn' with a reference to the original MedicationRequest
- Set property 'status' to 'draft'
- Optionally add the note of the patient
- The practitioner is notified of the new medication order and can approve or reject the order.
- When the order is approved, the patient receives a notification from Spreekuur.nl the order can be collected at the pharmacy.
- When the order is rejected, the patient receives a notification from Spreekuur.nl. Optionally, the practitioner can add a message which will be added to the notification.
Medication order overview
The flow to show the medication order overview is as follows:
- The patient requests the medication order overview. Spreekuur.nl will show all medication orders which are known in the Spreekuur.nl database.
- When the patient opens the detail of a medication order, Spreekuur.nl will request the pharmacy organization from the XIS to show the name and address of the pharmacy where the medication can be collected. The pharmacy organization is requested at the XIS so the name and address are always up to date.