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

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

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>

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

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>