Differences

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

--- fmk:1.6.0:services:hent_pakkegruppe [2025-10-30 09:39] – [Forespørgsler til servicen] sas
+++ fmk:1.6.0:services:hent_pakkegruppe [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
 Denne service anvendes af apoteket til at hente en pakkegruppe samt evt. et overblik over de patienter, dispenseringskort og -perioder, der er knyttet til pakkegruppen.
-Denne service kan kaldes med VOCES / FOCES certifikat. Det kan blandt andet anvendes af udleveringsapoteket, til automatisering af kald Påbegynd DD ekspedition for alle dispenseringskort i en pakkegruppe, eller til polling fra pakkeapoteket for at afgøre om hele pakkegruppen er klar til pakning.
+Denne service kan kaldes med VOCES / FOCES certifikat. Det kan blandt andet anvendes af udleveringsapoteket, til automatisering af kald Påbegynd DD ekspedition for alle dispenseringskort i en pakkegruppe, eller til poll-ing fra pakkeapoteket for at afgøre om hele pakkegruppen er klar til pakning.
-===== Forespørgsler til servicen =====
+===== Forespørgsel =====
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupRequestType|Request]]
-Der er 3 primære inputs til servicen:
+I forspørgsel til service angives følgende elementer:
   * ''PackingGroupIdentifier'': Identifier på pakkegruppen
-  * ''IncludeContents'': Element, som markerer, at et overblik af tilknyttede dispenseringskort ønskes.
+  * Optionelt: ''IncludeContents'' element, som markerer at et overblik af tilknyttede dispenseringskort ønskes.
-Der kan på ''IncludeContents'' optionelt angives et eller begge af følgende elementer:
+På ''IncludeContents'' elementet kan der gives et eller begge af følgende elementer:
   * ''IncludePatientDetails''-flag, hvis dispenseringskortene ønskes returneret sammen med patientdetaljer.
-  * ''IncludeStatus''-element kan angives, for at modtage overblik og evt status for alle de dispenseringskort //og dertil knyttede dispenseringsperioder//, der er knyttet til gruppen. Det er kun dispenseringskort med aktive dispenseringsperioder, som fremsøges, se nedenfor.
+  * ''IncludeStatus''-element kan angives, for at modtage overblik og evt status for alle de dispenseringskort //og dertil knyttede dispenseringsperioder//, der er knyttet til gruppen. Det er kun dispenseringskort med aktive dispenseringsperioder, som fremsøges hvis dette benyttes, se nedenfor.
 ''IncludeStatus'' kan indeholde op til 2 ''FilterDate''-elementer, som specificerer et tidsrum, hvor en aktiv periode på fremsøgte dispenseringskort skal have StartDate til at ligge imellem disse datoer. Angives der ikke nogen ''FilterDate''-elementer, vil FMK søge mellem "nu" og "14 dage frem".
 Angives 1 ''FilterDate'', vil FMK søge mellem "nu" og den angivne ''FilterDate''. Angives begge, fremsøger FMK perioder, hvor ''StartDate'' ligger imellem disse datoer.
+**Bemærk** Benyttes ''IncludeStatus'' ikke på ''IncludeContents'' vil man få et overblik over alle dispenseringskort i pakkegruppen, også dem uden nogen perioder. Hvorimod de frasorteres såfremt ''IncludeStatus'' benyttes.
 Her er et eksempel på et request, der blot henter overordnet information om pakkegruppen:
@@ Line 56: / Line 58: @@
-===== Svar fra servicen =====
+===== Svar =====
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupResponseType|Response]]
@@ Line 71: / Line 73: @@
-Hernæst kommer en liste af ''EntityWithDispensing'' elementer. Disse elementer indeholder følgende:
+Hernæst kommer en liste af ''EntityWithDispensing'' elementer. Disse hentes kun såfremt ''IncludeContents'' blev angives i forespørgslen, elementer indeholder følgende:
-  * Valget mellem ''PersonIdentifier'', ''Patient'' & ''Organisation''. Hvorvidt ''Patient'' eller ''PersonIdentifier'' returneres, afhænger af ''IncludePatientDetails''-flaget fra forespørgslen.
+  * Valget mellem ''PersonIdentifier'', ''Patient'' & ''Organisation''. **bemærk** Hvorvidt ''Patient'' eller ''PersonIdentifier'' returneres, afhænger af ''IncludePatientDetails''-flaget fra forespørgslen.
   * Optionelt en række ''PatientRegistration'' elementer. Såfremt der på patienten er registeret nogle af disse, og disse er aktive, vil de fremkomme her.
   * Optionelt en række ''DispensingCard''-elementer
-''DispensingCard'' elementet indeholder følgende informationer:
+''DispensingCard'' elementerne forekommer kun såfremt blev angivet i forespørgslen, elementerne indeholder følgende informationer:
   * ''Identifier'' ID på dispenseringskortet
   * ''Description'' Beskrivelse af kortet
   * ''PackingGroupIdentifier'', ''PackingGroupName'', ''OrderedAtPharmacy'' & ''PackedAtOrganisation''. Bemærk at ''DispensingOrganisation'' er inkluderet i skemaet, men det forventes ikke denne værdi vil kunne forekomme fra denne service.
-  * Optionelt en række ''DispensingPeriod'' elementer. Der vil fra denne service altid være mindst 1 periode.
+  * Optionelt en række ''DispensingPeriod'' elementer.
-''DispensingPeriod'' elementerne indeholder følgende:
+''DispensingPeriod'' elementerne forekommer kun såfremt ''IncludeStatus'' blev angivet på forespørgslen, gøres dette vil der altid være mindst 1 periode per ''DispenisngCard''. Elementerne indeholder følgende:
   * ''Identifier'', ID på perioden.