Dosmigrering (SOL:51)
Denna tjänst används när en region upphandlar en ny dosleverantör och behov av att flytta flera dospatienter från ett dosapotek till ett annat uppstår.
Varje flytt kräver ett antal åtgärder från dosaktören, information om det hittar du här Byte av dosaktör vid massmigrering.
Innehållsförteckning
1. Tjänstespecifikation Dosmigrering (SOL:51)
dosmigrering V1.0
2. Indata
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| I001 | tilldosapotekid | GLN-kod för det dosapotek dospatienten migreras till | 1..1 | Exakt 13 pos Valideras mot EXPO Se R002, R009 |
| I002 | Behorighetsinformation | Se I1 nedan | 1..1 | Klass |
| I003 | Flyttlista | Se I2 nedan | 1..1 | Klass |
2.1. I1. Behörighetsinformation
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| I004 | fornamn | Farmaceuts eller annan apotekspersonals förnamn | 1..1 | 1 - 25 pos Se R007 |
| I005 | efternamn | Farmaceuts eller annan apotekspersonals efternamn | 1..1 | 1 - 25 pos Se R007 |
| I006 | legitimationskod | Farmaceuts legitimationskod | 0..1 | Exakt 6 pos |
| I007 | yrkesroll | Farmaceutens yrkesroll FA = Farmaceut (apotekare och receptarie) eller AP = apotekspersonal | 1..1 | Enum |
| I008 | dosapotekid | GLN-kod för dosapotek | 1..1 | Exakt 13 pos Valideras mot EXPO Se R002, R007 |
2.2. I2. Flyttlista
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| I009 | FlyttInfo | Objekt innehållande de dospatienter som ingår i migreringen. Se I3. nedan | 1..* | Klass |
2.3. I3. FlyttInfo
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| I010 | personnummer | Personnummer för dospatient enligt format YYYYMMDDXXXX | 1..1 | Exakt 12 pos Se R003, R004 |
| I011 | tilldosmottagareId | ID för dosmottagare som dospatient flyttas till | 1..1 | R006 |
| I012 | tillordinationsansvarigenhet | ID för ordinationsansvarig enhet | 0..1 | Se R005 |
| I013 | tilldosmottagaridtillfalligadress | ID för dosmottagare/leveransadress som ska kopplas till dospatientens tillfälliga adress | 0..1 | R006 |
| I014 | versionsid | Aktuellt versions-id för den vårdtagare som ska migreras. | 1..1 | R008 |
3. Utdata
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| U001 | resultatkod | Möjliga värden: INFO WARN ERROR | 1..1 | Enum Resultatkod WARN returneras om det finns poster i Resultatlista som har ett felmeddelande. |
| U002 | meddelandetext | 1..1 | 1 - 300 pos | |
| U003 | meddelandeid | ID för responsmeddelande | 1..1 | Integer |
| U004 | Resultatlista | Se U1 nedan | 1..1 | Klass |
3.1. U1. Resultatlista
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| U005 | Resultat | Se U2 nedan | 0..* | Klass |
3.2. U2. Resultat
| ID | <XML-tag>/ fältnamn | Kort beskrivning | Mult | Validering/Anmärkning |
|---|---|---|---|---|
| U006 | Personnummer | Personnummer för dospatient enligt format YYYYMMDDXXXX | 1..1 | 12 pos |
| U007 | Felmeddelande | Text som förklarar utfallet av migreringen för denna dospatient. | 0..1 | 1 - 300 pos Returneras endast patienten inte kunde flyttas. |
4. Verksamhetsregler/Logik
| ID | Verksamhetsregel/Logik |
|---|---|
| R002 | Användare hos ett dosapotek kan endast flytta en dospatient till ett dosapotek inom den egna dosaktören. Kontroll sker att I008 dosapotekid och I002 tilldosapotekid tillhör samma dosaktör. |
| R003 | Flytt medges ej om dospatientens är avliden i SOL. |
| R004 | Flytt medges ej om det finns beställningar med status MOTTAGEN/MOTTAGEN AV APOTEK/UNDER BEARBETNING för dospatienten. |
| R005 | Om I012 tillordinationsansvarigenhet finns i SOL och tillhör samma dosapotek som dospatienten ska flyttas till, så kopplas dospatienten dit. Om I012 utelämnas så tas uppgifter om vårdtagarens ”ordinationsansvariga enhet” bort ur SOL. Flytt medges ej om angivet id saknas i SOL. |
| R006 | En validering sker att dosmottagare/tillfällig leveransadress (I011, I013) finns i SOL och tillhör samma dosapotek som dospatienten ska flyttas till. |
| R007 | I004 fornamn, I005 efternamn, I008 dosapotekid samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat dospatientens informationen och när. |
| R008 | I014 versionsid måste överensstämma med dospatientens versionsid i SOL för att uppdateringen ska lyckas. |
| R009 | Vid migrering i SOL görs även motsvarande flytt på patientens dosunderlag i Nationella läkemedelslistan. Flytt där görs till samma dosapotek som anges i I001. Statusen på dosunderlaget förändras inte vid dosmigrering. |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2022-05-25 | Ny sida |
| 1.1 | 2024-02-22 | Tagit bort R001 |