====== Opret dispenseringsperiode ======
Oprettelse af en dispenseringsperiode for et givent dispenseringskort. En dispenseringsperiode angiver et interval hvor en mængde planlagte administrationer vil blive dispenseret.

Oprettelse af dispenseringsperiode seperat fra dispenseringen foregår i FMK kun for dosisdispensering, dvs denne service forventes kun anvendt af apotekersystemerne til at vedligeholde og planlægge dosisdispensering af en patients medicin. For hjemmeplejen o.lign organisationer, som foretager ophældning af medicinen hjemme ved borgeren, anvendes [[fmk:1.6.0:services:registrer_ophældning | Registrer ophældning]]. 

Dette betyder også at dispenseringsperioderne altid skal tilknyttes til et [[fmk:1.6.0:xml-elementer:dispenseringskort | dispenseringskort]] ved deres oprettelse.

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

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

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

I elementet ''CreatedBy'' medsendes information omkring organisationen (udleverings eller pakkeapoteket) og brugeren som har foretaget oprettelsen, Modifikator. Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK medsendes både et ''ReportedBy''-element, og ''CreatedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]. 

I et ''DispensingPeriod'' element medsendes detaljer omkring den dispenseringsperiode, i hvert request kan der angives flere ''DispensingPeriod'', såfremt man ønsker at oprette flere på en gang. Elementet indeholder følgende:
  * ''DispensingCardIdentifier'', ID på det dispenseringskort som den planlagte administration skal tilknyttes. Angives denne ikke bliver administration kun tilknyttet ordinationen.
  * ''StartDate'', element som indholder startdato for perioden.
  * ''EndDate'', element som indeholder slutdato for perioden.
  * Optionelt: ''ExpectedDelivery'', element som indeholder den forventede leveringstidspunkt for perioden
  * Optionelt: ''ProductionIdentifier'', element som indeholder et produktions-nummer (stregkode) for perioden
  * Optionelt: ''AcutePacking'', element som indeholder en markering af at perioden anses som værende akut, og en årsag hertil.

<file xml CreateDispensingPeriodRequest.xml>
<CreateDispensingPeriodRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <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>
    </CreatedBy>
    <DispensingPeriod>
        <DispensingCardIdentifier>4684681358</DispensingCardIdentifier>
        <StartDate>2025-04-29</StartDate>
        <EndDate>2025-05-12</EndDate>
        <ExpectedDelivery>2025-04-26T12:00:00Z</ExpectedDelivery>
    </DispensingPeriod>
    <DispensingPeriod>
        <DispensingCardIdentifier>4684681358</DispensingCardIdentifier>
        <StartDate>2025-05-06</StartDate>
        <EndDate>2025-05-20</EndDate>
        <ExpectedDelivery>2025-04-26T12:00:00Z</ExpectedDelivery>
        <AcutePacking>Akut supplerende pakning for tilføjet medicinering</AcutePacking>
    </DispensingPeriod>
</CreateDispensingPeriodRequest>
</file>

===== Svar =====

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

Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''. Desuden returneres et eller flere ''DispensingPeriodIdentifier'' elementer som indeholder ''Identifier'' på de oprettede perioder. Såfremt man har valgte at oprette mere end en periode i samme request, svarer ''DispensingPeriodIdentifier'' elementerne i svaret til den rækkefølge som perioderne blev angivet i forespørgslen.

<file xml CreateDispensingPeriodResponse.xml>
<CreateDispensingPeriodResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DispensingPeriodIdentifier>32184361438</DispensingPeriodIdentifier>
    <DispensingPeriodIdentifier>33513818354</DispensingPeriodIdentifier>
</CreateDispensingPeriodResponse>
</file>