Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:services:opret_track-and-trace-event [2025-09-30 08:23] – lbdo
+++ fmk:1.6.0:services:opret_track-and-trace-event [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Opret Track&Trace-event ======
-Denne service kan bruges til at oprette diverse events i Track&Trace.
+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 [[fmk:1.6.0:services:Opret bestilling]] og [[fmk:1.6.0:services: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.
-==== Forespørgsel ====
+Bemærk at Track&Trace-events også oprettes implicit af andre services, såsom [[fmk:1.6.0:services:Opret bestilling]] og [[fmk:1.6.0:services: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.
-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.
+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.
-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.
+===== Forespørgsel =====
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateTrackAndTraceEventRequestType|Request]]
+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.
-Dernæst angives ''OrganisationIdentifier'' på det ansvarlige apotek, samt eventets type.
 <file xml CreateTrackAndTraceEventRequest.xml>
@@ Line 16: / Line 28: @@
     <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>
 </file>
-==== Svar ====
-Svaret indeholder den identifier, som event blev tilknyttet (forsendelse, bestilling eller dispenseringsperiode), samt den genererede ''TrackAndTraceEventIdentifier'' for eventet
+===== Svar =====
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateTrackAndTraceEventResponseType|Response]]
+Svaret indeholder den identifier, som event blev tilknyttet (forsendelse, bestilling eller dispenseringsperiode), samt den genererede ''TrackAndTraceEventIdentifier'' for eventet
 <file xml CreateTrackAndTraceEventResponse.xml>