Page Status: updated 2022-10-31
Provenance - Fetch
Page index
Introduction
Sv. Hämta händelser.
This page describes how to fetch the resource Provenance for a patient by a few examples.
A Provenance can be fetched in different ways. See Provenance query operations for information about all options.
In short, a query request is either a read, that is, a retrieval via the resource ID, or a search via a search condition. The result differs between a read and a search. A search results in a Bundle being returned containing all matching resources. If there are no hits, an empty Bundle is returned. A read results in the requested resource being returned or an error if no resource with the requested ID exists. If a system error occurs both searches and reads result in an error (i.e. an OperationOutcome).
Fetching a Provenance is done by one of the following operations.
GET [base]/Provenance/[id]
GET [base]/Provenance?[search parameters]
A set of HTTP headers must be provided in order to fetch a provenance. See HTTP Header and Authorization for more information about the various headers used by the National Medication List.
See Provenance for more information about the Provenance resource.
Before a Provenance can be retrieved and presented to the user other information is needed from the National Medication List. For more information on different scenarios and what information is required for each scenario, see Handbok för vård- och apotekstjänster: Verksamhetsområden.
Examples
HTTP Headers
See HTTP Header and Authorization for generic information about all HTTP headers used by the National Medication List including information about authorization, purpose and access type. The authorization token is translated to an authority role. The authority role together with the purpose and type of access is used by the National Medication List to determine what actions a user may perform and what information the user may access.
| Header | Comment |
|---|---|
| authorization | The users's security token |
| prefer | Type of returned content |
| x-access | The cause for the call |
| x-context-id | An ID to group a sequence of requests |
| x-org-info | Information about the users's organisation |
| x-patientref | The logical ID of the patient |
| x-provenance | A provenance resource with information about the user interacting with NLL |
| x-purpose | The purpose of the call |
| x-request-id | A random and unique ID |
| x-user-agent | Information about the calling system |
Example 1 - Fetch a provenance of an updated MedicationRequest
This example shows a provenance of an updated prescription. The update is done by a pharmacy on request by the prescriber.
The request is made as a compartment search by the logical id of the prescription,
GET [base]/MedicationRequest/5099332b-7591-4e8a-8919-087f82db440c/Provenance.
HTTP headers
| Header | Value | Comment |
|---|---|---|
| authorization | {...,"APOTEKSID":"7350045511997","LEGITIMATIONSKOD":"920007","YRKESKOD":["AP"],"loa":3} |
Selected information from the OAuth2-ticket in decoded form |
| prefer | ||
| x-access | UTAN_KRAV_SAMTYCKE |
|
| x-org-info | ||
| x-patientref | b00a0407-b781-43e8-983b-74fdfb8eb97d |
|
| x-provenance | ||
| x-purpose | EXPEDIERING |
|
| x-request-id | 2a264482-fe08-4136-af51-ebe95bc9ea59 |
|
| x-user-agent | {"name":"Test system testaren","version":"0.01010101010.1 beta"} |
Decoded value |
HTTP body: Fetch Provenance related to an updated prescription
Example 2 - Fetch a provenance of a DataLock
This example shows a provenance of a new data lock. The data lock is created by a prescriber.
The request is made as a search by the logical id of the data lock,
GET [base]/Provenance?target=Basic/7bc1497d-1b8b-4a41-9a54-bea383a7a2ac.
HTTP headers
| Header | Value | Comment |
|---|---|---|
| authorization | {...,"FORSKRIVARKOD":"9000027","VARDGIVARE":"0123456789","YRKESKOD":["LK"],"loa":3} |
Selected information from the OAuth2-ticket in decoded form |
| prefer | ||
| x-access | TILLFALLIGT_SAMTYCKE_SPARRADE_UPPGIFTER |
|
| x-org-info | {"orgenhetsOrt":"Sala"} |
Decoded value |
| x-patientref | 02ca682b-e728-43d7-845c-466238f2e96e |
|
| x-provenance | ||
| x-purpose | VARD |
|
| x-request-id | 41da34e2-acc5-4334-887e-2626c3e1a078 |
|
| x-user-agent | {"name":"Test system testaren","version":"0.01010101010.1 beta"} |
Decoded value |
HTTP body: Fetch Provenance related to a data lock