Differences

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

--- fmk:1.6.0:xml-elementer:track-and-trace_event [2026-05-19 08:25] – created lbdo
+++ fmk:1.6.0:xml-elementer:track-and-trace_event [2026-05-20 08:04] (current) – [XML: Track&Trace-event] exttkn
@@ Line 1: / Line 1: @@
 ====== XML: Track&Trace-event  ======
-Et Track&Trace-event er en slags opdatering på leveringsstatus for medicin. Eventet er tilknyttet enten en bestilling, en (dosis)dispenseringsperiode eller en forsendelse -- sidstnævnte er blot en gruppering af flere bestillinger og/eller dosisruller.
+Et Track&Trace-event er en slags opdatering på leveringsstatus for medicin. Eventet er tilknyttet enten en bestilling, en (dosis)dispenseringsperiode eller en forsendelse -- sidstnævnte er blot en gruppering af flere bestillinger og/eller dosisruller. Når Track&Trace-events fremsøges vil grupperes under enkelte bestillinger og dispenseringsperioder.
+For en generel beskrivelse af brugen af Track&Trace refereres til [[..:intro:track_and_trace#track_and_trace1|denne side]]
+Skemadefinitionen for Track&Trace-events kan findes[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#trackandtraceeventdetailstype | her]].
+===== Generelle felter =====
+==== Event-ID ====
+Eventet indeholder først en ''TackAndTraceEventIdentifier'' med det unikke ID for eventet.
+==== Tidspunkt ====
+''EventDateTime''-elementet indeholder tidspunktet for eventets oprettelse. Hvis dette ikke indrapporteres til FMK, vil tidspunktet svare til tidspunktet for service-kaldet, som oprettede eventet.
+==== Ansvarligt apotek ====
+''OrderedAtPharmacy'' refererer til det apotek, som håndterer bestillingen/dispenseringsperioden.
+==== Forsendelses-ID ====
+Optionelt kan en ''ShipmentIdentifier'' forekomme, hvis eventet er blevet oprettet via ID'et på en forsendelse frem for en enkelt bestilling/dispenseringsperiode. Se evt. service-beskrivelse for [[fmk:1.6.0:services:Opret Track-and-Trace-event]].
+==== Type ====
+''EventType''-elementet angiver eventets type, f.eks. "Bestilling oprettet" eller "Medicin klar til afhentning".
+==== Forventet leveringsdato ====
+Optionelt kan et event indeholde et ''ExpectedDeliveryDate''-element med forventet leveringsdato.
+==== Fritekst ====
+Yderligere information om eventet kan optionelt forekomme i ''FreeText''-elementet.
+===== Information om fremtidige events =====
+Optionelt kan ét af følgende elementer angives ved oprettelse af et Track&Trace-event. Disse er tiltænkt kommunikation til modtageren om, hvad de kan forvente af fremtidig Track&Trace-information om deres medicin.
+==== Forventet tidspunkt for næste event ====
+Angivelse af ''ExpectedNextEventDateTime''-elementet indikerer, at der forventes at ske noget nyt med medicinen på dette tidspunkt. Det kunne eksempelvis være det tidspunkt, hvor bestillingen forventes afsendt fra apoteket.
+==== Sidste event ====
+''IsFinalEvent''-flaget indikerer, at apoteket ikke forventer, at yderligere Track&Trace-events vil blive oprettet for bestillingen/dispenseringsperioden. Dette kan f.eks. bruges, hvis medicinen skal sendes til et af apotekets udleveringssteder, som ikke har den nødvendige teknologi til at registrere Track&Trace-events på FMK. I så fald kan dette flag sættes, når apoteket opretter et event af typen "Afsendt".
+===== Yderligere oplysninger =====
+Et Track&Trace-event kan til sidst indeholde en række ''AdditionalInformation''-elementer, som er af typen ''KeyValueSetType''. Disse kan bruges til at angive yderligere metadata omkring leveringen på en struktureret form.
+Anvendelsen af disse metadata skal foregå via aftale mellem apoteket og aftagersystemet. FMK behandler ikke disse metadata internt, men er blot formidler.
+===== Eksempler =====
+Ved [[fmk:1.6.0:services:Opret Track-and-Trace-event | oprettelse]]  af events angives enten den relaterede ''ShipmentIdentifier'', ''OrderIdentifier'' eller ''DispensingPeriodIdentifier''. Når events [[fmk:1.6.0:services:Hent Track-and-Trace-oplysninger for person | hentes ]] vil de imidlertid være grupperet under den enkelte bestilling eller dispenseringsperiode.
+==== Eksempel 1: Track&Trace-events på en bestilling ====
+<file xml TrackAndTraceEventsOnOrder.xml>
+<TrackAndTraceEventsOnOrder>
+  <Order>
+    <Identifier>46384710763</Identifier>
+    <Version>3414134122312</Version>
+    <Status>Bestilt</Status>
+    <Delivery>
+      [...]
+    </Delivery>
+  </Order>
+  <TrackAndTraceEvent>
+    <TrackAndTraceEventIdentifier>3413207023947</TrackAndTraceEventIdentifier>
+    <EventDateTime>2026-10-09T11:23:34Z</EventDateTime>
+    <OrderedAtPharmacy>
+      <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
+      <Type>Apotek</Type>
+      <Name>Kolind Apotek</Name>
+    </OrderedAtPharmacy>
+    <ShipmentIdentifier>1231098</ShipmentIdentifier>
+    <EventType>"Afsendt"</EventType>
+    <ExpectedDeliveryDate>2026-10-11</ExpectedDeliveryDate>
+    <ExpectedNextEventDateTime>2026-10-10T09:00:00Z</ExpectedNextEventDateTime>
+    <AdditionalInformation><Key>Opbevaringstemperatur</Key><Value>5 grader</Value></AdditionalInformation>
+  </TrackAndTraceEvent>
+</TrackAndTraceEventsOnOrder>
+</file>
+==== Eksempel 2: Track&Trace-events på en dispenseringsperiode ====
+<file xml TrackAndTraceEventsOnDispensingPeriod.xml>
+<TrackAndTraceEventsOnDispensingPeriod>
+  <DoseDispensingDeliveryAndStatus>
+    <DispensingPeriodIdentifier>77123109281</DispensingPeriodIdentifier>
+    <DispensingStatus>Sendes</DispensingStatus>
+    <Delivery>
+      [...]
+    </Delivery>
+  </DoseDispensingDeliveryAndStatus>
+  <TrackAndTraceEvent>
+    <TrackAndTraceEventIdentifier>3413207023947</TrackAndTraceEventIdentifier>
+    <EventDateTime>2026-10-09T11:23:34Z</EventDateTime>
+    <OrderedAtPharmacy>
+      <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
+      <Type>Apotek</Type>
+      <Name>Kolind Apotek</Name>
+    </OrderedAtPharmacy>
+    <EventType>"Afsendt"</EventType>
+    <ExpectedDeliveryDate>2026-10-11</ExpectedDeliveryDate>
+    <IsFinalEvent/>
+  </TrackAndTraceEvent>
+</TrackAndTraceEventsOnDispensingPeriod>
+</file>