Uppdatera vårdtagare (SOL:03)
Med denna tjänst kan vården uppdatera information för en dospatient. Dospatienten är knuten till ett specifikt dosapotek som producerar dospåsarna åt dospatienten.
Innehållsförteckning
1. Tjänstespecifikation Uppdatera vårdtagare (SOL:03)
UppdateraVardtagareinformation 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, uppdateras till 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 |
I011 |
Vardtagarinformation |
Se I2 nedan |
1..1 |
Klass |
I101 |
meddelandetillapotek |
|
0..1 |
1 - 1024 pos |
I1. Behörighetsinformation
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
I003 |
fornamn |
Förnamn på behörig användare som använder tjänsten |
1..1 |
1 - 25 pos se R010 |
I004 |
efternamn |
Efternamn på behörig användare som använder tjänsten |
1..1 |
1 - 25 pos se R010 |
I005 |
forskrivarkod |
Förskrivarkod |
0..1 |
Exakt 7 pos |
I006 |
yrkeskod |
Typ av förskrivare LK = Läkare BM = Barnmorska SJ = Sjuksköterska TL = Tandläkare RS = Röntgensjuksköterska TH = Tandhygienist |
0..1 |
Enum |
I007 |
arbetsplatskod |
Arbetsplatskod |
1..1 |
1 - 13 pos se R010 |
I008 |
hsaid |
Vårdens identitetsbegrepp |
0..1 |
1 - 64 pos |
I009 |
personnummer |
Användarens personnummer |
0..1 |
Exakt 12 pos |
I010 |
organisationsnummer |
Användarens organisations organisationsnummer |
0..1 |
1 - 20 pos |
3.1. I2. Vårdtagarinformation
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
I012 |
hemmaboende |
Indikator om dospatient är hemmaboende eller inte: True = Hemmaboende False = Ej hemmaboende |
1..1 |
Boolean se R001 |
I015 |
forstadosdag |
Dag då dospatient ska påbörja behandling med dosdispenserade läkemedel. Anges om annan än den som finns i dospatientens produktionsinformation. |
1..1 |
Datum |
I016 |
avvikandedosschema |
Indikator om avvikande dosschema eller inte: True = Avvikande schema False = Ej avvikande schema |
1..1 |
Boolean |
I022 |
personnummer |
Personnummer för dospatient enligt format: YYYYMMDDXXXX |
1..1 |
Exakt 12 pos
|
I029 |
telefon |
Telefonnummer |
0..1 |
1 - 15 pos |
I030 |
dosmottagareid |
ID för dosmottagare för hemmaboende (dospatientens folkbokföringsadress) |
1..1 |
1 - 31 pos Angivet värde ignoreras och sparas därmed inte i SOL. Parametern kommer utgå i nästa externpåverkande release. |
I032 |
Tillfalligadress |
Se I5 nedan |
0..1 |
Klass |
I049 |
Kontaktinformation |
Se I7 nedan |
0..1 |
Klass |
I095 |
vilandestatusorsak |
Orsak till att dospatienten ska ha status vilande |
0..1 |
1 - 100 pos Se R008 |
I097 |
vilandefranochmed |
Från och med vilket datum dospatienten ska ha status vilande |
0..1 |
Datum Se R008 |
I098 |
vilandetillochmed |
Till och med vilket datum dospatienten ska ha status vilande |
0..1 |
Datum Se R008 |
I102 |
versionsid |
Versionsnummer för aktuell version av vårdtagarinformationen |
1..1 |
Long se R011 |
3.2. I5. Tillfällig adress
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
I033 |
adress |
Adress till tillfälligt boende |
0..1 |
1 - 50 pos |
I034 |
postnummer |
Postnummer till tillfälligt boende |
0..1 |
Exakt 5 pos |
I035 |
ort |
Tillfälliga boendets postort |
0..1 |
1 - 50 pos |
I036 |
telefon |
Tillfälliga boendets telefonnummer |
0..1 |
1 - 15 pos |
I037 |
dosmottagareid |
ID för dosmottagare som ska kopplas till tillfällig adress |
0..1 |
1 - 31 pos Valideras mot dosmottagare i SOL |
I103 |
frandatum |
Tillfällig adress giltig fr o m datum |
0..1 |
Datum Se R003 |
I104 |
tilldatum |
Tillfällig adress giltig t o m datum |
0..1 |
Datum Se R003 |
3.3. I7. Kontaktinformation
ID |
<XML-tag> / fältnamn |
Kort beskrivning |
Mult |
Validering/ Anmärkning |
---|---|---|---|---|
I050 |
PALforskrivarkod |
Förskrivarkod för patientansvarig läkare (=PAL) |
0..1 |
Exakt 7 pos |
I051 |
PALfornamn |
Förnamn PAL |
0..1 |
1 - 25 pos |
I052 |
PALefternamn |
Efternamn PAL |
0..1 |
1 - 50 pos |
I053 |
anhorigkontaktnamn |
|
0..1 |
1 - 50 pos |
I054 |
anhorigkontaktemail |
E-postadress till anhörig |
0..1 |
1 - 40 pos |
I055 |
ansvarigkontaktnamn |
|
0..1 |
1 - 50 pos |
I056 |
ansvarigkontaktemail |
|
0..1 |
1 - 40 pos |
I057 |
ansvarigkontaktadress |
|
0..1 |
1 - 50 pos |
I058 |
ansvarigkontaktpostnummer |
|
0..1 |
Exakt 5 pos |
I059 |
ansvarigkontaktpostort |
|
0..1 |
1 - 50 pos |
I060 |
ansvarigkontakttelefon1 |
|
0..1 |
1 - 15 pos |
I061 |
ansvarigkontakttelefon2 |
|
0..1 |
1 - 15 pos |
I062 |
vardandeenhetid |
ID för ordinationsansvarigs enhet |
0..1 |
1 - 31 pos Valideras mot vårdande enheter i SOL |
4. Utdata
Utdata returneras enligt Utdata i Hämta vårdtagareinformation (SOL:02).
5. Verksamhetsregler/logik
ID |
Verksamhetsregler/logik |
---|---|
R003 |
Utöver patientens ordinarie dosmottagare kan patienten ha en tillfällig leveransadress: Tillfällig adress gäller om den finns och a) både frandatum och tilldatum har angivits och dagens datum ligger inom datumintervallet frandatum – tilldatum eller b) dagens datum har passerat frandatum och tilldatum är tomt eller c) dagens datum har inte passerat tilldatum och frandatum är tomt |
R004 |
När en dospatient har uppdaterats av vården, skapas ett nytt meddelande adresserat till dospatientens dosapotek. |
R008 |
I098 vilandetillochmed får inte ligga före I097 vilandefranochmed I095 vilandestatusorsak måste anges om I097 vilandefranochmed har angivits. I095 vilandestatusorsak kan inte anges om I097 vilandefranochmed inte har angivits. |
R010 |
I003 fornamn, I004 efternamn, I007 arbetsplatskod samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat vårdtagarinformationen och när. |
R011 |
I102 versionsid måste överensstämma med dospatientens versionsid i SOL för att uppdateringen ska lyckas. |
R012 |
Vårdande enhet och dosmottagare/produktionsinformation för dospatientens boenden måste tillhöra samma dosaktör som dospatienten. |
R013 |
Angiven status för dospatient valideras mot FOLK. |
Versionshistorik
Version |
Datum |
Kommentar |
---|---|---|
1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
1.1 | 2022-05-25 |
Tagit bort I041 boendeenhetid och I092 statuskod Ändrat I030 dosmottagareid till obligatorisk Uppdaterat R003 och R008. Uppdaterat Utdata med referens till SOL 02 Tagit bort R001, R002, R009 och R015 |
1.2 | 2022-11-10 | Ändrat maxlängden för I095 vilandestatusorsak till 100 tecken. |
1.3 | 2024-08-26 | Angivet värde för I030 ignoreras enligt kommentar |
1.4 | 2024-08-26 | Tagit bort R014 eftersom I092 tagits bort |