====== Hent medicinkort ====== Servicen ”Hent medicinkort” returnerer et eller flere medicinkort med tilknyttede aktive læge­middel­ordinationer, og afhængigt at de medsendte parametre med recepter og effektueringer. Ved opslag med dato og til eller med et specifikt versionsnummer returneres medicinkortet som det så ud på dette tidspunkt (ved opslag med versionsnummer svarende til tidspunktet versionen blev oprettet). Der kan derved returneres lægemiddelordinationer der aktuelt ikke længere er aktive, men er seponerede eller udløbne. Ved opslag på det aktuelle medicinkort angives hverken versionsnummer eller tidspunkt i forespørgselen. ==== Privatmarkering ==== Med det optionelle element NegativeConsent angives at der også ønskes returneret lægemiddel­ordinationer markeret med [[fmk:generel:privatmarkering|privatmarkering]]. Årsagen hertil skal angives ved anvendelse af en af de to XML-elementer: * ConsentOverridden såfremt opslaget sker for nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten. * ConsentGiven såfremt opslaget sker efter mundtlig eller skriftlig samtykke. 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. I version 1.2.x af snitfladen var det kun nødvendigt at give NegativeConsent elementet med én gang indenfor 24 timer. Efterfølgende kald, indenfor 24 timer, ville så også inkludere eventuelle privatmarkerede lægemiddelordinationer. Dette er ændret i version 1.4 af snitfladen. I version 1.4 skal NegativeConsent elementet gives med hver gang eventuelle privatmarkerede lægemiddel­ordinationer ønskes inkluderet i responset. ==== Valg af indhold i response ==== 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. * 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å recept­ordinationer, dog vil effektueringer på receptordinationer ikke blive returneret hvis Include­Prescription­Medications er false. Det er muligt at blive whitelisted til kun at modtage 30 effektueringer. Hvis flere effektueringer ønskes kan [[fmk:1.4.4:hent_effektuering|hent effektueringer]] bruges. Hvis der findes flere end 30 effektueringer, og begrænsning er valgt, bliver der ikke informeret om, at der er flere effektueringer til rådighed. * 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 Include­Prescription­Medications er false. * [[fmk:generel:extensions_til_services|Extension]] [[fmk:extensions:e1|E1]] IncludeWithdrawnDrugmedications: Giver mulighed for at hente seponerede lægemiddelordinationer, og dermed de recepter og recept-effektueringer knyttet til den seponerede lægemiddelordination. Se desuden [[fmk:extensions:e1#hent_recepter_og_effektueringer|Hent seponerede lægemiddelordinationer]] 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. ==== Extensions ==== === E1 === FMK 1.4.4.[[fmk:extensions:e1|E1]] udvider Hent medicinkort med en række nye informationer. [[fmk:generel:extensions_til_services|Extensions]] er udvidelser af eksisterende snitflader. * [[fmk:extensions:e1#udvidelse_af_hent_medicinkort_servicen_med_dd-info|Information om dosis dispenderede effektueringer]] vil i blive returneret som en del af svaret. * [[fmk:extensions:e1#udvidelse_af_hent_medicinkort_servicen_med_informationer_om_receptanmodninger|Information om eksisterende receptanmodninger]] vil i blive returneret som en del af svaret. * [[fmk:extensions:e1#datoer_og_historik_pa_relationer|Datoer på indlæggelses- og henvisningsmarkeringer]] vil i blive returneret som en del af svaret. * Ny parameter til hentning af [[fmk:extensions:e1#hent_recepter_og_effektueringer|seponerede lægemiddelordinationer]], og dermed de recepter og recept-effektueringer knyttet til den seponerede lægemiddelordination. Med denne parameter sat, undgåes kald til Søg seponerede lægemiddelordinationer. === E2 === ** I 1.4.4.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. === E4 === I **1.4.4.[[fmk:extensions:e4|E4]]** er der følgende ændringer i hent medicinkort: * Hent medicinkort er udvidet med et ''DoseDispensingSummary'' element, som indeholder de elementer der er beskrevet i [[fmk:extensions:e4#udvidelse_af_hent_medicinkort_med_informationer_omkring_dosisdispensering|E4]] * Den enkelte ''DrugMedication'' i svaret er udvidet med en markering ''IsDoseDispensed'' der angiver om lægemiddelordinationen håndteres dosisdispenseret. Dette afgøres ved at en af følgende kriterier er opfyldt: * 1. Ordinationen er på DD-kortet * 2. Recepten er åben, og til DD, men endnu ikke effektueret. * 3. Recepten er åben, og er taget under DD behandling indenfor de seneste 3 måneder. * 4. Recepten er åben, og er effektueret DD indenfor de seneste 3 måneder (ingen igangværende ekspedition). * Scenarie 2-4 kræver recepten er åben. * ''DrugMedication'' ændret således at der nu ikke længere hentes samtlige effektueringer på det pågældende lægemiddel, og i stedet får man kun de seneste 30 tilbage i svaret. Samtidig er elementet ''MoreEffectuationsAvailable'' indført som beskriver at der findes ydereligere effektueringer på den pågældende lægemiddelordination, og disse kan hentes med den [[fmk:extensions:hent_lmo_effektueringer|nye service]] i E4. ==== Forespørgsel på tidligere versioner ==== Ønskes der en tidligere [[fmk:generel:versionsnummerering|version]] af medicinkortet kan der forespørges ud fra [[fmk:generel:versionsnummerering|versionsnummer]]. Forespørges der på en version der ikke findes (dvs. med en højere værdi en den aktuelle version) vil kaldet fejle. 1111111118 133283328800420001 false false false Kombinationen af en versions- og en IncludeNonReviewedOnly-angivelse resulterer i løse receptordinationer, der beregnes som følger: Receptordinationerne skal være nyere end den seneste receptgennemgang der er tidligere end datoen for denne version, og ældre end medicinkortversions seneste gyldigheds­tidspunkt. Endelig kan der forespørges efter medicinkortet som det så ud på et givent tidspunkt, dvs. med et tidsstempel. 1111111118 2012-03-28T09:51:00Z false false false De tre typer af forespørgsler kan kombineres i samme kald. Kombinationen af en versions- og en IncludeNonReviewedOnly-angivelse resulterer i løse recept­ordinationer, der beregnes som følger: Receptordinationerne 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 ==== 1111111118 2012-10-05 2012-10-05 true true false ==== Svar ==== Der returneres et medicinkort uden effektueringer, eller eventuelt flere versioner af samme medicinkort. 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 for den pågældende persons aktive CPR-nummer. (se evt. [[fmk:CPR skift]]) Elementet GetMedicineCard­Response 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.4:medicinkort|Medicinkort]]. Rob Müller 1403837853
Magnolievej 842 4 8653 Them
0 ==== Ugyldig-markeret medicinkort ==== Medicinkortet kan være markeret som ugyldigt, se [[..:1.4.2:medicinkort_med_ugyldig-markering]]. ==== Administrativt slettet lægemiddelordination eller receptordination ==== Medicnkortet kan desuden indeholde en eller flere administrativt slettede lægemiddelordinationer og receptordinationer, se [[fmk:1.4.2:ugyldig-markeret_laegemiddelordination_eller_receptordination|Administrativt slettet lægemiddelordination eller receptordination]].