Denne service kan bruges til at oprette Track&Trace-events.

Bemærk at Track&Trace-events også oprettes implicit af andre services, såsom Opret bestilling og Klargør forsendelse. Denne service gør det muligt at oprette yderligere Track&Trace-events og derved kunne kommunikere til andre, hvor langt man er med udleverings-arbejdsprocesserne på apoteket og udleveringsstedet.

Da Track&Trace allerede understøtter en form for historik i form af en event-log, understøtter FMK ikke versionering af events. I stedet vil eventuelle rettelser til event-loggen foregå ved at oprette nye Track&Trace-events, typisk via. kald til denne service.

CreateTrackAndTraceEventRequest

Kald til denne service skal via en ShipmentIdentifier, en OrderIdentifier eller en DispensingPeriodIdentifier identificere den forsendelse, bestilling eller dispenseringsperiode, som eventet er relateret til.

Det er muligt at angive et tidspunkt for eventet, som afspejler, hvornår opdateringen skete – hvis dette ikke angives, antages eventets tidspunkt som værende tidspunktet for service-kaldet.

Der ud over skal angives OrganisationIdentifier på det ansvarlige apotek, ExpectedDeliveryDate, som er den forventet leveringsdato samt EventType som er typen af Track&Trace event.

I det optionelle felt EventFreeText er det muligt at angive en fritekst knyttet til eventet, for eksempel til at uddybe konteksten for at eventet er blevet oprettet.

Det er muligt at angive et forventet tidspunkt for næste event i elementet ExpectedNextEventDateTime. Ideen med at angive forventet tidspunkt på næste event, at forsøge at udngå at modtageren ringer og rykker for svar, hvis alt går som forventet.

Alternativt kan man angive IsFinalEvent, hvis dette event forventes at blive det sidste, der bliver oprettet til denne forsendelse (eller bestilling/dispenseringsperiode). Dette kan for eksempel være relevant, hvis et specifikt udleveringssted ikke har den nødvendige teknologi til at registrere Track&Trace-events på FMK, og apoteket derfor ikke forventer at flere events bliver oprettet efter en forsendelse er blevet afsendt.

CreateTrackAndTraceEventRequest.xml

<CreateTrackAndTraceEventRequest>
    <ShipmentIdentifier>57398396576</ShipmentIdentifier>
    <OrderedAtPharmacyIdentifier>source="EAN-Lokationsnummer">123456789</OrderedAtPharmacyIdentifier>
    <ExpectedDeliveryDate>2025-12-08</ExpectedDeliveryDate>
    <EventType>"Modtaget på udleveringssted"</EventType>
    <ExpectedNextEventDateTime>2025-12-06T10:00:00Z</ExpectedNextEventDateTime>
</CreateTrackAndTraceEventRequest>

Svaret indeholder den identifier, som event blev tilknyttet (forsendelse, bestilling eller dispenseringsperiode), samt den genererede TrackAndTraceEventIdentifier for eventet

CreateTrackAndTraceEventResponse

CreateTrackAndTraceEventResponse.xml

<CreateTrackAndTraceEventResponse>
    <ShipmentIdentifier>57398396576</ShipmentIdentifier>
    <TrackAndTraceEventIdentifier>777888881827312</TrackAndTraceEventIdentifier>
</CreateTrackAndTraceEventResponse>