Table of Contents

Opslag på medicinanmodninger

Der udstilles en ”Opslag på medicinanmodninger”-service på tre former, hvor resultatet af opslaget afhænger af formen af opslag og en række medsendte parametre.

Bemærk at for alle patienter der fremsøges, vil det i disse patienters MinLog fremgå at anvenderen af kaldet har fremsøgt medicinanmodninger. Dette er ofte en uønsket sideeffekt af denne service. Hvis kalderen ønsker et overblik over medicinanmodninger, uden at kaldet logges på alle fremsøgte patienter, kan man i stedet anvende Opslag på medicinanmodninger på opsummeret form

Kaldet kan udformes på tre måder.

Opslag på medicinanmodninger for en bestemt patient / borger

Her angives (med skema-elementnavnet i parentes):

Opslag på medicinanmodninger foretaget af en bestemt organisation (typisk hjemmesygeplejen)

I dette tilfælde angives medicinamodnings-organisationen i OrderingOrganisation. Der søges således på source og værdi for Identifier under OrderingOrganisation. I dette tilfælde angives:

Opslag på medicinanmodninger til en bestemt organisation (lægepraksis, sygehus m.v)

Servicen kan i denne variant anvendes til at f.eks. lægepraksis med jævne mellemrum slå op med eget ydernummer, og på den måde henter medicinanmodninger der ikke er behandlet endnu. Dvs. servicen kan anvendes som alternativ til advisering, som beskrevet alternative workflows for advis.

I dette tilfælde angives organisationen angivet i PrescribingOrganisation ved oprettelsen af medicinanmodningen. Der søges således på source og værdi for Identifier under PrescribingOrganisation.

I kaldet angives:

Det gælder for alle de tre former at hvis ”Inkluder udleveringsanmodninger” eller ”Inkluder receptanmodninger” udelades, så svarer dette til at alle værdier herunder er sat til true. På nuværende tidspunkt kan udleveringsanmodninger ikke annulleres (de vil umiddelbart efter udleveringsanmodningen er foretaget kunne hentes og tages under behandling af apoteket), så dette flag ignoreres i nuværende version.

Filtrene IncludeUnprescribedOrders, IncludePrescribedOrders, IncludeCancelledOrders, IncludeUneffectuatedOrders, IncludeEffectuatedOrders og IncludeCancelledOrders er tilvalgsfiltre. Resultatet er således foreningsmængden. Det er derfor ikke muligt at frasortere eks. alle annullerede ved at sætte IncludeCancelledOrders til false.

Servicen kan anvendes til direkte opslag på patientens CPR-nummer, til hjemmesygeplejens opslag på egne oprettede medicinanmodninger, f.eks. for at se status herpå, og til at lægen kan slå op på receptanmodninger, f.eks. receptanmodninger som lægen endnu ikke har udstedt recept ud fra.

I svaret returneres en række ID'er på lægemiddelordinationer, recepter og recepteffektueringer. Disse ID'er er referencer til lægemiddelordinationer, recepter og effektueringers ID'er i FMK snitfladen. Egentlige data for disse returneres ikke i denne snitflade, men kan efterfølgende slås op FMK snitfladen. Dette gøres da data muligvis allerede er kendt i EOJ-systemet, og for at opnå en afkobling mellem de fælles FMK-services og de mere specifikke services til at håndtere medicinanmodninger.

Forespørgsel

Eksempel 1 – opslag på CPR-nummer

Eksemplet viser opslag på borgerens/patientens CPR-nummer, for at få samtlige medicinanmodninger foretaget den sidste måned returneret.

I forespørgselen er angivet starttid og sluttid for det interval der hvor der ønskes medicinanmodninger (begge er optionelle). Det er oprettelsestidspunktet for en medicinanmodning der er afgørende for om den inkluderes i søgningen. Desuden angives der flag for om der ønskes returneret receptanmodninger (afventende, udførte og annullerede) og udleveringsanmodninger (afventende, udførte og annullerede).

IncludeOrderedPrescriptionMedications og IncludeOrderedEffectuations er ikke medsendt, så dette svarer til at alle underelementerne er sat til true. 

<GetOrderedEffectuationsRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<FromDateTime>2013-09-11T00:00:00Z</FromDateTime>
	<ToDateTime>2013-10-11T23:59:59Z</ToDateTime>
</GetOrderedEffectuationsRequest>

Eksempel 2 – opslag på ”medicinanmodninger foretaget af hjemmesygeplejen”

Dette eksempel viser opslag på medicinanmodninger foretaget af en given hjemmesygepleje-organisation. Forespørgslen kan f.eks. udføres for at synkronisere data i EOJ-systemet ud fra data i FMK. Der forespørges på et datointerval, f.eks. seneste uge, og alle typer og status returneres.

IncludeOrderedPrescriptionMedications og IncludeOrderedEffectuations er ikke medsendt, så dette svarer til at alle underelementerne er sat til true. 

<GetOrderedEffectuationsRequest>
	<OrderingOrganisation>
		<Name>Hjemmesygeplejen i Skanderborg</Name>
		<Type>Kommune</Type>
		<Identifier source="Kommunekode">746</Identifier>
	</OrderingOrganisation>
	<FromDateTime>2013-09-05T00:00:00</FromDateTime>
	<ToDateTime>2013-09-11T23:59:59Z</ToDateTime>
</GetOrderedEffectuationsRequest>

Eksempel 3 – opslag på ”åbne receptanmodninger til lægen”

Eksemplet viser opslag på receptanmodninger stilet til en læge-organisation, i dette tilfælde ud fra et ydernummer.

Forespørgslen kan f.eks. udføres når lægen slår op efter åbne receptanmodninger stilet til lægens klinik.

Et sådan søgning vil returnere personhenførbare oplysninger og kaldet bliver logget i MinLoggen for samtlige borger der returneres. Derfor bør Opslag på medicinanmodninger på opsummeret form anvendes i stedet. 

<GetOrderedEffectuationsRequest>
	<PrescribingOrganisation>
		<Name>Lægerne Vestergade</Name>
		<Type>Yder</Type>
		<Identifier source="Yder">061069</Identifier>
	</PrescribingOrganisation>
	<IncludeOrderedPrescriptionMedications>
		<IncludeUnprescribedOrders>true</IncludeUnprescribedOrders>
		<IncludePrescribedOrders>false</IncludePrescribedOrders>
		<IncludeCancelledOrders>false</IncludeCancelledOrders>
	</IncludeOrderedPrescriptionMedications>
</GetOrderedEffectuationsRequest>

Svar

Svaret indeholder et antal Patient-elementer, hver identificeret med CPR-nummer i PersonIdentifier-elementet.

I hvert “patient”-element returnes der et antal elementer ”OrderedPrescriptionMedication” eller ”OrderedEffectuation” for medicinanmodninger på patientens CPR-nummer. En væsentlig del af indholdet svarer til ”Medicinanmodning”-kaldet.

Hvis opslaget går på tværs af CPR-numre (dvs. opslag på medicinanmodninger foretaget af en bestemt organisation eller udstedt af en bestemt organisation) vil kaldet returnere de 25 nyeste medicinanmodninger på tværs af de patienter der returneres. Hvis der eksisterer flere end 25 medicinanmodninger så afsluttes svaret med et ”MoreAvailable” element: 

<MoreAvailable>
	<LastDate>2013-01-01T12:12:00Z</LastDate>
<MoreAvailable>

Elementet indeholder et ”LastDate” element med en dato for den ældste medicinanmodninger returneret. Denne dato, fratrukket 1 sekund for at undgå dubletter, kan efterfølgende anvendes til at ændre datointervallet i request-dokumentet for at få ældre medicinanmodninger returneret.

Bemærk som en lille spidsfindighed, at kaldet returnerer de nyeste 25 anmodninger samt alle de anmodninger ud over de 25, som er oprettet på samme tidspunkt som den ældste af de 25. Dette er lavet i tilfælde af, at der findes mange (>25) samtidigt oprettede anmodninger til den samme organisation. Hvis der blot blev returneret 25 ville man aldrig kunne læse de sidste af de anmodninger, der var oprettet samtidigt med den ældste af de 25.

OrderedPrescriptionMedication

For receptanmodninger returneres et OrderedPrescriptionMedication-element. Herunder findes først anmodnings-id og id for lægemiddelordinationen receptanmodningen er foretaget på grundlag af.

Herefter følger information omkring sundhedspersonen og organisationen der har oprettet receptanmodningen.

I svaret returneres en angivelse af hvilken lægepraksis, evt. sygehusafdeling m.v, som hjemmesygeplejen har ønsket receptanmodningen skal effektueres af. Dette angives i elementet PrescribingOrganisation. Elementet kan være udeladt, eller der kan være angivet flere, f.eks. hvor hjemmesygeplejen er i tvivl om hvorvidt receptanmodningen skal foretages af borgerens egen læge eller af en speciallæge, et ambulatorium eller lignende.

I EffectuatingOrganisation er angivet hvilket apotek hjemmesygeplejen har angivet at udleveringen ønskes adresseret til.

Herefter følger en eventuel angivelse af leveringsinformation eller ordre-instruktion, og eventuelt yderligere detaljer omkring leveringen. Elementerne svarer til indholdet i FMKs øvrige recept-skemaer.

I svaret findes altid et ”OrderedDateTime”-element, der sættes af FMK til tidspunktet ”Medicinanmodning”-servicen er kaldt.

Endeligt findes der et recepts-id i OrderedPrescriptionMedicationIdentifier-elementet når lægen har oprettet recepten ud fra medicinanmodningen. Når apoteket efterfølgende har ekspederet recepten findes der et (evt. flere) OrderedEffectuationIdentifier-elementer.

Såfremt medicinanmodningen er annulleret, af enten lægen eller af hjemmesygeplejen selv, vil dette være angivet med cancelled-elementet. Der gives ingen årsag til annulleringen.

OrderedEffectuationMedication

For hver udleveringsanmodning returneres et OrderedEffectuation-element. Indholdet svarer til receptanmodninger, bortset fra at PrescribingOrganisation ikke forekommer, og der i stedet for OrderedPrescriptionMedicationIdentifier i ExistingPrescriptionMedicationIdentifier angives id på den eksisterende recept som udleveringsanmodningen foretages ud fra

Relation mellem receptanmodninger og recepter

Ved en receptanmodning til lægen skal den nye recept knyttes hertil. recepten oprettes ud fra lægemiddelordinationen ved at lægepraksissystemet kalder ”opret recept ud fra lægemiddelordination”-servicen på FMK snitfladen. Denne service er derfor udvidet med receptanmodningens id. Via godkendelseskriterier skal der sikres at feltet udfyldes hvis receptopretelsen sker på baggrund af en receptanmodningen.

Eksempel

"GetOrderedEffectuationsResponse.xml
<GetOrderedEffectuationsResponse>
    <Patient>
        <PersonIdentifier>1111111118</PersonIdentifier>
        <OrderedPrescriptionMedication>
            <Identifier>1341404071665003002</Identifier>
            <DrugMedicationIdentifier>1341404681125001011</DrugMedicationIdentifier>
            <OrderedBy>
                <Other>
                    <Name>
                        <GivenName>Hanne</GivenName>
                        <Surname>Hansen</Surname>
                    </Name>
                </Other>
                <Role>Assistent for Sygeplejerske</Role>
                <Organisation>
                    <Name>Hjemmesygeplejen i Skanderborg</Name>
                    <AddressLine>Adelgade 64</AddressLine>
                    <AddressLine>8660 Skanderborg</AddressLine>
                    <TelephoneNumber>87947000</TelephoneNumber>
                    <EmailAddress>hjs@skanderborg.dk</EmailAddress>
                    <Type>Kommune</Type>
                    <Identifier source="Kommunekode">746</Identifier>
                </Organisation>
            </OrderedBy>
            <PrescribingOrganisation>
                <Name>Lægerne Vestergade</Name>
                <Type>Yder</Type>
                <Identifier source="Yder">061069</Identifier>
            </PrescribingOrganisation>
            <OrderedDateTime>2013-11-12T08:43:12</OrderedDateTime>
        </OrderedPrescriptionMedication>
    </Patient>
</GetOrderedEffectuationsResponse>