Table of Contents
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.
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 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 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.
Eksempel 1: Track&Trace-events på en bestilling
- 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>
Eksempel 2: Track&Trace-events på en dispenseringsperiode
- 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>
