Resurssamling – Bundle
Beskrivning av resursen Resurssamling - Bundle och dess tillämpning för resurssamling uttag - NLLDispatch, resurssamling förskrivning- NLLPrescriptionBundle, samt resurssamling transaktion - NLLTransactionBundle.
1. Inledning
Resurssamling - Bundle används när flera resurser behöver hanteras i en transaktion.
2. Översikt
När det finns behov att hantera flera resurser i samma transaktion används resurssamling. För att underlätta förståelsen av vilken information som kan anges eller returneras i en resurssamling har olika profiler tagits fram. Dessa profiler är baserade på resursen bundle.
Tabell 1 - Profiler för resurssamling
Profil för resurssamling |
Berörd resurs |
Kommentar |
---|---|---|
Förskrivning |
Resurssamling förskrivning används för att i ett anrop ange flera förskrivningsresurser i samma förskrivningskedja som ska hanteras i samma transaktion. Mer information om användning under avsnitt 3.1. |
|
NLLDispatch | Uttag |
Resurssamling uttag används vid expediering, backning, kreditering eller efterregistrering av uttag om fler än ett uttag ska hanteras i samma transaktion. Mer information om användning under 3.2. |
NLLTransactionBundle | Flertal resurser |
Resurssamling transaktion används för att hålla ihop ändringar av olika resurser i en transaktion när det är viktigt att allt eller inget utförs. Om någon resurs får ett avvisande fel sparas inga ändringar. Rekommenderade scenarier och mer information om användning under avsnitt 3.3. |
3. Användning av Resurssamling
Oavsett vilken Bundle-profil som anropande system har utgått från så används nedan logik för att utifrån innehållet i resurssamlingen avgöra vilka regler och kontroller som appliceras i NLL vid hanteringen:
- Om samtliga resurser avser förskrivning och alla har samma kedje-id hanteras de som Resurssamling förskrivning. Se avsnitt 3.1 nedan.
- Om samtliga resurser avser uttag eller uttag pappersrecept hanteras de som Resurssamling uttag. Se avsnitt 3.2.
- Övriga fall hanteras som Resurssamling transaktion. Se avsnitt 3.3 nedan.
3.1. Resurssamling förskrivning
Resurssamling förskrivning används för att i samma transaktion hantera förskrivningar som ingår i samma förskrivningskedja.
- Endast tillåtna kombinationer enligt VR178, se Generella verksamhetsregler.
- Händelsetyp som ska utföras anges för varje förskrivningsresurs.
- Förskrivningarna sorteras och hanteras i följande turordning: den först skapade av befintliga förskrivningar hanteras först enligt regler i aktuell tillämpningsanvisning. Efter hantering av den eller de befintliga förskrivningarna hanteras eventuell förskrivning som ska skapas (Ersätta eller Registrera förskrivning).
Resurssamling förskrivning vid hantering av förskrivningar:
- Hantering av parallella förskrivningar. Parallella förskrivningar ska bedömas tillsammans då de speglar en framtida förändring av en pågående behandling. När det finns behov av att hantera två parallella förskrivningar med olika händelsetyper, exempelvis att avsluta förskrivning A och makulera förskrivning B behöver resurssamling förskrivning användas. Även vid uppdateringar där det finns beroenden mellan dem, som att förändra datum för övergång mellan de två parallella förskrivningarna, behöver båda parallella förskrivningarna anges i en resurssamling. Läs mer om parallella förskrivningar på sidan Historik i Nationella läkemedelslistan.
REKOMMENDATION Rekommendationen är att all hantering av parallella förskrivningar sker via resurssamling. När resurssamling inte används kan önskad händelsetyp endast anges för den första parallella förskrivningen (förskrivning A) och den efterföljande förskrivningen (förskrivning B) hanteras då automatiskt utifrån samma händelsetyp enligt regler i respektive tillämpningsanvisning.
- Akut ersättning av dosdispenserad förskrivning. När en ny förskrivning skapas vid Ersätta förskrivning påverkas ytterligare en eller två andra förskrivningar (två förskrivningar påverkas när parallella förskrivningar ersätts). En eller två befintliga förskrivningar avslutas och en ny aktiv förskrivning skapas i samma förskrivningskedja för att ersätta tidigare förskrivningar. För att kunna markera avslut av en dosdispenserad förskrivning som en akut förändring måste tidigare förskrivningar först avslutas innan de ersätts, samtliga påverkade förskrivningar ska då anges i en resurssamling för att detta ska ske i samma transaktion.
3.1.1. Berörda tillämpningsanvisningar
Tabell 2. Specifika kombinationer av de händelsetyper som listas nedan är möjliga. För beskrivning av dessa och syfte med respektive kombination, se regel VR178 på sidan Generella verksamhetsregler.
Händelsetyp | Berörda tillämpningsanvisningar |
---|---|
Avsluta förskrivning | |
Makulera förskrivning | |
Uppdatera förskrivning | |
Registrera förskrivning | |
Ersätta förskrivning |
3.2. Resurssamling uttag
Resurssamling uttag kan användas av apotek för uttag eller uttag pappersrecept när flera uttag ingår i samma expediering (samma expeditions-id och expeditionstidpunkt) och ingen samtidig uppdatering av någon förskrivning krävs. När en eller flera förskrivningar behöver uppdateras i samband med en expediering används Resurssamling transaktion istället, se avsnitt 3.3.
- Flera uttagsresurser kan anges, Resurssamling uttag kan innehålla antingen uttag eller uttag pappersrecept.
- Samma händelsetyp gäller för samtliga resurser.
3.2.1. Berörda tillämpningsanvisningar
Tabell 3. Senarier för resurssamling uttag.
Scenario | Berörda tillämpningsanvisningar | Kommentar |
---|---|---|
Expediera flera uttag samtidigt |
Får innehålla antingen Uttag eller Uttag pappersrecept. Uttag för dosdispensering och helförpackning kan inte förekomma i samma resurssamling. |
|
Efterregistrera flera uttag samtidigt |
|
|
Backa flera uttag samtidigt | Får innehålla antingen Uttag eller Uttag pappersrecept. | |
Kreditera flera uttag samtidigt | Får innehålla antingen Uttag eller Uttag pappersrecept. |
3.3. Resurssamling transaktion
Resurssamling transaktion möjliggör att hålla ihop ändringar av flera typer av resurser i en transaktion när det är viktigt att antingen samtliga eller ingen resurs registreras eller ändras. Det bör användas när det ur en användares perspektiv är en händelse som utförs, men flera anrop mot Nationella läkemedelslistan krävs.
REKOMMENDATIONI tabell 4 nedan listas scenarier där användning av Resurssamling transaktion rekommenderas för att informationen inte ska riskera att hamna i ett oönskat läge för patienten eller för anropande system.
- Resurssamling transaktion kan tillämpas för resurserna Förskrivning, Uttag, Spärr, Dosunderlag, Dossamtycke.
- Händelsetyp som ska utföras anges för varje förskrivningsresurs, samt när det är relevant även händelseorsak.
- Resurserna hanteras i den ordning som de är angivna i resurssamlingen. När det finns beroenden mellan resurserna är det viktigt att de anges i rätt ordning, exempelvis:
- en förskrivning registreras innan en spärr skapas.
- Förskrivningar uppdateras innan uttag registreras. För att uttag ska hanteras i samma expediering måste samtliga uttag, oavsett vilken förskrivning de tillhör, anges i en följd i resurssamlingen.
- Detaljer kring regler och kontroller vid Resurssamling transaktion beskrivs i VR194 på sidan Generella verksamhetsregler.
3.3.1. Berörda tillämpningsanvisningar
Tabell 4. Rekommenderade scenarier för Resurssamling transaktion och berörda tillämpningsanvisningar
Scenario | Beskrivning | Kommentar | Aktör |
---|---|---|---|
Registrera en dospatient |
|
Motsvarar transformator-tjänsten SkapaDosunderlag. *Omregistrering av dospatient (PUT) från vård via Resurssamling möjliggörs i en senare release, då ett avregistrerat dosunderlag kan läsas upp utan krav på samtycke. |
Apotek (endast dosapotek) Vård |
Avregistrera en dospatient |
|
Motsvarar transformator-tjänsten AvregistreraDosunderlag |
Apotek (endast dosapotek) Vård |
Uppdatera förskrivningsinformation vid expediering |
|
Motsvarar transformator-tjänsten GodkannUttag där det är möjligt att ange förmånsrelaterad daglig mängd (OR: Max dygnsdos) och/eller uppdatera doseringstext på förskrivning. Samtliga uttag som ingår i expedieringen ska anges i en följd, och anges efter den eller de förskrivningar som uppdateras i samband med expedieringen. |
Apotek |
Registrera spärrad förskrivning |
|
|
Apotek Vård |
Registrera spärrat uttag från pappersrecept |
|
|
Apotek |
4. Attribut Resurssamling
Tabell 5. Attribut resurssamling
Term |
Termdefinition och anmärkning |
FHIR |
Kommentar FHIR |
---|---|---|---|
Typ av resurssamling |
Anger att resurssamlingen hanteras i en transaktion, i ett anrop eller i ett svar. Anmärkning |
Bundle.type |
ValueSet: |
Post |
Lista med resurser och metadata om varje resurs |
Bundle.entry |
|
Resurs |
Resurs som ingår i listan. |
Bundle.entry.resource |
|
Anrop |
Metadata för varje resurs i anropet (indata). | Bundle.entry.request | |
URL |
URL för resurs Anmärkning Vid uppdatera resurs innehåller url resursnamn + id t ex MedicationDispense/2c7c33de-0b93-4bd7-890f-10f6bc49bd1f |
Bundle.entry.request.url |
|
HTTP-metod |
Den HTTP-metod som ska exekveras. | Bundle.entry.request.method |
ValueSet: |
Händelse |
Information om händelse. Används istället för motsvarande attribut i händelsen (X-Provenance) i meddelandehuvudet |
Bundle.entry.request.extension:nllProvenanceDetails |
Används inte för NLLDispatch (uttag) |
Händelsetyp |
typ av händelse kopplat till resurs |
Bundle.entry.request.extension:nllProvenanceDetails.extension:activity |
ValueSet: provenance-activity-types |
Händelseorsak |
kod för orsak till händelse | Bundle.entry.request.extension: nllProvenanceDetails.extension:reason.coding.code |
ValueSet: NLLReasonForProvenance |
Beskrivning händelseorsak |
fritextbeskrivning av orsak till händelse |
Bundle.entry.request.extension: |
|
Svar |
Metadata för varje resurs i svaret (utdata). | Bundle.entry.response | |
HTTP-status |
Returnerad HTTP-status per post i en transaktion |
Bundle.entry.response.status |
|
Adress-id |
Adress-id (om operationen returnerar en plats) för resursen i svaret. | Bundle.entry.response.location | |
AFF-varning |
Om det finns AFF-varningar på förskrivningsresurs som uppdateras i transaktionen returneras en AFF-kod för AFF-varningen. |
Bundle.entry.response.outcome |
Versionshistorik
Version |
Datum |
Release |
Kommentar |
---|---|---|---|
1.0 | 2021-11-27 | 21.0 | Ny handbok vård- och apotekstjänster |
1.1 | 2022-02-02 | Lagt till Bundle.entry.response.status och Bundle.entry.response.location | |
1.2 | 2023-05-04 | 21.5 |
Döpt om och sidan till resurssamling, samt strukturerat om sidan för att beskriva de profiler som ingår.
Nytt avsnitt 2.1 som beskriver användningen av resurssamling för resurs Förskrivning |
1.3 | 2024-02-22 | 21.8 |
Förbättrad dokumentation
|
1.4 | 2024-11-05 | 21.11 |
Lagt till information om Resurssamling transaktion |