Hämta vårdtagareinformation (SOL:02)

Med denna tjänst kan vården hämta information om en dospatient. Dospatienten är kopplad till ett specifikt dosapotek som producerar dospåsarna åt dospatienten. Dospåsarna levereras av dosapoteket till en dosmottagare, som är leveransstället.

Innehållsförteckning

Tjänstespecifikation Hämta vårdtagareinformation (SOL:02)

HamtaVardtagareinformation V4.0

Formatregler

Datum / 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.

Indata

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I002

Behorighetsinformation

Se I1 nedan

1..1

Klass

I012

personnummer

Personnummer enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 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
I004	efternamn	Efternamn på behörig användare som använder tjänsten	1..1	1 - 25 pos
I005	forskrivarkod		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
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

Utdata

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U001	resultatkod	Möjliga värden: 1 = Info 2 = Varning 3 = Fel	1..1	Enum
U002	meddelandetext		1..1	1 - 300 pos
U003	meddelandeid	ID för responsmeddelande	1..1	Integer
U004	Vardtagarinformation	Se U1 nedan	0..1	Klass

U1. Vårdtagarinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U005	hemmaboende	Indikator om dospatient är hemmaboende eller inte True = Hemmaboende False = Ej hemmaboende	1..1	Boolean
U006	dosapotekid	GLN-kod för dosapotek	1..1	Exakt 13 pos
U007	dosapoteknamn	Namn på dosapotek	1..1	1 - 50 pos Hämtas från EXPO
U008	forstadosdag	Första dosdag för leveransomgång	0..1	Datum
U009	avvikandedosschema	Anger om avvikande dosschema används True = Avvikande dosschema False = Ej avvikande dosschema	1..1	Boolean
U010	Patientinformation	Se U2 nedan	1..1	Klass Hämtas från FOLK
U018	AdressInfoFolk	Se U3 nedan	0..1	Klass Hämtas från FOLK
U123	AdressInfoSPost	Se U4 nedan	0..1	Klass Hämtas från FOLK
U022	telefon	Telefonnummer	0..1	1 - 15 pos
U025	Tillfalligadress	Se U5 nedan	0..1	Klass
U032	Dosmottagare	Se U6 nedan	0..1	Klass
U042	Kontaktinformation	Se U8 nedan	0..1	Klass
U085	statuskod	Vårdtagarstatuskod Möjliga värden: 1 = Aktiv 2 = Vilande 4 = Avförd 5 = Avliden	1..1	Enum
U088	vilandestatusorsak	Orsak till att dospatienten har haft eller ska ha status Vilande	0..1	1 - 100 pos
U089	senastUppdaterad	Se U12 nedan	0..1	Klass
U095	vilandefranochmed	Från och med vilket datum dospatienten har haft eller ska ha status Vilande	0..1	Datum
U096	vilandetillochmed	Till och med vilket datum dospatienten har haft eller ska ha status Vilande	0..1	Datum
U100	hemleverans	Indikerar att läkemedlen skickas till dospatientens hemadress. True = läkemedlen ska skickas till dospatientens hemadress False = läkemedlen ska inte skickas till dospatientens hemadress	1..1	Boolean
U101	aktörsbunden	Indikerar om dostjänsten är bunden till dosaktören eller upphandlad av en region True = dostjänsten är bunden till dosaktören False = dostjänsten är upphandlad av en region	1..1	Boolean

U2. Patientinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U011	fornamn	Dospatientens förnamn	1..1	1 - 80 pos
U012	mellannamn	Dospatientens mellannamn	0..1	1 - 40 pos
U013	efternamn	Dospatientens efternamn	1..1	1 - 60 pos
U015	personnummer	Personnummer för dospatient enligt format: YYYYMMDDXXXX	1..1	Exakt 12 pos
U016	lanskod	Dospatientens län	0..1	1 - 2 pos
U017	kommunkod	Dospatientens kommun	0..1	1 - 2 pos

U3. AdressInfoFolk

Patientens folkbokföringsadress

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U019	gatuadress	Patientens folkbokföringsadress	0..1	1 - 50 pos
U111	foadress	Fortsättningsadress på gatuadress	0..1	1 - 35 pos
U020	postnummer	Patientens postnummer	0..1	Exakt 5 pos
U021	ort	Patientens folkbokföringsort	0..1	1 - 50 pos
U110	coAdress	Patientens c/o adress om sådan finns	0..1	1 - 50 pos
U112	land	Patientens land i klartext	0..1	Datum
U113	skapadDat	Datum när adressen skapades i FOLK	0..1	Datum
U114	andradDat	Datum när adressen senast ändrades i FOLK	0..1	Datum

U4. AdressInfoSPost

Patientens särskilda postadress om sådan finns

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U115	gatuadress	Patientens särskilda postadress	0..1	1 - 50 pos
U116	foadress	Fortsättningsadress på patientens särskilda postadress	0..1	1 - 35 pos
U117	postnummer	Postnummer för patientens särskilda postadress	0..1	Exakt 5 pos
U118	ort	Ort för patientens särskilda postadress	0..1	1 - 50 pos
U119	coAdress	Patientens c/o adress om sådan finns	0..1	1 - 50 pos
U120	land	Land för patientens särskilda postadress i klartext	0..1	Datum
U121	skapadDat	Datum när adressen skapades i FOLK	0..1	Datum
U122	andradDat	Datum när adressen senast ändrades i FOLK	0..1	Datum

U5. Tillfällig adress

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U026	adress	Adress till tillfälligt boende	0..1	1 - 50 pos
U027	postnummer	Postnummer till tillfälligt boende	0..1	Exakt 5 pos
U028	ort	Tillfälliga boendets postort	0..1	1 - 50 pos
U029	telefon	Tillfälliga boendets telefonnummer	0..1	1 - 15 pos
U030	id	ID för dosmottagare/leveransadress kopplad till tillfällig adress	0..1	1 - 31 pos
U099	namn	Namn på dosmottagare kopplad till tillfällig adress	0..1	1 – 64 pos
U096	frandatum	Tillfällig adress giltig fr o m datum	0..1	Datum
U097	tilldatum	Tillfällig adress giltig t o m datum	0..1	Datum

U6. Dosmottagare

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U035	adress	Adress för dosmottagare	0..1	1 - 50 pos
U036	postnummer	Postnummer till dosmottagare	0..1	1 - 40 pos
U037	ort	Dosmottagarens postort	0..1	1 - 64 pos
U039	arbetsplatskod	Arbetsplatskod för dosmottagare	0..1	1 - 13 pos
U040	id	ID för dospatientens aktuella dosmottagare	0..1	1 - 31 pos
U041	namn	Namn på dosmottagare	0..1	1 – 64 pos
U069	dosaktor	Den dosaktör som dosmottagaren tillhör	0..1	1 - 50 pos
U070	dosapotek	Namn på det dosapotek som dosmottagaren tillhör	0..1	1 - 50 pos
U109	dosapotekid	GLN-kod till det dosapotek som dosmottagaren tillhör	0..1	Exakt 13 pos
U102	avdelning	Namnet på dospatientens avdelning om dosmottagaren är ett boende	0..1	1 - 50 pos
U103	kommunkod	Dosmottagarens kommunkod	0..1	1 - 2 pos
U104	lanskod	Dosmottagarens länskod	0..1	1 - 2 pos
U105	boende	Indikerar om dosmottagaren är ett boende. True = Dosmottagaren är ett boende False = Dosmottagaren är inte ett boende	0..1	Boolean
U106	sampack	Indikerar om läkemedel till patienter tillhörande dosmottagaren kan paketeras ihop. True = patienters läkemedel kan paketeras ihop med andra patienters läkemedel False = patienters läkemedel kan inte paketeras ihop med andra patienters läkemedel	0..1	Boolean
U107	Produktionsinformation	Se U9 nedan	0..1	Klass
U108	Leveransadress	Se U7 nedan	0..1	Klass

U7. Leveransadress

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U035	adress	Adress för dosmottagare/leveransadress	0..1	1 - 50 pos
U036	postnummer	Postnummer till dosmottagare/leveransadress	0..1	1 - 40 pos
U037	ort	Dosmottagarens/leveransadressens postort	0..1	1 - 64 pos
U039	arbetsplatskod	Arbetsplatskod för dosmottagare/leveransadress	0..1	1 - 13 pos
U040	id	ID för dosmottagare/leveransadress	0..1	1 - 31 pos
U041	namn	Namn på dosmottagare/leveransadress	0..1	1 – 64 pos
U124	dosaktor	Den dosaktör som dosmottagaren/leveransadressen tillhör.	0..1	1 - 50 pos
U125	dosapotek	Det dosapotek som dosmottagaren/leveransadressen tillhör.	0..1	1 - 50 pos
U102	avdelning	Namnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende	0..1	1 - 50 pos
U103	kommunkod	Dosmottagarens/leveransadressens kommunkod	0..1	1 - 2 pos
U104	lanskod	Dosmottagarens/leveransadressens länskod	0..1	1 - 2 pos

U8. Kontaktinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U043	PALforskrivarkod	Förskrivarkod till patientansvarig läkare (=PAL)	0..1	Exakt 7 pos
U044	PALfornamn	Förnamn PAL	0..1	1 - 25 pos
U045	PALefternamn	Efternamn PAL	0..1	1 - 50 pos
U046	anhorigkontaktnamn		0..1	1 - 50 pos
U047	anhorigkontaktemail	E-postadress till anhörig	0..1	1 - 40 pos
U048	ansvarigkontaktnamn		0..1	1 - 50 pos
U049	ansvarigkontaktemail		0..1	1 - 40 pos
U050	ansvarigkontaktadress		0..1	1 - 50 pos
U051	ansvarigkontaktpostnummer		0..1	Exakt 5 pos
U052	ansvarigkontaktpostort		0..1	1 - 50 pos
U053	ansvarigkontakttelefon1		0..1	1 - 15 pos
U054	ansvarigkontakttelefon2		0..1	1 - 15 pos
U055	vardandeenhetid	ID för ordinationsansvarig enhet	0..1	1 - 31 pos
U056	vardandeenhetnamn	Namn på ordinationsansvarig enhet	0..1	1 - 64 pos
U057	vardandeenhetpostort	Postort för ordinationssansvarig enhet	0..1	1 - 50 pos
U058	vardandeenhetpostnummer		0..1

U8. Produktionsinformation

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U071	dosapotekid	GLN-kod för dosapotek	1..1	Exakt 13 pos
U072	stopptidbestallning	Datum och klockslag	0..1	Datum
U073	stopptidordination	Datum och klockslag	0..1	Datum
U074	forstadosdag	Första dosdag för leveransomgång	1..1	Datum
U075	dosvecka	Vilken vecka dosleveransen kommer till dosmottagaren Möjliga värden: U = udda vecka J = jämn vecka V = varje vecka	0..1	Sträng
U076	doseringsschema	Standardschema Se U9 nedan	1..1	Klass
U095	akutstopptid	Akut stopptid för beställning	0..1	Datum

U9. Standardschema

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U077	periodlangd	Längd på produktionsperiod i dagar tex 7, 14 eller 21	1..1	Integer
U078	intagstillfalle	Intagstillfälle Se U10 nedan	1..*	Klass

U10. Intagstillfälle

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

U079

intagstillfalleKl

Klockslag enligt standardschema för intagstillfällen t ex 08, 12, 16, 20

1..1

Integer

U12. SenastUppdaterad

ID	<XML-tag> / fältnamn	Kort beskrivning	Mult	Validering/ Anmärkning
U090	senastUppdaterad	Tidsstämpel för när vårdtagarinformationen senast uppdaterades	0..1	Datum
U091	senastUppdateradAvFornamn	Förnamn på den som senast uppdaterat vårdtagarinformationen	0..1	1 - 25 pos
U092	senastUppdateradAvEfternamn	Efternamn på den som senast uppdaterat vårdtagarinformationen	0..1	1 - 25 pos
U093	senastUppdateradAvArbetsplats	Arbetsplatskod alternativt apoteksid för den som senast uppdaterat vårdtagarinformationen	0..1	1 - 13 pos
U094	versionsid	Versionsnummer för aktuell version av vårdtagarinformationen	1..1	Long

Verksamhetsregler/logik

ID	Verksamhetsregler/logik
R001	En dospatients tillfälliga 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
R002	Om dospatientens personnummer inte hittas i SOL returneras ett fel (ERROR) i U001 resultatkod.
R005	Om I012 personnummer ej finns i FOLK eller dospatienten saknar dossamtycke hos eHälsomyndigheten så returneras ett felmeddelande.
R006	Om I012 personnummer ej finns i FOLK eller dospatienten saknar dossamtycke så sätts statusen i SOL till AVFÖRD. Om dospatienten har status avliden i FOLK sätts statusen i SOL till AVLIDEN. Dospatient som tilldelas status AVFÖRD eller AVLIDEN historiseras efter ett givet antal dagar som bestäms av eHälsomyndigheten.

Versionshistorik

Version

Datum

Kommentar

1.0

2021-11-27

Ny handbok vård- och apotekstjänster

1.1

2022-05-25

U5. Särskilt boende och hemsjukvårdinformation ersatt av U6. Dosmottagare

U102-U108 tillagda i U6. Dosmottagare

Referens till U6. Dosmottagare flyttad till U1. Vårdtagarinformation

U100 hemleverans tillagd

U089 Senast uppdaterad flyttad till U1. Vårdtagarinformation

U8. Leveransadress tillagd

R007 borttagen då produktionsinformation alltid finns i U6. Dosmottagare

U101 aktörsbunden tillagd

U3. Hemmaboendeinformation ersatt av U3. AdressinfoFolk och

U4. SPostadress

1.2

2022-11-10

Ändrat maxlängd för vilandestatusorsak till 100 tecken