Hämta vårdtagareinformation, dosaktör (SOL:22)

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


Innehållsförteckning

1. Tjänstespecifikation Hämta vårdtagareinformation, dosaktör (SOL:22)

HamtaVardtagareinformationDosaktor 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.

3. Indata

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

I002

behorighetsinformation

Se I1 nedan

1..1

Klass

I012

personnummer

Dospatients personnummer i format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

3.1. I1. Behörighetsinformation

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

I003

fornamn

Farmaceuts eller annan apotekspersonals förnamn

1..1

1 - 25 pos

I004

efternamn

Farmaceuts eller annan apotekspersonals efternamn

1..1

1 - 25 pos

I005

legitimationskod

Farmaceuts legitimationskod

0..1

Exakt 6 pos

I006

yrkesroll

Användarens yrkesroll

FA = Farmaceut (apotekare och receptarie)

eller

AP = apotekspersonal

1..1

Enum



I007

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

Valideras mot EXPO

4. Utdata

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U001

resultatkod

Möjliga värden:
INFO
WARN
ERROR

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

U005

samtyckeforskrivare

Se U12 nedan

0..1

Klass

4.1. U1. Vårdtagarinformation

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U006

hemmaboende

Indikator om ny dospatient är hemmaboende eller inte

1=Ja

2=Nej

1..1

Enum


U007

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

U008

dosapoteknamn

Namn på dosapotek

1..1

1 - 50 pos

Hämtas från EXPO


U009

forstadosdag

Första dosdag för leveransomgång för dosmottagare

0..1

Datum


U010

avvikandedosschema

Visar om avvikande dosschema används

Möjliga värden:

1=Ja

2=Nej

1..1

Enum

U011

patientinformation

Se U2 nedan

1..1

Klass

Hämtas från FOLK

U012

adressInfoFolk

Se U3 nedan

0..1

Klass

Hämtas från FOLK

U030

telefon

Telefonnummer

0..1

1 - 15 pos

U013

tillfalligadress

Se U4 nedan

0..1

Klass

U014

dosmottagare

Se U6 nedan

0..1

Klass

U015

kontaktinformation

Se U8 nedan

0..1

Klass

U017

adressInfoSPost

Se U8 nedan

0..1

Klass

Hämtas från FOLK

U089

statuskod

Vårdtagarstatuskod


Möjliga värden:

AKTIV

VILANDE

AVFORD

AVLIDEN

1..1

Enum

U097senastUppdateradSe U13 nedan1..1Klass

U019

vilandestatusorsak

Orsak till att dospatienten har, har haft eller ska ha status Vilande

0..1

1 - 100 pos

U102

vilandefranochmed

Från och med vilket datum dospatienten har, har haft eller ska ha status Vilande

0..1

Datum

U103

vilandetillochmed

Till och med vilket datum dospatienten har, har haft eller ska ha status Vilande

0..1

Datum

U104versionsidVersionsnummer för aktuell version av vårdtagarinformationen1..1Long
U105hemleverans

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
0..1Boolean
U106aktö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
0..1Boolean

4.2. U2. Patientinformation

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U020

fornamn

Dospatientens förnamn

1..1

1 - 80 pos

U021

mellannamn

Dospatientens mellannamn


0..1


1 -  40 pos


U022

efternamn

Dospatientens efternamn

1..1

1 - 60 pos

U024

personnummer

Personnummer för dospatient enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

U025

lanskod

Dospatientens län

0..1

1 - 2 pos

U026

kommunkod

Dospatientens kommun

0..1

1 - 2 pos

4.3. U3. AdressInfoFolk

Patientens folkbokföringsadress

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U027

gatuadress

Patientens folkbokföringsadress

0..1

1 - 50 pos

U107foadressFortsättningsadress på gatuadress0..11 - 35 pos
U108coAdressPatientens c/o adress om sådan finns0..11 - 50 pos

U028

postnummer

Hempostnummer

0..1

1 - 10 pos

U029

ort

Hempostort

0..1

1 - 50 pos

U031

land

Patientens land i klartext

0..1

1 - 31 pos

U032

skapadDat

Datum när adressen skapades i FOLK

0..1

Datum

U109andradDatDatum när adressen senast ändrades i FOLK0..1Datum

4.4. U4. AdressInfoSPost

Patientens särskilda postadress om sådan finns

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U110

gatuadress

Patientens särskilda postadress

0..1

1 - 50 pos

U111foadressFortsättningsadress på patientens särskilda postadress0..11 - 35 pos
U112postnummerPostnummer för patientens särskilda postadress0..1Exakt 5 pos
U113ortOrt för patientens särskilda postadress0..11 - 50 pos
U114coAdressPatientens c/o adress om sådan finns0..11 - 50 pos
U115landLand för patientens särskilda postadress i klartext0..11 - 35 pos
U116skapadDatDatum när adressen skapades i FOLK0..1Datum
U117andradDatDatum när adressen senast ändrades i FOLK0..1Datum

4.5. U5. Tillfällig adress

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U033

adress

Adress till tillfälligt boende

0..1

1 - 50 pos

U034

postnummer

Postnummer till tillfälligt boende

0..1

5 - 6 pos

U035

ort

Postort för tillfälligt boende

0..1

1 - 50 pos

U036

telefon

Telefonnummer för tillfälligt boende

0..1

1 - 15 pos

U037

id

ID för dosmottagare/leveransadress kopplad till den tillfälliga adressen

1..1

1 - 31 pos

U038

namn

Namn på dosmottagare/leveransadress kopplad till den tillfälliga adressen

0..1

1 – 64 pos

Se R007

U039

frandatum

Tillfällig adress giltig fr o m datum

0..1

Datum

U040

tilldatum

Tillfällig adress giltig t o m datum

0..1

Datum

4.6. U6. Dosmottagare

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning
U041adressAdress för dosmottagare 0..11 - 50 pos
U042postnummerPostnummer till dosmottagaren0..15 - 6 pos
U043ortDosmottagarens postort0..11 - 64 pos
U044arbetsplatskodArbetsplatskod för dosmottagare0..11 - 13 pos
U045idID för dospatientens aktuella dosmottagare  0..11 - 31 pos

U046

namn

Namn på dosmottagare

0..1

1 - 64 pos

Se R007

U047dosaktorDen dosaktör som dosmottagaren tillhör.0..11 - 50 pos
U048dosapotekNamn för det dosapotek som dosmottagaren tillhör.0..11 - 50 pos

U135

dosapotekid

GLN-kod för det dosapotek som dosmottagaren tillhör.

0..1

Exakt 13 pos

U049

avdelning

Namnet på dospatientens avdelning om dosmottagaren är ett boende

0..1

1 - 50 pos

U118kommunkodDosmottagarens kommunkod0..11 - 2 pos
U119lanskodDosmottagarens länskod0..11 - 2 pos
U120boende

Indikerar om dosmottagaren är ett boende.

True = Dosmottagaren är ett boende

False = Dosmottagaren är inte ett boende
0..1Boolean
U121sampack

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..1Boolean
U122ProduktionsinformationSe U90..1Klass
U123LeveransadressSe U70..1Klass
U136DoldIndikerar om dosmottagaren är dold eller synlig för vården0..1Boolean

4.7. U7. Leveransadress

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U124

adress

Adress för dosmottagare/leveransadress

0..1

1 - 50 pos

U125postnummerPostnummer till dosmottagare/leveransadress0..11 - 40 pos
U126ortDosmottagarens/leveransadressens postort0..11 - 64 pos
U127arbetsplatskodArbetsplatskod för dosmottagare/leveransadress0..11 - 13 pos
U128idID för dosmottagare/leveransadress0..11 - 31 pos
U129namnNamn på dosmottagare/leveransadress0..11 - 64 pos
U130dosaktorDen dosaktör som dosmottagaren/leveransadressen tillhör.0..11 - 50 pos
U131dosapotekDet dosapotek som dosmottagaren/leveransadressen tillhör.0..11 - 50 pos
U132avdelningNamnet på dospatientens avdelning om dosmottagaren/leveransadressen är ett boende0..11 - 50 pos
U133kommunkodDosmottagarens/leveransadressens kommunkod0..11 - 2 pos
U134lanskodDosmottagarens/leveransadressens länskod0..11 - 2 pos

4.8. U8. Kontaktinformation

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U050

PALforskrivarkod

Förskrivarkod för patientansvarig läkare (=PAL)

0..1

Exakt 7 pos

U051

PALfornamn

Förnamn PAL

0..1

1 - 25 pos

U052

PALefternamn

Efternamn PAL

0..1

1 - 50 pos

U053

anhorigkontaktnamn


0..1

1 - 50 pos

U054

anhorigkontaktemail

E-postadress till anhörig 

0..1

1 - 40 pos

U055

ansvarigkontaktnamn


0..1

1 - 50 pos

U056

ansvarigkontaktemail


0..1

1 - 40 pos

U057

ansvarigkontaktadress


0..1

1 - 50 pos

U058

ansvarigkontaktpostnummer


0..1

Exakt 5 pos

U059

ansvarigkontaktpostort


0..1

1 - 50 pos

U060

ansvarigkontakttelefon1


0..1

1 - 15 pos

U061

ansvarigkontakttelefon2


0..1

1 - 15 pos

U062

vardandeenhetid

ID för ordinationsansvarig enhet

0..1

1 - 64 pos

U063

vardandeenhetnamn


0..1

1 - 64 pos

U064

vardandeenhetpostort


0..1

1 - 50 pos

U065

vardandeenhetpostnummer


0..1

5 - 6 pos

4.9. U9. Produktionsinformation

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U076

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

U077

stopptidbestallning

Datum och klockslag

0..1

Datum

U078

stopptidordination

Datum och klockslag

0..1

Datum

U079

forstadosdag

Första dosdag för leveransomgång för dosmottagare

1..1

Datum

U073

akutstopptid

Klockslag

0..1

Datum

U080

dosvecka

Vilken vecka dosleveransen kommer till dosmottagaren

Möjliga värden:
U = Udda
J = Jämn
V = Varje

0..1

10 pos

U081

standardschema

Se U9 nedan

1..1

Klass

4.10. U10. Standardschema

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U084

periodlangd

Längd på produktionsperiod i dagar tex 7, 14 eller 21

1..1

Integer

U085

intagstillfalle

Se U10 nedan

1..*

 

Klass

 

4.11. U11. Intagstillfälle

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U086

intagstillfalleKl

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

1..1


Integer


4.12. U12. Samtyckeförskrivare

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U092

fornamn

Förnamn på läkare som inhämtat dossamtycke

1..1

1 - 25 pos

U093

efternamn

Efternamn på läkare som inhämtat dossamtycke

1..1

1 - 50 pos

U094

forskrivarKod

Förskrivarkod för läkare som inhämtat dossamtycke

1..1

Exakt 7 pos

U095

arbetsplatsKod

Arbetsplatskod för läkare som inhämtat dossamtycke

1..1

1 - 13 pos

U096

yrkesKod


LK = Läkare

SJ = Sjuksköterska


1..1


Enum 

4.13. U13. SenastUppdaterad

ID<XML-tag> / fältnamnKort beskrivningMultValidering/ Anmärkning

U098

senastUppdaterad

Tidsstämpel för när vårdtagarinformationen senast uppdaterades

0..1

Datum

U099

senastUppdateradAvFornamn

Förnamn på den som senast uppdaterat vårdtagarinformationen

0..1

1 - 25 pos

U100

senastUppdateradAvEfternamn

Efternamn på den som senast uppdaterat vårdtagarinformationen

0..1

1 - 25 pos

U101

senastUppdateradAvArbetsplats

Arbetsplatskod alternativt apoteksid för den som senast uppdaterat vårdtagarinformationen

0..1

1 - 13 pos

U102

versionsid

Versionsnummer för aktuell version av vårdtagarinformationen

1..1

Long

5. Verksamhetsregler/logik

IDVerksamhetsregler/logik

R003

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

R004

Om dospatientens personnummer inte hittas i SOL returneras ett fel (ERROR) i U001 resultatkod.

R007

Om I007 dosapotekid och U007 dosapotekid inte tillhör samma dosaktör:

  • Om U106 aktörsbunden = true:
    Ett felmeddelande returneras ”Det gick inte att hitta någon Dospatient med angivet personnummer”

  • Om U106 aktörsbunden = false eller NULL:
    • Då returneras enbart U045, U118, U119, U120, U121, U122, U123 och U135 för U6. Dosmottagare
    • Och U128, U133 och U134 för U7. Leveransadress
R008

Om I012 personnummer ej finns i FOLK returneras ett felmeddelande.

R009

Om dospatienten saknar dossamtycke 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 E-hälsomyndigheten.

R011Om U096 yrkesKod = SJ kan U094 förskrivarKod vara tomt.


Versionshistorik

Version

Datum

Kommentar

1.02021-11-27Ny handbok vård- och apotekstjänster
1.12022-05-25

Tagit bort U3 Ordinärtboendeinformation och

U5 Särskilt boende och hemsjukvårdinformation

Lagt till U3 adressInfoFolk, U4 Spostdressinfo, U6 dosmottagare, U7 Leveransadress

Uppdaterat om R003 och R007.

Tagit bort R010

U105 hemleverans, U106 aktorsbunden och U121 sampack tillagda.

1.22022-11-10Ändrat maxlängd för U019 vilandestatusorsak till 100 tecken.
1.32023-08-24Lagt till U136 Dold och justerat R007, R008 och R009.
1.42024-02-22Tagit bort R002