Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:services:registrer_ophaeldning [2025-05-20 07:36] – [Svar] sas
+++ fmk:1.6.0:services:registrer_ophaeldning [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Registrer ophældning ======
-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 dispenserings, 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 som er tilknyttet dispenseringskortet med en planlagt administration.
+====== 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 (udleverings eller pakkeapoteket) 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 ''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, værende en startdato for den ophældning der er foretaget. Angives elementet ikke antages Startdatoen som værende dags-dato.
+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, værende sidste dag i perioden der er ophældt til.
+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.
-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.
+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.
@@ Line 29: / Line 39: @@
         <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>
-            <Type>kommune</Type>
-            <Identifier source="SOR">987654321</Identifier>
         </Organisation>
     </CreatedBy>
@@ Line 40: / Line 50: @@
     <StartDate>2025-05-07</StartDate>
     <EndDate>2025-05-22</EndDate>
-    <PlannedAdministrationSubstitution>
-        <PlannedAdministrationIdentifier>45698713</PlannedAdministrationIdentifier>
-        <Substitution>
-            <Identifier date="2025-5-19" source="Medicinpriser">
-                28103888005
-            </Identifier>
-            <Name>Pinex</Name>
-            <ATC>
-                <Code date="2025-5-19" source="Medicinpriser">N02BE01</Code>
-                <Text>Paracetamol</Text>
-            </ATC>
-            <Form>
-                <Code date="2025-5-19" source="Medicinpriser">TABFILM</Code>
-                <Text>filmovertrukne tabletter</Text>
-            </Form>
-            <Strength>
-                <Value>500</Value>
-                <UnitCode date="2025-5-19" source="Medicinpriser">MG</UnitCode>
-                <UnitText>500 mg</UnitText>
-            </Strength>
-        </Substitution>
-    </PlannedAdministrationSubstitution>
     <isPreflight>
 </RegisterDispensingRequest>
@@ Line 67: / Line 55: @@
 ====== Svar ======
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterDispensingResponseType|Response]]
 Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' og ''DispensingCardIdentifier''.
-Der kan være at ''DispensingPeriodIdentifier'' element, dette element indeholder der unikke ID på den oprettede dispenseringsperiode. Dispenseringsperioden oprettes kun såfremt der ikke har været en blokerende fejl (såsom manglende mangelende opdatering efter ændring i LMO).
+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.
@@ Line 80: / Line 71: @@
 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 ansvarligt at tillade der registreres en ophældningen, inden der er foretaget handlinger fra brugerens side (såfremt det er muligt).
+''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>
@@ Line 110: / Line 101: @@
         </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>
 </file>