Generera doseringsanvisning - $patient-dosage-directions

Beskrivning av FHIR-operationen generera doseringsanvisning $patient-dosage-directions


1. Inledning

FHIR-operation som anropas för att generera de delar som tillsammans utgör en doseringsanvisning för en förskrivning eller ett uttag. Dessa delar är Behandlingsändamål, Doseringsinstruktion, Administreringsinstruktion samt Annan instruktion.

Se TA 55 - Generera doseringsanvisning.

2. Översikt

(info) FHIR-operation: $patient-dosage-directions

Vid lyckad operation returneras HTTP-status 2xx och utdata enligt tabell 1.
Vid misslyckad operation returneras HTTP-status 4xx eller 5xx samt ett felmeddelande enligt Krav på anropsresultat och felhantering.

För mer information se NLLPatientDosageDirections i Simplifier.

3. Attribut

Tabell 1. Attribut - Generera doseringsanvisning

Term

Definition och anmärkning 

Indata

Utdata

Dosering

Doseringsstruktur som beskriver en dosering.

dosageInstruction

Anmärkning
Struktur enligt NLLDosage för en dosering.


Behandlingsändamål

(om läkemedel) ändamål med behandlingen

Anmärkning
I samband med en läkemedelsordination kan ordinatören ange ett eller flera behandlingsändamål.

Vid förskrivning av läkemedel ska behandlingsändamål anges i receptet. Vid expediering på apotek skrivs informationen ut på etiketten som sätts på förpackningen.

Ändamålstexten har patienten som mottagare och uttrycks därför allmänspråkligt. Exempel på ändamålstext: mot bihåleinflammation, mot smärta, vätskedrivande, förebygger karies.

Detta är en fritext som anges av förskrivaren. Förskrivaren kan dock i sitt vårdinformationssystem få upp ett förslag till text som baseras på texter hämtade ur socialstyrelsens källa för ordinationsorsak (NKOO). Om det finns flera Behandlingsorsaker kan fältet Behandlingsändamål innehålla en sammanslagning av flera "behandlingsändamålsförslag". Behandlingsändamål är en del av Doseringsanvisning.

nllPatientTreatmentReason nllPatientTreatmentReason

Doseringsinstruktion

patientvänlig instruktion för dosering


Anmärkning
Är en del av doseringsanvisning.

Denna text genereras utifrån den strukturerade doseringen eller fritextdoseringen.

För uttag pappersrecept anges den kompletta doseringsanvisningen, den som ska skrivas ut på etiketten, i doseringsinstruktionen.

Om den genererade texten blir för lång för att skivas ut på etiketten returneras istället texten "Enligt separat doseringsschema".


patientInstruction
Doseringsinstruktion formaterad

Detta attribut innehåller en formaterad doseringsinstruktion som är avsedd att exempelvis skrivas ut till patienten.

Doseringsinstruktion formaterad innehåller alltid den kompletta texten, även i de fall den genererade texten i doseringsinstruktion blir för lång och har ersatts med "Enligt separat doseringschema".

Doseringsinstruktion formaterad innehåller även radbrytningar för ökad läsbarhet. 

(warning) Doseringsinstruktion formaterad kan inte registreras i Nationella läkemedelslistan.


patientInstructionFormatted

Administreringsinstruktion

patientanpassad beskrivning av administreringssätt

Anmärkning
Är en del av doseringsanvisning.

Denna text genereras utifrån de patientvänliga termerna  i kodverken för administreringssätt.


nllAdministeringInstruction

Annan instruktion

patientvänlig instruktion för doseringsanvisning utöver behandlingsändamål, administreringsinstruktion, doseringsinstruktion

Anmärkning
Är en del av doseringsanvisning.

Kan exempelvis vara text som
"Kom ihåg att förvara i kylskåp"
"Ta med ett halvt glas vatten"


additionalInstruction

Notifiering

OperationOutcome (Resultat och felhantering – NLLOperationOutcome)

Severity = warning (3) - Notifiering vid för lång text.

Severity = information (4) - Notifiering om att doseringsinstruktion är förkortad.


notification

Versionshistorik

Version Datum Release Kommentar
1.0 2022-11-10 21.4 Ny sida handbok vård- och apotekstjänster
1.1 2023-11-09 21.7

Förbättrad dokumentation

  • Förtydligat vilken HTTP status som returneras.
1.2 2025-04-29 21.13
  • Förtydligad text under inledning
  • Förtydligat beskrivning under doseringsinstruktion samt doseringsinstruktion formaterad
  • Anmärkning tillagd för term Dosering, indata.