====== Hent pakkegruppe ======


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 poll-ing fra pakkeapoteket for at afgøre om hele pakkegruppen er klar til pakning.


===== Forespørgsel =====


[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupRequestType|Request]]

I forspørgsel til service angives følgende elementer:
  * ''PackingGroupIdentifier'': Identifier på pakkegruppen
  * Optionelt: ''IncludeContents'' element, som markerer at et overblik af tilknyttede dispenseringskort ønskes. 

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 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:

<file xml BasicGetPackingGroupRequest.xml>
<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 GetPackingGroupRequest.xml>
<GetPackingGroupRequest>
    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
    <IncludeContents/>
</GetPackingGroupRequest>
</file>

Dette er et eksempel på et request, der henter en opsummeringer af dosiskort der er tilknyttet til en pakkegruppe. Der fremsøges dosiskort, hvor en dispenseringsperiode starter mellem "nu" og 30. september 2026.

<file xml GetPackingGroupRequest2.xml>
<GetPackingGroupRequest>
    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
    <IncludeContents>
        <IncludeStatus>
            <FilterDate>2026-09-30T00:00:00</FilterDate>
        </IncludeStatus>
    </IncludeContents>
</GetPackingGroupRequest>
</file>


===== Svar =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPackingGroupResponseType|Response]]

Svaret fra servicen indeholder først et ''PackingGroup''-element med følgende detaljer om pakkegruppen:
  * ''Identifier'', ID på pakkegruppen
  * ''Version'', pakkegruppens versionsnummer
  * ''Created'', modifikator på personen som oprettede pakkegruppen
  * Optionelt ''ReportedBy'', modifikator som indrapportede pakkegruppen til FMK
  * Optionelt ''Modified'', modifikator på personen som senest ændrede pakkegruppen
  * ''Name'', navnet på pakkegruppen
  * ''OrderedAtPharmacy'', udleveringsapoteket, som pakkegruppen er tilknyttet
  * ''PackedAtOrganisation'', pakkeapoteket, som pakkegruppen er tilknyttet


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''. **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'' 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.

''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.
  * ''Version'', versionsnummer for perioden
  * ''Created'', Modifikatoren på person som oprettede perioden.
  * 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
  * ''StartDate'', periodens startdato
  * ''EndDate'', periodens slutdato
  * Optionelt ''ExpectedDelivery'', timestamp på hvornår perioden forventes leveret.
  * ''Status'' den nuværende status for perioden.
  * Optionelt ''ProductionIdentifier'', stregkoden for den pågældende periode.
  * Optionelt ''AcutePacking'', akut status for perioden

=== Eksempel ===

Nedenstående eksempel svarer til det tredje eksempel på request. I.e. der hentes ikke patientdetaljer, men til gengæld hentes der overblik over perioder via ''IncludeStatus''. 

<file xml GetPackingGroupResponse.xml>
<GetPackingGroupResponse>
    <PackingGroup>
        <Identifier>24646345634</Identifier>
        <Version>323423424908</Version>
        <Created>
            <By>
                <HealthcareProfessional>
                    <Identifier source="CPR">1212121234</Identifier>
                    <Name>Anne Jørgensen</Name>
                </HealthcareProfessional>
                <Role>Apoteksansat</Role>
                <Organisation>
                    <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
                    <Type>Apotek</Type>
                    <Name>Århus Jernbane Apotek</Name>
                    <AddressLine>Banegårdsplads 8</AddressLine>
                    <AddressLine>8000 Århus</AddressLine>
                </Organisation>
            </By>
            <DateTime>2025-08-16T10:34:08</DateTime>
        </Created>
        <Name>Jernbanens pakkegruppe</Name>
        <OrderedAtPharmacy>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
            <Type>Apotek</Type>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
        </OrderedAtPharmacy>
        <PackedAtOrganisation>
            <Identifier source="EAN-Lokationsnummer">5790000173525</Identifier>
            <Type>Apotek</Type>
            <Name>Århus Stjerne Apotek</Name>
            <AddressLine>Funch Thomsensgade 3</AddressLine>
            <AddressLine>8200 Århus N</AddressLine>
        </PackedAtOrganisation>
    </PackingGroup>
    <EntityWithDispensing>
        <PersonIdentifier>1231231238</PersonIdentifier>
        <DispensingCard>
            <Identifier>21312312309179</Identifier>
            <Description>Dosisdispenseret medicin</Description>
            <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
            <PackingGroupName>Jernbanens pakkegruppe</PackingGroupName>
            <OrderedAtPharmacy>
               ...
            </OrderedAtPharmacy>
            <PackedAtOrganisation>
               ...
            </PackedAtOrganisation>
            <DispensingPeriod>
                <Identifier>98989893421</Identifier>
                <Version>9891342898234</Version>
                <Created>
                    <By>
                        <HealthcareProfessional>
                            <Identifier source="CPR">1212121234</Identifier>
                            <Name>Anne Jørgensen</Name>
                        </HealthcareProfessional>
                        <Role>Apoteksansat</Role>
                        ...
                   </By>
                   <DateTime>2026-09-02T10:34:08</DateTime>
                </Created>
                <StartDate>2026-09-25</StartDate>
                <EndDate>2026-10-15</EndDate>
                <Status>Pakning afsluttet</Status>
            </DispensingPeriod>
        </DispensingCard>
    </EntityWithDispensing>
    <EntityWithDispensing>...</EntityWithDispensing>
    <EntityWithDispensing>...</EntityWithDispensing>
</GetPackingGroupResponse>
</file>