====== Registrer manuel dispensering (ophældning) ======
Denne service anvendes til registrering af manuel dispensering (manuel ophældning). Registrering af manuel dispensering foretages, når hjemmeplejen vil vise, at der er foretaget en ophældning ude ved patienten.

EOJ systemerne skal kunne indberette ID'et på en eller flere udleveringer (Apoteksudleveringer el.lign), som indgår i den givne dispenseringsperiode.
Ud fra disse kan de se hvilken pakning, der er ophældt fra, og dermed hvilket lægemiddel, der er anvendt.

For at kunne foretage registrering af en manuel dispensering, skal dette gøres på et [[fmk:1.6.0:xml-elementer:dispenseringskort | dispenseringskort]] tilknyttet den organisation, som foretager registreringen. Indholdet af den færdige registrering afhænger af hvilke lægemiddelordinationer, der er tilknyttet dispenseringskortet med en planlagt administration.

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

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

I request-dokumentet skal der medsendes en ''PersonIdentifier'' på den patient som forespørgslen omhandler.

I elementet ''CreatedBy'' medsendes information omkring organisationen (hjemmesygepleje-enheden) og brugeren som har foretaget oprettelsen, Modifikator. Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK medsendes både et ''ReportedBy''-element, og ''CreatedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]. 

I elementet ''DispensingCardIdentifier'' medsende Id'et på det dispenseringskort som ophældningen foretages på baggrund af. Det forventes at dispenseringskortet bliver valideret som tilhørende samme organisation som organisationen i CreatedBy. 

Der kan angives et ''StartDate'' element, som angiver startdatoen i den periode, der er foretaget ophældning for. Angives elementet ikke antages Startdatoen som værende dags-dato.

Elementet ''EndDate'' skal angives. Det angiver den sidste dag i perioden der er ophældt til.
Registeringen af ophældning gælder altid alle de planlagte administrationer der er tilknyttet dispenseringskortet.

Elementet ''DispensedHandover'' kan angives. Identifikation af den dispenserede udlevering.

Til sidst kan et ''IsPreflight'' element angives. Dette element benyttes til at få gennemkørt servicen, men uden at der foretages en egentlig registrering. Dette kan benyttes til at tjekke om FMK vil tillade en registrering, eller om der skulle være mangler som kræver handlinger inden en registrering kan foretages. På lige fod med Apotekerne forventes det at denne service kan kaldes med FOCES certifikater af brugerens system, og dermed kan der dagligt køres en gennemgang for at finde dispenseringskort som kræver handlinger.

<file xml RegisterDispensingRequest.xml>
<RegisterDispensingRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Indentifier source="CPR">1208911078</Indentifier>
            <Name>Mikkel Smed Hansen</Name>
        </HealthcareProfessional>
        <Role>Kommunal ansat til medicinhåndtering</Role>
        <Organisation>
            <Identifier source="SOR">987654321</Identifier>
            <Type>kommune</Type>
            <Name>Nordfyns Kommune</Name>
            <AddressLine>Østergade 23, 5400 Bogense</AddressLine>
            <TelephoneNumber>99999999</TelephoneNumber>
            <EmailAddress>XYZ@ABC.com</EmailAddress>
        </Organisation>
    </CreatedBy>
    <DispensingCardIdentifier>843138321</DispensingCardIdentifier>
    <StartDate>2025-05-07</StartDate>
    <EndDate>2025-05-22</EndDate>
    <isPreflight>
</RegisterDispensingRequest>
</file>

====== Svar ======

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

Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' og ''DispensingCardIdentifier''.

Hvis kaldet er succesfuldt og der er oprettet en dispenseringsperiode vil elementet  ''DispensingPeriodIdentifier'' indeholde det unikke ID på denne periode. Dispenseringsperioden oprettes kun såfremt der ikke har været en blokerende fejl (såsom manglende opdatering efter ændring i LMO).

Efter ''DispensingPeriodIdentifier'' kan der komme en række ''Warning'' elementer. Disse er forskellige advarsler relateret til perioden, dispenseringskortet eller patienten. Dette kunne være såfremt dispenseringskortet ikke tilhører den samme organisation som CreatedBy. Nærmere detaljer omkring disse advarsler kommer senere.

Det næste kan være en række ''Dispensing'' elementer som indeholder følgende:
  * ''PlannedAdministration'' elementer, som angiver ID og Version på den planlagte administration
  * Optionelt: ''DispensingIdentifier'' unikt ID på den dispensering som er blevet registreret sammen med perioden. Elementet er optionelt af samme grund som ''DispensingPeriodIdentifier'' er.
  * Optionelt: en række ''Warning'' elementer, advarsler placeret her er relateret til den givne planlagte administration eller dispensering. Dette kunne være såfremt den planlagte administration ikke er up-to-date med lægemiddelordinationen.

Der vil forekomme et ''Dispensing'' element for hver aktiv planlagt administration som er tilknyttet de pågældende dispenseringskort.

''Warning'' elementer kan indeholde et ''Blocking'' element. Tilstedeværelsen af dette element angiver, at der advares om noget så betydeligt, at det forhindrer registreringen af den manuelle dispensering (ophældning). Eksempler på dette er fx hvis ikke alle planlagte administrationer er tilknyttet den seneste version af deres lægemiddelordination. Et andet eksempel kan være, at FMK i stamdata konstaterer, at patienten står registreret som død. Dette er eksempler hvor det ikke er forsvarligt at tillade, at der registreres en manuel dispensering (ophældning), inden der er foretaget handlinger fra brugerens side (såfremt det er muligt).

<file xml RegisterDispensingResponse.xml>
<RegisterDispensingResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DispensingCardIdentifier>843138321</DispensingCardIdentifier>
    <DispensingPeriodIdentifier>78346843810</DispensingPeriodIdentifier>
    <Warning>
        <WarningCode>2120</WarningCode>
        <WarningText>Patient har aktivt dispenseringskort ved andre organisationer</WarningText>
        <Severity>medium</Severity>
    </Warning>
    <Dispensing>
        <PlannedAdministration>
            <Identifier>1138438135183</Identifier>
            <Version>87968131381310</Version>
        </PlannedAdministration>
        <DispensingIdentifier>326598147</DispensingIdentifier>
        <Warining>
            <WarningCode>2421</WarningCode>
            <WarningText>Der ændres dosis i perioden</WarningText>
            <Severity>low</Severity>
        </Warining>
    </Dispensing>
    <Dispensing>
        <PlannedAdministration>
            <Identifier>21681838183</Identifier>
            <Version>86137813180</Version>
        </PlannedAdministration>
        <DispensingIdentifier>326598741</DispensingIdentifier>
    </Dispensing>
</RegisterDispensingResponse>
</file>