Uppdatera vårdtagare, dosaktör (SOL:23)

Med denna tjänst kan dosaktören uppdatera information kopplad till dospatient. Dospatienten är via sitt boende knuten till ett specifikt dosapotek som producerar dospåsarna åt dospatienten.


Innehållsförteckning

1. Tjänstespecifikation Uppdatera vårdtagare (SOL:23)

UppdateraVardtagareinformationDosaktor 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

vardtagarinformation

Se I2 nedan

1..1

Klass

I005

behorighetsinformation

Se I1 nedan

1..1

Klass

3.1. I1. Behörighetsinformation

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I006

fornamn

Farmaceuts eller annan apotekspersonals förnamn

1..1

1 - 25 pos

Se R012

I007

efternamn

Farmaceuts eller annan apotekspersonals efternamn

1..1

1 - 25 pos

Se R012

I008

legitimationskod

Farmaceuts legitimationskod

0..1

Exakt 6 pos

I009

yrkesroll

Användarens yrkesroll:

FA = Farmaceut (apotekare och receptarie)

eller

AP = apotekspersonal

1..1

Enum

I010

dosapotekid

GLN-kod för dosapotek

1..1

Exakt 13 pos

Valideras mot EXPO

Se R001, R012


3.2. I2. Vårdtagarinformation

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I011

hemmaboende

Indikator om dospatient är hemmaboende eller inte

Tillåtna värden:

JA

NEJ

1..1

Enum


Se R003, R004

I014

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

I015

avvikandedosschema

Indikator om avvikande dosschema eller inte

Tillåtna värden:

JA

NEJ

1..1

Enum


I029

personnummer

Personnummer för dospatient enligt format:

YYYYMMDDXXXX

1..1

Exakt 12 pos

I037

telefon

Telefonnummer

0..1

1 - 15 pos

I033

dosmottagareid

ID för dosmottagare som vårdtagaren är kopplad till.

1..1

1 - 31 pos

Valideras mot dosmottagare i SOL

I018

Tillfalligadress

Se I5 nedan

0..1

Klass

I020

kontaktinformation

Se I7 nedan


0..1

Klass

I024

vilandestatusorsak

Orsak till att dospatienten har eller ska ha status Vilande

0..1

1 - 100 pos

Se regel R010

I098

vilandefranochmed

Från och med vilket datum dospatienten ska ha status Vilande

0..1

Datum

Se R010

I099

vilandetillochmed

Till och med vilket datum dospatienten ska ha status Vilande

0..1

Datum

Se R010

I100

versionsid

Versionsnummer för aktuell version av vårdtagarinformationen

1..1

Long

Se R013

I101hemleverans

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
I102aktorsbunden

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

3.3. I5. Tillfällig adress

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I038

adress

Adress till tillfällig adress

0..1

1 - 50 pos

I039

dosmottagareid

ID för dosmottagare

0..1

1 - 31 pos

Valideras mot dosmottagare i SOL

I041

ort

Postort för tillfällig adress

0..1

1 - 50 pos

I042

postnummer

Postnummer för tillfällig adress

0..1

5 - 6 pos

I043

telefon

Telefonnummer till tillfällig adress

0..1

1 - 15 pos

I044

frandatum

Tillfällig adress giltig fr o m datum

1..1

Datum

Se R006

I045

tilldatum

Tillfällig adress giltig t o m datum

0..1

Datum

Se R006

3.4. I7. Kontaktinformation

ID

<XML-tag> / fältnamn

Kort beskrivning

Mult

Validering/ Anmärkning

I055

PALforskrivarkod

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

0..1

Exakt 7 pos

I056

PALfornamn

Förnamn PAL

0..1

1 - 25 pos

I057

PALefternamn

Efternamn PAL

0..1

1 - 50 pos

I058

anhorigkontaktnamn


0..1

1 - 50 pos

I059

anhorigkontaktemail

E-postadress till anhörig

0..1

1 - 40 pos

I060

ansvarigkontaktnamn


0..1

1 - 50 pos

I061

ansvarigkontaktemail


0..1

1 - 40 pos

I062

ansvarigkontaktadress


0..1

1 - 50 pos

I063

ansvarigkontaktpostnummer


0..1

Exakt 5 pos

I064

ansvarigkontaktpostort


0..1

1 - 50 pos

I065

ansvarigkontakttelefon1


0..1

1 - 15 pos

I066

ansvarigkontakttelefon2


0..1

1 - 15 pos

I067

vardandeenhetid

ID för ordinationsansvarig enhet

0..1

1 - 64 pos

Valideras mot ordinerande enheter i SOL


4. Utdata

Utdata returneras enligt Utdata i Hämta vårdtagareinformation, dosaktör (SOL:22)

5. Verksamhetsregler/logik

ID

Verksamhetsregler/logik

R001

Dosaktörsanvändare ska endast kunna uppdatera dospatient inom den egna dosaktören. Kontroll sker genom jämförelse av att I010 dosapotekid och dospatientens dosapotektillhör samma aktör.

R005

  1. Tillfällig adress gäller om den finns och
  2. a)  både frandatum och tilldatum har angivits och dagens datum ligger inom datumintervallet frandatum – tilldatum

eller

  1. b) dagens datum har passerat frandatum och tilldatum är tomt

eller

c) dagens datum har inte passerat tilldatum och frandatum är tomt

R010

I099 vilandetillochmed får inte ligga före I098 vilandefranochmed

I024 vilandestatusorsak måste anges om I098 vilandefranochmed har angivits.

I024 vilandestatusorsak kan inte anges om I098 vilandefranochmed inte har angivits.


R012

I006 fornamn, I007 efternamn, I010 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat vårdtagarinformationen och när.

R013

I100 versionsid måste överensstämma med dospatientens versionsid i SOL för att uppdateringen ska genomföras.

R014

Vårdande enhet och dosmottagare/produktionsinformation för dospatientens boenden måste tillhöra samma dosapotek som dospatienten.


Versionshistorik

Version

Datum

Kommentar

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

Tillagt: I101 och I102

Borttaget: I047, I094, R003, R004, R009, R010, R011, R015, R016

Ändrat: Utdata tabeller borttagna, R005 och R010 omformulerade, I033 till obligatorisk

1.22022-11-10Ändrat maxlängd för I024 vilandestatusorsak till 100 tecken.
1.32024-02-22Tagit bort R002