Service benyttes ved påbegyndelse af apoteks workflow for at få pakket og udleveret en dispenseringsperiode til patienten.

I 1.6.0 ændres funktionaliteten i denne service markant, for det første for at kunne understøtte de ændringer som sker i forbindelse med generaliseringen af planlagt administration & dosisdispensering. Dette kræver bl.a. at substitutioner for den periode der er begyndt, angives i denne forespørgsel, med mulighed for at vælge, at FMK skal genbruge tidligere periodes substitutioner.

Servicen forventes i 1.6.0 kun at kunne flytte en periode til “Klar til pakning”. Dette betyder bl.a. at det bliver et krav fra FMK's side, at alle data er “klar” inden en periode vil kunne startes. Der foretages ikke en låsning af ændringer fra lægen, før perioden er skiftet til “Klar til pakning”.

Request

I forespørgsel skal der sendes en PersonIdentifier med 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 OrganiastionIdentifier på den pågældende organisation.

I elementet ModifiedBy sendes information omkring organisationen med(udleverings eller pakkeapoteket), og brugeren som har foretaget opdateringen, Modifikator. Er elementet oprettet af en anden aktør end personen, der foretager kaldet mod FMK sendes både et ReportedBy-element, og ModifiedBy med. Se evt. Aktører på FMK.

Herefter kan elementet Preflight angives. Preflight anvendes, når en opdatering ikke skal finde sted, men man ønsker indsigt i, om en opdatering vil kunne accepteres, eller om der er ændringer, som kræver handling, inden en opdatering kan godkendes.

Herefter kan en række StartEffectuationOfDispensingPeriod elementer angives. Dette element indeholder en del information omkring de perioder, som apoteker ønsker at påbegynde en udlevering af. Elementet indeholde følgende:

• DispensingPeriodIdentifier ID'et på den dispenseringsperiode som ønskes påbegyndt håndtering af.
• DispensingPeriodVersion Versions-nummeret på den nuværende version af dispenseringsperiode.
• En af følgende 2 muligheder
• Optionelt: UseDraftSubstitutions element som ved sin angivelse signalere overfor FMK at man ønsker at benytte substitutionskladderne for alle planlagte administrationer.
• Optionelt: en række PlannedAdministrationSubstitutions elementer, som angiver en eksplicit Substitution for en given planlagt administration (angivet med PlannedAdministrationIdentifier) i denne periode.

Til sidste forespørgslen kan et CreateNextPeriod element angives, denne skal indeholde StartDate og EndDate og optionelt en ExpectedDelivery. Angivelsen af CreateNextPeriod erstatter funktionaliteten i FMK 1.4.6, hvor FMK automatisk oprettede næste periode, såfremt den ikke allerede eksisterede. Det er op til det enkelte system, om man ønsker at anvende denne funktionalitet.

StartHandlingOfDispensingPeriodRequest.xml

<StartHandlingOfDispensingPeriodRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <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>
    </ModifiedBy>
    <IsPreflight/>
    <StartHandlingOfDispensingPeriod>
        <DispensingPeriodIdentifier>325698741</DispensingPeriodIdentifier>
        <DispensingPeriodVersion>33213581313</DispensingPeriodVersion>
        <UsePreviousPeriodSubstitutions/>
        <PlannedAdministrationSubstitutions>
            <PlannedAdministrationIdentifier>357896512</PlannedAdministrationIdentifier>
            <Substitution>
                <Identifier source="Medicinpriser" sourceDate="2025-05-05">28100636073</Identifier>
                <Name>Panodil</Name>
                <ATC>
                    <Code source="Medicinpriser" sourceDate="2025-05-05">N02BE01</Code>
                    <Text></Text>
                </ATC>
                <Form>
                    <Code source="Medicinpriser" sourceDate="2025-05-05">TABFILM</Code>
                    <Text>filmovertrukne tabletter</Text>
                </Form>
                <Strength>
                    <Value>500.000</Value>
                    <UnitCode source="Medicinpriser" sourceDate="2025-05-05">MG</UnitCode>
                    <UnitText>500 mg</UnitText>
                </Strength>
            </Substitution>
        </PlannedAdministrationSubstitutions>
    </StartHandlingOfDispensingPeriod>
</StartHandlingOfDispensingPeriodRequest>

Response

Svaret fra FMK indeholder det medsendte PersonIdentifier eller OrganisationIdentifier. Herudover en der en række oplysninger omkring de perioder, som blev angivet i forespørgslen i en række StartedHandlingOfDispensingPeriod elementer, en for hver dispenseringsperiode.

StartedHandlingOfDispensingPeriodelementet indeholder følgende:

• DispensingPeriodIdentifier ID på den pågældende dispenseringsperiode.
• DispensingPeriodVersion det nye versionsnummer
• DispensingPeriodStatus Den resulterende status for periode, bemærk denne kan være uændret fra de man kaldte perioden.
• Optionelt: en række Warning elementer, disse advarsler er relateret til perioden eller patienten i sin helhed.
• Optionelt: en række Dispensing elementer. Her er en for hver planlagt administration som er involveret (skal dispenseres) i perioden. Hvis der ikke findes nogen planlagte administration som er aktive i perioden, er rækken tom.

Dispensing elementerne indeholder følgende:

• PlannedAdministration element, indeholder Identifier og Version på den planlagte administration, optionelt kan der også findes en række Warning elementer, disse er relateret til den planlagte administraiton.
• Optionelt: DispensingIdentifier Unikt ID for dispenseringen af den planlagte administration i den pågældende periode. Bemærk at dette felt mangler såfremt perioden ikke kunne sættes “Klar til pakning”.
• Optionelt: en række Warning elementer. Disse advarsler relateres den den enkelte dispensering, disse advarsler kan forekomme uden DispensingIdentifier forekommer.

Bemærk Warning elementerne er i 1.6.0 udvidet med et Blocking element, som ved sin angivelse signalerer, at den pågældende advarsel har været blokerende for opdateringen. Dette er specielt relevant for denne service, da det vil være her, at apoteket skal have fokus, hvis de vil have perioden sat “Klar til pakning”.

StartHandlingOfDispensingPeriodResponse.xml

<StartHandlingOfDispensingPeriodResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <StartedHandlingOfDispensingPeriod>
        <DispensingPeriodIdentifier>357852159</DispensingPeriodIdentifier>
        <DispensingPeriodVersion>32135813030</DispensingPeriodVersion>
        <DispensingPeriodStatus>Klar til pakning</DispensingPeriodStatus>
        <Warning>
            <WarningCode>2120</WarningCode>
            <WarningText>Patient har aktivt dispenseringskort ved andre organisationer</WarningText>
            <Severity>medium</Severity>
        </Warning>
        <Dispensing>
            <PlannedAdministration>
                <Identifier>2345687</Identifier>
                <Version>258963147</Version>
                <Warning>
                    <WarningCode>2511</WarningCode>
                    <WarningText>Lægemidlet er pauseret</WarningText>
                    <Severity>low</Severity>
                </Warning>
            </PlannedAdministration>
            <DispensingIdentifier>456123789</DispensingIdentifier>
            <Warining>
                <WarningCode>4132</WarningCode>
                <WarningText>Substitutionen er ikke valideret, da det ordinerede lægemiddel er udgået</WarningText>
                <Severity>low</Severity>
            </Warining>
        </Dispensing>
        <Dispensing>...</Dispensing>
        <Dispensing>...</Dispensing>
        <Dispensing>...</Dispensing>
        <Dispensing>...</Dispensing>
    </StartedEffectuationOfDispensingPeriod>
</StartHandlingOfDispensingPeriodResponse>