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 |