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.

Med det optionelle element NegativeConsent angives at der også ønskes returneret lægemiddel­ordinationer markeret med 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.

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

• Extension 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 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.

FMK 1.4.4.E1 udvider Hent medicinkort med en række nye informationer. Extensions er udvidelser af eksisterende snitflader.

• Information om dosis dispenderede effektueringer vil i blive returneret som en del af svaret.

• Information om eksisterende receptanmodninger vil i blive returneret som en del af svaret.

• Datoer på indlæggelses- og henvisningsmarkeringer vil i blive returneret som en del af svaret.

• Ny parameter til hentning af 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.

I 1.4.4.E2 er det desuden muligt at vælge hvilke 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.

I 1.4.4.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 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 nye service i E4.

Ønskes der en tidligere version af medicinkortet kan der forespørges ud fra versionsnummer. Forespørges der på en version der ikke findes (dvs. med en højere værdi en den aktuelle version) vil kaldet fejle.

<GetMedicineCardRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<Version>133283328800420001</Version>
	<IncludePrescriptionMedications>false</IncludePrescriptionMedications>
	<IncludeEffectuations>false</IncludeEffectuations>
	<IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications>
</GetMedicineCardRequest>

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.

<GetMedicineCardRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<DateTime>2012-03-28T09:51:00Z</DateTime>
	<IncludePrescriptionMedications>false</IncludePrescriptionMedications>
	<IncludeEffectuations>false</IncludeEffectuations>
	<IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications>
</GetMedicineCardRequest>

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 Historik

GetMedicineCardRequest.xml

<GetMedicineCardRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <NegativeConsent>
        <ConsentGiven>
            <FromDate>2012-10-05</FromDate>
            <ToDate>2012-10-05</ToDate>
        </ConsentGiven>
    </NegativeConsent>
    <IncludePrescriptionMedications>true</IncludePrescriptionMedications>
    <IncludeEffectuations>true</IncludeEffectuations>
    <IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications>
</GetMedicineCardRequest>

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. 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 Medicinkort og Lægemiddelordination.

Eksemplet herunder viser et tomt medicinkort. For et udfyldt eksempel se Medicinkort.

GetMedicineCardResponse-Minimal.xml

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Rob</GivenName>
                    <Surname>Müller</Surname>
                </Name>
                <PersonIdentifier>1403837853</PersonIdentifier>
            </Person>
            <Address>
                <StreetName>Magnolievej</StreetName>
                <StreetBuildingIdentifier>842</StreetBuildingIdentifier>
                <FloorIdentifier>4</FloorIdentifier>
                <PostCodeIdentifier>8653</PostCodeIdentifier>
                <DistrictName>Them</DistrictName>
            </Address>
        </Patient>
        <Version>0</Version>
    </MedicineCard>
</GetMedicineCardResponse>

Medicinkortet kan være markeret som ugyldigt, se medicinkort_med_ugyldig-markering.

Medicnkortet kan desuden indeholde en eller flere administrativt slettede lægemiddelordinationer og receptordinationer, se Administrativt slettet lægemiddelordination eller receptordination.