Avbeställ originalförpackning (SOL:08)
Med denna tjänst kan vården avbeställa en eller flera beställningar som tidigare lagts av vården på en produkt i originalförpackning. Det kan vara ett läkemedel som inte kan dispenseras, exempelvis flytande hostmedicin, eller ett läkemedel som är ordinerat att intas vid behov.
Innehållsförteckning
1. Tjänstespecifikation Avbeställ originalförpackning (SOL:08)
AvbestallOriginalforpackning V3.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, ersätts av null om inget värde anges.
3. Indata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
---|---|---|---|---|
I002 | Behorighetsinformation | Se I1 nedan | 1..1 | Klass |
I011 | Avbestallningsinfo | Se I2 nedan | 1..* | Klass |
3.1. 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 Se R005 |
I004 | efternamn | Efternamn på behörig användare som använder tjänsten | 1..1 | 1 - 25 pos Se R005 |
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 | 1..1 | 1 - 13 pos Se R005 | |
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. Avbeställningsinfo
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
---|---|---|---|---|
I020 | bestallningsid | Beställningens ID, UUID | 1..1 | 1 - 40 pos Se R006 |
I027 | meddelandetillapotek | Meddelande till apotek | 0..1 | 0 - 255 pos |
4. Utdata
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
---|---|---|---|---|
U001 | resultatkod | Möjliga värden: | 1..1 | enum |
U002 | meddelandetext | 1..1 | 1 - 300 pos | |
U003 | meddelandeid | ID för responsmeddelande | 1..1 | Integer |
U004 | Bestallningsrader | Se U1 nedan | 0..* | Klass |
4.1. U1. Beställningsrader
ID | <XML-tag> / fältnamn | Kort beskrivning | Mult | Validering/ Anmärkning |
---|---|---|---|---|
U005 | bestallningsid | Beställningens ID, UUID | 1..1 | 1 - 40 pos |
U012 | personnummer | Personnummer för dospatient som beställningen avser enligt format: YYYYMMDDXXXX | 1..1 | Exakt 12 pos |
U015 | nplpackid | 0..1 | 0 - 16 pos | |
U016 | varunummer | 0..1 | 0 - 8 pos | |
U018 | ordinationsid | Ordination som avropas | 1..1 | 1 - 20 pos |
U019 | dosunderlagsversion | Version på dosunderlaget | 0..1 | 0 - 10 pos |
U020 | bestallningsresultat | Möjligt värde: | 0..1 | Integer |
U021 | bestallningsresultattext | Sätts alltid till ”Beställningen avbeställdes” | 0..1 | 0 - 80 pos |
U022 | bestallningsstatus | Möjligt värde: 4 = Avbeställd | 1..1 | Enum
|
U023 | statustidpunkt | Datum och klockslag | 1..1 | Datum |
U025 | meddelandefranapotek | Meddelande från dosapotek | 0..1 | 0 - 255 pos |
U026 | onskadleveranstid | Datum och klockslag | 0..1 | Datum |
U027 | planeradleveranstid | Datum och klockslag | 0..1 | Datum |
U028 | dosmottagareid | ID för dosmottagare | 0..1 | 0 - 31 pos |
U029 | dosmottagarenamn | Namn på dosmottagare | 0..1 | 1 – 64 pos |
U030 | bestallningstid | Datum och klockslag | 0..1 | Datum |
U031 | bestallarefornamn | 1..1 | 1 - 25 pos | |
U032 | bestallareefternamn | 1..1 | 1 - 50 pos | |
U033 | bestallarearbetsplats | Arbetsplatskod | 1..1 | 1 - 256 pos |
U034 | dospotekid | GLN-kod för dosapotek | 1..1 | Exakt 13 pos |
5. Verksamhetsregler/logik
ID | Verksamhetsregler/logik |
---|---|
R001 | En beställning som har status 6 = Under bearbetning, 3 = Expedierad, 4 = Avvisad eller 7 = Skickad av apotek går inte att avbeställa. En sådan avbeställning kommer att avvisas. |
R002 | Bestallningsstatus U022, bestallningsresultat U020, bestallningsresultattext U021 och statustidpunkt U023 sätts automatiskt av tjänsten. Statustidpunkten sättas endast då status ändras. |
R003 | En varning samt en lista på samtliga beställningar och deras status returneras om en eller flera av beställningarna som ingår i anropet saknas eller inte gick att avbeställa. |
R005 | I003 fornamn, I004 efternamn, I007 arbetsplatskod samt anropstidpunkten sparas i SOL, som information om vem som senast ändrat beställningen och när. |
R006 | I011 Avbestallningsinfo får inte innehålla dubbletter av I020 bestallningsid i ett och samma anrop. |
Versionshistorik
Version | Datum | Kommentar |
---|---|---|
1.0 | 2021-11-27 | Ny handbok vård- och apotekstjänster |
1.1 | 2023-11-09 | Lagt till regel R006 och hänvisning till denna för I020. |
1.2 | 2024-02-22 | Uppdaterat R003 |