Differences

This shows you the differences between two versions of the page.

--- apo:2.0:laegemiddelordination [2014-06-30 12:06] – tom
+++ apo:2.0:laegemiddelordination [2015-04-10 11:22] (current) – removed bbk
@@ Line 1: / Line 1: @@
-====== Lægemiddelordination ======
-Herunder beskrives XML-skemaet for lægemiddelordinationen, som det anvendes når en lægemiddelordination returneres ved opslag på FMK via apotekssnitflade 2.0.
-XML-skemaet der anvendes ved oprettelse eller opdatering via FMK's 1.4 snitflade til lægesystemer m.v. adskiller sig en smule, og er beskrevet under [[fmk:1.4.2:laegemiddelordination|Lægemiddelordination i FMK's 1.4.2-snitflade]].
-==== Lægemiddelordinations-ID og versionsnummer ====
-Lægemiddelordination-elementet indeholder først en identifikation af lægemiddelordinationen, lægemiddelordination-ID og versionsnummer. Bemærk at versionsnummeret ikke er et fortløbende nummer
-Lægemiddelordinationen indeholder relation til den forrige version af medicinkortet (første version har dog ikke en tidligere version), og historiske versioner indeholder også en relation til den efterfølgende version. Idet der kan forekomme samtidige opdateringer kan der i sjældne tilfælde forekomme flere samtidige versioner for både forrige og næste version.
-Se i øvrigt [[fmk:1.4.2:versionsnummer|Versionsnummer]] for version-elementet og [[fmk:generel:versionsnummerering|Versionsnummerering]] for en generel beskrivelse af versionering i FMK.
-==== Ændret af (Modified) ====
-Elementet Modified indeholder information omkring personen der har oprettet versionen af lægemiddelordinationen, samt tidspunkt.
-Er lægemiddelordinationen ændret siden oprettelsen vil der i Modified-elementet blive returneret information omkring personen der har foretaget ændringen, se [[fmk:1.4.2:modifikator|Modifikator]].
-Modified/DateTime indeholder tidspunktet for seneste ændring, som det er registreret af FMK.
-Der returneres "ændret af" for seneste ændring. Er der sket ændringer mellem oprettelsen og seneste ændring vil disse ikke blive returneret (f.eks. i form af yderligere ”Modified”-elementer), men skal søges i de tidligere versioner. Modified vil kun være knyttet til versionen af lægemiddelordinationen.
-==== Pauseret (Paused) ====
-Såfremt lægemiddelordinationen er pauseret vil "Paused"-element angive dette. Heri kan ses hvilken person der har foretaget pauseringen, og hvornår det er sket.
-Bemærk, at pauserings-elementet er forberedt til at kunne indeholde en startdato eller startdato og tid samt slutdato eller slutdato eller tid. Aktuelt kan der ikke oprettes pauseringer med disse datoer sat, idet det ikke er muligt at returnere disse til klienter der anvender 1.2-snitfladen. Klientsystemer skal dog kunne håndtere at disse felter vil blive taget i brug, også i de eksisterende 1.4.0 og 1.4.2-snitflader.
-Paused/DateTime indeholder tidspunktet for pauseringen, som det er registreret af FMK.
-Det er muligt at opdatere på en pauseret lægemiddelordination. "Paused"-elementet vil blive returneret så længe lægemiddelordinationen er pauseret, dvs. muligvis på flere efterfølgende versioner, indtil pausereringen er ophævet.
-Se i øvrigt [[fmk:generel:laegemiddelordinationens_gyldighedsinterval|Lægemiddelordinationens gyldighedsinterval]].
-==== Seponering (Withdrawn) ====
-Ved opslag på direkte på lægemiddelordinationer kan der også returneres lægemiddelordinationer der er seponerede. Der anvendes samme skema, så disse er også defineret i medicinkortet, men seponerede lægemiddelordinationer vil ikke blive returneret ved oplag på det aktuelle medicinkort, det samme gælder lægemiddelordinationer der er udløbne.
-Withdrawn-elementet er ikke vist i eksemplet herunder.
-Ved oplag på den aktuelle version idet der kun returneres aktuelle lægemiddelordinationer, ved opslag på tidligere versioner, idet de lægemiddelordinationerne kun returneres hvis på dette tidspunkt er aktuelle, og i den form de da havde. Se i øvrigt [[fmk:1.4.2:hent_laegemiddelordination|Hent lægemiddelordination]] og [[fmk:1.4.2:sog_efter_seponerede_laegemiddelordinationer|Søg efter seponerede lægemiddelordinationer]] services.
-Se i øvrigt [[fmk:generel:laegemiddelordinationens_gyldighedsinterval|Lægemiddelordinationens gyldighedsinterval]].
-==== Privatmarkering ====
-Såfremt lægemiddelordinationen er privatmarkeret, og aktøren har fået adgang til at se denne via samtykke eller værdispring, vil lægemiddelordinationen indeholde et PrivacyMarked-element.
-Såfremt aktøren ikke har fået adgang til at se lægemiddelordinationen returnes kun lægemiddelordinationens ID og versionsnummer, se [[fmk:1.4.2:laegemiddelordination_med_privatmarkering|Lægemiddelordination med privatmarkering]].
-==== Lægemiddelordinationens start- og slutdato (BeginEndDate) ====
-Lægemiddelordinationens gyldighedsinterval findes i BeginEndDate-elementet.Der angives lægemiddelordinationens startdato og seponeringsdato, alternativt kan dato og tid angives, eller det kan angives at startdato og seponeringsdato er ukendte.
-Se en beskrivelse heraf i afsnittet [[fmk:generel:laegemiddelordinationens_gyldighedsinterval|Lægemiddelordinationens gyldighedsinterval]].
-Ud fra lægemiddelordinationens gyldighed BeginEndDate og en eventuel forekomst af PausedByStructure kan lægemiddelordinationens aktuelle status udledes. Idet status kan være aktiv f.eks ved afsendelse fra FMK, men få øjeblikke senere ved modtagelsen f.eks. i et EPJ-system være seponeret, idet datoen er ændret, indeholder lægemiddelordination-elementet ingen direkte angivelse af status.
-==== Indikation ====
-Lægemiddelordinationens indikation skal angives, se en beskrivelse under [[fmk:generel:klassifikationer_standarder_og_kildeangivelse#Indikation|Klassifikationer, standarder og kildeangivelse]].
-==== Administrationsvej (RouteOfAdministration) ====
-Der skal angives en administrationsvej. Administrationsvejen er i de fleste tilfælde givet ud fra lægemidlet. Administrationsvejen skal angives ud fra taksten, se afsnittet [[fmk:generel:klassifikationer_standarder_og_kildeangivelse#Administrationsvej|Klassifikationer, standarder og kildeangivelse]].
-==== Lægemiddel (Drug) ====
-Lægemiddelordinationen skal indeholde et lægemiddel. Lægemidlet kan være angivet på flere former, se afsnittet [fmk:1.4.2:laegemiddel|Lægemiddel]].
-For lægemidler der kan slås op i stamdata vil der blive returneret så meget data som haves, dvs. ATC, drugid, navn, form, styrke og aktive substanser. For lægemidler der ikke findes i stamdata returneres der den indsendte information.
-==== Dosering (Dosage) ====
-Der skal angives en dosering på lægemiddelordinationen. I eksemplet er angivet en struktureret dosering, at lægemidlet skal tages dagligt som ”1 tablet morgen og aften ved måltid”. Elementet gennemgås separat i under [[fmk:1.4.2:dosering|Dosering]]. Ved opslag returneres desuden en doseringsoversættelse i elementet DosageTranslation. Se evt. [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse]]
-==== Substitution tilladt (SubstitutionAllowed) ====
-På lægemiddelordinationen kan angives om lægemidlet må substitueres. Dette er specielt relevant når der skal oprettes receptordinationer ud fra lægemiddelordinationen.
-==== Tilskudsklausul ====
-Er patienten og lægemiddelordinationen berettiget til tilskud angives dette på lægemiddelordinationen. På nuværende tidspunkt er kun den faste tekst ”klausulbetingelse opfyldt” tilladt.
-#TODO tilladelser, bestillinger og effeketueringer
-#TODO Udvid PersonIdentifier med erstatnings-... og organisations-ID'er
-#TODO Ændr PrescriptionMedication til Warrant
-#TODO Ændr NegativeConsent til PrivacyMarked