Differences

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

--- fmk:1.6.0:services:hent_indhold_af_pakkegruppe [2025-10-09 12:33] – created lbdo
+++ fmk:1.6.0:services:hent_indhold_af_pakkegruppe [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-=== TODO: ===
+====== Hent indhold af pakkegruppe ======
- Denne servicebeskrivelse skal tilrettes, så den passer med 1.6.0. Det vil sige:
+Denne service fungerer på samme premise som [[fmk:1.6.0:services:hent_pakkegruppe | hent pakkegruppe]], og returnerer også samme type data. Dog er denne service tiltænkt en mere bred gennemgang af pakkegruppen, da der fx også er mulighed for at hente dispenseringskort uden perioder på.
-  * Specifikation af IncludeContents-flaget
+===== Request =====
-  * Eksempel på brug af IncludeContents-flaget
-  * Beskrivelse af PackingGroupDetails
-  * Eksempel på svar (her kan [[fmk:1.6.0:services:Hent akutte perioder]] nok bruges som inspiration, da begge dele benytter ''EntityWithDispensing''-elementet
-====== Hent pakkegruppe ======
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupContentsRequestType|Request]]
+I requesten angives en ''PackingGroupIdentifier'' dvs id for pakkegruppen. Derudover kan der optionelt tilføjes op til 2 ''FilterDate''-elementer og et ''IncludeCardsWithoutPeriod''-element.
-Denne service anvendes af apoteket til at hente en pakkegruppe samt evt. et overblik over de patienter, dosisdispenseringskort 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 dosisdispenseringskort i en pakkegruppe, eller til polling fra pakkeapoteket for at afgøre om hele pakkegruppen er klar til pakning.
-===== Forespørgsler til servicen =====
-Der er 3 primære inputs til servicen:
-  * ''PackingGroupIdentifier'': Identifier på pakkegruppen
-  * ''FilterDate'': Op til 2 af disse kan angives. Se beskrivelse herunder.
-  * ''IncludeContents'': Flag, som markerer, at opsummering af tilknyttede dispenseringskort ønskes
 ''FilterDate'' er valgfri at benytte, benyttes den ikke vil FMK bruge "nu" og "14 dage". ''FilterDate'' overtager for ''ProductionTime'' i 1.4.6, hvor ''ProductionTime'' skulle være en dato mellem ''Deadline'' og ''StartDate'' (Begge inklusive). Da ''Deadline'' udgår i 1.6.0, benyttes 1 eller 2 ''FilterDate'' til at vælge et tidsrum hvor StartDate skal ligge imellem disse datoer. Angives 1 ''FilterDate'' vil FMK søge mellem "nu" og den angivne ''FilterDate''. Angives begge søger FMK perioder hvor ''StartDate'' ligger imellem disse datoer.
-Her er et eksempel på et request, der blot henter overordnet information om pakkegruppen:
-<file xml BasicGetPackingGroupRequest.xml>
+''IncludeCardsWithoutPeriod'' elementet betyder, at FMK også skal returnere kort, som ikke har en periode i det angivne tidsrum.
-<GetPackingGroupRequest>
-    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
-</GetPackingGroupRequest>
-</file>
-Dette er et eksempel på et request, der henter en oversigt over hvilke dosiskort der er tilknyttet til en pakkegruppe.
-<file xml GetPackingGroupOverviewRequest.xml>
+<file xml GetPackingGroupContentsRequest.xml>
-<GetPackingGroupRequest>
+<GetPackingGroupContentsRequest>
-    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
+	<PackingGroupIdentifier>1607592088167001697</PackingGroupIdentifier>
-    <IncludeContents/>
+	<FilterDate>2026-06-10+01:00</FilterDate>
-</GetPackingGroupRequest>
+        <IncludeCardsWithoutPeriod/>
+</GetPackingGroupContentsRequest>
 </file>
 ===== Svar fra servicen =====
-Svaret fra servicen indeholder et ''PackingGroupDetails'' og en liste af ''EntityWithDispensing'' elementer. Disse elementer indeholder følgende:
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupContentsResponseType|Response]]
-  * Valget mellem ''PersonIdentifier'', ''Patient'' & ''Organisation''. Da det ikke er muligt at bede om patient detailjer i denne service, vil ''Patient'' ikke kunne forekomme. Men den ligger i skemaer da ''EntityWithDispensing'' typen genbruges i en række andre services.
+Som svar fra servicen får man samme type data som fra [[fmk:1.6.0:services:hent_pakkegruppe#svar|hent pakkegruppe]] servicen. Dvs en beskrivelse af pakkegruppen efterfuldte af en liste af personer som har kort knyttet til gruppen. ''EntityWithDispensing''-elementerne indeholder som udgangspunkt ''Patient'' frem for blot ''PersonIdentifier''.
-  * Optionelt en række ''PatientRegistration'' elementer. Såfremt der på patienten er registeret nogle af disse, og disse er aktive, vil de fremkomme her.
-  * ''DispensingCard'' element, som indeholder en række informationer.
-''DispensingCard'' elementet indeholder følgende informationer:
+<file xml GetPakingGroupContentsResponse.xml>
+<GetPackingGroupContentsResponse>
-  * ''Identifier'' ID på dispenseringskortet
+   <PackingGroup>
-  * ''Description'' Beskrivelse af kortet
+      <Identifier>1607592088167001697</Identifier>
-  * ''PackingGroupIdentifier'', ''PackingGroupName'', ''OrderedAtPharmacy'' & ''PackedAtOrganisation''. Bemærk igen at ''DispensingOrganisation'' er inkluderet i skemaet, men det forventes ikke denne værdi vil kunne forekomme fra denne service.
+      <Version>12341240983724234</Version>
-  * Optionelt en række ''DispensingPeriod'' elementer. Der vil fra denne service altid være mindst 1 periode.
+      <Created>
+         <By>
-''DispensingPeriod'' elementerne indeholder følgende:
+            <HealthcareProfessional>
+               <Identifier source="CPR">2002200909</Identifier>
-  * ''Identifier'' ID på perioden.
+               <Name>Pille P. Pillesen</Name>
-  * ''Created'' Modifikatoren på person som oprettede perioden.
+            </HealthcareProfessional>
-  * Optionelt ''ReportedBy'' & ''Modified'' modifikatorer på personen som indberettede og foretog den seneste ændring. ''Modified'' forekommer kun såfremt perioden har været ændret mindst 1 gang
+            <Role>Apoteksansat</Role>
-  * Optionelt ''ExpectedDelivery'' timestamp på hvornår perioden forventes leveret.
+            <Organisation>
-  * ''Status'' den nuværende status for perioden.
+               <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
-  * Optionelt ''ProductionIdentifier'' stregkoden for den pågældende periode.
+               <Type>Apotek</Type>
-  * Optionelt ''AcutePacking''
+               <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
+               <AddressLine>Drasbeksgade 16</AddressLine>
+               <AddressLine>8560 Kolind</AddressLine>
+               <TelephoneNumber>86392155</TelephoneNumber>
+            </Organisation>
+         </By>
+         <DateTime>2020-12-10T09:21:28Z</DateTime>
+      </Created>
+      <Name>Lorem ipsum nr: 0</Name>
+      <OrderedAtPharmacy>
+         <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
+         <Type>Apotek</Type>
+         <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
+         <AddressLine>Drasbeksgade 16</AddressLine>
+         <AddressLine>8560 Kolind</AddressLine>
+         <TelephoneNumber>86392155</TelephoneNumber>
+      </OrderedAtPharmacy>
+      <PackedAtOrganisation>
+         <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+         <Type>Apotek</Type>
+         <Name>Haderslev Løve Apotek</Name>
+         <AddressLine>Gravene 1</AddressLine>
+         <AddressLine>6100 Haderslev</AddressLine>
+         <TelephoneNumber>74522443</TelephoneNumber>
+      </PackedAtOrganisation>
+   </PackingGroup>
+   <EntityWithDispensing>
+      <Patient>
+         <Person>
+            <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+            <Name>
+               <GivenName>Helle</GivenName>
+               <Surname>Bonde</Surname>
+            </Name>
+            <BirthDate>1911-11-11</BirthDate>
+            <Gender>female</Gender>
+         </Person>
+         <AddressLine>Niels Bohrs Vej 322B</AddressLine>
+         <AddressLine>1473 København K</AddressLine>
+      </Patient>
+      <PatientRegistration>
+         <Created>
+            <By>
+               <HealthcareProfessional>
+                   <Identifier source="Autorisation">12345</Identifier>
+                   <Name>Pille P. Pillesen</Name>
+                </HealthcareProfessional>
+                <Organisation>
+                  <Identifier source="Yder">1884</Identifier>
+                  <Type>Yder</Type>
+                  <Name>Swoknnusk tandlæge klinik</Name>
+                  <AddressLine>Steinmannsgade 3311</AddressLine>
+                  <AddressLine>2610 Rødovre</AddressLine>
+                  <TelephoneNumber>12345678</TelephoneNumber>
+                </Organisation>
+            </By>
+            <DateTime>2020-12-10T09:21:28Z</DateTime>
+         </Created>
+         <Type>SetDoseDispensingOnHold</Type>
+      </PatientRegistration>
+      <DispensingCard>
+         <Identifier>1607592088167003697</Identifier>
+         <Description>Dosisdispensering af nyttig medicin til generel velvære</Description>
+         <PackingGroupIdentifier>1607592088167001697</PackingGroupIdentifier>
+         <PackingGroupName>Lorem ipsum nr: 0</PackingGroupName>
+         <OrderedAtPharmacy>
+            <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
+            <Type>Apotek</Type>
+            <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
+            <AddressLine>Drasbeksgade 16</AddressLine>
+            <AddressLine>8560 Kolind</AddressLine>
+            <TelephoneNumber>86392155</TelephoneNumber>
+         </OrderedAtPharmacy>
+         <PackedAtOrganisation>
+            <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+            <Type>Apotek</Type>
+            <Name>Haderslev Løve Apotek</Name>
+            <AddressLine>Gravene 1</AddressLine>
+            <AddressLine>6100 Haderslev</AddressLine>
+            <TelephoneNumber>74522443</TelephoneNumber>
+         </PackedAtOrganisation>
+         <DispensingPeriod>
+            <Identifier>1607592088167005697</Identifier>
+            <Version>16081340923840293842</Version>
+            <Created>
+               <By>
+                  <HealthcareProfessional>
+                      <Identifier source="CPR">2002200909</Identifier>
+                      <Name>Pille P. Pillesen</Name>
+                  </HealthcareProfessional>
+                  <Role>Apoteksansat</Role>
+                  <Organisation>
+                      <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
+                      <Type>Apotek</Type>
+                      <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
+                      <AddressLine>Drasbeksgade 16</AddressLine>
+                      <AddressLine>8560 Kolind</AddressLine>
+                      <TelephoneNumber>86392155</TelephoneNumber>
+                  </Organisation>
+               </By>
+               <DateTime>2020-12-10T09:21:28Z</DateTime>
+            </Created>
+            <StartDate>2020-12-10</StartDate>
+            <EndDate>2020-12-25</EndDate>
+            <ExpectedDelivery>2020-12-10T09:21:28Z</ExpectedDelivery>
+            <Status>Planlagt</Status>
+            <ProductionIdentifier>1234</ProductionIdentifier>
+         </DispensingPeriod>
+      </DispensingCard>
+   </EntityWithDispensing>
+</GetPackingGroupContentsResponse>
+</file>