Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Klassifikationer, standarder og kildeangivelse ======

For at kunne anvende fælles stamdata er det nødvendigt at disse angives efter fælles klassifikationer og standarder. Stamdata der anvendes i FMK er gennemgået i de følgende afsnit. 

Fra og med FMK 1.4.0 skal der i de fleste tilfælde når stamdata anvendes angives hvilken kilde der er anvendt. Også i de tilfælde hvor der aktuelt kun er en kilde, skal kilden angives. Dette sikrer at der i fremtiden kan introduceres nye stamdatakilder. Det er derfor nødvendigt at klientsystemer kan håndtere ukendte stamdatakilder. 

Kilde til stamdata angives i "source"-attributten til elementer med ID, kode m.v. 

===== Kilde Medicinpriser, takster og takstversioner =====

I de tilfælde hvor kilden er "Medicinpriser" (dvs. taksten) skal der i 1.4.X altid angives en takst-version i "date"- eller alternativt "yearAndWeek"-attributten. Datoen svarer takstens ikrafttrædelsesdato. Alternativt kan systemer der kun anvender de ordinære takster, som udkommer planmæssigt hver 14. dag, angive årstal og gældende takstuge, som angivet i filen system.txt. Årstal og ugenummer bliver af FMK konverteret til datoen for den første takst denne uge. I data returneret fra FMK vil takstdatoen blive returneret, også selv om der er angivet årstal og ugenummer. __Angivelse af den eksakte takstdato skal anvendes, med mindre systemet ikke har information herom__. Eksemplerne herunder viser de to varianter:

<code xml>

<Indication>
	<Code source="Medicinpriser" date="2012-02-11">123</Code>
	<Text>Mod lungebetændelse</Text>
</Indication>

</code>

<code xml>

<Indication>
	<Code source="Medicinpriser" yearAndWeek="2012-06">123</Code>
	<Text>Mod lungebetændelse</Text>
</Indication>

</code>

Når der i dokumentationen henvises til LMS01, LMS02, ... henvises der til at Taksten består af en række filer, der er navngivet lms01.txt, lms02.txt, ...

I FMK 1.4.0, 1.4.2 og 1.4.4 er der af hensyn til bagudkompatibilitet til 1.2.6 foreløbigt stadigt krævet at koder fra taksten stammer fra samme takstversion (f.eks. indikation, administrationsvej, enheder, ...). Derimod er der mulighed for at der for et lægemiddel henvises til en anden takstversion. Typisk anvendes dette hvor kodesæt fra seneste takst er indlæst i systemet, men hvor der skal oprettes/opdateres ud fra en ældre lægemiddelordination.

I FMK 1.6.0 kan takst-version i "date" eller "yearAndWeek" undlades, og i så fald vil FMK opføre sig som om "date" er sat til dags dato.

===== Kilde Magistrel =====

I de tilfælde hvor kilden er "Magistrel" (dvs. de magistrelle lægemidler) kan det valgfrit vælges om der angives en dato i "date"- eller alternativt "yearAndWeek"-attributten. Det anbefales dog at man undlader at angive en dato, da FMK så i stedet vil benytte datoen & tidspunkt hvor forespørgslen finder sted til eventuelle valideringer, og der valideres derfor så også mod det seneste kendte datasæt som FMK har til rådighed på det pågældne tidspunkt, frem for det datasæt som FMK kender fra starten af den dato som findes i date/yearAndWeek attributten. 

**Bemærk:** Da stamdata for de magistrelle stamdata importeres mere dynamisk en stamdata fra taksten (medicinpriser), vil det ikke være muligt at benytte nye stamdata som er blevet tilgængelige samme dag, medmindre date/yearAndWeek attributten unlades, da date/yearAndWeek benyttes tidspunktet 00:00 på den pågældende dag som tidspunkt, hvorimod ved unladelsen af disse attributter benyttes det aktuelle tidspunkt hvor forespørgslen finder sted.

<code xml>
<RouteOfAdministration>
	<Code source="Magistrel">OR</Code>
	<Text>Oral anvendelse</Text>
</RouteOfAdministration>
</code>

<code xml>
<RouteOfAdministration>
	<Code source="Magistrel" date="2012-02-11">OR</Code>
	<Text>Oral anvendelse</Text>
</RouteOfAdministration>
</code>

<code xml>
<RouteOfAdministration>
	<Code source="Magistrel" yearAndWeek="2012-06">OR</Code>
	<Text>Oral anvendelse</Text>
</RouteOfAdministration>
</code>

Bemærk: source Magistrel har ikke samme datagrundlag som Medicinpriser, kan derfor ikke anvedes på følgende kliniske stamdata: Indikationer, Form eller Pakkestørrelse


===== Stamdata på NSP'en =====

Stamdata er tilgængelig på stamdatamodulet på NSP'en. 

En oversigt over typer af stamdata findes på siden
https://www.nspop.dk/pages/viewpage.action?pageId=28872117
. Bemærk at Medicinpriser findes i registret "dkma". 


===== Håndtering af inkonsistente stamdataangivelser =====

I det tilfælde hvor der angives en kode og en fritekst for et givet sæt af stamdata og der ikke er konsistens mellem disse, vil friteksten blive gemt sammen med koden. Ved efterfølgende visninger vil stamdata blive fremsøgt ud fra koden, og kan således potentielt afvige fra den indtastede fritekstværdi.

===== Kliniske stamdata =====

Kliniske stamdata anvendt i FMK er:

  * [[Administrationsvej]]
  * [[Aktive substanser]]
  * [[ATC]]
  * [[Doseringsenhed]]
  * [[Form]] (lægemiddelform)
  * [[Indikation]]
  * [[Styrke]] (lægemiddelstyrke)
  * [[Type af effektuering]]
  * [[Pakningsstørrelse]]

===== Øvrige stamdata =====

Ud over kliniske stamdata anvender FMK data fra følgende registre: 

  * Autorisationsregister til validering af autorisationsnummer for autoriserede sundhedspersoner ved oprettelse/opdatering og til returværdier ved opslag. 
  * Bemyndigelse
  * Forældremyndighed / værge 
  * CPR-register til validering af CPR-nummer ved oprettelse/opdatering og returdata (person- og adressedata) ved oplsag. 
  * [[fmk:generel:ecpr|eCPR]] der anvende som cpr for borgere uden et CPR
  * [[Organisations koder]]
  * [[Speciale koder]]


(Listen er ikke garanteret komplet)