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

NLLPrescriptionBundle

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:

  1. Om samtliga resurser avser förskrivning och alla har samma kedje-id hanteras de som Resurssamling förskrivning. Se avsnitt 3.1 nedan.
  2. Om samtliga resurser avser uttag eller uttag pappersrecept hanteras de som Resurssamling uttag. Se avsnitt 3.2.
  3. Ö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.


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

  • Uttag från helförpackningsförskrivning TA 46
  • Uttag från dosdispenserad förskrivning TA 50
  • Uttag från pappersrecept TA 49

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
  • Efterregistrera uttag TA 51

Backa flera uttag samtidigt
  • Backa uttag TA 48
  • Backa uttag som skett från pappersrecept TA 52
Får innehålla antingen Uttag eller Uttag pappersrecept.
Kreditera flera uttag samtidigt
  • Kreditera uttag TA 48
  • Kreditera uttag som skett från pappersrecept TA 52
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

  1. Registrera dossamtycke (TA 16, delfunktion 1)*
  2. Registrera dosunderlag (TA 16, delfunktion 2) *

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

  1. Avregistrera dosunderlag (TA 17, delfunktion 1)
  2. Avregistrera dossamtycke (TA 17, delfunktion 2)
Motsvarar transformator-tjänsten AvregistreraDosunderlag

Apotek (endast dosapotek)

Vård

Uppdatera förskrivningsinformation vid expediering

  1. Uppdatera förskrivning (TA 40)
  2. Registrera uttag (TA 46)

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.

(warning) 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 

  1. Registrera förskrivning (TA 11)
  2. Skapa spärr (TA 36) 



Apotek

Vård

Registrera spärrat uttag från pappersrecept

  1. Registrera uttag pappersrecept (TA 49)
  2. Skapa spärr (TA 36) 



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 
Två standardtyper finns transaction eller transaction-response

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 skapa resurs innehåller url resursnamnet t ex MedicationDispense.

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:
nllProvenanceDetails.extension:reason.text


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.

  • Profil för resurssamling förskrivning -NLLPrescriptionBundle har tillkommit.
  • Nya attribut om händelse som används av profilen NLLPrescriptionBundle har lagts till
  • Beskrivning av samtliga attribut har uppdaterats.

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

  • Förbättrat ingress på sidan
  • Förtydligat beskrivning i Tabell 1
  • Ändrat rubrik på avsnitt 2.1
1.4 2024-11-05 21.11

Lagt till information om Resurssamling transaktion