This is an old revision of the document!
Table of Contents
Beskrivelse af extension E2
Baggrund
Formålet med Extension E2 er i første omgang at stille bedre information til rådighed for lægerne (og andre sundhedsfaglige) angående dosisdispenseret medicin. Det er planen at apotekerne på længere sigt vil foretage pakningen ud fra samme dosisdispenseringkort.
Dosisdispensering betragtes af de fleste som et meget kompliceret område. Det er svært for de sundhedsfaglige at få overblik og indblik, og derfor er det svært at træffe beslutninger om medicineringen. Her er nogle eksempler på, spørgmål, som det har været svært at få svar på:
- Hvilke lægemidler dosisdispenseres? Der kan dosisdispenseres på recepter, selvom de ikke var oprettet til dosisdispensering, og modsat kan recepter til dosisdispensering være udeladt, og der kan desuden være pakket håndkøbsmedicin, der slet ikke er recepter på.
- Hvordan er lægemidlerne fordelt i poserne? Fx hvis et lægemiddel skal tages 1 gang dagligt, hvornår er det så? Det er en detalje som i dag besluttes på apoteket.
- Hvilken periode dækker dosisdispenseringsrullen?
- Hvis medicineringen ændres nu, hvornår får det så effekt ude hos patienten?
Desuden har det været besværligt at sætte dosisdispenseringen midlertidigt i bero, fordi det krævede at alle dosisdispenserede recepter skulle annulleres, og for at genoptage dosisdispenseringen skulle der følgelig oprettes en række nye recepter.
Extension E2 vil forbedre på denne situation ved at stille et par nye services til rådighed - primært Hent dosisdispenseringskort - som samler og leverer de oplysninger, der er til rådighed i FMK omkring dosisdispenseringen. Over tid vil detaljegraden og fuldstændigheden af FMK's oplysninger blive forbedret, og i takt med dette vil den nye service levere tiltagende bedre data om dosisdispenseringen.
Der er nemlig planlagt en fase-opdelt udrulning systemer i apotekssektoren, som anvender “rigtige” FMK-snitflader (v1.4.6) i stedet for den snitflade der stammer fra Receptserveren. I denne sammenhæng kan faserne opsummeres på denne form:
- Apotekerne leverer nogle få ekstra-oplysninger omkring dosisdispensering via “Receptserver apoteksnitfladen” (dosisdispenserings-periode)
- Apotekerne overgår til FMK 1.4.6 snitfladen
- Apotekerne ibrugtager FMK snitflade inkl. udvidet funktionalitet til dosisdispensering
- Pakkeapotekerne foretager pakning af dosisdispenseret medicin ud fra samme dosisdispenseringskort som lægerne har mulighed for at hente
Når sidste fase er gennemført vil informationen til lægerne vedrørende dosisdispensering derfor være helt i overenstemmelse med det der pakkes til patienten.
Ud over servicen Hent dosisdispenseringskort suppleres med nye typer patientregistreringer i POR til at sætte dosisdispensering i bero samt at genoptage den. Det kan fx være relevant at sætte dosisdispenseringen i bero når en patient indlægges, og sygehuset tager sig af patientens medicinering i indlæggelsesperioden. I forbindelse med udskrivning kan dosisdispenseringen genoptages igen, typisk initieret af egen læge.
For bedre at kunne understøtte funktionaliteten omkring dosisdispenseringskort udvides en række services i 1.4.4 med nye felter. Det gælder eksempelvis receptoprettelser, hvor man i alle relevante services får mulighed for at angive gyldighedsperioden, samt services der returnerer recepter, hvor gyldighedsperioden nu også returneres. Disse felter blev indført i 1.4.6 snitfladen, men stilles altså nu også til rådighed i 1.4.4 gennem Extension 2.
Endelig er der enkelte udvidelser til 1.4.6 snitfladen.
Denne extension ændrer både eksisterende XML-strukturer, og introducerer nye strukturer til de nye services.
Udvidelser der gælder både 1.4.4.E2 og 1.4.6.E2
Nye services i FMK
Nye patientregistreringer i POR
Modifikator for privatmarkering tilføjet i FMK 1.4.4.E2 og 1.4.6.E2
I FMK var det tidligere ikke muligt at se modifikatoren i forbindelse med en eventuel privatmarkering af en lægemiddelordination. Når dette sker af en kliniker sættes det nu som en normal modifikator, og når det sker af en ikke-kliniker, dvs. en borger, en borgers værge eller en forælder, sættes det som et ekstra modifikator element 'ModifiedNonclinical' på lægemiddelordinationen i 1.4.4.E2 og lægemiddelordinationen i 1.4.6.E2. 'ModifiedNonclinical' fjernes igen, når der foretages ændringer af en kliniker.
Source fjernet på UnitText/UnitTexts elementer
Source og Date attributter er fjernet fra de steder i skemaerne, hvor man angiver en doseringsenhed. Doseringsenheder har i dag karakter af fritekst og der er derfor ingen klinisk eller valideringsmæssig værdi i at vedligeholde en sourceangivelse på en doseringsenhed.
I det omfang at data der oprettes via E2 snitfladerne udlæses på tidligere snitflader vil source attributten her blive returneret som Local. Dette vil også ske uagtet om værdien faktisk er indrapporteret fra en snitflade, der fortsat understøtter source på doseringsenheden.
Ovenstående funktionalitet er p.t. ved at blive gradvist indført på testsystemerne med henblik på fuld drift i produktion på et senere tidspunkt. For mere information om hvornår ovenstående funktionalitet enables på testystemer og i prod henvises til FMK-teknik:
Afvisningsårsag tilføjet receptanmodninger
I E2 er der tilføjet mulighed for, at lægen kan angive en årsag til at afvise en receptanmodning. Denne årsag kommunikeres tilbage til anmoderen. Blandt andet for bedre at understøtte dette er medicinanmodning i 1.4.4.E2 ændret til samme princip som i 1.4.6.
EO 1.4.4 E2
I EO 1.4.4 E2 er EO services ændret så de minder om de EO services der er lagt ind under FMK snitfladen i 1.4.6:
Afvisningsårsag i 1.4.6 E2
I FMK 1.4.6 E2 er afvisningsårsag tilføjet til receptanmodninger:
- Hent receptanmodninger for CPR-nummer - Afvisningsårsag returneres som et
CancellationReasonelement, hvis receptanmodningen er annulleret via 1.4.4 E2 eller 1.4.6 E2.
- Annuller receptanmodning - Afvisningsårsag angives i PrescriptionRequest strukturen, som beskrevet 1.4.4 E2 Annuller receptanmodning.
Borgervalgt medicin / Ikke-lægeordinerede lægemiddelordinationer
I E2 er der tilføjet et type-felt på ordinationer. Feltet er tiltænkt fremtidig funktionalitet, der tilgodeser registrering af præparater og medicin som patienten indtager på eget initiativ. Det kunne være naturpræparater, vitaminer eller andre produkter der ikke er lægeordinerede.
Feltet understøtter i sin nuværende form kun værdien Lægeordineret. Til gengæld er feltet påkrævet.
På sigt vil apotekerne oprette alle dosisdispenserede lægemidler i FMK, også eventuelle lægemidler som ikke er lægeordinerede men som patienten har aftalt med apoteket at det skal dosisdispenseres. Det kunne fx være vitaminpiller eller kalktabletter. Disse ordinationer repræsenteres ligesom andre lægemiddelordinationer, dog med en markering både på ordinationen og på dosiskortet af, at det er en ikke-lægeordineret lægemiddelordination (borgervalgt).
Ikke-lægeordinerede lægemiddelordinationer indgår som udgangspunkt ikke i det almindelige medicinkort, men kun på dosisdispenseringskortet. Det er dog muligt eksplicit at angive at man ønsker disse borgervalgte ordinationer returneret også.
Ikke-lægeordinerede lægemiddelordinationer kan hentes og opdateres med de normale services hertil, Hent lægemiddelordination og Opdater lægemiddelordination, hvis man kender deres ID. En borgervalgt lægemiddelordination kan opdateres af en læge, tandlæge, assistent for læge eller assistent for tandlæge, og eventuelt overgå til at blive betragtet som en almindelig lægeordineret lægemiddelordination. Derefter vil de blive inkluderet i det almindelige medicinkort, på linje med andre lægemiddelordinationer.
Det fremgår af en DrugMedication om den er lægeordineret eller borgervalgt. Dette sker gennem et nyt enum felt der indikerer typen.
Servicemæssig understøttelse af borgervalgte lægemidler
Det skal også være muligt at dosisdispensere frihandelsvarer og andre medikamenter, der ikke kræver lægeordination. For at disse kan fremgå af dosisdispenseringskortet, skal det være muligt for læger at indikere om en lægemiddelordination er lægeordineret eller borgervalgt. Tilsvarende gives apoteker mulighed for at oprette borgervalgte ordinationer for at sikre, at dosisdispenseringen omfatter de lægemidler, som patienten ønsker dosispakket.
For at understøtte dette er services til at vedligeholde lægemiddelordinationer udvidet, så de inkluderer en markering af at det er sådan en lægemiddelordination. Det drejer sig om servicene:
Desuden inkluderes denne markering også i svaret fra servicene:
Bemærk endvidere at apoteker gives adgang til services til seponering og pausering af lægemiddelordinationer, sålænge der er tale om borgervalgt medicin.
Viderestilling af receptanmodninger
Snitfladen indeholder nu services til at understøtte viderestilling af receptanmodninger (ForwardPrescriptionRequest og GetPrescriptionRequestVersions). Desuden er receptanmodninger i svar fra FMK udvidet med optionelle felter med version og modifier.
Bemærk: Viderestillings-servicene er endnu ikke implementeret, da det afventer klinisk afklaring. Begge services vil derfor indtil videre fejle med 'Not implemented'. De nye felter med version og modifier vil heller ikke være udfyldt indtil videre.
Ensartet angivelse af pakkestørrelse
Baggrund
Før 1.4.6. har der været forskellige måder at angive pakkestørrelser, afhængig af om det var på recepter eller på udleveringer. På recepter blev pakkestørrelsen angivet i FreeTradePackageSize uanset om der var tale om frihandelsvarer eller ej.
I 1.4.6 blev dette ensrettet, så der alle steder kunne angives enten en struktureret pakkestørrelse eller en fritekst pakkestørrelse. I svar ville FMK så vidt muligt returnere den strukturerede form.
Ny struktur
I både 1.4.4.E2 og 1.4.6.E2 ændres dette således at der kan angives både en struktureret pakkestørrelse og en fritekst pakkestørrelse. Dette sker for at inkludere så meget information som muligt om pakningen, idet der i visse tilfælde findes yderligere information i fritekstpakkestørrelsen om eksempelvis embalagetype, importør og delpakninger.
Eksempel:
<PackageSize> <Value>300</Value> <UnitCode source="Medicinpriser" date="2017-02-01">ST</UnitCode> <UnitText>stk.</UnitText> <PackageSizeText>3 x 100 stk. (blister)</PackageSizeText> </PackageSize>
Ændringer i 1.4.4.E2
En række ændringer fra 1.4.6, er blevet vurderet, at have så stor værdi, at de også er indført i 1.4.4.E2.
Årsag til ugyldiggørelse tilføjet i FMK 1.4.4.E2
I FMK 1.4.4 og tidligere har det ikke været muligt for andre aktører at se den årsag apotek har angivet, i forbindelse med en eventuel ugyldiggørelse af en recept. Dette er tilføjet som et ekstra element 'InvalidationReasonText' på recepten i lighed med FMK 1.4.6. snitfladen.
Angivelse af Source på PersonIdentifier
Med denne extension skal der angives source på PersonIdentifier-elementer. Pt. er kun “CPR” understøttet.
Privat markering
I 1.4.4.E2 returneres privatmarkerede recepter i servicen getPrescriptionMedications på samme måde som i 1.4.6. Det vil sige, hvis der returneres en recept der er knyttet til en lægemiddelordination, der er privatmarkeret og der ikke i kaldet er angivet samtykke til visning af privatmarkerede elementer, returneres kun receptens identifier i et element med navnet PrivatePrescriptionMedication. Hvis der er angivet samtykke returneres recepten som normalt men med et tomt element med navnet IsPrivatePrescription.
Recept gyldighedsperiode
I 1.4.4.E2 er Receptordination udvidet med gyldighedsperiode.
Det vil sige ValidFromDate og ValidToDate er tilføjet til Receptordination i følgende services:
Bemærk: Det er p.t. ikke tilladt at fremdatere en recept. D.v.s. ValidFromDate kan ikke være senere end oprettelsestidspunktet.
Eksempler på recept gyldighedsperiode i Extension 1.4.4.E2
1. Oprettelse af recept med gyldighedsperiode i 14 dage:
<CreatePrescriptionMedicationRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <MedicineCardVersion>1341404077657004001</MedicineCardVersion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier> <Name>Tess Christoffersen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <TelephoneNumber>86521348</TelephoneNumber> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </CreatedBy> <PrescriptionMedication> <DrugMedicationIdentifier>133283023900110001</DrugMedicationIdentifier> <AuthorisationDateTime>2012-03-29T09:30:47.0Z</AuthorisationDateTime> <ReceiverOrganisation> <Name>Skanderborg Apotek</Name> <Type>Apotek</Type> <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier> </ReceiverOrganisation> <SystemName>FMK-online</SystemName> <ValidFromDate>2017-03-02</ValidFromDate> <ValidToDate>2017-03-16</ValidToDate> <SinglePrescriptionDispensing> <PackageNumber source="Medicinpriser" date="2012-02-23">412</PackageNumber> <PackageQuantity>1</PackageQuantity> <DosageText>1 tablet morgen og aften</DosageText> </SinglePrescriptionDispensing> </PrescriptionMedication> </CreatePrescriptionMedicationRequest>
2. Hent medicinkort returnerer gyldighedsperioder på recepter (visse elementer er udeladt af hensyn til overskueligheden):
<GetMedicineCardResponse> <MedicineCard> <Patient> ... </Patient> <Version>1488447229957001999</Version> <Modified> ... </Modified> <DrugMedication> <Identifier>11201</Identifier> <Version>1488447230043001999</Version> <Created> ... </Created> ... <PrescriptionMedication> <Identifier>226146830863050</Identifier> <AuthorisationDateTime>2017-03-02T09:33:47Z</AuthorisationDateTime> <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>12345</AuthorisationIdentifier> <Name>Helle Bonde</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Anitas praksis</Name> <AddressLine>Vestervold 47</AddressLine> <AddressLine>1000 København K</AddressLine> <TelephoneNumber>12345678</TelephoneNumber> <Type>Yder</Type> <Identifier source="Yder">1234</Identifier> </Organisation> </By> <DateTime>2017-03-02T09:33:47Z</DateTime> </Created> <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause> <ValidFromDate>2017-03-04</ValidFromDate> <ValidToDate>2017-03-24</ValidToDate> <ReiteratedPrescriptionDispensing> <PackageNumber source="Medicinpriser" date="2011-03-09">23661</PackageNumber> <ReiterationNumber>3</ReiterationNumber> <ReiterationInterval>4</ReiterationInterval> <ReiterationIntervalUnit>uger</ReiterationIntervalUnit> <PackageQuantity>1</PackageQuantity> <DosageText>1 stk morgen, middag og aften</DosageText> </ReiteratedPrescriptionDispensing> <Indication> <Code source="Medicinpriser" date="2011-03-09">348</Code> <Text>mod impotens</Text> </Indication> ... </PrescriptionMedication> <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause> </DrugMedication> <PrescriptionMedication> <Identifier>226146832150050</Identifier> ... <AuthorisationDateTime>2016-06-12T14:02:47Z</AuthorisationDateTime> <Created> ... </Created> <LatestEffectuationDateTime>2016-06-12T14:02:47Z</LatestEffectuationDateTime> <TerminatedDateTime>2016-06-12T14:02:47Z</TerminatedDateTime> <ValidFromDate>2017-03-02</ValidFromDate> <ValidToDate>2019-03-02</ValidToDate> <SinglePrescriptionDispensing> <PackageNumber source="Medicinpriser" date="2011-03-09">85251</PackageNumber> <PackageQuantity>1</PackageQuantity> <DosageText>Ukendt</DosageText> </SinglePrescriptionDispensing> <Indication> <FreeText>Fritekst indikation nummer 124</FreeText> </Indication> ... <Status>afsluttet</Status> </PrescriptionMedication> <HasOpenDosageDispensingPrescriptions>false</HasOpenDosageDispensingPrescriptions> <OrderedPrescriptionMedicationsExist>false</OrderedPrescriptionMedicationsExist> </MedicineCard> </GetMedicineCardResponse>
Udvidelser i 1.4.6.E2
Nedenstående ændringer vedrører kun 1.4.6.E2
Understøttelse af ReportedBy på CreateAndEffectuate
I 1.4.6 er der ikke mulighed for at angive reportedBy på CreateAndEffectuate servicen. Det er der tilføjet mulighed for i 1.4.6.E2 jævnfør de generelle principper for modifikatorer.
WSDL og skemaer
WSDL og skemaer, version 1.4.4.E2
WDSL med skemaer inline, version 1.4.4.E2
IDWS WSDL og skemaer, version 1.4.4.E2
IDWS WDSL med skemaer inline, version 1.4.4.E2
WSDL og skemaer, version EO 1.4.4.E2
WDSL med skemaer inline, EO version 1.4.4.E2
IDWS WSDL og skemaer, EO version 1.4.4.E2
IDWS WDSL med skemaer inline, EO version 1.4.4.E2
Feltbeskrivelser for EO 1.4.4.E2
WSDL og skemaer, version 1.4.6.E2
WDSL med skemaer inline, version 1.4.6.E2
IDWS WSDL og skemaer, version 1.4.6.E2
