Differences

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

--- apo:2.0:laegemiddelordination [2014-07-01 08:13] – [Lægemiddel (Drug)] 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:generel:versionsnummerering|Versionsnummerering]] for en generel beskrivelse af versionering i FMK.
-==== Oprettet af (Created) ====
-Created-elementet indeholder information omkring aktøren der har oprettet lægemiddelordinationen. Dette element er obligatorisk. Bemærk at lægemiddelordinationen kan være oprettet af en person der ikke er autoriseret sundhedsperson, såfremt personens rolle der giver rettighed hertil og arbejder på vegne af en autoriseret sundhedsperson. Dvs. at elementet under Created/By ikke nødvendigvis indeholder er AuthorisedHealthcareProfessional. Se [[fmk:1.4.2:modifikator|Modifikator]].
-Created/DateTime-elementet indeholder tidspunktet for lægemiddelordinationens oprettelse, som det er registreret af FMK.
-"Oprettet af" vil blive registreret ved oprettelse af lægemiddelordinationen, og information omkring "oprettet af" person, organisation og tidspunkt vil blive returneret på samtlige efterfølgende versioner af lægemiddelordinationen.
-==== Indrapporteret af (ReportedBy) ====
-Elementet ReportedBy indeholder information omkring personen der har indrapporteret versionen af lægemiddelordinationen til FMK, dvs. "certifikatejer".
-Elementet er ikke vist i eksemplet herunder, og vil ikke altid forekomme, se [[fmk:1.4.2:modifikator|Modifikator]].
-ReportedBy vil, såfremt det findes, kun være knyttet til versionen af lægemiddelordinationen.
-==== Æ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 datoer datoer__, 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.*-snitflader og i apotekssnitflade 2.0.
-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.
-Ved opslag på det aktuelle medicinkort vil seponerere og udløbne lægemiddelordinationer ikke blive returneret. Vil opslag på historiske versioner af medicinkortet vil lægemiddelordinationerne blive returneret som de så ud i versionen eller på datoen, dvs. lægemiddelordinationerne vil her heller ikke være seponerede eller udløbne.
-Der anvendes samme skema, så disse er også defineret i medicinkortet, men seponerede lægemiddelordinationer vil ikke blive returneret ved
-Ved opslag på lægemiddelordinationer vil seponerede lægemiddelordinationer indeholde et Withdrawn-element. Dette er ikke vist i eksemplet herunder. Bemærk at lægemiddelordinationer der er udløbne (dvs. har passeret [[fmk:generel:laegemiddelordinationens_gyldighedsinterval#laegemiddelordinationens_seponeringsdato|lægemiddelordinationens seponeringsdato]]) ikke vil indeholde et Withdrawn-element.
-Se i øvrigt [[apo:2.0:hent_laegemiddelordination#opslag_pa_laegemiddelordinationer_der_aktuelt_ikke_kan_udleveres_ud_fra|Hent lægemiddelordination, Opslag på lægemiddelordinationer der aktuelt ikke kan udleveres ud fra]] samt  [[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 [[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]] og [[fmk:generel:indikation|Indikation]].
-==== 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]] og [[fmk:generel:administrationsvej|Administrationsvej]].
-==== 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