Differences

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

--- fmk:1.6.0:services:start_handtering_af_dispenseringsperiode [2025-10-29 11:53] – [Forespørgsel] sas
+++ fmk:1.6.0:services:start_handtering_af_dispenseringsperiode [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Start håndtering af dispenseringsperiode ======
-Service benyttes ved påbegyndelsen af apoteks workflow for at få pakket og udleveret en dispersingsperiode til patienten.
+Service benyttes ved påbegyndelse af apoteks workflow for at få pakket og udleveret en dispenseringsperiode 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.
+I 1.6.0 ændres funktionaliteten i denne service markant, for det første for at kunne understøtte de ændringer som sker i 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 periode der er begyndt, angives i denne forespørgsel, med mulighed for at vælge, at 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".
+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 er skiftet til "Klar til pakning".
 ===== Forespørgsel =====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartHandlingOfDispensingPeriodRequestType|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]].
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartHandlingOfDispensingPeriodRequestType|Request]]
-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.
+I forespørgsel skal der sendes en ''PersonIdentifier'' med på den patient, som skal have tilføjet et dosisdispenseringskort. Såfremt det pågældende dispenseringskort skal anvendes som dosisdispenseringskort til organisationer, skal dette angives i ''OrganiastionIdentifier'' på den pågældende organisation.
-herefter 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:
+I elementet ''ModifiedBy'' sendes information omkring organisationen med(udleverings eller pakkeapoteket), og brugeren som har foretaget opdateringen, [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Er elementet oprettet af en anden aktør end personen, der foretager kaldet mod FMK sendes både et ''ReportedBy''-element, og ''ModifiedBy'' med. 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 vil kunne accepteres, eller om der er ændringer, som kræver handling, inden en opdatering kan godkendes.
+Herefter 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 håndtering af.
   * ''DispensingPeriodVersion'' Versions-nummeret på den nuværende version af dispenseringsperiode.
   * En af følgende 2 muligheder
-  * Optionelt: ''UseDraftSubstitutions'' element som ved sin angivelse signalere overfor FMK at man ønsker at benytte substitutionskladerne for alle planlagte administrationer.
+  * Optionelt: ''UseDraftSubstitutions'' element som ved sin angivelse signalere overfor FMK at man ønsker at benytte substitutionskladderne for alle planlagte administrationer.
   * Optionelt: en række ''PlannedAdministrationSubstitutions'' elementer, som angiver en eksplicit ''Substitution'' for en given planlagt administration (angivet med ''PlannedAdministrationIdentifier'') i denne periode.
-Til sidste forespørgslen kan et ''CreateNextPeriod'' element angives, denne skal indeholder ''StartDate'' og ''EndDate'' og optionelt en ''ExpectedDelivery''. Angivelsen af ''CreateNextPeriod'' erstatter funktionaliteten i FMK 1.4.6 hvor FMK automatisk oprettede næste periode, såfremt den ikke allerede eksisterede. Det er op til det enkelte system om man ønsker at anvende denne funktionalitet.
+Til sidste forespørgslen kan et ''CreateNextPeriod'' element angives, denne skal indeholde ''StartDate'' og ''EndDate'' og optionelt en ''ExpectedDelivery''. Angivelsen af ''CreateNextPeriod'' erstatter funktionaliteten i FMK 1.4.6, hvor FMK automatisk oprettede næste periode, såfremt den ikke allerede eksisterede. Det er op til det enkelte system, om man ønsker at anvende denne funktionalitet.
 ==== XML eksempel ====
 <file xml StartHandlingOfDispensingPeriodRequest.xml>
@@ Line 59: / Line 62: @@
                 </Form>
                 <Strength>
-                    <Value>500.000</Value>
+                    <StrengthItem>
-                    <UnitCode source="Medicinpriser" sourceDate="2025-05-05">MG</UnitCode>
+                        <Value>500.000</Value>
-                    <UnitText>500 mg</UnitText>
+                        <UnitCode source="Medicinpriser" sourceDate="2025-05-05">MG</UnitCode>
+                        <UnitText>500 mg</UnitText>
+                    </StrengthItem>
                 </Strength>
             </Substitution>
@@ Line 69: / Line 74: @@
 </file>
 ===== Svar =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartHandlingOfDispensingPeriodResponseType|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 ''StartedHandlingOfDispensingPeriod'' elementer, en for hver dispenseringsperiode.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartHandlingOfDispensingPeriodResponseType|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 ''StartedHandlingOfDispensingPeriod'' elementer, en for hver dispenseringsperiode.
 StartedHandlingOfDispensingPeriodelementet indeholder følgende:
@@ Line 85: / Line 91: @@
   * 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".
+**Bemærk** ''Warning'' elementerne er i 1.6.0 udvidet med et ''Blocking'' element, som ved sin angivelse signalerer, 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, at apoteket skal have fokus, hvis de vil have perioden sat "Klar til pakning".
 ==== XML eksempel ====