Differences

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

--- fmk:1.6.0:services:start_effektuering_af_dispenseringsperiode [2025-10-17 10:04] – [TODO:] sas
+++ fmk:1.6.0:services:start_effektuering_af_dispenseringsperiode [2025-10-29 11:52] (current) – removed sas
@@ Line 1: / Line 1: @@
-====== TODO: ======
-  * STSTB-119
-  * Substitution foregår anderledes, skal beskrives (( Se [[fmk:1.6.0:services:registrer_substitutions_kladde|her]] ))
-  * CreateNextPeriod er indført, skal beskrives
-====== Start effektuering af dispenseringsperiode ======
-Service benyttes ved påbegyndelsen af apoteks workflow for at få pakket og udleveret en dispersingsperiode til patienten.
-I 1.6.0 ændres funktionaliteten i denne service markant, for det første for at kunne understøtte de ændringer som sker if forbindelse med generaliseringen af [[fmk:1.6.0:planlagt_administration |planlagt administration]] & [[fmk:1.6.0:dosisdispensering]]. Dette kræver bl.a. at substitutioner for den startede periode, angives i denne forespørgsel, med mulighed for at vælge FMK skal genbruge tidligere periodes substitutioner.
-Servicen forventes i 1.6.0 kun at kunne flytte en periode til "Klar til pakning". Dette betyder bl.a. at det bliver et krav fra FMK's side at alle data er "klar" inden en periode vil kunne startes, der foretages ikke en låsning af ændringer fra lægen før perioden har skiftet til "Klar til pakning".
-===== Forespørgsel =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartEffectuationOfDispensingPeriodRequestType|Request]]
-I request-dokumentet skal der medsendes en ''PersonIdentifier'' på den patient som skal have tilføjet et dosisdispenseringskort. Såfremt det pågældnede dispenseringskort skal anvendes som dosisdispenseringskort til organiastioner, skal dette angives i ''OrganiastionIdentifier'' på den pågældende organisation.
-I elementet ''ModifiedBy'' medsendes information omkring organisationen (udleverings eller pakkeapoteket) og brugeren som har foretaget opdateringen, Modifikator. Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK medsendes både et ''ReportedBy''-element, og ''ModifiedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].
-Herefter kan elementet ''Preflight'' angives. Preflight anvendes når en opdatering ikke skal finde sted, men man ønsker indsigt i om en opdatering faktisk ville kunne accepteres, eller om der er ændringer som kræver handling inden en opdatering kan godkendes.
-Sidst i forespørgslen kan en række ''StartEffectuationOfDispensingPeriod'' elementer angives. Dette element indeholder en del information omkring de perioder som apoteker ønsker at påbegynde en udlevering af. Elementet indeholde følgende:
-  * ''DispensingPeriodIdentifier'' ID'et på den dispenseringsperiode som ønskes påbegyndt udlevering på.
-  * Optionelt: ''UsePreviousPeriodSubstitutions'' element som ved sin angivelse signalere overfor FMK at FMK genre må forsøge at anvende substitutioner fra tidligere periode. Dette erstatter den funktionalitet i 1.4.6 hvor det pakkede lægemiddel fra pakkeapoteket kopieres til næste version af den planlagte dispensering.
-  * en række ''PlannedAdministrationSubstitutions'' elementer, som angiver en eksplicit ''Substitution'' for en given planlagt administration (angivet med ''PlannedAdministrationIdentifier'') i denne periode. Benyttes dette element, samtidig med at ''UsePreviousPeriodSubstitutions'' er angivet, benyttes informationer fra dette element, og sidste periodes substitution ignoreres for den angivne planlagte administration.
-==== XML eksempel ====
-<file xml StartEffectuationOfDispensingPeriodRequest.xml>
-<StartEffectuationOfDispensingPeriodRequest>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-    <ModifiedBy>
-        <HealthcareProfessional>
-            <Indentifier source="CPR">2012850101</Indentifier>
-            <Name>Hanne Jensen</Name>
-        </HealthcareProfessional>
-        <Role>Apoteksansat</Role>
-        <Organisation>
-            <Name>Aarhus Kobbergade Apotek</Name>
-            <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
-            <TelephoneNumber>00000000</TelephoneNumber>
-            <EmailAddress>ABC@XYZ.com</EmailAddress>
-            <Type>Apotek</Type>
-            <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
-        </Organisation>
-    </ModifiedBy>
-    <IsPreflight/>
-    <StartEffectuationOfDispensingPeriod>
-        <DispensingPeriodIdentifier>325698741</DispensingPeriodIdentifier>
-        <UsePreviousPeriodSubstitutions/>
-        <PlannedAdministrationSubstitutions>
-            <PlannedAdministrationIdentifier>357896512</PlannedAdministrationIdentifier>
-            <Substitution>
-                <Identifier source="Medicinpriser" sourceDate="2025-05-05">28100636073</Identifier>
-                <Name>Panodil</Name>
-                <ATC>
-                    <Code source="Medicinpriser" sourceDate="2025-05-05">N02BE01</Code>
-                    <Text></Text>
-                </ATC>
-                <Form>
-                    <Code source="Medicinpriser" sourceDate="2025-05-05">TABFILM</Code>
-                    <Text>filmovertrukne tabletter</Text>
-                </Form>
-                <Strength>
-                    <Value>500.000</Value>
-                    <UnitCode source="Medicinpriser" sourceDate="2025-05-05">MG</UnitCode>
-                    <UnitText>500 mg</UnitText>
-                </Strength>
-            </Substitution>
-        </PlannedAdministrationSubstitutions>
-    </StartEffectuationOfDispensingPeriod>
-</StartEffectuationOfDispensingPeriodRequest>
-</file>
-===== Svar =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartEffectuationOfDispensingPeriodResponseType|Response]]
-Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''. Herudover en der en række oplysninger omkring de perioder som blev angivet i forespørgslen i en række ''StartedEffectuationOfDispensingPeriod'' elementer, en for hver dispenseringsperiode.
-StartedEffectuationOfDispensingPeriod elementet indeholder følgende:
-  * ''DispensingPeriodIdentifier'' ID på den pågældende dispenseringsperiode.
-  * ''DispensingPeriodStatus'' Den resulterende status for periode, bemærk denne kan være uændret fra de man kaldte perioden.
-  * Optionelt: en række ''Warning'' elementer, disse advarsler er relateret til perioden eller patienten i sin helhed.
-  * Optionelt: en række ''Dispensing'' elementer. Her er en for hver planlagt administration som er involveret (skal dispenseres) i perioden. Hvis der ikke findes nogen planlagte administration som er aktive i perioden, er rækken tom.
-''Dispensing'' elementerne indeholder følgende:
-  * ''PlannedAdministration'' element, indeholder ''Identifier'' og ''Version'' på den planlagte administration, optionelt kan der også findes en række ''Warning'' elementer, disse er relateret til den planlagte administraiton.
-  * Optionelt: ''DispensingIdentifier'' Unikt ID for dispenseringen af den planlagte administration i den pågældende periode. Bemærk at dette felt mangler såfremt perioden ikke kunne sættes "Klar til pakning".
-  * Optionelt: en række ''Warning'' elementer. Disse advarsler relateres den den enkelte dispensering, disse advarsler kan forekomme uden ''DispensingIdentifier'' forekommer.
-**Bemærk** ''Warning'' elementerne er i 1.6.0 udvidet med et ''Blocking'' element, som ved sin angivelse signalere at den pågældende advarsel har været blokerende for opdateringen. Dette er specielt relevant for denne service, da det vil være her apoteket skal lægge fokus hvis de vil have perioden sat "Klar til pakning".
-==== XML eksempel ====
-<file xml StartEffectuationOfDispensingPeriodResponse.xml>
-<StartEffectuationOfDispensingPeriodResponse>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-    <StartedEffectuationOfDispensingPeriod>
-        <DispensingPeriodIdentifier>357852159</DispensingPeriodIdentifier>
-        <DispensingPeriodStatus>Klar til pakning</DispensingPeriodStatus>
-        <Warning>
-            <WarningCode>2120</WarningCode>
-            <WarningText>Patient har aktivt dispenseringskort ved andre organisationer</WarningText>
-            <Severity>medium</Severity>
-        </Warning>
-        <Dispensing>
-            <PlannedAdministration>
-                <Identifier>2345687</Identifier>
-                <Version>258963147</Version>
-                <Warning>
-                    <WarningCode>2511</WarningCode>
-                    <WarningText>Lægemidlet er pauseret</WarningText>
-                    <Severity>low</Severity>
-                </Warning>
-            </PlannedAdministration>
-            <DispensingIdentifier>456123789</DispensingIdentifier>
-            <Warining>
-                <WarningCode>4132</WarningCode>
-                <WarningText>Substitutionen er ikke valideret, da det ordinerede lægemiddel er udgået</WarningText>
-                <Severity>low</Severity>
-            </Warining>
-        </Dispensing>
-        <Dispensing>...</Dispensing>
-        <Dispensing>...</Dispensing>
-        <Dispensing>...</Dispensing>
-        <Dispensing>...</Dispensing>
-    </StartedEffectuationOfDispensingPeriod>
-</StartEffectuationOfDispensingPeriodResponse>
-</file>