Table of Contents

Opret effektuering på recept

Servicen anvendes i forbindelse med at at der foretages en ekspedition af en eksisterende recept + bestilling på apoteket.

Se evt. også også Effektuering og forskel til apotekssnitflade 1

Forudsætninger

Inden ekspeditionen påbegyndes skal apoteket tage en “lås” på recepten. Det gøres ved at kalde servicen Påbegynd ekspedition

Dette skal ske blandt andet for at sikre at den ikke er ekspederet af et andet apotek eller er annulleret af lægen og evt. erstattet af en anden recept.

Herefter er bestillingens status “Ekspedition påbegyndt”. Når bestillingen har fået denne status, vil det altid være tilladt efterfølgende at oprette en effektuering, uanset at lægen evt. i mellemtiden annullerer ordinationen.

Hvis en læge opdaterer eller seponerer på en dosisdispenseret lægemiddelordination og tilhørende recept bør lægen være informeret om at ændringen først slår igennem ved næste dosispakning. Sker opdateringen på en lægemiddelordination, hvor recepten udleveres som hele pakninger vil forsinkelsen være mindre, og dermed vil også sandsynligheden for at der er ændret samtidig med at lægemidlet udleveres være mindre.

Forespørgsel

I kaldet til FMK sendes først borgerens CPR-nummer. For personer uden CPR-nummer kan der anvendes en alternativ værdi, se Medicinkortets nøgle.

Aktør CreatedBy

I CreatedBy elementet angives den apoteksansatte samt apoteket, som opretter effektueringen.

Aktør ReportedBy

I ReportedBy elementet kan angives den apoteksansatte samt apoteket, som indsender effektueringen, såfremt dette er forskelligt fra CreatedBy. Det vil sige i de fleste tilfælde kan dette udelades.

DeliverySite

I DeliverySite elementet angives stedet hvor medicinen udleveres, eksempelvis, Skanderborg Apotek eller Ry apoteksudsalg. Elementet skal udfyldes med et gyldigt p-nummer (IdentifierSource CVR-P). Anden information i elementet kan risikere at blive overskrevet med aktuel data fra stamdata. Elementet skal altid udfyldes også selv om medicinen udleveres samme sted som bestillingen effektueres. Kun for effektueringer på udenlandske recepter kan den undlades. Udenlandske recepter kan kun oprettes med servicen 'opret og ekspeder recept'.

Lægemiddelordination, recept og bestilling

Ved oprettelse af en effektuering skal der angives hvilken recept og bestilling effektueringen oprettes på. I XML-strukturen angives dette via elementerne PrescriptionIdentifier og OrderIdentifier. Identifier-elementerne angiver ID for de elementer de er placeret under.

Effektuering

I samme kald kan der angives flere effektueringer på forskellige recept + bestillinger. Hvis en ekspedition på apoteket omfatter flere lægemidler bør de indrapporteres i ét samlet kald.

Data for selve effektueringen angives i Effectuation-elementet, ifht. den struktur der returneres indeholder et Effectuation element til oprettelse ikke elementerne:

I stedet for Created optræder et CreatedBy element, som identificerer hvem der har oprettet udleveringen samt et DateTime element som angiver apotekets tidsstempel for ekspeditionstidspunkt.

Angivelse af lægemiddel ved substitution

Ved effektuering kan der substitueres til et andet lægemiddel end angivet af lægen. Er der ikke substitueret angives ikke information omkring lægemiddel på effektueringen.

Ved substitution angives:

Lægemidlets drugid angives i Identifier-elementet. Ved angivelse af drugid skal der i source-attributten angives hvad kilden til lægemiddel er, se Lægemiddel på FMK:

BEMÆRK: for udgåede lægemidler er det vigtigt, at “date” angives som den takstdato, hvori lægemidlet var aktivt. Anvendes dags dato vil kaldet blive afvist, idet lægemidlet skal være/have været aktivt på den angivne dato.

Lægemidlets navn angives og er obligatorisk.

Lægemidlets form kan angives for lægemidler i Medicinpriser og “Stærke vitaminer og mineraler”, og skal angives hvis der substitueres til andre typer af lægemidler. Formen angives idet der angives en form-kode med kilde i “Medicinpriser”. Form teksten kan angives, men overskrives med hvad der findes ved opslag.

Tilsvarende kan lægemidlet styrke angives for i Medicinpriser og “Stærke vitaminer og mineraler”, og skal angives hvis der substitueres til andre typer af lægemidler. Styrken angives enten som numerisk værdi og enhedskode samt evt. enheds-tekst og evt. komplet tekst, eller alternativt som komplet tekst.

Endeligt kan der der angives aktive substanser, såfremt der haves datagrundlag herfor. Angivelse af aktive substanser er først og fremmest relevant hvor der ikke findes fælles stamdata for lægemidlet der substitueres til.

Afslut Recept

Sidst under Prescription-elementet angives med true eller false i Terminate-elementet om recepten er afsluttet, eller om der fortsat kan udleveres ud fra recepten.

Eksempel: Opret effektuering af en enkelt pakning

CreateEffectuationRequest-Iterated.xml
<CreatePharmacyEffectuationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Skanderborg Apotek</Name>
            <AddressLine>Adelgade 27</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
            <Type>Apotek</Type>
	    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
        </Organisation>
    </CreatedBy>
    <Prescription>
        <PrescriptionIdentifier>1341404071655002003</PrescriptionIdentifier>
        <OrderIdentifier>1341404070747001001</OrderIdentifier>
        <Effectuation>
            <DateTime>2014-03-10T11:12:39Z</DateTime>
            <PackageDispensed>
                <PackageQuantity>1</PackageQuantity>
                <PackageNumber source="Medicinpriser" date="2014-03-10">789</PackageNumber>
                <PackageSize>
                    <Value>40</Value>
                    <UnitCode source="Medicinpriser" date="2014-03-10">stk</UnitCode>
                    <UnitText>stk</UnitText>
                </PackageSize>
                <SubstitutedDrug>
                    <Identifier source="Medicinpriser" date="2014-03-10">28101234504</Identifier>
                    <Name>Eksemplificin</Name>
                    <Form>
                        <Code source="Medicinpriser" date="2014-03-10">TAB</Code>
                        <Text>tabletter</Text>
                    </Form>
                    <Strength>
                        <Value>50</Value>
                        <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
                        <UnitText>mg</UnitText>
                    </Strength>
                </SubstitutedDrug>
            </PackageDispensed>
            <ExpectedDeliveryDateTime>2014-03-10T14:00:00Z</ExpectedDeliveryDateTime>
            <PharmacyComment>Oprettet i Betalingsservice</PharmacyComment>
            <LabelText>1 tablet morgen, middag og aften mod smerter</LabelText>
            <DeliverySite>
                <Name>Ry Apoteksudsalg</Name>
                <AddressLine>Siimtoften 2</AddressLine>
                <AddressLine>8660 Ry</AddressLine>
                <Type>Apotek</Type>
	        <Identifier source="CVR-P">1008648049</Identifier>
            </DeliverySite>
        </Effectuation>
        <Terminate>true</Terminate>
    </Prescription>
</CreatePharmacyEffectuationRequest>

Eksempel: Opret effektuering ved dosisdispensering

Ved effektuering ved dosisdispensering anvendes elementet DoseDispensed/DoseDispensedQuantity, hvor der angives antal tabletter/kapsler/… der er dosispakket. Bemærk endvidere at apoteket opdaterer informationen om den ekspederede dosisdispenseringsperiode. Hvis de udelades bevares eventuelle værdier angivet ved påbegynd eller forige ekspedition.

Desuden angives start og slut-dato samt tidsfrist for ændringer for næste dosisdispenseringsperiode. Her kan også angives pakkeapotek og pakkegruppe. Hvis de udelades, bliver de automatisk videreført fra den forudgående periode

Bemærk, tilbagedateres Deadline på elementet NextDoseDispensing, vil recepten automatisk ende op med status “Under behandling” svarerende til at servicen Påbegynd ekspedition er blevet kaldt. Dermed kan apoteket i princippet udføre flere ekspeditioner til dosisdispensering i “en transaktion”.

Bemærk: i 1.4.6.E2 skal der ikke angives source på DosageQuantityUnitText elementet

CreateEffectuationRequest-DoseDispsensed.xml
<CreatePharmacyEffectuationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Skanderborg Apotek</Name>
            <AddressLine>Adelgade 27</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
            <Type>Apotek</Type>
	    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
        </Organisation>
    </CreatedBy>
    <Prescription>
        <PrescriptionIdentifier>1341404071655002003</PrescriptionIdentifier>
        <OrderIdentifier>1341404070747001001</OrderIdentifier>
        <Effectuation>
            <DateTime>2016-06-16T11:12:39Z</DateTime>
            <DoseDispensed>
                <DoseQuantity>28</DoseQuantity>
                <DosageQuantityUnitText source="Local">tabletter</DosageQuantityUnitText>
                <SubstitutedDrug>
                    <Identifier source="Medicinpriser" date="2014-03-10">28101234504</Identifier>
                    <Name>Eksemplificin</Name>
                </SubstitutedDrug>
                <CurrentDoseDispensing>
                    <PackedAtOrganisation>
                        <Name>Skanderborg Apotek</Name>
                        <AddressLine>Adelgade 27</AddressLine>
                        <AddressLine>8660 Skanderborg</AddressLine>
                        <Type>Apotek</Type>
                        <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
                    </PackedAtOrganisation>
                    <FirstDosageDate>2016-06-20</FirstDosageDate>
                    <LastDosageDate>2016-07-03</LastDosageDate>
                    <PackingGroup>Plejehjemmet Hvilely</PackingGroup>
                    <Deadline>2016-07-01T08:00:00Z</Deadline>
                </CurrentDoseDispensing>
                <NextDoseDispensing>
                    <FirstDosageDate>2016-07-04</FirstDosageDate>
                    <LastDosageDate>2016-07-17</LastDosageDate>
                    <Deadline>2016-07-01T08:00:00Z</Deadline>
                </NextDoseDispensing>
            </DoseDispensed>
            <DeliverySite>
                <Name>Ry Apoteksudsalg</Name>
                <AddressLine>Siimtoften 2</AddressLine>
                <AddressLine>8660 Ry</AddressLine>
                <Type>Apotek</Type>
	        <Identifier source="CVR-P">1008648049</Identifier>
            </DeliverySite>
        </Effectuation>
        <Terminate>true</Terminate>
    </Prescription>
</CreatePharmacyEffectuationRequest>

Svar

Svaret returnerer id'er for de recepter, og bestillinger som effektueringerne er oprettet på sammen med id'erne på de nye effektueringer.

CreatePharmacyEffectuationResponse.xml
<CreatePharmacyEffectuationResponse>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Effectuation>
		<PrescriptionIdentifier>1341404077656004004</PrescriptionIdentifier>
		<OrderIdentifier>1341404077656004006</OrderIdentifier>
		<EffectuationIdentifier>1341404078102001010</EffectuationIdentifier>
	</Effectuation>
</CreatePharmacyEffectuationResponse>