Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » apo » 2.0 » hent_laegemiddelordination
apo:2.0:hent_laegemiddelordination

This is an old revision of the document!

Table of Contents

Hent lægemiddelordination

Når borgeren henvender sig på apoteket vil apotekssystemet normalt foretage et opslag via Hent medicinkort, og ad den vej få returneret lægemiddelordinationer + tilladelser samt evt. bestillinger, hvorfra der kan udleveres på et apotek.

For bestilte lægemiddelordinationer vil apotekssystemet med jævne mellemrum kunne hente lægemiddelordinationer + tilladelser hvor der findes bestillinger til det pågældende apotek, via servicen Hent til apotek. Derved kan apotekssystemet foretage filtreringer, checke lagerstatus m.v. En efterfølgende manuel arbejdsgang vil kræve at brugeren slår op på FMK med sit medarbejdercertifikat, således at brugerens adgang til data kan checkes og logges.

Apoteket kan modtage en advis om at der er sket en handling på lægemiddelordinationen, og derved slå op. F.eks. når der substitueres og dosispakkes på pakkeapoteket.

Endeligt kan der være behov for at slå op på nye versioner af lægemiddelordination + tilladelse, f.eks. ved ændringer kort tid forinden ekspeditionstidspunktet, der medfører en advarsel ved ekspedition.

Opslag på tidligere versioner kan være nødvendige i forbindelse med fejlrettelser.

Servicen “Hent lægemiddelordination” henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde receptordinationer og effektueringer på lægemiddel­ordinationen. En lægemiddelordination har et unikt ID, lægemiddel­ordinations-ID eller Drug­Medication­Identifier, som tildeles af FMK, og som anvendes ved opslag direkte på lægemiddel­ordinationen.

Forespørgsel

Simpelt opslag

I det simple og almindelige tilfælde forespørges med CPR-nummer (alternativt medicinkortets nøgle) samt en eller flere lægemiddelordinations-ID'er.

GetDrugMedicationRequest-Simple.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationRequest.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
</GetDrugMedicationRequest>

Opslag på privatmarkerede data

Med det optionelle element PrivacyMarkedConsentGiven angives at, såfremt en eller flere af læge­middel­ordinationerne er privatmarkeret, sker forespørgselen af efter mundtlig eller skriftlig samtykke.

Denne typer af forespørgsel vil blive logget specielt. I kaldet angives i hvilket datointerval dette samtykke sker (f.eks. kun denne dag eller to år i forbindelse med dosisdispensering). Værdien kan evt. anvendes i forbindelse med opfølgning på logdata.

Bemærk at opslag “nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten” ikke er mulig via apotekssnitfladen.

GetDrugMedicationRequest-PrivacyMarked.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationRequest.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
	<PrivacyMarkedConsentGiven/>
</GetDrugMedicationRequest>

Opslag på lægemiddelordinationer der aktuelt ikke kan udleveres ud fra

Ved opslag på lægemiddelordinationer vil der normalt forud være sket et opslag på Hent medicinkort (eller for bestilte lægemiddelordinationer + tilladelser et kald til Hent til apotek). Dette er normalt en forudsætning for at lægemiddelordinationens ID kendes. Ved opslag på “det komplette medicinkort”, dvs. inklusiv lægemiddelordinationer der ikke aktuelt kan udleveres ud fra på apoteket, skal der angives at borgeren har givet samtykke hertil.

Ved et efterfølgende opslag på lægemiddelordinationen ud fra et allerede kendt lægemiddelordinations-ID kan der fortsat angives såfremt borgeren har givet samtykke til at se lægemiddelordinationer der ikke aktuelt kan udleveres ud fra.

GetDrugMedicationRequest-Complete.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationRequest.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
	<CompleteConsentGiven/>
</GetDrugMedicationRequest>

(Se i øvrigt afklaring Opslag på lægemiddelordinations-ID og samtykke)

Forespørgsel på tidligere versioner

Ønskes der en tidligere version af lægemiddelordinationen kan der forespørges ud fra versionsnummer.

GetDrugMedicationRequest-WithVersion.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationRequest.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<IdentifierAndVersion>
		<Identifier>1341404068462002004</Identifier>
		<Version>1341404071912001002</Version>
	</IdentifierAndVersion>
</GetDrugMedicationRequest>

Endeligt kan der forespørges efter lægemiddelordinationen som den så ud på et givent tidspunkt, dvs. med et tidsstempel.

GetDrugMedicationRequest-WithDateTime.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationRequest.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<IdentifierAndDateTime>
		<Identifier>1341404068462002004</Identifier>
		<DateTime>2014-05-01T08:00:00</DateTime>
	</IdentifierAndDateTime>
</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.

Herunder vises et svar med en enkelt lægemiddelordination.

GetDrugMedicationResponse.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationResponse 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetDrugMedicationResponse.xsd" 
	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:m13="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 	
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<DrugMedication>
		<Identifier>13143641280998</Identifier>
		<Version>1341404071666006001</Version>
		<PreviousVersion>1341404070012003001</PreviousVersion>
		<Created>
			<m13:By>
				<m13:AuthorisedHealthcareProfessional>
					<m12:AuthorisationIdentifier>2Q5TK</m12:AuthorisationIdentifier>
					<m12:Name>Tess Christoffersen</m12:Name>
					<m12:SpecialityCode source="Medicinpriser" date="2014-11-18">PSYK</m12:SpecialityCode>
				</m13:AuthorisedHealthcareProfessional>
				<m13:Organisation>
					<m12:Name>Lægerne Vestergade</m12:Name>
					<m12:AddressLine>Vestergade 2</m12:AddressLine>
					<m12:AddressLine>8660 Skanderborg</m12:AddressLine>
					<m12:TelephoneNumber>86521348</m12:TelephoneNumber>
					<m12:EmailAddress>kontakt@laegernevestergade.dk</m12:EmailAddress>
					<m12:Type>Yder</m12:Type>
					<m12:Identifier source="Yder">66974</m12:Identifier>
				</m13:Organisation>
			</m13:By>
			<m13:DateTime>2014-11-19T09:30:47.0Z</m13:DateTime>
		</Created>
		<BeginEndDate>
			<m12:TreatmentStartDate>2014-11-18</m12:TreatmentStartDate>
			<m12:TreatmentEndDate>2014-11-30</m12:TreatmentEndDate>
		</BeginEndDate>
		<Indication>
			<m12:Code source="Medicinpriser" date="2014-11-18">121</m12:Code>
			<m12:Text>mod mellemørebetændelse</m12:Text>
		</Indication>
		<RouteOfAdministration>
			<m12:Code source="Medicinpriser" date="2014-11-18">OR</m12:Code>
			<m12:Text>oral anvendelse</m12:Text>
		</RouteOfAdministration>
		<Drug>
			<m13:ATC>
				<m12:Code source="Medicinpriser" date="2014-11-18">J01CE02</m12:Code>
				<m12:Text>Phenoxymethylpenicillin</m12:Text>
			</m13:ATC>
			<m13:Identifier source="Medicinpriser" date="2014-11-18">28100902676</m13:Identifier>
			<m13:Name>Primcillin</m13:Name>
			<m13:Form>
				<m12:Code source="Medicinpriser" date="2014-11-18">TABFILM</m12:Code>
				<m12:Text>filmovertrukne tabletter</m12:Text>
			</m13:Form>
			<m13:Strength>
				<m13:Value>250.0</m13:Value>
				<m13:UnitCode source="Medicinpriser" date="2014-11-18">MG</m13:UnitCode>
				<m13:UnitText>mg</m13:UnitText>
				<m13:Text source="Medicinpriser" date="2014-11-18">250 mg</m13:Text>
			</m13:Strength>
			<m13:Substances>
				<m13:ActiveSubstance>
					<m13:SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium</m13:SubstanceText>
				</m13:ActiveSubstance>
			</m13:Substances>
		</Drug>
		<Dosage>
			<m13:Structures>
				<m13:UnitTexts source="Doseringsforslag">
					<m12:Singular>tablet</m12:Singular>
					<m12:Plural>tabletter</m12:Plural>
				</m13:UnitTexts>
				<m13:Structure>
					<m13:IterationInterval>1</m13:IterationInterval>
					<m13:StartDate>2014-11-18</m13:StartDate>
					<m13:EndDate>2014-11-30</m13:EndDate>
					<m13:Day>
						<m12:Number>1</m12:Number>
						<m12:Dose>
							<m12:Time>morning</m12:Time>
							<m12:Quantity>2</m12:Quantity>
						</m12:Dose>
						<m12:Dose>
							<m12:Time>evening</m12:Time>
							<m12:Quantity>2</m12:Quantity>
						</m12:Dose>
					</m13:Day>
					<m13:DosageTranslation>
						<m13:ShortText>1 tablet morgen og aften</m13:ShortText>
						<m13:LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag:
   Doseringsforløb:
   1 tablet morgen og aften</m13:LongText>
						<m13:AverageDailyDosage>2</m13:AverageDailyDosage>
					</m13:DosageTranslation>
				</m13:Structure>
			</m13:Structures>
			<m13:Type>temporær</m13:Type>
		</Dosage>
		<Warrant>
			<Identifier>1341404068848001001</Identifier>
			<Version>1341404068848001001</Version>
			<ValidToDate>2014-11-30</ValidToDate>
			<PackageRestriction>
				<PackageNumber source="Medicinpriser">2917</PackageNumber>
				<PackageSize>
					<Value>30</Value>
					<UnitCode source="Medicinpriser">stk</UnitCode>
				</PackageSize>
				<PackageQuantity>1</PackageQuantity>
				<DosageText>1 tablet morgen og aften</DosageText>
			</PackageRestriction>
		</Warrant>
	</DrugMedication>
</GetDrugMedicationResponse>

Privatmarkering

Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet at opslaget sker efter mundtlig eller skriftlig samtykke fra borgeren Privatmarkering, returneres kun id og versionsid:

#TODO: Root-namepspace skal rettes

GetDrugMedicationResponse-NegativeConsent.xml
<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationResponse 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01" 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01 	
		../../../../etc/schemas/2013/06/01/GetDrugMedicationResponse.xsd" 
	xmlns:medicinecard20120601="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<DrugMedicationWithNegativeConsent>
		<m12:Identifier>13143641280998</m12:Identifier>
		<m12:Version>1341404071666006001</m12:Version>
	</DrugMedicationWithNegativeConsent>
</GetDrugMedicationResponse>

Administrativt slettet lægemiddelordination

Endelig kan lægemiddelordinationen være administrativt slettet, i så fald returneres kun id i InvalidDrugMedication.

#TODO: Root-namepspace skal rettes

GetDrugMedicationResponse-Invalid.xml
/<?xml version="1.0" encoding="UTF-8"?>
<GetDrugMedicationResponse 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01" 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01 	
		../../../../etc/schemas/2013/06/01/GetDrugMedicationResponse.xsd" 
	xmlns:medicinecard20120601="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<InvalidDrugMedication>
		<Identifier>13143641280998</Identifier>
	</InvalidDrugMedication>
</GetDrugMedicationResponse>
apo/2.0/hent_laegemiddelordination.1401266272.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki