This is an old revision of the document!
Table of Contents
Opret Track&Trace-event
Denne service kan bruges til at oprette Track&Trace-events.
Læg mærke til at Track&Trace-events også kan oprettes implicit af andre services, såsom Opret bestilling og Klargør forsendelse. Denne service gør det derfor muligt at oprette yderligere Track&Trace-events og derved bedre understøtte 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 i event-loggen foregå ved at oprette nye Track&Trace-events, typisk via. kald til denne service.
Forespørgsel
Forespørgslen til denne service starter med enten en ShipmentIdentifier, en OrderIdentifier eller en DispensingPeriodIdentifier på hhv. 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.
Dernæst angives OrganisationIdentifier på det ansvarlige apotek, forventet leveringsdato samt eventets type.
Det er muligt at angive en fritekst på eventet, for eksempel til at uddybe konteksten for at eventet er blevet oprettet.
Det er desuden muligt at angive et flag af typen IsFinalEvent, hvis det ikke forventes at flere events 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. Alternativt er det muligt at angive et forventet tidspunkt for næste event i elementet ExpectedNextEventDateTime.
CreateTrackAndTraceEventRequest
- 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>
Svar
Svaret indeholder den identifier, som event blev tilknyttet (forsendelse, bestilling eller dispenseringsperiode), samt den genererede TrackAndTraceEventIdentifier for eventet
- CreateTrackAndTraceEventResponse.xml
<CreateTrackAndTraceEventResponse> <ShipmentIdentifier>57398396576</ShipmentIdentifier> <TrackAndTraceEventIdentifier>777888881827312</TrackAndTraceEventIdentifier> </CreateTrackAndTraceEventResponse>
