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 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.
Forespørgsel
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
Privatmarkering
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:
- 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.
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:
- <ConsentType>PrivateDataConsentOverridden</ConsentType>
- <ConsentType>PrivateDataConsentGiven</ConsentType>
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.
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:
- IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordinationer 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> <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.
Svar
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.xml
<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>
Privatmarkering
Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet …Privatmarkering, returneres kun id og versionsid:
- GetDrugMedicationResponse-NegativeConsent.xml
<GetDrugMedicationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <DrugMedicationWithNegativeConsent> <Identifier>13143641280998</Identifier> <Version>1341404071666006001</Version> </DrugMedicationWithNegativeConsent> </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>1111111118</PersonIdentifier> <InvalidDrugMedication> <Identifier>13143641280998</Identifier> </InvalidDrugMedication> </GetDrugMedicationResponse>