Differences

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

--- fmk:1.6.0:services:hent_track-and-trace-oplysninger_for_person [2026-05-13 08:08] – [Svar] lbdo
+++ fmk:1.6.0:services:hent_track-and-trace-oplysninger_for_person [2026-05-20 09:56] (current) – lbdo
@@ Line 1: / Line 1: @@
-====== Hent Track&Trace-oplysninger (WIP) ======
+====== Hent Track&Trace-oplysninger ======
 Denne service anvendes til at finde oplysninger relateret til Track&Trace for en person eller organisation.
 Foruden Track&Trace-oplysninger relateret til bestillinger og dispenseringsperioder, kan servicen også hente oplysninger om anmodninger om udleveringsgrundlag.
+Se også [[..:intro:track_and_trace#track_and_trace1|Intro til Track and trace]]
 ===== Forespørgsel =====
 I forespørgslen angives først patientens ''PersonIdentifier''. Hvis der er tale om praksisrecepter eller DD til institutioner, kan organisationens ''OrganisationIdentifier'' angives i stedet.
-Forespørgslen tillader filtrering på både event-typer og datoer. Sættes ''IncludeAllEventsCreatedSince'' vil FMK returnere alle events oprettet efter dette tidspunkt. Sættes denne dato ikke, vil FMK kun fremsøge det senest oprettede event. Filtrering på event-typer foregår ved enten ''IncludeType'' eller ''ExcludeType''. Angives en række ''IncludeType''-elementer, vil FMK kun fremsøge events af denne type. Angives i stedet ''ExcludeType''-elementer vil FMK fremsøge alle typer events foruden de angivne.
+Forespørgslen tillader filtrering på både event-typer og datoer. Sættes ''IncludeAllEventsCreatedSince'' vil FMK returnere alle events oprettet efter dette tidspunkt. Vær dog opmærksom på, at FMK ikke gemmer Track&Trace-events i mere end 3 måneder. Sættes denne dato ikke, fremsøges kun events oprettet inden for de sidste 7 dage.
-Der kan optionelt angives op til flere ''DrugMedicationIdentifier''-elementer. Angives disse, vil der kun hentes Track&Trace-oplysninger (og evt. anmodninger om udleveringsgrundlag) relateret til disse specfikke lægemiddelordinationer. Ligeledes kan der angives op til flere ''DispensingPeriodIdentifier''-elementer, hvor servicen så kun returnerer events relateret til disse dispenseringsperioder.
+Filtrering på event-typer foregår ved enten ''IncludeType'' eller ''ExcludeType''. Angives en række ''IncludeType''-elementer, vil FMK kun fremsøge events af denne type. Angives i stedet ''ExcludeType''-elementer vil FMK fremsøge alle typer events foruden de angivne. Der kan ikke angives både ''IncludeType''- og ''ExcludeType''-elementer.
+Der kan optionelt angives et antal ''DrugMedicationIdentifier''-elementer. Angives disse, vil der kun hentes Track&Trace-oplysninger (og evt. anmodninger om udleveringsgrundlag) relateret til disse specfikke lægemiddelordinationer. Ligeledes kan der angives et antal ''DispensingPeriodIdentifier''-elementer, hvor servicen så kun returnerer events relateret til disse dispenseringsperioder.
 Angives der ikke nogen identifiers, vil servicen returnere Track&Trace-oplysninger relateret til alle patientens lægemiddelordinationer/dispenseringsperioder.
@@ Line 30: / Line 32: @@
 === Eksempel 2 ===
-Forespørgsel på seneste events af typerne "Afsendt" og "Modtaget på udleveringssted" på samtlige lægemiddelordinationer/dispenseringsperioder.
+Forespørgsel på events oprettet inden for den sidste uge af typerne "Afsendt" og "Modtaget på udleveringssted" på samtlige lægemiddelordinationer/dispenseringsperioder.
 <file xml GetTrackAndTraceDetailsRequest.xml>
@@ Line 43: / Line 45: @@
 Svaret indeholder først den medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''.
-Dernæst forekommer op til flere ''TrackAndTraceEventsOnDrugMedication''-elementer og op til flere ''TrackAndTraceEventsOnDispensingPeriod''-elementer, som beskrevet nedenfor.
+Dernæst forekommer et antal ''TrackAndTraceEventsOnDrugMedication''-elementer og et antal ''TrackAndTraceEventsOnDispensingPeriod''-elementer, som beskrevet nedenfor. De enkelte sekvenser af Track&Trace-events vil være sorteret kronologisk med det nyeste først. Grupperingerne under lægemiddelordination og dispenseringsperiode vil være sorteret efter, senest oprettede tilknyttede event.
 ''TrackAndTraceEventsOnDrugMedication'' indeholder følgende:
   * ''DrugMedicationIdentifier'', id på lægemiddelordinationen
-  * Optionelt op til flere ''TrackAndTraceEventsOnOrder''-elementer. Hver af disse indeholder et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#ordertype|Order]]-element samt op til flere specifikke ''TrackAndTraceEvent''-elementer, som beskrevet i [[fmk:1.6.0:services:sog_efter_track-and-trace-events#svar | denne service]].
+  * Optionelt et antal ''RequestForWarrant''-elementer.
-  * Optionelt op til flere ''RequestForWarrant''-elementer.
+  * Optionelt et antal ''TrackAndTraceEventsOnOrder''-elementer. Hver af disse indeholder et [[fmk:1.6.0:xml-elementer:bestilling|Order]]-element samt op til flere specifikke ''TrackAndTraceEvent''-elementer, som beskrevet på [[fmk:1.6.0:xml-elementer:Track-and-trace event | denne side]].
 ''TrackAndTraceEventsOnDispensingPeriod'' indeholder følgende:
   * ''DoseDispensingDeliveryAndStatus'', indeholder ID på dispenseringsperioden, status på dispenseringsperioden samt det ''Delivery''-element, som er angivet på dispenseringskortet.
-  * Op til flere specifikke ''TrackAndTraceEvent''-elementer, som beskrevet i [[fmk:1.6.0:services:sog_efter_track-and-trace-events#svar | denne service]].
+  * En række specifikke ''TrackAndTraceEvent''-elementer, som beskrevet [[fmk:1.6.0:xml-elementer:Track-and-trace event | her]] .
 Et ''RequestForWarrant''-element indeholder:
@@ Line 64: / Line 66: @@
   * Optionelt: ''WarrantIdentifier''. Denne er angivet såfremt anmodningen er behandlet, og der er blevet oprettet et udleveringsgrundlag på lægemiddelordinationen.
+=== Eksempel ===
+<file xml GetTrackAndTraceDetailsResponse.xml>
+<GetTrackAndTraceDetailsResponse>
+  <PersonIdentifier source=CPR>1111111118</PersonIdentifier>
+  <TrackAndTraceEventsOnDrugMedication>
+    <DrugMedicationIdentifier>213219872091</DrugMedicationIdentifier>
+    <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>"Pakket til forsendelse"</EventType>
+        <ExpectedDeliveryDate>2025-10-11</ExpectedDeliveryDate>
+        <ExpectedNextEventDateTime>2025-10-10T09:00:00Z</ExpectedNextEventDateTime>
+        <AdditionalInformation><Key>Kurer</Key><Value>DAO</Value></AdditionalInformation>
+      </TrackAndTraceEvent>
+    </TrackAndTraceEventsOnOrder>
+  </TrackAndTraceEventsOnDrugMedication>
+  <TrackAndTraceEventsOnDrugMedication>
+    <DrugMedicationIdentifier>234029384209</DrugMedicationIdentifier>
+    <RequestForWarrant>
+      <Identifier>79871982731</Identifier>
+      <DoseDispensed/>
+      <Status>unhandled</Status>
+    <RequestForWarrant>
+  </TrackAndTraceEventsOnDrugMedication>
+  <TrackAndTraceEventsOnDispensingPeriod>
+    <DoseDispensingDeliveryAndStatus>
+      <DispensingPeriodIdentifier>77123109281</DispensingPeriodIdentifier>
+      <DispensingStatus>Sendes</DispensingStatus>
+      <Delivery>
+        [...]
+      </Delivery>
+    </DoseDispensingDeliveryAndStatus>
+    <TrackAndTraceEvent>
+      <TrackAndTraceEventIdentifier>34132034234232</TrackAndTraceEventIdentifier>
+      <EventDateTime>2026-09-09T13:37:12Z</EventDateTime>
+      <OrderedAtPharmacy>
+        <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
+        <Type>Apotek</Type>
+        <Name>Kolind Apotek</Name>
+      </OrderedAtPharmacy>
+      <EventType>"Afsendt"</EventType>
+      <IsFinalEvent/>
+    </TrackAndTraceEvent>
+  </TrackAndTraceEventsOnDispensingPeriod>
+</GetTrackAndTraceDetailsResponse>
+</file>