This is an old revision of the document!
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.
BEMÆRK: Apotekssystemet skal informere farmaceuten / farmakonomen hvis recepten er tilknyttet en lægemiddelordination, men ikke er tilknyttet til den nyeste version af lægemiddelordinationen, således at farmaceuten / farmakonomen evt. kan nå at ændre hvad der udleveres efter kontakt med lægen.
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 farmaceuten/farmakonomen samt apoteket, som opretter effektueringen.
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:
- Identifier
- Modified
- Created
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:
- Ved effektuering af effektueringer af lægemidler defineret i Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = “Medicinpriser” og date = dato for den aktuelle takst der refereres til.
- Ved effektuering af lægemidler i “Stærke vitaminer og mineraler” angives source = “Stærke vitaminer m.v.” og date = dato for den aktuelle takst
- Lægemidler angives som “Tilknyttede behandlinger” bør substitueres til f.eks. frihandelsvare.
- Ved effektueringer af lægemidler defineret lokalt kan der substitueres eller der kan ekspederes en frihandelsvare uden at lægemidlet substitueres.
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>Farmakonom</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.
- CreateEffectuationRequest-DoseDispsensed.xml
<CreatePharmacyEffectuationRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <CreatedBy> <Other> <Name> <GivenName>Anne</GivenName> <Surname>Andersen</Surname> </Name> </Other> <Role>Farmakonom</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="Doseringsforslag">tabletter </DosageQuantityUnitText> <SubstitutedDrug> <Identifier source="Medicinpriser" date="2014-03-10">28101234504</Identifier> <Name>Eksemplificin</Name> </SubstitutedDrug> <DoseDispensing> <PackedAtOrganisation> <Name>Skanderborg Apotek</Name> <AddressLine>Adelgade 27</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <Type>Apotek</Type> <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier> </PackedAtOrganisation> <ExpectedFirstDosageDate>2016-06-20</ExpectedFirstDosageDate> <ExpectedLastDosageDate>2016-07-03</ExpectedLastDosageDate> <ProductionDay>Fredag lige uger</ProductionDay> <PackingGroup>Plejehjemmet Hvilely</PackingGroup> </DoseDispensing> </DoseDispensed> </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>
