Differences

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

--- fmk:1.6.0:aendringer-14x-160:track_and_trace [2026-05-18 12:54] – lbdo
+++ fmk:1.6.0:aendringer-14x-160:track_and_trace [2026-06-03 14:33] (current) – [Typer af events] lbdo
@@ Line 1: / Line 1: @@
-====== Track&Trace ======
+====== Track&Trace (WIP) ======
-Fra FMK 1.6.0 indføres et Track-and-trace-system (forkortet Track&Trace eller blot T&T) til bestillinger og (dosis)dispenseringsperioder. Dette er hovedsageligt tiltænkt bestillinger og dosisruller, som skal sendes til levering.
+:!: Se [[..:intro:track_and_trace#track_and_trace1|Intro til Track and trace]]
+Fra FMK 1.6.0 indføres et Track-and-trace-system (forkortet Track&Trace eller blot T&T) til bestillinger og (dosis)dispenseringsperioder. Dette er hovedsageligt tiltænkt bestillinger og dosisruller, som leveres -- 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/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&Trace-eventets //type// -- eksempelvis "Modtaget på udleveringssted".
@@ Line 8: / Line 11: @@
 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 er kun tiltænkt afsenderen af medicinen for at gøre det nemmere at registrere events.
@@ Line 20: / Line 25: @@
   * Markering af, at der ikke forventes at forekomme et næste event
   * Yderligere metadata i form af key-value-par.
+Se [[fmk:1.6.0:xml-elementer:Track-and-trace event | denne side]] for 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&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&Trace-events kan oprettes via kald til servicen [[fmk:1.6.0:services:Opret Track-and-Trace-event]].
@@ Line 33: / Line 49: @@
 Ligeledes kan følgende service oprette Track&Trace-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&Trace]] via følgende services. Track&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 and trace-events:
+  * [[fmk:1.6.0:services: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 ====
-**TODO: dobbeltjek at disse stadig er relevante. Behøver vi have fx "Dosisrulle klar til pakning"?**
+''EventType'' er defineret som en udvidbar liste i snitfladen med følgende værdier:
   * Bestilling oprettet
@@ Line 43: / Line 68: @@
   * Bestilling ekspederet
   * Pakket til forsendelse
-  * Afsendt
+  * Afsendt fra apotek
   * Modtaget på udleveringssted
   * Medicin klar i udleveringsboks
@@ Line 53: / Line 78: @@
   * Dosisrulle klar til afhentning
   * Dosisrulle ekspederet
-  * Andet event (kræver udfyldelse af fritekst)
+  * Andet event