Uppdatera meddelandestatus, dosaktör (SOL:31)
Med denna tjänst kan dosaktör uppdatera status på ett meddelande. Meddelande kan uppdateras från status "Oläst" till "Läst", "Oläst" till "Borttaget" eller "Läst" till "Borttaget". Ett eller flera meddelande kan ändra status i samma anrop. Meddelandestatus kan även uppdateras från "Läst" tillbaka till "Oläst". Meddelanden är patientbundna (kopplat till ett personnummer) alternativt meddelandebundet (kopplat till en tidigare meddelandeidentitet).
Innehållsförteckning
1. Tjänstespecifikation Uppdatera meddelandestatus, dosaktör (SOL:31)
UppdateraMeddelandeStatusDosaktor 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.
2.2. Uppdatering av valfria värden i SOL
Alla valfria värden som kan uppdateras vid anrop av SOL:s uppdateringstjänster, ersätts av null om inget värde anges.
3. Indata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I002 | behorighetsinformation | Se I1 nedan | 1..1 | Klass |
I008 | uppdaterameddelande | Se I2 nedan | 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 Se R005 |
I004 | efternamn | Farmaceuts eller annan apotekspersonals efternamn | 1..1 | 1 - 25 pos Se R005 |
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. Uppdatera meddelande
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I009 | meddelandeid | ID för meddelande ID | 1..1 | String 1-36 pos se R004 och R006 |
I010 | meddelandesstatus | Meddelandestatus: O = Oläst L = Läst B = Borttaget | 1..1 | Enum Se R001 och R007 |
I011 | statustidpunkt | Datum och klockslag | 1..1 | Datum |
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 | uppdaterameddelandestatus | Se U1 nedan | 0..* | Klass |
4.1. U1. UppdateraMeddelandeStatus
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
U005 | meddelandeid | ID för meddelande | 1..1 | UUID 36 pos |
U006 | meddelandestatus | Möjliga värden: O = Oläst L = Läst B = Borttaget | 1..1 | Enum |
U007 | statustidpunkt | Datum och klockslag | 1..1 | Datum |
5. Verksamhetsregler/logik
ID | Verksamhetsregler/logik |
|---|---|
R001 | Meddelande kan uppdateras från status ”Oläst” till ”Läst”, ”Oläst” till ”Borttaget”, ”Läst” till ”Borttaget” samt från status “Läst” till “Oläst”. |
R002 | Ett eller flera meddelanden kan uppdateras i samma anrop. |
R004 | Endast meddelanden som är kopplade till det anropande dosapoteket kan uppdateras. |
R005 | I003 fornamn, I004 efternamn, I007 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat meddelandet och när. |
R006 | I008 uppdaterameddelande får inte innehålla dubbletter av I009 meddelandeid i ett och samma anrop. |
R007 | Status ”Läst” får endast sättas på meddelanden som har skickats av vården. |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 | Ändrat: datatyp på I009 och U005 |
| 1.2 | 2023-11-09 | Lagt till R006 och hänvisning till denna för I009 |
| 1.3 | 2024-02-22 | Tagit bort R003. Lagt till R007. |