User Tools

Site Tools


fmk:1.6.0:services:hent_pakkegruppe

This is an old revision of the document!


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

Forespørgsler til servicen

Request

Der er 3 primære inputs til servicen:

  • PackingGroupIdentifier: Identifier på pakkegruppen
  • IncludeContents: Element, som markerer, at et overblik af tilknyttede dispenseringskort ønskes.

Der kan på IncludeContents optionelt angives 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 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.

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 fra servicen

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 elementer indeholder følgende:

  • Valget mellem PersonIdentifier, Patient & Organisation. 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:

  • 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.

DispensingPeriod 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.1761817180.txt.gz · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki