====== Hent Dispenseringskort historik ======

Servicen anvendes til at hente en historisk oversigt over alle versioner af patientens dispenseringskort.

====== Forespørgsel ======
I 
[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardHistoryRequestType|forespørgslsen]] skal ''PersonIdentifier'' på patienten altid angives. Alternativt angives ''OrganisationIdentifier'', hvis der er tale om dispenseringskort til organisationer. 

Herefter kan en ''DispensingCardIdentifier'' angives, såfremt man ønsker historik over et givent dispenseringskort. Undlades ''DispensingCardIdentifier'' hentes historikken for samtlige af patientens/organisationens dispenseringskort, inklusiv dispenseringskort, som ikke længere er aktive.

<file xml GetDispensingCardHistoryRequest.xml>
<GetDispensingCardHistoryRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<DispensingCardIdentifier>35148313183</DispensingCardIdentifier>
</GetDispensingCardHistoryRequest>
</file>

====== Svar ======
Som [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardHistoryResponseType|svar]] fra servicen modtager man ''PersonIdentifier'' for patienten og en række ''DispensingCardHistory'' elementer. Bemærk, hvis patienten aldrig har haft et dispenseringskort, vil der ingen ''DispensingCardHistory'' elementer være.

Hvert ''DispensingCardHistory'' element indeholder ''Identifier'' for det enkelte dispenseringskort, og en række ''DispensingCardEntry'' elementer med historikken.

''DispensingCardEntry'' elementerne indeholder følgende:

  * ''Version'': Versionsnummer for det pågældende historiske dispenseringskort.
  * ''Created'': Modifikator for personen, som oprindeligt oprettede dispenseringskortet.
  * Optionelt ''ReportedBy'': Modifikator for personen, som indrapportede den pågældende version.
  * Optionelt ''Modified'': Modifikatoren for personen, hvis ændring ledte til denne version af dispenseringskortet.
  * ''Description'': Beskrivelse af dispenseringskortet.
  * Optionelt ''Delivery'': Informationer omkring leveringen af dispenseringskortet.
  * Informationer omkring de involverede apoteker eller hjemmeplejen i enten ''PackingGroupIdentifier''+''OrderedAtPharmacy''+''PackedAtOrganisation'' ELLER ''DispensingOrganisation''.
  * Optionelt ''DispensingNotes'': Noter omkring dispenseringen.
  * Optionelt ''DeliveryNotes'': Noter omkring leveringen.
  * Optionelt ''DispensingMachineIdentification'': Information omkring den dispenseringsmaskine, som er tilknyttet dispenseringskortet.

Yderligere beskrivelse af felterne kan findes på [[fmk:1.6.0:xml-elementer:dispenseringskort|denne side]]

<file xml GetDispensingCardHistoryResponse.xml>
<GetDispensingCardHistoryResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DispensingCardHistory>
        <Identifier>35148313183</Identifier>
        <DispensingCardEntry>
            <Version>342349203842</Version>
            <Created>
                <By>
                    <HealthcareProfessional>
                        <Identifier source="CPR">1111111118</Identifier>
                        <Name>Karl Karlsen</Name>
                    </HealthcareProfessional>
                    <Role>Apoteksansat</Role>
                    <Organisation>
                        <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                        <Type>Apotek</Type>
                        <Name>Kolind Apotek</Name>
                        <AddressLine>...</AddressLine>
                        <TelephoneNumber>...</TelephoneNumber>
                        <EmailAddress>...</EmailAddress>
                    </Organisation>
                </By>
                <DateTime>2013-10-01T00:00:00Z</DateTime>
            </Created>
            <Description>Version 1</Description>
            <PackingGroupIdentifier>241245127</PackingGroupIdentifier>
            <OrderedAtPharmacy>
                <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                <Type>Apotek</Type>
                <Name>Kolind Apotek</Name>
                <AddressLine>...</AddressLine>
                <TelephoneNumber>...</TelephoneNumber>
                <EmailAddress>...</EmailAddress>
            </OrderedAtPharmacy>
            <PackedAtOrganisation>
                <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                <Type>Apotek</Type>
                <Name>Kolind Apotek</Name>
                <AddressLine>...</AddressLine>
                <TelephoneNumber>...</TelephoneNumber>
                <EmailAddress>...</EmailAddress>
            </PackedAtOrganisation>
            <DeliveryNotes>Leveres med bud</DeliveryNotes>
            <DispensingMachineIdentification>
                <Brand>MyMachineINC</Brand>
                <Identifier>A1336</Identifier>
            </DispensingMachineIdentification>
        </DispensingCardEntry>
        <DispensingCardEntry>...</DispensingCardEntry>
        <DispensingCardEntry>...</DispensingCardEntry>
    </DispensingCardHistory>
</GetDispensingCardHistoryResponse>
</file>