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. 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 denne side

Skemadefinitionen for Track&Trace-events kan findes her.

Eventet indeholder først en TackAndTraceEventIdentifier med det unikke ID for eventet.

EventDateTime-elementet indeholder tidspunktet for eventets oprettelse. Hvis dette ikke indrapporteres til FMK, vil tidspunktet svare til tidspunktet for service-kaldet, som oprettede eventet.

OrderedAtPharmacy refererer til det apotek, som håndterer bestillingen/dispenseringsperioden.

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 Opret Track-and-Trace-event.

EventType-elementet angiver eventets type, f.eks. “Bestilling oprettet” eller “Medicin klar til afhentning”.

Optionelt kan et event indeholde et ExpectedDeliveryDate-element med forventet leveringsdato.

Yderligere information om eventet kan optionelt forekomme i FreeText-elementet.

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.

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.

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

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.

Ved oprettelse af events angives enten den relaterede ShipmentIdentifier, OrderIdentifier eller DispensingPeriodIdentifier. Når events hentes vil de imidlertid være grupperet under den enkelte bestilling eller dispenseringsperiode.

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>

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>