User Tools

Site Tools


fmk:1.6.0:services:sog_efter_track-and-trace-events

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 til Track and trace

Forespørgsel

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

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

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>

Svar

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. 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.
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>
fmk/1.6.0/services/sog_efter_track-and-trace-events.txt · Last modified: by lbdo

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki