Skapa ny vårdtagare för dos (SOL:01)
Med denna tjänst kan vården skapa en vårdtagare för dos, en så kallad dospatient. Dospatienten är knuten till ett specifikt dosapotek som kommer att producera dospåsarna åt dospatienten. Dostillhörigheten visar vilket dosapotek dospatienten tillhör.
Innehållsförteckning
1. Tjänstespecifikation Skapa ny vårdtagare för dos (SOL:01)
SkapaVardtagare 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ältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I002 | Behorighetsinformation | Se I1 nedan | 1..1 | Klass |
I011 | forskrivaresamtyckefornamn | Förnamn på användare som inhämtat dossamtycke | 1..1 | 1 - 25 pos |
I012 | forskrivaresamtyckeefternamn | Efternamn på användare som inhämtat dossamtycke | 1..1 | 1 - 50 pos |
I013 | forskrivaresamtyckeforskrivarkod | Förskrivarkod för läkare som inhämtat dossamtycke | 0..1 | Exakt 7 pos |
I014 | forskrivaresamtyckearbetsplatskod | Arbetsplatskod för användare som inhämtat dossamtycke | 1..1 | 1 - 13 pos |
I015 | forskrivaresamtyckeyrkeskod | Tillåtna värden: LK=Läkare SJ = Sjuksköterska | 1..1 | Enum Se R004 |
I016 | Vardtagarinformation | Se I2 nedan | 1..1 | Klass |
I102 | meddelandetillapotek | Meddelande till dosapotek | 1..1 | 1 - 1024 pos |
3.1. I1. Behörighetsinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I003 | fornamn | Förnamn på användare som registrerar dospatient | 1..1 | 1 - 25 pos Se R010 |
I004 | efternamn | Efternamn på användare som registrerar dospatient | 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.2. I2. Vårdtagarinformation
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I017 | hemmaboende | Indikator om ny dospatient är hemmaboende eller inte True = Hemmaboende False = Ej hemmaboende | 1..1 | Boolean Se R001 och R002 |
I018 | dosapotekid | GLN kod till dosapotek | 1..1 | Exakt 13 pos Valideras mot EXPO |
I021 | avvikandedosschema | Indikator om avvikande dosschema eller inte True = Avvikande dosschema False = Ej avvikande dosschema | 1..1 | Boolean |
I020 | forstadosdag | Dag då dospatient ska påbörja behandling med dosdispenserade läkemedel. Anges om annan än den som finns i dospatientens produktionsinformation. | 0..1 | Datum |
I027 | personnummer | Personnummer för ny dospatient enligt format: YYYYMMDDXXXX | 1..1 | Exakt 12 pos Se R012 och R013 |
I034 | telefon | Telefonnummer | 0..1 | 1 - 15 pos |
I035 | dosmottagareid | ID för dosmottagare för hemmaboende (dospatientens folkbokföringsadress) | 1..1 | 1 - 31 pos |
I037 | Tillfalligadress | Se I5 nedan | 0..1 | Klass |
I054 | Kontaktinformation | Se I7 nedan | 0..1 | Klass |
I100 | vilandestatusorsak | Orsak till att dospatient ska ha status Vilande | 0..1 | 1 - 100 pos Se R009 |
I104 | vilandefranochmed | Från och med vilket datum dospatienten ska ha status Vilande | 0..1 | Datum Se R009 |
I105 | vilandetillochmed | Till och med vilket datum dospatienten ska ha status Vilande | 0..1 | Datum Se R009 |
3.3. I5. Tillfällig adress
| ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
|---|---|---|---|---|
I038 | adress | Adress till tillfälligt boende | 0..1 | 1 - 50 pos |
I039 | postnummer | Postnummer till tillfälligt boende | 0..1 | 5 - 6 pos |
I040 | ort | Tillfälliga boendets postort | 0..1 | 1 - 50 pos |
I041 | telefon | Tillfälliga boendets telefonnummer | 0..1 | 1 - 15 pos |
I042 | dosmottagareid | ID för dosmottagare | 0..1 | 1 - 31 pos Valideras mot dosmottagare i SOL |
I043 | frandatum | Tillfällig adress giltig fr o m datum | 0..1 | Datum Se R003 |
I044 | tilldatum | Tillfällig adress giltig t o m datum | 0..1 | Datum Se R003 |
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 Se R011 |
4. Utdata
Utdata returneras enligt Utdata i Hämta vårdtagareinformation (SOL:02).
5. Verksamhetsregler/logik
| ID | Verksamhetsregler/logik |
|---|---|
R003 | En dospatient kan vara kopplad till tre typer av boenden: Tillfällig adress, Hemmaboende och Särskilt boende/hemsjukvård. Endast en av dessa är dock gällande vid en viss tidpunkt: 1. 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 2. Annars om hemmaboende = True gäller Hemmaboende 3. Annars om hemmaboende = False gäller Särskilt boende/hemsjukvård |
R004 | Giltig yrkeskod för I015 forskrivaresamtyckeyrkeskod är LK och SJ. Om I015 = LK är I013 obligatoriskt, annars valfritt fält. |
R005 | När ny dospatient har skapats, skapar SOL ett nytt meddelande adresserat till dennes dosapotek (se tjänstespecifikation SOL:09 Skicka meddelanden till dosapotek). |
R009 | I105 vilandetillochmed får inte ligga före I104 Vilandefranochmed. I100 vilandestatusorsak måste anges om I104 vilandefranochmed har angivits. I100 vilandestatusorsak kan inte anges och om I104 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 | Vårdande enhet och dosmottagare/produktionsinformation för dospatientens boenden måste tillhöra samma dosaktör som dospatienten. |
R012 | I027 personnummer måste finnas och ej ha status Tekniskt avregistrerad eller Avliden i FOLK. |
| R013 | I027 personnummer får inte sedan tidigare finnas sparat som vårdtagare i SOL. |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
| 1.1 | 2022-05-25 | Tagit bort I046 boendeenhetid och I097 statuskod 2.5 Utdata refererar till SOL 02 Uppdaterat R009 Tagit bort R001, R002 och R013 |
| 1.2 | 2022-11-10 | Maxlängd för I100 vilandestatusorsak ändrad till 100 tecken. |
| 1.3 | 2023-08-24 | R013 tillagd |
| 1.4 | 2024-02-22 | Uppdaterat R012. |