Hent dispenseringsperioder

Service til hentning af dispenseringsperioder for et givent dispenseringskort. Servicen henter seneste version af en række dispenseringsperioder for et givent dispenseringskort, kan også benyttes til at hente et overblik over historiske perioder.

Request

I forespørgslen skal der medsendes en PersonIdentifier på den patient, som skal have tilføjet et dosisdispenseringskort. Såfremt det pågældende dispenseringskort skal anvendes som dosisdispenseringskort til organisationer, skal dette angives i OrganisationIdentifier på den pågældende organisation.

Herefter angives et DispensingCardIdentifier element, som skal indeholder det unikke ID for et givent Dispenseringskort på patienten, som man ønsker at hente perioder fra.

IncludePeriodsSince elementet kan angives efterfølgende, såfremt man ønsker at udvide eller begrænse den mængde perioder som hentes. Servicen henter samtlige perioder på dispenseringskortet når Startdatoen for den givne periode ligger på eller efter datoen IncludePeriodsSince. Hvis ikke dette element sættes, anvendes dags dato som værdi.

GetDispensingPeriodsRequest.xml

<GetDispensingPeriodsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DispensingCardIdentifier>841315581</DispensingCardIdentifier>
    <IncludePeriodsSince>2023-01-01</IncludePeriodsSince>
</GetDispensingPeriodsRequest>

Response

Svaret fra FMK indeholder et EntityWithDispensing element. Dette element returneres i flere services og indeholder et generelt overblik over en given Person / Organisations dispenseringsperiode.

EntityWithDispensing elementet indeholder følgende elementer:

• En af: PersonIdentifier, Patient eller Organisation. PersonIdentifier og Patient såfremt der er tale om en person. Organisation såfremt dispenseringskortet er til en organisation.
• Optionelt: en række PatientRegistrations elementer, såfremt patienten har nogle relevante registreringer.
• Optionelt: en række DispensingCard elementer.

DispensingCard elementerne indeholder følgende:

• Identifier, det unikke ID for en given Dispenseringskort, dette skal stemmer overens med det ID, som blev angivet i forespørgslen.
• Description en beskrivelse af kortet, som defineret af kortets ejer (se beskrivelse herunder).
• Optionelt: en række DispensingPeriod elementer.

Kortets ejer defineres enten i kombinationen af følgende elementer fra apoteket: Optionelt PackingGroupIdentifier og PackingGroupName som kun sættes såfremt kortet er tilknyttet en pakkegruppe, herudover skal OrderedAtPharmacy og PackedAtOrganisation forekomme. Alternativet til dette er at DispensingOrganisation er anvendt af organisationen som foretager manuel ophældning

DispensingPeriod elementerne indeholder følgende:

• Identifier ID for den pågældende dispenseringsperiode
• Created modifikatoren som har oprettet denne periode.
• Optionelt: ReportedBy modifikator som har indberettet seneste ændring
• Optionelt: Modified modifikator som har foretaget seneste ændring
• StartDate Startdato for perioden
• EndDate Slutdato for perioden
• Optionelt: ExpectedDelivery, den forventede leveringstidspunkt for perioden
• Status status værdien for perioden
• Optionelt: ProductionIdentifier et produktionsid (stregkode) for perioden
• Optionelt: AcutePacking en akut-markering af perioden.

GetDispensingPeriodsResponse.xml

<GetDispensingPeriodsResponse>
    <EntityWithDispensing>
        <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
        <PatientRegistration>...</PatientRegistration>
        <DispensingCard>
            <Identifier>546213879</Identifier>
            <Description>Et dispenseringskort</Description>
            <PackingGroupIdentifier>35138135803</PackingGroupIdentifier>
            <PackingGroupName>Afhentes mandag eftermiddag, ulige uger</PackingGroupName>
            <OrderedAtPharmacy>
                <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                <Type>Apotek</Type>
                <Name>Aarhus Kobbergade Apotek</Name>
                <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                <TelephoneNumber>00000000</TelephoneNumber>
                <EmailAddress>ABC@XYZ.com</EmailAddress>
            </OrderedAtPharmacy>
            <PackedAtOrganisation>
                <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                <Type>Apotek</Type>
                <Name>Aarhus Kobbergade Apotek</Name>
                <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                <TelephoneNumber>00000000</TelephoneNumber>
                <EmailAddress>ABC@XYZ.com</EmailAddress>
            </PackedAtOrganisation>
            <DispensingPeriod>
                <Identifier>213546879</Identifier>
                <Created>
                    <By>
                        <HealthcareProfessional>
                            <Indentifier source="CPR">2012850101</Indentifier>
                            <Name>Hanne Jensen</Name>
                        </HealthcareProfessional>
                        <Role>Apoteksansat</Role>
                        <Organisation>
                            <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                            <Type>Apotek</Type>
                            <Name>Aarhus Kobbergade Apotek</Name>
                            <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                            <TelephoneNumber>00000000</TelephoneNumber>
                            <EmailAddress>ABC@XYZ.com</EmailAddress>
                        </Organisation>
                    </By>
                    <DateTime>2025-04-24T17:01:09Z</DateTime>
                </Created>
                <Modified>
                    <By>
                        <HealthcareProfessional>
                            <Indentifier source="CPR">2012850101</Indentifier>
                            <Name>Hanne Jensen</Name>
                        </HealthcareProfessional>
                        <Role>Apoteksansat</Role>
                        <Organisation>
                            <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                            <Type>Apotek</Type>
                            <Name>Aarhus Kobbergade Apotek</Name>
                            <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                            <TelephoneNumber>00000000</TelephoneNumber>
                            <EmailAddress>ABC@XYZ.com</EmailAddress>
                        </Organisation>
                    </By>
                    <DateTime>2025-04-30T12:05:42Z</DateTime>
                </Modified>
                <StartDate>2025-05-01</StartDate>
                <EndDate>2025-05-14</EndDate>
                <ExpectedDelivery>2025-04-29T12:00:00Z</ExpectedDelivery>
                <Status>Planlagt</Status>
                <ProductionIdentifier>987456321</ProductionIdentifier>
            </DispensingPeriod>
            <DispensingPeriod>...</DispensingPeriod>
            <DispensingPeriod>...</DispensingPeriod>
        </DispensingCard>
    </EntityWithDispensing>
</GetDispensingPeriodsResponse>