====== Hent medicinkort ====== Servicen ”Hent medicinkort” returnerer et eller flere medicinkort med tilknyttede aktive læge­middel­ordinationer, og - afhængigt at de medsendte parametre, også 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 ==== Ved hjælp af en valgfri ConsentHeader angives at der også ønskes returneret lægemiddel­ordinationer 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. * ''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. I version 1.2.x af snitfladen var det kun nødvendigt at specificere samtykke é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 samtykke specificeres 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.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 Include­Prescription­Medications 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 ==== Ø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 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 ==== 2012-10-05 2012-10-05 PrivateDataConsentGiven MedicineCard 1111111118 true true false ==== Opslag ud fra CPR-nummer, med samtykke til at se samtlige lægemiddelordinationer ==== Apoteker kan foretage opslag på medicinkort med samtlige aktuelle lægemiddelordination + evt. recepter og bestillinger, også hvor der ikke aktuelt kan ekspederes på apoteket. Dette skal i så fald ske med markering i samtykkeheaderen af, at borgeren har givet samtykke til at se hele medicinkortet. Borgeren kan give samtykke til dette eksempelvis i forbindelse med vejledning eller interaktionskontrol på hele medicinkortet. MedicineReviewConsent MedicineCard 1111111118 true true true Det er kun apoteker-rollen, som skal inkludere MedicineReviewConsent i samtykkeheaderen, da andre roller pr. default har adgang til at se det fulde medicinkort. Denne type af opslag kan også kombineres med at borgeren har givet samtykke til at se privatmarkerede data også (hvilket ikke er vist i eksemplet). Her angives et ekstra element under elementet med eksempelvis et PrivateDataConsentGiven element samt et datointerval. ==== 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. 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.6:medicinkort|Medicinkort]]. Rob Müller 1403837853 1973-02-01 male
Magnolievej 842 4 8653 Them
0 true true ==== Ugyldig-markeret medicinkort ==== Medicinkortet kan være markeret som ugyldigt, se [[fmk:1.4.2:Medicinkort med ugyldig-markering]]. ==== Administrativt slettet lægemiddelordination eller recept ==== 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: ... 2016-06-20 2016-07-03 2016-06-17T13:30:00Z Anne Andersen Apoteksansat Skanderborg Apotek Adelgade 27 8660 Skanderborg Apotek 5790000170609 true Århus Jernbane Apotek Banegårdsplads 8 8000 Århus Apotek 5790000171323 ==== Seponerede ordinationer ==== Det er muligt at angive, at ordinationer seponeret fra en given dato ønskes inkluderet i medicinkortet. Hvis angivet i opslaget, vil recepter og effektueringer for de seponerede ordinationer også blive fremsøgt. 1111111118 false false false 2013-11-19T09:30:47.0Z