====== Søg efter Track&Trace-events ======
Service anvendes til at finde events relateret til Track&Trace på en given dispenseringsperiode eller bestilling. De fremsøgte events kan godt være tilknyttet flere dispenseringsperioder eller bestillinger -- i så fald vil oplysninger om disse alle blive returneret.

Denne service returnerer blot identifiers og status på bestillinger og dispenseringsperioder, og dermed ikke følsom persondata såsom CPR-numre. Derved tillades det, at servicen kaldes automatisk via systemkald.

Se også [[..:intro:track_and_trace#track_and_trace1|Intro til Track and trace]]
===== Forespørgsel =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#SearchTrackAndTraceEventsRequestType|Request]]

Servicen fremsøger events relateret til den angivne ''OrderIdentifier'' eller  ''DispensingPeriodIdentifier''.  

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.




== Eksempel 1 ==

Forespørgsel på det senest oprettede event af typen "Medicin klar til afhentning".

<file xml SearchTrackAndTraceEventsRequest.xml>
<SearchTrackAndTraceEventsRequest>
    <IncludeType>"Medicin klar til afhentning"</IncludeType>
    <OrderIdentifier>46384710763</OrderIdentifier>
</SearchTrackAndTraceEventsRequest>
</file>


== Eksempel 2 ==

Forespørgsel på alle events oprettet efter en given dato, med "Bestilling oprettet"- og "Bestilling behandles"-typer udeladt.

<file xml SearchTrackAndTraceEventsRequest.xml>
<SearchTrackAndTraceEventsRequest>
    <IncludeAllEventsCreatedSince>2025-09-01T00:00:00Z</IncludeAllEventsCreatedSince>
    <ExcludeType>"Bestilling oprettet"</ExcludeType>
    <ExcludeType>"Bestilling behandles"</ExcludeType>
    <OrderIdentifier>46384710763</OrderIdentifier>
</SearchTrackAndTraceEventsRequest>
</file>

===== Svar =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#SearchTrackAndTraceEventsResponseType|Response]]

Svaret består af en sekvens af ''TrackAndTraceEvents''-elementer. Hver af disse indeholder enten et ''Order''-element eller et ''DoseDispensingDeliveryAndStatus''-element samt en række ''[[fmk:1.6.0:xml-elementer:track-and-trace_event|TrackAndTraceEvent]]''-elementer. De enkelte Track&Trace-events er sorteret kronologisk med nyeste først.

''TrackAndTraceEvent''-elementerne indeholder:

  * ''TrackAndTraceEventIdentifier'', ID for eventet
  * ''EventDateTime'', tidspunkt for eventet
  * ''OrderedAtPharmacy'', oplysninger om tilhørende apotek
  * Optionelt: ''ShipmentIdentifier'', såfremt eventet er knyttet til en forsendelse indeholdene flere bestillinger og/eller dispenseringsperioder.
  * ''EventType'', typen af event
  * Optionelt: ''ExpectedDeliveryDate'', forventet leveringsdato
  * Optionelt: ''FreeText'', fritekst
  * Optionelt én af følgende:
    * ''ExpectedNextEventDateTime'', forventet tidspunkt for oprettelse af næste Track&Trace-event
    * ''IsFinalEvent''-flag, som angiver at det ikke forventes, at der oprettes flere events på bestillingen/dispenseringsperioden
  * Optionelt: en række ''AdditionalInformation''-elementer i form af key-value-par.


<file xml SearchTrackAndTraceEventsResponse.xml>
<SearchTrackAndTraceEventsResponse>
  <TrackAndTraceEvents>
    <Order>
      <Identifier>46384710763</Identifier>
      <Version>3414134122312</Version>
      <Status>Bestilt</Status>
      <Delivery>
        [...]
      </Delivery>
    </Order>
    <TrackAndTraceEvent>
      <TrackAndTraceEventIdentifier>3413207023947</TrackAndTraceEventIdentifier>
      <EventDateTime>2025-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>
    <TrackAndTraceEvent>
      [...]
    </TrackAndTraceEvent>
  </TrackAndTraceEvents>
</SearchTrackAndTraceEventsResponse>
</file>