====== Hent Track&Trace-oplysninger ======
Denne service anvendes til at finde oplysninger relateret til Track&Trace for en person eller organisation. 

Foruden Track&Trace-oplysninger relateret til bestillinger og dispenseringsperioder, kan servicen også hente oplysninger om anmodninger om udleveringsgrundlag.

Se også [[..:intro:track_and_trace#track_and_trace1|Intro til Track and trace]]
===== Forespørgsel =====

I forespørgslen angives først patientens ''PersonIdentifier''. Hvis der er tale om praksisrecepter eller DD til institutioner, kan organisationens ''OrganisationIdentifier'' angives i stedet.

Forespørgslen tillader filtrering på både event-typer og datoer. Sættes ''IncludeAllEventsCreatedSince'' vil FMK returnere alle events oprettet efter dette tidspunkt. Vær dog opmærksom på, at FMK ikke gemmer Track&Trace-events i mere end 3 måneder. Sættes denne dato ikke, fremsøges kun events oprettet inden for de sidste 7 dage. 

Filtrering på event-typer foregår ved enten ''IncludeType'' eller ''ExcludeType''. Angives en række ''IncludeType''-elementer, vil FMK kun fremsøge events af denne type. Angives i stedet ''ExcludeType''-elementer vil FMK fremsøge alle typer events foruden de angivne. Der kan ikke angives både ''IncludeType''- og ''ExcludeType''-elementer. 

Der kan optionelt angives et antal ''DrugMedicationIdentifier''-elementer. Angives disse, vil der kun hentes Track&Trace-oplysninger (og evt. anmodninger om udleveringsgrundlag) relateret til disse specfikke lægemiddelordinationer. Ligeledes kan der angives et antal ''DispensingPeriodIdentifier''-elementer, hvor servicen så kun returnerer events relateret til disse dispenseringsperioder.

Angives der ikke nogen identifiers, vil servicen returnere Track&Trace-oplysninger relateret til alle patientens lægemiddelordinationer/dispenseringsperioder.

=== Eksempel 1 ===
Forespørgsel på alle events oprettet siden 1. september 2026 relateret til 2 specikke lægemiddelordinationer samt 1 specifik dispenseringsperiode.

<file xml GetTrackAndTraceDetailsRequest.xml>
<GetTrackAndTraceDetailsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IncludeAllEventsCreatedSince>2026-09-01T00:00:00Z</IncludeAllEventsCreatedSince>
    <DrugMedicationIdentifier>213219872091</DrugMedicationIdentifier>
    <DrugMedicationIdentifier>234029384209</DrugMedicationIdentifier>
    <DispensingPeriodIdentifier>77123109281</DispensingPeriodIdentifier>
</GetTrackAndTraceDetailsRequest>
</file>


=== Eksempel 2 ===
Forespørgsel på events oprettet inden for den sidste uge af typerne "Afsendt" og "Modtaget på udleveringssted" på samtlige lægemiddelordinationer/dispenseringsperioder.

<file xml GetTrackAndTraceDetailsRequest.xml>
<GetTrackAndTraceDetailsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IncludeType>Afsendt</IncludeType>
    <IncludeType>Modtaget på udleveringssted</IncludeType>
</GetTrackAndTraceDetailsRequest>
</file>
===== Svar =====

Svaret indeholder først den medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''.

Dernæst forekommer et antal ''TrackAndTraceEventsOnDrugMedication''-elementer og et antal ''TrackAndTraceEventsOnDispensingPeriod''-elementer, som beskrevet nedenfor. De enkelte sekvenser af Track&Trace-events vil være sorteret kronologisk med det nyeste først. Grupperingerne under lægemiddelordination og dispenseringsperiode vil være sorteret efter, senest oprettede tilknyttede event.

''TrackAndTraceEventsOnDrugMedication'' indeholder følgende:
  * ''DrugMedicationIdentifier'', id på lægemiddelordinationen
  * Optionelt et antal ''RequestForWarrant''-elementer.
  * Optionelt et antal ''TrackAndTraceEventsOnOrder''-elementer. Hver af disse indeholder et [[fmk:1.6.0:xml-elementer:bestilling|Order]]-element samt op til flere specifikke ''TrackAndTraceEvent''-elementer, som beskrevet på [[fmk:1.6.0:xml-elementer:Track-and-trace event | denne side]].

''TrackAndTraceEventsOnDispensingPeriod'' indeholder følgende:
  * ''DoseDispensingDeliveryAndStatus'', indeholder ID på dispenseringsperioden, status på dispenseringsperioden samt det ''Delivery''-element, som er angivet på dispenseringskortet.
  * En række specifikke ''TrackAndTraceEvent''-elementer, som beskrevet [[fmk:1.6.0:xml-elementer:Track-and-trace event | her]] .

Et ''RequestForWarrant''-element indeholder:
  * ''Identifier'', id for anmodningen
  * Optionelt op til flere ''IssuerOrganisation''-elementer, oplysninger om modtagerorganisation(er)
  * Optionelt en af følgende: (se evt [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#typer_af_udleveringsgrundlag | typer af udleveringsgrundlag]])
    * ''Prescription'', angiver at der anmodes om en recept
    * ''HospitalPharmacyHandover'', angiver at der anmodes om et sygehusapoteksudleveringsgrundlag
    * ''DoseDispened'', angiver at der anmodes om en dosisrecept.
  * ''Status'', status på anmodningen
  * Optionelt: ''WarrantIdentifier''. Denne er angivet såfremt anmodningen er behandlet, og der er blevet oprettet et udleveringsgrundlag på lægemiddelordinationen.

=== Eksempel === 

<file xml GetTrackAndTraceDetailsResponse.xml>
<GetTrackAndTraceDetailsResponse>
  <PersonIdentifier source=CPR>1111111118</PersonIdentifier>
  <TrackAndTraceEventsOnDrugMedication>
    <DrugMedicationIdentifier>213219872091</DrugMedicationIdentifier>
    <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>"Pakket til forsendelse"</EventType>
        <ExpectedDeliveryDate>2025-10-11</ExpectedDeliveryDate>
        <ExpectedNextEventDateTime>2025-10-10T09:00:00Z</ExpectedNextEventDateTime>
        <AdditionalInformation><Key>Kurer</Key><Value>DAO</Value></AdditionalInformation>
      </TrackAndTraceEvent>
    </TrackAndTraceEventsOnOrder>
  </TrackAndTraceEventsOnDrugMedication>
  <TrackAndTraceEventsOnDrugMedication>
    <DrugMedicationIdentifier>234029384209</DrugMedicationIdentifier>
    <RequestForWarrant>
      <Identifier>79871982731</Identifier>
      <DoseDispensed/>
      <Status>unhandled</Status>
    <RequestForWarrant>
  </TrackAndTraceEventsOnDrugMedication>
  <TrackAndTraceEventsOnDispensingPeriod>
    <DoseDispensingDeliveryAndStatus>
      <DispensingPeriodIdentifier>77123109281</DispensingPeriodIdentifier>
      <DispensingStatus>Sendes</DispensingStatus>
      <Delivery>
        [...]
      </Delivery>
    </DoseDispensingDeliveryAndStatus>
    <TrackAndTraceEvent>
      <TrackAndTraceEventIdentifier>34132034234232</TrackAndTraceEventIdentifier>
      <EventDateTime>2026-09-09T13:37:12Z</EventDateTime>
      <OrderedAtPharmacy>
        <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
        <Type>Apotek</Type>
        <Name>Kolind Apotek</Name>
      </OrderedAtPharmacy>
      <EventType>"Afsendt"</EventType>
      <IsFinalEvent/>
    </TrackAndTraceEvent>
  </TrackAndTraceEventsOnDispensingPeriod>
</GetTrackAndTraceDetailsResponse>
</file>