Servicen “Hent lægemiddelordination” henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde receptordinationer og effektueringer på lægemiddelordinationen. En lægemiddelordination har et unikt ID, lægemiddelordinations-ID eller DrugMedicationIdentifier, som tildeles af FMK, og som anvendes ved opslag direkte på lægemiddelordinationen.
Eksemplet viser en forespørgsel efter seneste version af lægemiddelordinationer. For at sikre at alle lægemiddelordinationer hører til samme medicinkort medsendes patientens CPR-nummer.
<GetDrugMedicationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <Identifier>1221231331123</Identifier> <NegativeConsent> <ConsentGiven> <FromDate>2012-10-05</FromDate> <ToDate>2012-10-05</ToDate> </ConsentGiven> </NegativeConsent> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
Detaljer om hvad der returneres i historiske kald, findes på siden Historik
Med det optionelle element NegativeConsent angives at såfremt en eller flere af lægemiddelordinationerne er markeret med privatmarkering sker forespørgselen af en af to årsager, disse angives ved anvendelse af en af de to XML-elementer:
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.
Det er muligt at angive samtykke ved anvendelse af ConsentHeader. I dette tilfælde tilføjes en SOAP header til requesten med følgende indhold i ConsentType elementet:
Benyttes ConsentHeader er det ikke muligt samtidigt at anvende NegativeConsent elementet (kaldet vil fejle).
Bemærk: For snitfladeversioner 1.4.6 og senere er det udelukkende muligt at gøre brug af ConsentHeader i forbindelse med angivelse af samtykke, idet NegativeConsent elementet er fjernet i skemaerne fra og med denne version.
Request-dokumentet indeholder to felter til angivelse af, hvad der ønskes returneret i responset, ud over data direkte på lægemiddelordinationen:
Ønskes der en tidligere version af lægemiddelordinationen kan der forespørges ud fra versionsnummer.
<GetDrugMedicationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IdentifierAndVersion> <Identifier>1221231331123</Identifier> <Version>1341404077658001001</Version> </IdentifierAndVersion> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
Endeligt kan der forespørges efter lægemiddelordinationen som det så ud på et givent tidspunkt, dvs. med et tidsstempel.
<GetDrugMedicationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IdentifierAndDateTime> <Identifier>1221231331123</Identifier> <DateTime>2012-07-04T08:34:44Z</DateTime> </IdentifierAndDateTime> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
De tre typer af forespørgsler kan kombineres i samme kald.
Der returneres et eller flere lægemiddelordinationer, samt tilhørende data som angivet i forespørgselen. Dog kan PersonIdentifier være udskiftet med personens aktive CPR-nummer. (se evt. CPR skift)
Herunder vises et svar med en lægemiddelordination.
<GetDrugMedicationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <DrugMedication> <Identifier>13143641280998</Identifier> <Version>1341404071666006001</Version> <PreviousVersion>1341404070012003001</PreviousVersion> <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier> <Name>Tess Christoffersen</Name> <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </By> <DateTime>2013-11-19T09:30:47.0Z</DateTime> </Created> <ReportedBy> <Other> <Name> <GivenName>Anne</GivenName> <Surname>Andersen</Surname> </Name> </Other> <Role>Assistent for Læge</Role> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </ReportedBy> <Paused> <FromDate>2013-11-18</FromDate> <ToDate>2013-11-19</ToDate> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>VQDZR</AuthorisationIdentifier> <Name>Godfred Damgård</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </By> <DateTime>2013-11-18T15:51:12.0Z</DateTime> </Paused> <HasNegativeConsent/> <FollowUpDates> <Date>2014-05-15</Date> <Date>2014-05-29</Date> <Date>2014-06-12</Date> </FollowUpDates> <BeginEndDate> <TreatmentStartDate>2013-11-18</TreatmentStartDate> <TreatmentEndDate>2013-11-30</TreatmentEndDate> </BeginEndDate> <Indication> <Code source="Medicinpriser" date="2013-11-18">121</Code> </Indication> <RouteOfAdministration> <Code source="Medicinpriser" date="2013-11-18">OR</Code> </RouteOfAdministration> <Drug> <ATC> <Code source="Medicinpriser" date="2012-08-06">J01CE02</Code> <Text>Phenoxymethylpenicillin</Text> </ATC> <Identifier source="Medicinpriser" date="2012-08-06">28100902676</Identifier> <Name>Primcillin</Name> <Form> <Code source="Medicinpriser" date="2012-08-06">TABFILM</Code> <Text>filmovertrukne tabletter</Text> </Form> <Strength> <Value>250.0</Value> <UnitCode source="Medicinpriser" date="2012-08-06">MG</UnitCode> <UnitText>mg</UnitText> <Text source="Medicinpriser" date="2012-08-06">250 mg</Text> </Strength> <Substances> <ActiveSubstance> <SubstanceText source="Medicinpriser" date="2012-08-06">Phenoxymethylpenicillinkalium</SubstanceText> </ActiveSubstance> </Substances> </Drug> <Dosage> <Structures> <UnitText source="Local">tablet</UnitText> <Structure> <IterationInterval>1</IterationInterval> <StartDate>2013-11-18</StartDate> <EndDate>2013-11-30</EndDate> <Day> <Number>1</Number> <Dose> <Time>morning</Time> <Quantity>2</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>2</Quantity> </Dose> </Day> <DosageTranslation> <ShortText>1 tablet morgen og aften</ShortText> <LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag: Doseringsforløb: 1 tablet morgen og aften</LongText> <AverageDailyDosage>2</AverageDailyDosage> </DosageTranslation> </Structure> </Structures> <Type>temporær</Type> </Dosage> <SubstitutionAllowed>true</SubstitutionAllowed> <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause> </DrugMedication> </GetDrugMedicationResponse>
Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet …Privatmarkering, returneres kun id og versionsid:
<GetDrugMedicationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <DrugMedicationWithNegativeConsent> <Identifier>13143641280998</Identifier> <Version>1341404071666006001</Version> </DrugMedicationWithNegativeConsent> </GetDrugMedicationResponse>
Endelig kan lægemiddelordinationen være administrativt slettet, i så fald returneres kun id i InvalidDrugMedication.
<GetDrugMedicationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <InvalidDrugMedication> <Identifier>13143641280998</Identifier> </InvalidDrugMedication> </GetDrugMedicationResponse>