====== Påbegynd ekspedition af dosisdispenseringsperiode ======

Servicen svarer til [[fmk:1.4.6:Påbegynd ekspedition]] men i forbindelse med DD ekspedition påbegyndes ekspedition samlet for alt indholdet i en eller flere dosisdispenseringsperioder. 

Servicen anvendes typisk af udleveringsapoteket ved tidsfrist for ændringer for dosisdispenseringsperioden. Kaldet anvendes i de første trin i det normale flow for en [[dosisdispenseringsperiode]].

Det bevirker at perioden enten får status 'Apoteksbehandling påbegyndt' eller 'Klar til pakning'. Desuden fastholdes indholdet af dosisdispenseringskortet, således at ændringer til den dosisdispenserede medicin, der sker efter dette tidspunkt ikke kommer til at påvirke dosispakningen for denne periode. 

**Bemærk:** Når denne service benyttes til at ændre en periodes status fra planlagt, vil dette medfører at tidsfrist for ændringer på perioden ændres til kalds-tidspunktet.

I lighed med [[fmk:1.4.6:Påbegynd ekspedition - Automatiseret]] kan denne service også kaldes med VOCES / FOCES certifikat, så det er muligt at kalde servicen automatiseret.

==== Næstkommende periode ====
Hvis der ikke allerede findes en periode efter den periode der påbegyndes, oprettes denne automatisk. Det sker for at eksempelvis lægen altid kan se hvornår den næste tidsfrist for ændringer er. Perioden oprettes med alle datoer forskudt med det antal dage, der er angivet i dosiskortets ''NormalPeriodDuration''.

**Bemærk**: Gælder også for akutte periode, undtagen de akutte perioder af typen "Akut supplerende pakning for tilføjet medicinering"

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

I modsætning til [[fmk:1.4.6:Påbegynd ekspedition]] medsendes ikke referencer til de enkelte recepter, der påbegyndes, men i stedet en reference til en eller flere dosisdispenseringsperioder for en patient.

Det er heller ikke relevant at medsende angivelse af udleveringsapoteket, da det fremgår af det dosisdispenseringskort, som perioden tilhører.

Desuden medsendes den ønskede status. Her kan kun angives enten "Apoteksbehandling påbegyndt" eller "Klar til pakning".

Apoteket skal i kaldet sætte status til "Apoteksbehandling påbegyndt" hvis de ønsker mulighed for at ændre i de planlagte administrationer for perioden inden de sender den videre til pakkeapoteket. Men hvis de ønsker (så vidt muligt) at sende den direkte til pakning vælger de i stedet "Klar til pakning".

<code xml StartEffectuationOfDoseDispensingPeriodRequest-dosisdispensing.xml> 
<StartEffectuationOfDoseDispensingPeriodRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <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>
    </ModifiedBy>
    <StartEffectuationOfDoseDispensingPeriod>
        <DoseDispensingPeriodIdentifier>234523435235</DoseDispensingPeriodIdentifier>
        <RequestedStatus>Klar til pakning</RequestedStatus>
    </StartEffectuationOfDoseDispensingPeriod>
    <StartEffectuationOfDoseDispensingPeriod>
        <DoseDispensingPeriodIdentifier>125687346634</DoseDispensingPeriodIdentifier>
        <RequestedStatus>Klar til pakning</RequestedStatus>
    </StartEffectuationOfDoseDispensingPeriod>
</StartEffectuationOfDoseDispensingPeriodRequest>
</code>

=== Preflight ===

Servicen tilbyder at køre i en særlig "preflight" tilstand. I denne tilstand vil alle normale checks og valideringer blive udført, men ekspeditionen vil ikke blive påbegyndt selvom der ikke konstateres fejl.

Denne tilstand kan benyttes af apoteket til at kontrollere om det ville være muligt at sætte perioden klar til pakning, uden rent faktisk at gøre det. Kaldet kan foretages med et systemcertifikat og kan derfor benyttes både af brugere og af apotekssystemet til løbende at identificere problemstillinger der skal følges op på, i stedet for at dette arbejde først kan ske når periodens tidsfrist for ændringer er indtruffet.

Preflight tilstand slås til ved at tilføje <IsPreflight/> til requestet, som vist i følgende eksempel:

<code xml StartEffectuationOfDoseDispensingPeriodRequest-dosisdispensing.xml> 
<StartEffectuationOfDoseDispensingPeriodRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <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>
    </ModifiedBy>
    <IsPreflight/>
    <StartEffectuationOfDoseDispensingPeriod>
        <DoseDispensingPeriodIdentifier>234523435235</DoseDispensingPeriodIdentifier>
        <RequestedStatus>Klar til pakning</RequestedStatus>
    </StartEffectuationOfDoseDispensingPeriod>
</StartEffectuationOfDoseDispensingPeriodRequest>
</code>


==== Svar ====

Svaret fra FMK indeholder det medsendte CPR-nummer. Desuden returneres ID for de opdaterede dosisdispenseringsperioder og den status, som perioderne reelt har fået. Denne kan afvige fra den ønskede status, hvis apoteket har ønsket "Klar til pakning", men der er ordinationer og planlagte administrationer, der gør at perioden ikke er klar til pakning.

Der returneres endvidere en id-liste over de planlagte dispenseringer (PlannedDispensings) der er omfattet af perioden. PlannedDispensings udpeger lægemiddelordinationer og dermed hvilke recepter der skal påbegyndes.

Hvis den returnerede status afviger fra den ønskede status vil årsagen fremgå af Warnings der sendes retur, på samme måde som ved [[Hent dosisdispenseringskort]]. Der returneres generelle warnings på yderste niveau samt warnings på individuelle PlannedDispensing identifiers såfremt der er noget der gør at det pågældende lægemiddel ikke er klar til pakning. Eksempelvis hvis lægen har foretaget ændringer i lægemiddelordinationen, som apoteket mangler at tage højde for.

Bemærk: Hvis der returneres en fejl på en enkelt planlagt dispensering, så er reglen at ingen af periodens planlagte dispenseringer (og tilhørende recepter) er påbegyndt. Endvidere vil det samme gælde hvis servicen er kørt i "preflight" tilstand.

I eksemplet nedenfor er der vist warnings på begge niveauer, men typisk vil der enten være overordnede warnings eller individuelle warnings.

<code xml StartEffectuationOfDoseDispensingPeriodResponse.xml>
<StartEffectuationOfDoseDispensingPeriodResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <StartedEffectuationOfDoseDispensingPeriod>
        <DoseDispensingPeriodIdentifier>234241231</DoseDispensingPeriodIdentifier>
        <DoseDispensingPeriodStatus>Ekspedition påbegyndt</DoseDispensingPeriodStatus>
        <PlannedDispensing>
             <Identifier>2387942346283746</Identifier>
        </PlannedDispensing>
        <PlannedDispensing>
             <Identifier>2387942346283746</Identifier>
             <Warning>
                  <WarningCode>4202</WarningCode>
                  <WarningText>Lægemiddelordinationen er opdateret efter tilknytningen til dosisdispenseringskortet</WarningText>
                  <Severity>high</Severity>
             </Warning>
        </PlannedDispensing>
        <Warning>
            <WarningCode>5003</WarningCode>
            <WarningText>Der findes dosisdispenserede recepter, der ikke er på dosisdispenseringskortet</WarningText>
            <Severity>medium</Severity>
        </Warning>
    </StartedEffectuationOfDoseDispensingPeriod>
</StartEffectuationOfDoseDispensingPeriodResponse>
</code>

Bemærk: Hvis dosisdispensering er sat i bero svarer servicen med et response som vist herunder. Periodens status sættes samtidigt til "ekspederes ikke".

<code xml StartEffectuationOfDoseDispensingPeriodResponse.xml>
<StartEffectuationOfDoseDispensingPeriodResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <StartedEffectuationOfDoseDispensingPeriod>
        <DoseDispensingPeriodIdentifier>234241231</DoseDispensingPeriodIdentifier>
        <DoseDispensingPeriodStatus>Ekspederes ikke</DoseDispensingPeriodStatus>
        <Warning>
            <WarningCode>4503</WarningCode>
            <WarningText>Effektuering af periode ikke mulig da patientens dosisdispensering er sat i bero</WarningText>
            <Severity>medium</Severity>
        </Warning>
    </StartedEffectuationOfDoseDispensingPeriod>
</StartEffectuationOfDoseDispensingPeriodResponse>
</code>

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