Differences

This shows you the differences between two versions of the page.

--- fmk:1.4.6:hent_medicinkort [2016-08-16 11:13] – mbe
+++ fmk:1.4.6:hent_medicinkort [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 8: / Line 8: @@
 ==== Privatmarkering ====
-Ved hjælp af en valgfri ConsentHeader angives at der også ønskes returneret lægemiddelordinationer markeret med [[fmk:generel:privatmarkering|privatmarkering]]. Årsagen hertil skal angives ved anvendelse af en af de to ConsentType værdier:
+Ved hjælp af en valgfri ConsentHeader angives at der også ønskes returneret lægemiddelordinationer markeret med [[fmk:generel:privatmarkering|privatmarkering]]. Årsagen hertil skal angives ved anvendelse af en af følgende ConsentType værdier:
-  * PrivateDataConsentOverridden såfremt opslaget sker for nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten.
+  * ''PrivateDataConsentOverridden'' såfremt opslaget sker for nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten.
-  * PrivateDataConsentGiven såfremt opslaget sker efter mundtlig eller skriftlig samtykke.
+  * ''PrivateDataConsentGiven'' såfremt opslaget sker efter mundtlig eller skriftlig samtykke.
+For en mere detaljeret beskrivelse af ConsentHeader henvises til [[fmk:1.4.6:soap_header_--_specifikt_omkring_samtykke|SOAP header beskrivelsen]].
 Disse to typer af forespørgsler vil blive logget specielt. Såfremt opslaget sker efter patientens samtykke, skal der i kaldet angives i hvilket datointerval dette samtykke sker. Værdien kan evt. anvendes i forbindelse med opfølgning på logdata, men har i øvrigt ingen indvirkning på omfanget af de returnerede data.
@@ Line 22: / Line 24: @@
 Request-dokumentet indeholder en række felter til angivelse af, hvad der ønskes returneret i responset. Medicinkort-delen og lægemiddelordinationer returneres altid. Derover kan der angives:
-  * IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordinationer. Dette uanset om receptordinationerne er knyttet til lægemiddelordinationer eller er aktuelle løse receptordinationer.
+  * ''IncludePrescriptionMedications'': Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordinationer. Dette uanset om receptordinationerne er knyttet til lægemiddelordinationer eller er aktuelle løse receptordinationer.
-  * IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektueringer. I så fald gælder dette både effektuereringer på lægemiddelordinationer og effektueringer på receptordinationer, dog vil effektueringer på receptordinationer ikke blive returneret hvis IncludePrescriptionMedications er false.
+  * ''IncludeEffectuations'': Såfremt elementet sættes til true vil svaret indeholde eventuelle effektueringer. I så fald gælder dette både effektuereringer på lægemiddelordinationer og effektueringer på receptordinationer, dog vil effektueringer på receptordinationer ikke blive returneret hvis IncludePrescriptionMedications er false. Det er muligt at blive whitelisted til kun at modtage 30 effektueringer. Hvis flere effektueringer ønskes kan [[fmk:1.4.6:hent_effektueringer|hent effektueringer]] bruges.
-  * IncludeNonRelevantPrescriptionMedications: Sættes elementet til true vil løse receptordinationer  blive returneret, uanset om de er markeret som uaktuelle eller ej. Sættes elementet til false vil løse recepter markeret som uaktuelle ikke blive returneret. Flaget har ingen mening, såfremt IncludePrescriptionMedications er false.
+  * ''IncludeNonRelevantPrescriptionMedications'': Sættes elementet til true vil løse receptordinationer  blive returneret, uanset om de er markeret som uaktuelle eller ej. Sættes elementet til false vil løse recepter markeret som uaktuelle ikke blive returneret. Flaget har ingen mening, såfremt IncludePrescriptionMedications er false.
 Med "løse" receptordinationer menes receptordinationer der ikke er tilknyttet en lægemiddelordination, og som er oprettet uden om det fælles medicinkort på f.eks. EDIFACT-, papir- eller telefonrecepter. FMK henter receptordinationer fra Receptserveren.
+** I 1.4.6.E2 ** er det desuden muligt at vælge hvilke [[fmk:extensions:e2#Borgervalgt medicin / Ikke-lægeordinerede lægemiddelordinationer|typer af lægemiddelordinationer]] der skal returneres. Det sker ved at angive IncludeDrugMedicationType. Her kan angives enten Borgervalgt, Lægeordineret eller begge.
+Hvis feltet udelades, vil det virke som på tidligere snitflader. Det vil sige, der kun returneres Lægeordinerede lægemiddelordinationer.
 ==== Forespørgsel på tidligere versioner ====
@@ Line 65: / Line 69: @@
 Kombinationen af en versions- og en IncludeNonReviewedOnly-angivelse resulterer i løse recepter, der beregnes som følger: Recepterne skal være nyere end den seneste receptgennemgang, der er tidligere end datoen for denne version, og ældre end denne medicinkortversions seneste gyldighedstidspunkt.
+Detaljer om hvad der returneres i historiske kald, findes på siden [[fmk:generel:historik|Historik]]
 ==== Forespørgsel ====
@@ Line 123: / Line 128: @@
 Såfremt der endnu ikke er oprettet data på medicinkortet, men patienten findes, vil der blive returneret en medicinkort-oversigt med versionsnummer 0 og uden elementet ModifiedStructure. Det returnerede dokument vil indeholde personinformation.
-Elementet GetMedicineCardResponse vi indeholde et eller flere MedicineCard-elementer. Responset kan indeholde flere medicinkort som svar, idet der kan forespørges på f.eks. flere versioner eller flere tidspunkter. En nærmere gennemgang af indholdet i MedicineCard-elementet findes i [[fmk:1.4.2:medicinkort|Medicinkort]] og [[fmk:1.4.2:laegemiddelordination|Lægemiddelordination]].
+Elementet GetMedicineCardResponse vi indeholde et eller flere MedicineCard-elementer. Responset kan indeholde flere medicinkort som svar, idet der kan forespørges på f.eks. flere versioner eller flere tidspunkter. En nærmere gennemgang af indholdet i MedicineCard-elementet findes i [[fmk:1.4.4:medicinkort|Medicinkort]] og [[fmk:1.4.4:laegemiddelordination|Lægemiddelordination]].
 Eksemplet herunder viser et tomt medicinkort. For et udfyldt eksempel se [[fmk:1.4.6:medicinkort|Medicinkort]].
@@ Line 164: / Line 169: @@
 Medicnkortet kan desuden indeholde en eller flere administrativt slettede lægemiddelordinationer og recepter, se [[fmk:1.4.6:ugyldig-markeret_laegemiddelordination_eller_recept|Administrativt slettet lægemiddelordination eller recept]].
+==== Udvidelser i 1.4.4.E4 ====
+I 1.4.4.E4 returneres yderligere information om eventuel dosisdispensering af patienten. Dette returneres i elementet ''DoseDispensingSummary'' som erstatter de to felter ''LatestDosageDispensingEffectuation'' og ''HasOpenDosageDispensingPrescriptions''. Disse er inkluderet under summary elementet sammen ''Deadline'', ''StartDate'' og ''EndDate'', der angiver startdato og slutdato og tidsfrist for ændringer på den først fremtidige dosisdispenseringsperiode hvor deadline endnu ikke er overskredet på en eventuel igangværende dosisdispenseringskperiode. Deadline (også kaldet tidsfrist for ændringer) angiver den førstkommende fremtidige tidsfrist for ændringer til den dosisdispenserede medicin. Det vil sige det tidspunkt, hvor ændringer skal foretages inden, hvis det skal have effekt for den næste pakning af dosisdipenseret medicin. Endelig indeholder elementet information om det udleveringsapotek, der har ansvaret for patientens dosisdispensering som elementet ''OrderedAtPharmacy''.
+**Bemærk** Findes der ikke en kommende dosisdispenseringsperiode hvor deadline ikke er overskredet, returneres den sidste periode hvor deadline er overskredet.
+**Bemærk** Feltet ''LatestDosageDispensingEffectuation'' udfyldes kun såfremt der forefindes en DD-effektuering som er foretaget indenfor de seneste 3 måneder. Effektueringen vil oftest forefindes som LMO effektuering, men kan i nogle situationer også være som recept-effektuering.
+Desuden returneres der på den enkelte lægemiddelordination en markering 'IsDoseDispensed', hvis lægemidlet håndteres dosisdispenseret på apoteket.
+Eksempel:
+<code xml GetMedicineCardResponseE4.xml>
+<GetMedicineCardResponse>
+    <MedicineCard>
+...
+        <DoseDispensingSummary
+            <StartDate>2016-06-20</StartDate>
+            <EndDate>2016-07-03</EndDate>
+            <Deadline>2016-06-17T13:30:00Z</Deadline>
+            <LatestDosageDispensingEffectuation>
+                <Created>
+                    <By>
+                        <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>
+                    </By>
+                </Created>
+            </LatestDosageDispensingEffectuation>
+            <HasOpenDosageDispensingPrescriptions>true</HasOpenDosageDispensingPrescriptions>
+            <OrderedAtPharmacy>
+                <Name>Århus Jernbane Apotek</Name>
+                <AddressLine>Banegårdsplads 8</AddressLine>
+                <AddressLine>8000 Århus</AddressLine>
+                <Type>Apotek</Type>
+                <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
+            </OrderedAtPharmacy>
+        </DoseDispensingSummary>
+    </MedicineCard>
+</GetMedicineCardResponse>
+</code>
 ==== Seponerede ordinationer ====