====== Opret planlagt dispensering ======

Denne service anvendes blandt primært af udleveringsapoteket i forbindelse med dosisdispensering til at definere en planlagt administration for et lægemiddel samt at angive evt. substituion.


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

I request-dokumentet skal der medsendes et [[fmk:1.4.4:cpr-nummer|CPR-nummmer]] på den patient som kaldet vedrører.

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

Oplysninger om selve dispensering sendes i elementet PlannedDispensing.
Denne består af 4 overordnede informationer:
  * Identifikation af det dosisdispenseringskort, dispenseringen skal tilknyttes 
  * Identifikation af lægemiddelordinationen, der skal dispenseres.
  * Angivelse af om, og i givet fald til hvilket lægemiddel, der substitueres.
  * Detaljer om den planlagte administration (inklusiv eventuel indtagelsesvejledning)

Det er muligt at angive flere PlannedDispensing elementer i samme kald. Dels for at oprette dispensering af flere lægemiddelordinationer ad gangen, men også hvis den samme lægemiddelordination skal 'fordeles' over flere dosisdispenseringskort. 

**Bemærk:** Det er ikke muligt at oprette en planlagt dispensering på en lægemiddelordinationen hvor lægemidlet ikke har et drugId, dvs fx ordinationer med ''DetailedDrugText''. Dette er af hensyn til at lægemidlet altid skal unikt kunne identificeres for at det skulle kunne dosisdispenseres. Det samme gælder for en eventuel substitution, disse skal også angives ved et DrugId.

<file xml CreatePlannedDispensingRequest.xml>
<CreatePlannedDispensingRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
            <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
        </Organisation>
    </CreatedBy>
    <PlannedDispensing>
        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
        <DrugMedication>
            <Identifier>1280998</Identifier>
            <Version>1341404071666006001</Version>
        </DrugMedication>
        <Substitution>
            <SubstitutionChosenByPatient/>
            <Drug>
                <Identifier source="Medicinpriser" date="2016-02-22">28100902676</Identifier>
                <Name>Kaleorid</Name>
                <Form>
                    <Code source="Medicinpriser" date="2016-02-22">TAB</Code>
                    <Text>tabletter</Text>
                </Form>
                <Strength>
                    <Value>750</Value>
                    <UnitCode source="Medicinpriser" date="2016-02-22">MG</UnitCode>
                    <UnitText>mg</UnitText>
                    <Text source="Medicinpriser" date="2016-02-22">750 mg</Text>
                </Strength>
            </Drug>
        </Substitution>
        <AdministrationInstruction>Synkes hele</AdministrationInstruction>
        <PlannedAdministration>
            <UnitTexts>
                <Singular>tablet</Singular>
                <Plural>tabletter</Plural>
            </UnitTexts>
            <PlannedAdministrationFixed>
                <PlannedAdministrationStructure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2017-12-12</StartDate>
                    <EndDate>2018-12-12</EndDate>
                    <Day>
                        <Number>1</Number>
                        <Dose>
                            <Time>morning</Time>
                            <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>noon</Time>
                           <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>evening</Time>
                           <Quantity>1</Quantity>
                        </Dose>
                    </Day>
                </PlannedAdministrationStructure>
            </PlannedAdministrationFixed>    
        </PlannedAdministration>
    </PlannedDispensing>
</CreatePlannedDispensingRequest>
</file>

=== Sekvens nummer ====

Det er muligt for apoteket, meget detaljeret at styre fordelingen i og sorteringen af poser på dosisrullen ved på den enkelte dosering at angive et sekvensnummer. Sker det ikke danner FMK en [[fmk:extensions:planlagt administration#default|default fordeling og sortering]]
 baseret på tidspunkter og AdministrationInstruction.

Nedenstående er et eksempel på oprettelse af to planlagte dispenseringer, med angivelse af SequenseNumber, der sikrer at 'middag' kommer før kl. 11.30. 


<file xml CreatePlannedDispensingWithSequenceRequest.xml>
<CreatePlannedDispensingRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
            <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
        </Organisation>
    </CreatedBy>
    <PlannedDispensing>
        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
        <DrugMedication>
            <Identifier>1280998</Identifier>
            <Version>1341404071666006001</Version>
        </DrugMedication>
        <PlannedAdministration>
            <UnitTexts>
                <Singular>tablet</Singular>
                <Plural>tabletter</Plural>
            </UnitTexts>
            <PlannedAdministrationFixed>
                <PlannedAdministrationStructure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2017-12-12</StartDate>
                    <EndDate>2018-12-12</EndDate>
                    <Day>
                        <Number>1</Number>
                        <Dose>
                           <Time>noon</Time>
                           <SequenceNumber>110000</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>evening</Time>
                           <SequenceNumber>180000</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                    </Day>
                </PlannedAdministrationStructure>
            </PlannedAdministrationFixed>    
        </PlannedAdministration>
    </PlannedDispensing>
    <PlannedDispensing>
        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
        <DrugMedication>
            <Identifier>23241143</Identifier>
            <Version>2321212312311006003</Version>
        </DrugMedication>
        <PlannedAdministration>
            <UnitTexts>
                <Singular>kapsel</Singular>
                <Plural>kapsler</Plural>
            </UnitTexts>
            <PlannedAdministrationFixed>
                <PlannedAdministrationStructure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2017-12-12</StartDate>
                    <EndDate>2018-12-12</EndDate>
                    <Day>
                        <Number>1</Number>
                        <Dose>
                           <Time>08:00:00</Time>
                           <SequenceNumber>80000</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>11:30:00</Time>
                           <SequenceNumber>113000</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                           <Time>17:30:00</Time>
                           <SequenceNumber>173000</SequenceNumber>
                           <Quantity>1</Quantity>
                        </Dose>
                    </Day>
                </PlannedAdministrationStructure>
            </PlannedAdministrationFixed>    
        </PlannedAdministration>
    </PlannedDispensing>
</CreatePlannedDispensingRequest>
</file>






=== Dispensering ifølge Lægemiddelordination ===

Hvis den strukturerede dosering på lægemiddelordinationen er på en form der umiddelbart kan anvendes til dispensering kan den detaljerede planlagte administration udelades og i stedet angives ''AdministrationAccordingToDrugMedication''.

Hvis der heller ikke skal ske substitution kan kaldet derfor være så simpelt:

<file xml CreateSimplePlannedDispensingRequest.xml>
<CreatePlannedDispensingRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
            <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
        </Organisation>
    </CreatedBy>
    <PlannedDispensing>
        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
        <DrugMedication>
            <Identifier>1280998</Identifier>
            <Version>1341404071666006001</Version>
        </DrugMedication>
        <AdministrationAccordingToDrugMedication/>
    </PlannedDispensing>
</CreatePlannedDispensingRequest>
</file>

===== Svar =====
I svaret returneres patientens CPR'nummer samt ID og version for de(t) oprettede dispensering(er). Hvis der oprettes flere i samme kald, returneres ID'erne i samme rækkefølge som de blev angivet i requestet.

<file xml CreatePlannedDispensingResponse.xml>

<CreatePlannedDispensingResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PlannedDispensing>
        <Identifier>234241231</Identifier>
        <Version>1341404079919003002</Version>
    </PlannedDispensing>
</CreatePlannedDispensingResponse>

</file>
                
Hvis der er valgt AdministrationAccordingToDrugmedication og lægemiddelordinationens dosering ikke er egnet til dosisdispensering, bliver den planlagte dispensering stadig oprettet, men uden planlagt administration og der returneres en advarsel. Eksempel:

<file xml CreatePlannedDispensingResponseWithWarning.xml>

<CreatePlannedDispensingResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PlannedDispensing>
        <Identifier>234241231</Identifier>
        <Version>1341404079919003002</Version>
        <Warning>
            <WarningCode>3122></WarningCode>
            <WarningText>Fritekstdosering er uegnet til dosisdispensering</WarningText>
            <Severity>medium</Severity>
        </Warning>    
    </PlannedDispensing>
</CreatePlannedDispensingResponse>

</file>

==== Advarsler ====
Se listen her:[[Advarsler til Dosisdispensering]]