Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:intro:track_and_trace [2026-05-19 13:38] – [Forsendelser] exttkn
+++ fmk:1.6.0:intro:track_and_trace [2026-06-23 09:06] (current) – exttkn
@@ Line 1: / Line 1: @@
+====== Track and trace ======
 ===== Indledning =====
@@ Line 28: / Line 30: @@
 Udleveringsgrundlag "1" *-right- "0..1" Udlevering : "     "
 Bestilling "0..1" -down- "0..*" Event
-Anmodning "0..1" .right. "0..*" Event : "          "
+Anmodning "0..1" .[hidden]right. "0..*" Event : "          "
 @enduml
@@ Line 34: / Line 36: @@
 </uml>
-===== FMK’s elementer i relation til bestilling og Track&Trace ====
+===== FMK’s elementer i relation til bestilling og Track and trace ====
 I det følgende beskrives hvilke elementer og data FMK indeholder, og som indgår i arbejdsgangen i forbindelse med anmodning om nyt udleveringsgrundlag og bestilling, samt de væsentligste services hertil.
@@ Line 69: / Line 71: @@
 ==== Anmodning om udleveringsgrundlag ====
-Er der ikke allerede et passende udleveringsgrundlag, kan hjemmesygeplejen, borgeren eller en anden aktør [[..:services:opret_anmodning_om_udleveringsgrundlag|oprette en anmodning om et nyt udleveringsgrundlag]]. Bemærk, der er begrænsning for, hvilke lægemidler en borger kan anmode om. Dette er styret af lægemidlets udleveringsbestemmelser samt ATC-kode. Lægemiddelordinationens felt til foretrukket udlevering, dvs. lægens angivelse af, hvordan lægen forventer at udleveringer skal foregå, afgør om det er muligt at oprette en anmodning. Der kan oprettes anmodninger hvor foretrukket udlevering er recept og dosisrecept. Foreløbigt understøttes anmodninger til udlevering af medicin fra sygehusapotek ikke, og anmodninger er ikke relevante for de øvrige former for foretrukket udlevering.
+Er der ikke allerede et passende udleveringsgrundlag, kan hjemmesygeplejen, borgeren eller en anden aktør [[..:services:opret_anmodning_om_udleveringsgrundlag|oprette en anmodning om et nyt udleveringsgrundlag]]. Der kan oprettes anmodninger hvor foretrukket udlevering er recept og dosisrecept.
-FMK sender [[..:..:automatiske_receptanmodninger|automatisk anmoding]] om nyt udleveringsgrundlag for dosisrecept.
+FMK sender [[..:..:automatiske_receptanmodninger|automatisk anmodning]] om nyt udleveringsgrundlag for dosisrecept.
 Som støtte til at afgøre hvilken eller hvilke organisationer anmodningen skal rettes til har FMK en [[..:services:hent_udsteder_til_udleveringsgrundlag|Hent udsteder til udleveringsgrundlag-service]], som ud fra lægemiddelordination eller udleveringsgrundlag returnerer forslag til modtager.
@@ Line 112: / Line 114: @@
 Bemærk også at det kan være krævet, at der registreres [[..:xml-elementer:sekundaer_udlevering|sekundær udlevering]].
-==== Track & trace ====
+==== Track and trace ====
 Track & trace introduceres i FMK 1.6, og giver mulighed for at borgere, hjemmesygeplejen og andre aktører løbende kan modtage information i forbindelse med bestilling og levering af lægemidler. FMK danner track and trace-events ved handlinger på eller relateret til bestillinger, og apotekerne kan desuden supplere med egne events.
@@ Line 120: / Line 122: @@
 Track & trace-events har et antal mulige typer, alle tilknyttet bestilling og levering af lægemidler, og apotekerne har derudover mulighed for at supplere med yderligere typer. Track & trace beskrives nærmere i det følgende afsnit.
-===== Track&Trace =====
+===== Track and trace =====
 I FMK 1.6 indføres et "Track and trace"-system (evt. forkortet T&T), til bestillinger og (dosis)dispenseringsperioder. Track and trace er hovedsageligt tiltænkt bestillinger og dosisruller, som leveres af enten (de private) apoteker eller regionernes sygehusapoteker, enten direkte til modtageren eller til et udleveringssted.
@@ Line 134: / Line 136: @@
 Forsendelser gør det muligt at f.eks. et medicinudleveringssted kan registrere at forsendelsen er modtaget og er klar til afhentning, uden at personalet på medicinudleveringssted skal åbne posen eller en anden emballage. Derved undgås også at medicinudleveringsstedet utilsigtet får viden om hvilken medicin borgeren får.
-==== Track&Trace-events ====
+==== Track and trace-events ====
 Et event knyttes altid til en enkelt forsendelse, bestilling eller dispenseringsperiode. Eventet indeholder et oprettelsestidspunkt og en type samt identifier for det ansvarlige apotek.
@@ Line 148: / Line 150: @@
 Events har ikke versionering, da de blot afspejler en notifikation om ændring i medicinens leveringsstatus. En opdatering i forbindelse med Track and trace kommunikeres altså via oprettelse af et nyt event.
+==== Relaterede services ====
+Track&Trace i FMK har to forskellige brugsscenarier, afhængigt af om brugeren er afsender eller modtager af medicinen. Afsenderen af medicinen (f.eks. et apotek) kan oprette Track&Trace-events for at kommunikere, hvor langt leveringen af medicinen er nået. Modtageren af medicinen vil så kunne hente disse Track&Trace-oplysninger.
+=== Oprettelse af events ===
+Track and trace-events kan oprettes via kald til servicen [[fmk:1.6.0:services:Opret Track-and-Trace-event]].
+Følgende services opretter desuden automatisk Track and trace-events, såfremt der er angivet et ''Delivery''-element på bestillingen:
+  * [[fmk:1.6.0:services:Opret bestilling]] -- opretter events af typen "Bestilling oprettet"
+  * [[fmk:1.6.0:services:Annuller bestilling]] -- opretter events af typen "Bestilling annulleret"
+  * [[fmk:1.6.0:services:Effektuer bestilling]] -- opretter events af typen "Pakket til forsendelse"
+  * [[fmk:1.6.0:services:Registrer løs recept og udlevering]] -- opretter events af typen "Pakket til forsendelse"
+  * [[fmk:1.6.0:services:Klargør forsendelse]] -- opretter events af typen "Afsendt"
+Ligeledes kan følgende service oprette events, såfremt der er angivet leveringsoplysninger på dispenseringskortet:
+  * [[fmk:1.6.0:services:Effektuer dispenseringsperiode]] -- opretter events af typen "Pakket til forsendelse"
+=== Fremsøgning af events ===
+Modtageren af medicinen kan hente [[fmk:1.6.0:xml-elementer:Track-and-trace event | oplysninger om Track and trace]] via følgende services. Track and trace-events grupperes under den enkelte bestilling / dosisrulle -- også selvom de er registreret via en ''ShipmentIdentifier''. Således behøver modtageren af medicinen ikke bekymre sig om, hvordan afsenderen konkret har valgt at pakke medicinen.
+FMK udstiller to forskellige services til at fremsøge Track&Trace-events:
+  * [[fmk:1.6.0:services:Søg efter Track-and-Trace-events|Søg efter Track and trace-events]] fremsøger events på specifikke bestillinger og dispenseringsperioder og kan kaldes automatisk via systemkald.
+  * [[fmk:1.6.0:services:Hent Track-and-Trace-oplysninger for person | Hent Track and trace-oplysninger]] fremsøger Track&Trace-events for en borger eller organisation og grupperer disse under modtagerens lægemiddelordinationer. Denne service returnerer også status på eventuelle anmodninger om udleveringsgrundlag.
+==== Typer af events ====
+''EventType'' er defineret som en udvidbar liste i snitfladen med følgende værdier:
+  * Bestilling oprettet
+  * Bestilling modtaget på (sygehus)apoteket
+  * Bestilling behandles
+  * Bestilling annulleret
+  * Bestilling afvist
+  * Bestilling ekspederet
+  * Pakket til forsendelse
+  * Afsendt fra apotek
+  * Modtaget på udleveringssted
+  * Medicin klar i udleveringsboks
+  * Medicin klar til afhentning
+  * Medicin udleveret
+  * Medicin sendt retur til apotek
+  * Dosisrulle klar til pakning
+  * Dosisrulle pakket
+  * Dosisrulle klar til afhentning
+  * Dosisrulle ekspederet
+  * Andet event