Page Status: Outdated

Change status of list (sv: ändra status på dosunderlag)

This section describes the process of changing the status of the basis of a number of dose-dispensed MedicationRequest(s) (sv: ändra status på dosunderlag). The basis of the dose-dispensed MedicationRequests of a patient is realized in the resource List. A pharmacist needs to approve the status of the List before production of dose-dispense bags starts for a patient. The list also contains information of which pharmacy is the producer of the dose-dispense bags for the patient.

The basic approach to achieve this use case is to use HTTP PUT on the resource List.

PUT [base]/fhir/List

To find the list, a HTTP GET is used, with query parameters

GET [base]/fhir/List?subject.identifier=195011132098&code=dose

All POST and PUT interaction should be accompanied with a NLLProvenance in the X-Provenance header (examples will be added).

Example 1, review the basis for dose-dispensed MedicationRequests and changing status

Practitioners with the appropriate access rights should be able to fetch the list of dose-dispensed MedicationRequests for a patient in order to conclude a review before production starts. This example shows how to fetch the List for a given patient and the changing the status after the review is done.

1. Search-query:

Header: required authorization and provenance information

Parameter Mandatory Comment
Authorization Yes Bearer [valid OAuth2 token]
X-Access DOSPATIENTS_UPPGIFTER -
X-Purpose EXPEDIERING -
X-Provenance N/A -

An example of a full provenance json structure can be seen in General information about Use Cases

GET [base]/fhir/List?identifier=195011132098&code=multi-dose-disp-list

2. Response

{
    "resourceType": "Bundle",
    "id": "611b8f4a-5966-4b32-a137-526d61846e88",
    "meta": {
        "lastUpdated": "2019-02-28T06:57:05.104002+00:00"
    },
    "type": "searchset",
    "total": 1,
    "entry": [
        {
            "fullUrl": "https://basepath/fhir/List/7b360be0-41e2-4d93-beaf-c6122b3446cc",
            "resource": {
                "resourceType": "List",
                "id": "7b360be0-41e2-4d93-beaf-c6122b3446cc",
                "meta": {
                    "lastUpdated": "2019-01-16T12:51:36.912965+00:00",
                    "profile": [
                        "https://simplifier.net/SwedishNationalMedicationList/nll-dose-med-list"
                    ]
                },
				"code" : "multi-dose-disp-list",
				"subject" : "https://basepath/fhir/Patient/7b360be0-41e2-4d93-beaf-c6122b3446cc"
				"entry" [
                    {
                        "item": {
                            "reference": "https://basepath/fhir/MedicationRequest/7b360be0-41e2-4d93",
				...
                "contentStatus" : "EJ_GODKANT"

3. Update-action:

Header: required authorization and provenance information

Parameter Mandatory Comment
Authorization Yes Bearer [valid OAuth2 token]
X-Access N/A -
X-Purpose N/A -
X-Provenance Yes Must be provided with information as described below
activity.coding.code : GODKANN_DOSUNDERLAG
agent.type : enterer .
agent.who : NLLPractitioner At least name, identifier (user id), qualification workplaceIdentifier must be defined. Make sure that the individual is the same as in the authorization ticket.

An example of a full provenance json structure can be seen in General information about Use Cases

PUT [base]/fhir/List/7b360be0-41e2-4d93-beaf-c6122b3446cc

{
...
    body: "contentStatus" : "GODKANT"

Comment: id is the referred logical id from the fullURL in search query