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
Tjänstespecifikation Uppdatera vårdtagare (SOL:03)
UppdateraVardtagareinformation V4.0
Formatregler
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.
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.
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 |
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 Valideras mot dosmottagare i SOL |
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 |
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 |
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 |
Utdata
Utdata returneras enligt Utdata i Hämta vårdtagareinformation (SOL:02).
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. |
R014 | I det fall I092 statuskod inte överensstämmer med vårdtagarens status i FOLK kommer den senare att sparas ner som status för vårdtagaren i SOL. När vårdtagarens status ändras sparas tidpunkten för statusändringen i SOL. Statustidpunkten används vid historisering av vårdtagarinformation. Dospatient som tilldelas status AVFÖRD eller AVLIDEN historiseras efter ett givet antal dagar som bestäms av E-hälsomyndigheten. |
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. |