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

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

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodsRequestType|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.


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

===== Svar =====
[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodsResponseType|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.


<file xml 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>
</file>