Table of Contents
Hent lægemiddelordination
Servicen “Hent lægemiddelordination” henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde recepter, bestillinger 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.
Forespørgsel
Eksemplet viser en forespørgsel efter seneste version af en lægemiddelordination (forespørgslen kan alternativt udpege en liste af lægemiddelordinations-ID'er). For at sikre at alle lægemiddelordinationer hører til samme medicinkort medsendes patientens CPR-nummer.
- GetDrugMedicationRequest-minimal.xml
<GetDrugMedicationRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Identifier>1221231331123</Identifier> <IncludePrescriptions>false</IncludePrescriptions> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
Privatmarkering
Via ConsentHeader 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 ConsentType elementer:
- 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.
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.
Valg af indhold i response
Request-dokumentet indeholder to felter til angivelse af, hvad der ønskes returneret i responset, ud over data direkte på lægemiddelordinationen:
- IncludePrescriptions: Såfremt elementet sættes til true vil svaret indeholde eventuelle recepter knyttet til lægemiddelordinationen.
- IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektueringer på lægemiddelordinationen.
Forespørgsel på tidligere versioner
Ønskes der en tidligere version af lægemiddelordinationen kan der forespørges ud fra versionsnummer.
- GetDrugMedicationRequest-IdAndVersion.xml
<GetDrugMedicationRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <IdentifierAndVersion> <Identifier>1221231331123</Identifier> <Version>1341404077658001001</Version> </IdentifierAndVersion> <IncludePrescriptions>false</IncludePrescriptions> <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-IdAndDate.xml
<GetDrugMedicationRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <IdentifierAndDateTime> <Identifier>1221231331123</Identifier> <DateTime>2012-07-04T08:34:44Z</DateTime> </IdentifierAndDateTime> <IncludePrescriptions>false</IncludePrescriptions> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
De tre typer af forespørgsler kan kombineres i samme kald.
Detaljer om hvad der returneres i historiske kald, findes på siden Historik
Svar
Der returneres et eller flere lægemiddelordinationer, samt tilhørende data som angivet i forespørgslen.
Herunder vises et svar med en lægemiddelordination, se Lægemiddelordination for flere detaljer.
- GetDrugMedicationResponse.xml
<GetDrugMedicationResponse> <PersonIdentifier source="CPR">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="2014-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>2014-11-19T09:30:47.0Z</DateTime> </Created> <FollowUpDates> <Date>2014-05-15</Date> <Date>2014-05-29</Date> <Date>2014-06-12</Date> </FollowUpDates> <BeginEndDate> <TreatmentStartDate>2014-11-18</TreatmentStartDate> <TreatmentEndDate>2014-11-30</TreatmentEndDate> </BeginEndDate> <Indication> <Code source="Medicinpriser" date="2014-11-18">121</Code> <Text>mod mellemørebetændelse</Text> </Indication> <RouteOfAdministration> <Code source="Medicinpriser" date="2014-11-18">OR</Code> <Text>oral anvendelse</Text> </RouteOfAdministration> <Drug> <ATC> <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code> <Text>Phenoxymethylpenicillin</Text> </ATC> <Identifier source="Medicinpriser" date="2014-11-18">28100902676</Identifier> <Name>Primcillin</Name> <Form> <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code> <Text>filmovertrukne tabletter</Text> </Form> <Strength> <Value>250.0</Value> <UnitCode source="Medicinpriser" date="2014-11-18">MG</UnitCode> <UnitText>mg</UnitText> <Text source="Medicinpriser" date="2014-11-18">250 mg</Text> </Strength> <Substances> <ActiveSubstance> <SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium</SubstanceText> </ActiveSubstance> </Substances> </Drug> <Dosage> <!-- Bemærk fra og med Extension E2 vil UnitText(s) elementer ikke have en source attribut --> <UnitTexts source="Local"> <Singular>tablet</Singular> <Plural>tabletter</Plural> </UnitTexts> <StructuresFixed> <Structure> <IterationInterval>1</IterationInterval> <StartDate>2014-11-18</StartDate> <EndDate>2014-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> </StructuresFixed> <Type>fast</Type> </Dosage> <Prescription> <Identifier>21298478</Identifier> <AttachedToDrugMedicationIdentifier>13143641280998</AttachedToDrugMedicationIdentifier> <CreatedFromDrugMedicationVersion>1341404071666006001</CreatedFromDrugMedicationVersion> <OrderedEffectuationIdentifier>21297322</OrderedEffectuationIdentifier> <AuthorisationDateTime>2012-03-29T09:30:47.0Z</AuthorisationDateTime> <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> <LatestEffectuationDateTime>2013-11-20T15:59:12.0Z</LatestEffectuationDateTime> <TerminatedDateTime>2013-11-20T15:59:12.0Z</TerminatedDateTime> <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause> <ValidFromDate>2013-11-19Z</ValidFromDate> <ValidToDate>2015-11-19Z</ValidToDate> <PackageRestriction> <PackageNumber source="Medicinpriser" date="2012-02-06">84194</PackageNumber> <PackageQuantity>1</PackageQuantity> </PackageRestriction> <Indication> <Code source="Medicinpriser" date="2011-04-09">122</Code> <Text>mod halsbetændelse</Text> </Indication> <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> <DosageText>1 tablet morgen og aften ved måltid</DosageText> <SubstitutionAllowed>true</SubstitutionAllowed> <Status>åben</Status> </Prescription> </DrugMedication> </GetDrugMedicationResponse>
Privatmarkering
Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet Privatmarkering, returneres kun id og versionsid:
- GetDrugMedicationResponse-PrivateDrugMedication.xml
<GetDrugMedicationResponse> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <PrivateDrugMedication> <Identifier>13143641280998</Identifier> <Version>1341404071666006001</Version> </PrivateDrugMedication> </GetDrugMedicationResponse>
Administrativt slettet lægemiddelordination
Endelig kan lægemiddelordinationen være administrativt slettet, i så fald returneres kun id i InvalidDrugMedication.
- GetDrugMedicationResponse-Invalid.xml
<GetDrugMedicationResponse> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <InvalidDrugMedication> <Identifier>13143641280998</Identifier> </InvalidDrugMedication> </GetDrugMedicationResponse>