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 Angivet objekt ignoreras och sparas därmed inte i SOL. Objektet kommer utgå i nästa externpåverkande release.
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

Ignoreras enligt I032.

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
I104	tilldatum	Tillfällig adress giltig t o m datum	0..1	Datum

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
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	Release	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
1.5	2025-08-28	21.14	Tillfällig adress ignoreras (I032 och I5). R003 borttagen.