Hämta meddelanden, dosaktör (SOL:30)
Med denna tjänst kan dosaktör hämta meddelanden i fritextformat. Ett meddelande i SOL är alltid kopplat till ett personnummer. Meddelandet kan även vara kopplat till tidigare meddelanden. Meddelandeidentitet genereras automatiskt i SOL.
Innehållsförteckning
1. Tjänstespecifikation Hämta meddelanden, dosaktör (SOL:30)
HamtaMeddelandeDosaktor V4.0
2. Formatregler
2.1. Datum och tid
Datatypen ”Datum” sätts i SOLs tjänstespecifikationer till formatet YYYY-MM-DDTHH:mm:ss om inte annat anges. Om inte tid skickas med vid anrop sätts tiden till 00:00:00. Vissa tjänster tar bara hänsyn till YYYY-MM-DD-delen.
3. Indata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I002 | behorighetsinformation | Se I1 nedan | 1..1 | Klass |
I008 | meddelandeurval | Se I2 nedan | 1..1 | Klass |
3.1. I1. Behörighetsinformation
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I003 | fornamn | Farmaceuts eller annan apotekspersonals förnamn | 1..1 | 1 - 25 pos |
I004 | efternamn | Farmaceuts eller annan apotekspersonals efternamn | 1..1 | 1 - 25 pos |
I005 | legitimationskod | Farmaceuts legitimationskod | 0..1 | Exakt 6 pos |
I006 | yrkesroll | Användarens yrkesroll FA = Farmaceut (apotekare och receptarie) eller AP = Apotekspersonal | 1..1 | Enum |
I007 | dosapotekid | GLN-kod för dosapotek | 1..1 | Exakt 13 pos Valideras mot EXPO |
3.2. I2. Meddelandenurval
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I015 | personnummer | Personnummer för dospatient som meddelandet avser enligt format: YYYYMMDDXXXX | 0..1 | Exakt 12 pos |
I018 | meddelandeid | 0..1 | String 0-36 pos | |
I019 | status | Tillåtna värden: O = Oläst L = Läst LO = Läst eller oläst B = Borttaget | 0..1 | Enum Se R001 |
I023 | frantidpunkt | Datum och klockslag | 0..1 | Datum |
I024 | tilltidpunkt | Datum och klockslag | 0..1 | Datum |
| I025 | maxantal | Anges för att begränsa antalet meddelanden som anropet ska returnera. | 0..1 | Integer Se R003 |
4. Utdata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
U001 | resultatkod | Möjliga värden: | 1..1 | enum |
U002 | meddelandetext | 1..1 | 1 - 300 pos | |
U003 | meddelandeid | ID för responsmeddelande | 1..1 | Integer |
U004 | meddelanden | Se U1 nedan | 0..* | Klass |
4.1. U1. Meddelanden
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
U005 | meddelandeid | ID för meddelandet | 1..1 | UUID 36 pos |
U011 | personnummer | Personnummer för dospatient som meddelandet avser enligt format: YYYYMMDDXXXX | 1..1 | Exakt 12 pos |
U014 | kommunikationsriktning | Möjliga värden: 1 = Från vården 2 = Från dosapotek | 0..1 | Enum |
U015 | tidigaremeddelandeid | Anges om meddelandet är kopplat till ett tidigare meddelande | 0..1 | UUID 36 pos |
U017 | dosapotekid | GLN-kod för mottagande dosapotek | 0..1 | Exakt 13 pos |
U018 | dosapoteknamn | Namn på dosapotek | 0..1 | 0 - 40 pos |
U019 | sandningstidpunkt | Tidpunkt då meddelandet skickades | 1..1 | Datum |
U020 | ursprungligsandarefornamn | Avsändares förnamn | 1..1 | 1 - 25 pos |
U021 | ursprungligsandareefternamn | Avsändares efternamn | 1..1 | 1 - 40 pos |
U022 | ursprungligsandareid | Avsändares HSA-id | 0..1 | 0 - 64 pos |
U023 | ursprungligsandareyrkeskod | Avsändares yrkeskod: LK = Läkare BM = Barnmorska SJ = Sjuksköterska TL = Tandläkare RS = Röntgensjuksköterska TH = Tandhygienist | 0..1 | Enum |
U024 | ursprungligsandarearbplats | Avsändares arbetsplats | 0..1 | 0 - 40 pos |
U025 | rubrik | Rubrik för meddelandet | 0..1 | 0 - 40 pos |
U026 | prioritet | Möjliga värden: H = Hög N = Normal L = Låg | 0..1 | Enum |
U027 | meddelandestatus | Möjliga värden: O = Oläst L = Läst | 1..1 | Enum |
U028 | meddelandestatusfornamn | Förnamn på den som senast uppdaterat status | 1..1 | 1 - 25 pos |
U029 | meddelandestatusefternamn | Efternamn på den som senast uppdaterat status | 1..1 | 1 - 25 pos |
U030 | meddelandestatusarbetsplats | Arbetsplats för den som senast uppdaterat status | 1..1 | 1 - 40 pos |
U031 | meddelandestatustidpunkt | Datum och klockslag för senaste statusuppdatering | 1..1 | Datum |
U032 | meddelande | 1..1 | 1 - 1024 pos |
5. Verksamhetsregler/logik
ID | Verksamhetsregler/logik |
|---|---|
R001 | Meddelanden som är markerade som Borttagna returneras ej. |
R003 | De meddelanden som returneras är de äldsta bland de som uppfyller sökkriterierna, baserat på meddelandets sändningstidpunkt. Maxantalet anges i I028. Om inget värde anges i I028 blir defaultvärdet 500 st. |
R004 | Endast meddelanden kopplade till det anropande dosapoteket kommer att returneras. |
R008 | Utöver personnummer eller meddelandeid kan sökning göras på |
R010 | Sökresultat som inte ger någon träff genererar meddelandetext: ”Ingen träff” |
R011 | Om varken I015 personnummer eller I018 meddelandeid anges så ska tjänsten bara returnera de meddelanden som skickats från vården till det aktuella dosapoteket. |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 | Ändrat: datatyp för I018, U005 och U015, justerat R003 Tillagt: I025 |
| 1.2 | 2024-02-22 | Tagit bort R002 |