====== List Dispenseringspatienter ======

Denne service anvendes til at fremsøge alle de patienter der er tilknyttet et givet lægehus (jvf. sygesikringen) og som har et aktivt dispenseringskort.

Servicen er tiltænkt at lægesystemet kan give lægen eller lægehuset et overblik over deres DD patienter.

**Bemærk** Servicen er primært tiltænkt tiltænkt en liste af DD-patienter, men FMK's 1.6.0 tillader også Dispenseringskort ved hjemmeplejen el.lign. Det er muligt at filtrere på, om sådanne dispenseringskort skal inkluderes.

====== Forespørgsel ======

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#ListDispensingPatientsRequestType|Request]]

I en forespørgsel til servicen angives først hvilke information man ønsker at inkludere i sit svar fra FMK, herefter hvilke organisationer som skal søges på.

Følgende muligheder findes for at specificere sine resultater:
  * ''IncludePatientDetails'' markere at der ønskes detaljer omkring patienten (navn og adresse)
  * ''IncludeDoseDispensingPatients'' markere at man ønsker at fremsøger dispenseringskort fra apoteket (Dosisdispensering)
  * ''IncludeManualDispensingPatients'' markere man ønsker at fremsøger dispenseringskort fra hjemmeplejen o.lign

Herefter angiver man hvilke(n) organisation(er) man ønsker at søge på i en række ''OrganisationIdentifier'' elementer.

<file xml ListDispensingPatientsRequest.xml>
<ListDispensingPatientsRequest>
    <IncludePatientDetails/>
    <IncludeDoseDispensingPatients/>
    <IncludeManualDispensingPatients/>
    <OrganisationIdentifier source="Yder">987441</OrganisationIdentifier>
</ListDispensingPatientsRequest>
</file>  

===== Svar =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#ListDispensingPatientsResponseType|Response]]

Svaret fra servicen indeholder en række ''Organisation'' elementer, en for hver der blev angivet i forespørgslen.

''Organisation'' elementerne indeholder hver en ''Identifier'' på den organisation der blev søgt på samt muligheden for en række ''PersonWithDispensingCard'' (elementerne forekommer ikke såfremt der ingen dispenseringspatienter er).

Hvert ''PersonWithDispensingCard'' element indeholder følgende:
  * et ''Patient'' eller ''PersonIdentifier'' element. ''Patient'' kommer såfremt man anvendte ''IncludePatientDetails'' i forespørgslen, eller kommer kun ''PersonIdentifier''.
  * En række ''DispensingCardSummary'' elementer, et for hvert aktivt dispenseringskort som patienten har.

''DispensingCardSummary'' elementerne indeholder følgende:
  * ''DispensingCardIdentifier'' Unikt id for det enkelte dispenseringskort.
  * ''DispensingCardOwner'' den nuværender "ejer" af dispenseringskortet.
  * ''DispensingCardOwnerName'' navnet på den nuværende ejer.
  * ''CreatedDateTime'' hvornår kortet originalt er blevet oprettet.
  * Optionelt: en række ''DispensedMedication'' elementer, disse indeholder ''DrugMedicationIdentifier'' og optionelt også ''DrugName'' på de lægemiddelordinationer som dispenseres fra det pågældende dispenseringskort.

Eksempel med patient detaljer:
<file xml ListDispensingPatientsResponse.xml>
<ListDispensingPatientsResponse>
    <Organisation>
        <Identifier source="Yder">987441</Identifier>
        <PersonWithDispensingCard>
            <Patient>
                <Person>
                    <Name>
                        <GivenName>Sonja</GivenName>
                        <Surname>Kristensen</Surname>
                    </Name>
                    <PersonIdentifier source="CPR">2006230004
                </PersonIdentifier>
                </Person>
                <AddressLine>Sumatravej 142</AddressLine>
                <AddressLine>4840 Nørre Alslev</AddressLine>
            </Patient>
            <DispensingCardSummary>
                <DispensingCardIdentifier>1751533926204027088</DispensingCardIdentifier>
                <DispensingCardOwner source="SOR">987654321</DispensingCardOwner>
                <DispensingCardOwnerName>Plejehjemmet hedegaarden</DispensingCardOwnerName>
                <CreatedDateTime>2025-11-29T12:00:00Z</CreatedDateTime>
                <DispensedMedication>
                    <DrugMedicationIdentifier>3216813135813</DrugMedicationIdentifier>
                    <DrugName>Panodil</DrugName>
                </DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
            </DispensingCardSummary>
        </PersonWithDispensingCard>
        <PersonWithDispensingCard>...</PersonWithDispensingCard>
        <PersonWithDispensingCard>...</PersonWithDispensingCard>
    </Organisation>
</ListDispensingPatientsResponse>
</file>

Hvis der ikke er anmodet PatientDetails kan svaret se sådan ud:

<file xml ListDispensingPatientsResponse2.xml>
<ListDispensingPatientsResponse>
    <Organisation>
        <Identifier source="Yder">987441</Identifier>
        <PersonWithDispensingCard>
            <PersonIdentifier source="CPR">1212205790</PersonIdentifier>
            <DispensingCardSummary>
                <DispensingCardIdentifier>1751533926204027088</DispensingCardIdentifier>
                <DispensingCardOwner source="SOR">987654321</DispensingCardOwner>
                <DispensingCardOwnerName>Plejehjemmet hedegaarden</DispensingCardOwnerName>
                <CreatedDateTime>2025-11-29T12:00:00Z</CreatedDateTime>
                <DispensedMedication>
                    <DrugMedicationIdentifier>3216813135813</DrugMedicationIdentifier>
                    <DrugName>Panodil</DrugName>
                </DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
                <DispensedMedication>...</DispensedMedication>
            </DispensingCardSummary>
        </PersonWithDispensingCard>
        <PersonWithDispensingCard>...</PersonWithDispensingCard>
        <PersonWithDispensingCard>...</PersonWithDispensingCard>
    </Organisation>
</ListDispensingPatientsResponse>
</file>