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.

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.

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

SearchTrackAndTraceEventsRequest.xml

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

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

SearchTrackAndTraceEventsRequest.xml

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

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 TrackAndTraceEvent-elementer.

TrackAndTraceEventelementerne 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.

SearchTrackAndTraceEventsResponse.xml

<SearchTrackAndTraceEventsResponse>
  <TrackAndTraceEvents>
    <Order>
      <Identifier>46384710763</Identifier>
      <Status>Bestilt</Status>
      <Delivery>
        [...]
      </Delivery>
    </Order>
    <TrackAndTraceEvent>
      <TrackAndTraceEventIdentifier>3413207023947</TrackAndTraceEventIdentifier>
      <EventDateTime>2025-10-09T11:23:34Z</EventDateTime>
      <OrderedAtPharmacy source="EAN-Lokationsnummer">5790000170609</OrderedAtPharmacy>
      <ShipmentIdentifier>1231098</ShipmentIdentifier>
      <EventType>"Pakket til forsendelse"</EventType>
      <ExpectedDeliveryDate>2025-10-11</ExpectedDeliveryDate>
      <AdditionalInformation><Key>Kurer</Key><Value>DAO</Value></AdditionalInformation>
    </TrackAndTraceEvent>
    <TrackAndTraceEvent>
      [...]
    </TrackAndTraceEvent>
  </TrackAndTraceEvents>
</SearchTrackAndTraceEventsResponse>