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.02021-11-27Ny handbok vård- och apotekstjänster
1.12022-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.22022-11-10Ändrat maxlängden för I095 vilandestatusorsak till 100 tecken.