Registrering af en ophældt dispensering. Foretages når hjemmeplejen vil signalere at der er foretaget en ophældning ude ved patienten.

For at kunne foretage regisreringen af en 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 som er tilknyttet dispenseringskortet med en planlagt administration.

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.

Der kan angives en række PlannedAdministrationSubstitutions elementer. Elementerne anvendes til at registere at der er foretaget en substitution i forhold til det lægemiddel som lægen har ordineret. Elementet indeholder PlannedAdministrationIdentifier som markere hvilken administration der foretages en substitution af, sammen med et Substitution element med informationer omkring der substituerende lægemiddel.

Registeringen af ophældning gælder altid alle de planlagte administrationer der er tilknyttet dispenseringskortet. Hvis der ophældes det samme lægemiddel som lægemiddelordinationen angiver, skal der ikke angives en PlannedAdministrationSubstitution.

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>
            <Name>Nordfyns Kommune</Name>
            <AddressLine>Østergade 23, 5400 Bogense</AddressLine>
            <TelephoneNumber>99999999</TelephoneNumber>
            <EmailAddress>XYZ@ABC.com</EmailAddress>
            <Type>kommune</Type>
            <Identifier source="SOR">987654321</Identifier>
        </Organisation>
    </CreatedBy>
    <DispensingCardIdentifier>843138321</DispensingCardIdentifier>
    <StartDate>2025-05-07</StartDate>
    <EndDate>2025-05-22</EndDate>
    <isPreflight>
</RegisterDispensingRequest>

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. Angivelsen af dette element angiver at der advares om noget så betydeligt at det forhindre registreringen af ophældningen. Eksempler på dette er fx hvis ikke alle planlagte administrationer er tilknyttet den seneste version af deres lægemiddelordination. Andre eksempler kunne være hvis FMK kan konstatere i sine stamdata at patienten står registeret som død. Dette er eksempler på situationer hvor FMK ikke mener det er forsvarligt at tillade der registreres en ophældningen, 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>
        <Warining>
            <WarningCode>4132</WarningCode>
            <WarningText>Substitutionen er ikke valideret, da det ordinerede lægemiddel er udgået</WarningText>
            <Severity>low</Severity>
        </Warining>
    </Dispensing>
</RegisterDispensingResponse>