User Tools

Site Tools


fmk:1.6.0:services:hent_pakkegruppe

Table of Contents

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

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.

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:

BasicGetPackingGroupRequest.xml
<GetPackingGroupRequest>
    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
</GetPackingGroupRequest>

Dette er et eksempel på et request, der henter en oversigt over hvilke dosiskort der er tilknyttet til en pakkegruppe.

GetPackingGroupRequest.xml
<GetPackingGroupRequest>
    <PackingGroupIdentifier>24646345634</PackingGroupIdentifier>
    <IncludeContents/>
</GetPackingGroupRequest>

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.

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

Svar

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.

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>
fmk/1.6.0/services/hent_pakkegruppe.txt · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki