Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 [[fmk:bestil_udlevering:1.4.4:opslag_op_bestilte_udleveringer_pa_opsummeret_form|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):

  * Borgerens CPR-nummer (PersonIdentifier)
  * Optionelt startdato for medicinanmodningens oprettelsesdato (FromDateTime)
  * Optionelt slutdato for medicinanmodningens oprettelsesdato (ToDateTime)
  * Inkluder receptanmodninger (IncludeOrderedPrescriptionMedications samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUnprescribedOrders)
    * Inkluder ekspederede anmodninger (IncludePrescribedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Inkluder udleveringsanmodninger (IncludeOrderedEffectuations samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUneffectuatedOrders)
    * Inkluder ekspederede anmodninger (IncludeEffectuatedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Optionelt filtrering på ID, dvs. højst en af de to følgende lister:
    * En en liste af ID'er (Identfier) for medicinanmodninger der __kun__ ønskes inkluderet i svaret (IncludeOnly)
    * Eller en liste af ID'er (Identfier) for medicinanmodninger der __ikke__ ønskes returneret i svaret (Exclude)

==== 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: 

  * Organisationen der har oprettet medicinanmodningen, dvs. typisk hjemmesygeplejen (OrderingOrganisation)
  * Optionelt startdato for medicinanmodningens oprettelsesdato (FromDateTime)
  * Optionelt slutdato for medicinanmodningens oprettelsesdato (ToDateTime)
  * Inkluder receptanmodninger (IncludeOrderedPrescriptionMedications samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUnprescribedOrders)
    * Inkluder ekspederede anmodninger (IncludePrescribedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Inkluder udleveringsanmodninger (IncludeOrderedEffectuations samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUneffectuatedOrders)
    * Inkluder ekspederede anmodninger (IncludeEffectuatedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Optionelt filtrering på ID, dvs. højst en af de to følgende lister:
    * En en liste af ID'er (Identfier) for medicinanmodninger der __kun__ ønskes inkluderet i svaret (IncludeOnly)
    * Eller en liste af ID'er (Identfier) for medicinanmodninger der __ikke__ ønskes returneret i svaret (Exclude)

==== 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 [[fmk:advis:alternative_workflows|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:

  * Organisation, dvs. typisk lægepraksis der angives med ydernummer, eller sygehus der angives med SKS-kode. Organisationen her er således svarende til hvad der i medicinanmodningen er angivet i PrescribingOrganisation. (PrescribingOrganisation).
  * Optionelt startdato for medicinanmodningens oprettelsesdato (FromDateTime)
  * Optionelt slutdato for medicinanmodningens oprettelsesdato (ToDateTime)
  * Inkluder receptanmodninger (IncludeOrderedPrescriptionMedications samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUnprescribedOrders)
    * Inkluder ekspederede anmodninger (IncludePrescribedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Inkluder udleveringsanmodninger (IncludeOrderedEffectuations samt underelementer):
    * Inkluder anmodninger der ikke er ekspederet endnu (IncludeUneffectuatedOrders)
    * Inkluder ekspederede anmodninger (IncludeEffectuatedOrders)
    * Inkluder afviste anmodninger (IncludeCancelledOrders)
  * Optionelt filtrering på ID, dvs. højst en af de to følgende lister:
    * En en liste af ID'er (Identfier) for medicinanmodninger der __kun__ ønskes inkluderet i svaret (IncludeOnly)
    * Eller en liste af ID'er (Identfier) for medicinanmodninger der __ikke__ ønskes returneret i svaret (Exclude)

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.

<code xml>

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

</code>

=== 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.

<code xml>

<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>

</code>

=== 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 [[fmk:bestil_udlevering:1.4.4:opslag_op_bestilte_udleveringer_pa_opsummeret_form|Opslag på medicinanmodninger på opsummeret form]] anvendes i stedet. 

<code xml>

<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>

</code>
==== 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:

<code xml>

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

</code>

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 ===

<code xml "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>

</code>