Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Opret Track&Trace-event ======

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

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.

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.

===== 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. 


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

===== 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>
<CreateTrackAndTraceEventResponse>
    <ShipmentIdentifier>57398396576</ShipmentIdentifier>
    <TrackAndTraceEventIdentifier>777888881827312</TrackAndTraceEventIdentifier>
</CreateTrackAndTraceEventResponse>
</file>