Differences

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

--- fmk:1.6.0:intro:track_and_trace [2026-05-19 11:45] – [Bestilling] exttkn
+++ fmk:1.6.0:intro:track_and_trace [2026-06-03 14:33] (current) – [Typer af events] lbdo
@@ Line 28: / Line 28: @@
 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 34: @@
 </uml>
-===== FMK’s elementer ====
+===== 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 86: / Line 86: @@
 Foreløbigt understøtter FMK ikke bestillinger på medicin fra sygehusapotek. For recepter til brug i praksis anvendes en separat [[..:services:opret_bestilling_til_brug_i_praksis|service]]. For de øvrige typer af udleveringsgrundlag “købes uden recept”, “løs recept” og “direkte udlevering” er bestilling ikke relevant.
+Udleveringsgrundlaget skal desuden have en status der tillader at der oprettes en bestilling. Der kan bestilles på åbne og ventende (pending) udleveringsgrundlag. Findes der allerede en bestilling på en dosisrecept kan der ikke oprettes yderligere bestillinger.
+Bestillinger oprettes via o[[..:services:opret_bestilling|pret bestillinger-servicen]]. Her angives apotek samt eventuelle yderligere ønsker til levering.
+Servicen [[..:services:hent_bestillinger|hent bestillinger]] anvendes til at slå op på bestillinger på en enkelt borger, og [[..:services:sog_bestillinger|søg bestillinger]] til at slå op på bestillinger der er oprettet af en given organisation.
+[[..:xml-elementer:bestilling|Bestillinger]] kan være åbne, under behandling eller afsluttede:
+Bestillingerne har status “åben” ved oprettelse og indtil apoteket tager bestillingen under behandling.
+Bestillingernes status ændres til “under behandling” når apoteket tager bestillingen under behandling, dvs. at apoteket påbegynder ekspeditionen. Detaljer om bestillingen kan herefter findes via track and trace.
+Bestillingens status ændres herefter til "afsluttet", enten når der sker en udlevering på baggrund af bestillingen, eller hvis apoteket beslutter ikke at foretage en udlevering og f.eks. i stedet ugyldiggøre udleveringsgrundlaget. Normalt vil der ske en udlevering, og der vil så findes en udlevering knyttet til bestillingen.
+==== Udlevering ====
+I forbindelse med et overblik over et bestillingsflow, er tilstedeværelsen af en udlevering en væsentlig information.
+Apoteket [[..:services:effektuer_bestilling|opretter en udlevering]], hvormed det vil være synligt at apoteket har ekspederet og enten udleveret eller sendt lægemidlet. Er lægemidlet sendt kan track and trace supplere med yderligere information.
+Apoteket kan desuden [[..:services:annuller_udlevering|tilbageføre en udlevering]].
+Ved opslag på lægemiddelordination og udleveringsgrundlag kan udleveringer også returneres.
+Bemærk også at det kan være krævet, at der registreres [[..:xml-elementer:sekundaer_udlevering|sekundær udlevering]].
+==== 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.
+Track & trace-events knyttes til en bestilling eller ved dosisdispensering til dispenseringsperioden (DispensingPeriodIdentifier).
+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 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.
+Track and trace skal tænkes som en lille log, der er knyttet til den enkelte bestilling eller dispenseringsperiode. Denne log består af en række events, som hver især afspejler en specifik opdatering eller handling. Den specifikke handling fremgår af Track and trace-eventets type – eksempelvis “Modtaget på udleveringssted”.
+==== Forsendelser ====
+Da det er muligt at en person har flere bestillinger, som ønskes leveret samtidigt, er det muligt at gruppere disse bestillinger i //forsendelser// (i snitfladen kaldet ''Shipments''). En forsendelse indeholder en unik ''ShipmentIdentifier'' samt en række identifiers for bestillinger og/eller dispenseringsperioder for den enkelte borger.
+En forsendelse kan registreres i FMK via kald til [[fmk:1.6.0:services:Klargør forsendelse]]. Det er muligt at "reservere" en ''ShipmentIdentifier'' via kald til [[fmk:1.6.0:services:reserver_forsendelses-id_er | Reservér forsendelses-id'er]], såfremt denne ønskes på forhånd.
+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 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.
+Yderligere information kan angives på et Track&Trace-event, såsom:
+  * Forventet leveringsdato
+  * Fritekst
+  * Forventet tidspunkt for næste event
+  * Markering af, at der ikke forventes at forekomme et næste event
+  * Yderligere metadata i form af key-value-par.
+Se evt. [[fmk:1.6.0:xml-elementer:Track-and-trace event|beskrivelse af Track&Trace-events i XML]].
+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