====== 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 [[..:intro:track_and_trace#track_and_trace1|denne side]]

Skemadefinitionen for Track&Trace-events kan findes[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#trackandtraceeventdetailstype | her]].

===== Generelle felter =====

==== Event-ID ====

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

==== Tidspunkt ====

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

==== Ansvarligt apotek ====

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

==== Forsendelses-ID ====

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 [[fmk:1.6.0:services:Opret Track-and-Trace-event]].

==== Type ====

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

==== Forventet leveringsdato ====

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

==== Fritekst ====

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

===== Information om fremtidige events =====

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.

==== Forventet tidspunkt for næste event ====

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.

==== Sidste event ====

''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".

===== Yderligere oplysninger =====

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.

===== Eksempler =====

Ved [[fmk:1.6.0:services:Opret Track-and-Trace-event | oprettelse]]  af events angives enten den relaterede ''ShipmentIdentifier'', ''OrderIdentifier'' eller ''DispensingPeriodIdentifier''. Når events [[fmk:1.6.0:services:Hent Track-and-Trace-oplysninger for person | hentes ]] vil de imidlertid være grupperet under den enkelte bestilling eller dispenseringsperiode.

==== Eksempel 1: Track&Trace-events på en bestilling ====

<file xml 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>
</file>


==== Eksempel 2: Track&Trace-events på en dispenseringsperiode ====

<file xml 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>
</file>