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 |