Det Fælles Medicinkort. Snitfladebeskrivelse. Version 1.4.2

Transkript

1 Det Fælles Medicinkort Snitfladebeskrivelse Vsion

2 Vsioning Vsion Dato Forfatt Ændring TOM Opdatet til FMK snitflade SHP Opdatet fejlkod TOM SHP Opdatet med receptsv-status og beskrivelse af levings-elementet, afsnit 6.2 WhitelistingHead element til system autorisation beskrevet JBU Indført udvidet beskrivelse af strukturede dosing TOM Tilføjet afsnit 9 ændring fra til Udvidet med første del af FMK 1.4.2: Udvidet med strukturede dosing med fle piod, opdatet: - Teknisk afsnit 4.15 strukturede dosing. - XML eksempl 6.11 Dosing, beskrivelse opdatet og eksempel flyttet til afsnit Hele afsnit 10 Dosingsstruktur supplende beskrivelse. Styrke (DrugStrength) ændret således at både numisk og tekst form kan returns samtidigt. Opdatet: - XML eksempl 6.9 Lægemiddel opdatet omkring Styrke Desuden mindre rettels. 2

3 Indhold 1 Indledning Medicinkortet Medicinkortets struktur Læsevejledning Begreb XML konvention Tekniske forhold vedr. anvendelsen af svices Transaktion Vsionsnumming Historik Fejlhåndting Sikkhedsmodel Timing angivelse i response head Kommunikation med receptsv Angivelse at seneste repliking Klassifikation, standard Registring af pson og organisation på FMK Lægemiddelordinationens gyldighedsintval Dosingens gyldighedsintval Sammenhæng mellem lægemiddelordinationens behandlingsintval og dosingens gyldighedsintval Sammenhæng mellem gyldighedsintvall og recepten Strukturet dosing Vsioning af svices Svices Hent medicinkort Hent medicinkort som PDF dokument Hent medicinkort-vsion Suspending af medicinkort Gensuspending af medicinkort Ophæv suspending af medicinkort (frigiv medicinkort) Sæt marking for medicinafstemning Hent lægemiddelordination Opret lægemiddelordination Opdat lægemiddelordination Pausing af lægemiddelordination Ophæv pausing af lægemiddelordination Sepon lægemiddelordination Afsepon lægemiddelordination

4 5.15 Søg eft seponede lægemiddelordination Hent receptordination Opret receptordination ud fra lægemiddelordination Opret recept til pson uden CPR-numm Opret receptordination til brug i praksis Opret ell ophæv tilknytning af receptordination til lægemiddelordination Mark receptordination som ikke aktuel Ophæv mark receptordination som ikke aktuel Annull receptordination Hent effektuing Opret effektuing Slet effektuing Opdating af medicinkort (bulk svice) Hent rettighed XML eksempl Medicinkort og lægemiddelordination Receptordination Effektuing CreatePrescriptionMedication - Oprettelse af recept ud fra lægemiddelordination Patientinformation Organisation Autoriset sundhedspson Indikation Lægemiddel Lægemiddelordinationens start- og slutdato Dosing Pakningsstørrelse Fejlkod og -tekst Refenceliste Ændring Ændring fra til Dosingstruktur supplende beskrivelse Medicinskema og strukturet dosing Form for daglige dos Dosing eft behov (PN-dosing) Dosingens dage Itationsintval Dosing start- og slutdato Anvendelse af den supplende tekst Dosingsforslag Dosis-intvall Dosing med fle piod Begrænsning

5 1 Indledning Dette dokument indehold en beskrivelse af de svices som Det Fælles Medicinkort still til rådighed for EPJ-system og lægepraksissystem. Dokumentet beskriv en ikke endelig vsion 1.4.2, d forudses således ydlige udvidels. Vsion 1.4.* ikke bagud-kompatible til FMK vsion 1.2.*, de tidlige snitflad beskrevet i beskrevet i [fmk10] og [fmk1.2.6] (se Refenceliste i afsnit 8). For uddybning af de begreb d anvendes henvises til Begrebsdefinition vsion 1.2 Medicinkort [begreb] og for uddybning af brugssituation henvises til Scenari og Use Cases [usecase]. Det hensigten, at oplysningne skal kunne indlæses i den behandlende læges EPJ-system ell lægepraksissystem, og danne grundlag for den eftfølgende behandling, udskrivning af recept med vide. Ligeledes vil oplysningne være til rådighed for hjemmesygeplejen. Hvis d ændres i lægemiddelbehandlingen, skal behandlingen opdates i Det Fælles Medicinkort. Tilsvarende skal patientens aktuelle og opdatede medicining hentes fra Det Fælles Medicinkort, og vises i lægepraksissystemet og sygehusets EPJ-system ved indlæggelse og anden kontakt. Det Fælles Medicinkort skal således altid (bortset fra når patienten indlagt) vise patientens aktuelle lægemiddelbehandling ved sidste kontakt til en sundhedspson. I denne og andre tekst anvendes forkortelsen FMK om Det Fælles Medicinkort. 5

6 2 Medicinkortet 2.1 Medicinkortets struktur I dette afsnit beskrives medicinkortets struktur, dvs. hvordan det sammensat af lægemiddelordination, receptordination, og effektuing. Enhv pson med et dansk psonnumm vil have et medicinkort på FMK. Medicinkortets primære indhold lægemiddelordination. Receptordination, som sendt til et apotek gennem receptsven vil også findes på medicinkortet. Endeligt kan effektuing også findes på medicinkortet, dels som lægens udleving og indgivels og dels som apotekets udleving. I nedenstående struktur d vist nogle grundlæggende struktur på medicinkortet. Med en enkelt undtagelse, d beskrive sene, kan alle tre element dog forekomme 0 ell mange gange: Medicinkort Lægemiddelordination Lægemiddelordination Effektuing Lægemiddelordination Receptordination Effektuing Receptordination Effektuing 1 2a 2b 3a 3b 3c 4a 4b 1: På medicinkortet kan lægen have oprettet en lægemiddelordination uden at d foretaget effektuing hpå. Effektuingne kan sene tilknyttes. 2: En lægemiddelordination kan have en ell fle effektuing tilknyttet, ved at lægen har udlevet ell indgivet et lægemiddel. 3: En lægemiddelordination kan have en ell fle receptordination tilknyttet. Dette sk ved at lægen udsted en recept. Receptordinationen kan heft effektues på apoteket en ell fle gange. 4: D kan forekomme en række receptordination direkte på medicinkortet, dvs. uden at være tilknyttet en lægemiddelordination. Disse receptordination betegnes ofte løse recept, og opstår når recept modtages af apotekne uden om FMK. Ved ekspedition på apotekne tilknyttes effektuing htil. Ud ov de h beskrevne struktur kan andre kombination forekomme. F.eks. kan lægen ved en konsultation oprette en effektuing og udleve lægemidlet til patienten første gang, hvoreft patienten sene ov tre gange kan afhente lægemidlet på apoteket idet lægen udsted en recept. Strukturen for dette eksempel kan se således ud: Lægemiddelordination Effektuing Receptordination Effektuing 6

7 Effektuing Effektuing Receptordination direkte på medicinkortet opstår når receptsven indehold information om receptordination d oprettet uden om FMK, dvs. som modtaget på receptsven som EDIFACT, ell på apotekne som en papirrecept, via fa ell som telefonrecept. 7

8 3 Læsevejledning I det følgende forespørgsl og svar for de svices som det fælles medicinkort still til rådighed, illustret med eksempl på XML-dokument. I disse namespaces og andre tekniske dele udeladt for at forbedre ovskueligheden. Fle sted d udeladt en række element, dette angivet ved... og i teksten forklaret, hvad d udeladt. Den komplette definition kan naturligvis ikke opnås alene ved brug af eksempl, og d refes således til skemadefinition. 3.1 Begreb De mest benyttede begreb i FMK beskrevet i dokumentet Begrebsdefinition. Ovsættelsen af de væsentligste begreb : Dansk betegnelse Medicinkort Recept Receptordination Ordination Lægemiddel Lægemiddelordination Effektuing Engelsk betegnelse Medicine card Prescription Prescription medication Medication Drug Drug medication Effectuation En recept kan indeholde fle receptordination på hvt et lægemiddel: En papirrecept kan indeholde op til 3 og en EDIFACT-recept op til 99. Recept oprettet gennem FMK vil kun indeholde en enkelt receptordination på et lægemiddel. På teknisk niveau det således nødvendigt at skelne mellem recept (som contain ) og den ell de receptordination d optræd på recepten (som tilladelse til at udleve et enkelt lægemiddel). Recept optræd ikke på FMK. 3.2 XML konvention XML-skemane for FMKs svices findes altid som par af Request og Response skemadefinition, eksempelvis CreateDrugMedicationRequest og CreateDrugMedicationResponse. Request- og Response-skemane gør brug af en række und-skemaelement. Med få undtagels findes skemaelement i separate fil, d indehold en element- og en typedefinition (f.eks. hhv. DrugMedication og DrugMedicationType). Definition på attributt findes dog delvist i elementet som attributten anvendes på, eksempelvis definitionen af source attributt på f.eks. DrugIdentifi, OrganisationIdentifi m.v. I modsætning til tidlige vsion skemane ikke udviklet eft navngivnings- og designregl for OIOXML. 8

9 4 Tekniske forhold vedr. anvendelsen af svices 4.1 Transaktion Svices genelt opbygget således, at det muligt at foretage fle samtidige opation af samme slags på samme medicinkort, dvs. for samme pson. Disse opation vil blive udført i samme transaktion. Det dimod ikke muligt at kombine fle svicekald i samme transaktion. Er det nødvendigt f.eks. at oprette, sepone og opdate fle lægemiddelordination på samme medicinkort i samme transaktion gøres dette ved svicen Opdating af medicinkort (bulk svice). Det anbefales dog at holde forskellige opation adskilt, så vidt det i øvrigt muligt og giv mening med hensyn til arbejdsgange og pformance. Erfaringen, at håndting af fejl, først og fremmest brugfejl men også uforudsete systemfejl, bliv langt enkle på denne måde. 4.2 Vsionsnumming Princippet for vsioning på FMK, at ændring af patientens medicining vsiones. Dvs. at en ændring af patientens medicining på lægemiddelordination og medicinkortet vil medføre en ny vsion. Oprette d en lægemiddelordination opdates medicinkortets vsionsnumm. Opdates lægemiddelordinationen idet mediciningen på lægemiddelordinationen opdates opdates lægemiddelordinationens vsionsnumm og medicinkortets vsionsnumm. Vsionsnumre for andre lægemiddelordination på medicinkortet ændres ikke dved. Medicinkortet kan opdates som helhed, f.eks. idet medicinkortet suspendes når patienten indlægges, suspendingen ophæves m.v. Ved ændring direkte på medicinkortet opdates medicinkortets vsionsnumm. Lægemiddelordinations vsionsnumre ændres ikke dved. Bemærk, at det ikke kan antages, at vsionsnumre vil være fortløbende. I tidlige vsion af FMK (før vsion 1.4) var dette tilfældet, fra og med FMK 1.4 vsionsnummingen ændret til nedenstående format: TTTTTTTTTTTTTSSSIII eksempelvis Hvor TTTTTTTTTTTTT angiv et tidspunkt som uni tid, SSS en sub-millisekund tæll og III et instans-numm for den proces d har genet vsionsnummet. Vsionsnummet vil fortsat kunne repræsentes i samme format som nu, og håndtes i long typen i Java og C#. Idet forrige og næste vsion ikke nødvendigvis vil kunne findes ved at fratrække ell lægge en til vsionsnummet, indehold lægemiddelordinationen og medicinkortet elementne PreviousVsion (bortset fra første vsion) og NetVsion (bortset fra den aktuelle vsion). Ved opdating af data på medicinkortet forventes det at opdating foretages på baggrund af seneste vsion af medicinkortet. Dette skal angives ved at medicinkortets seneste vsionsnumm sendes med i forespørgslen. Systemet anvend dimod ikke vsionsnummet til at foretage en optimistisk låsning. 9

10 Er d medsendt et ældre vsionsnumm vil kaldet alligevel blive gennemført, men det vil blive logget at opdatingen ikke foretaget ud fra opdatede data. I svaret vil d desuden blive returnet et element "VsionMismatchWarning" d vil advare afsenden om at opdatingen ikke foregået på baggrund af seneste vsion af medicinkortet. Modtages en advarsel om at opdatingen ikke foretaget ud fra opdatede data skal d eftfølgende foretages en klinisk vurding af hvorvidt dette har en betydning, og d skal om nødvendigt følges op på dette. FMK skal dog ikke nødvendigvis opdates på baggrund af denne vurding. 4.3 Historik Ved ændring på medicinkortet og lægemiddelordinationne forøges vsionsnummet på disse to, som også beskrevet ovenfor. Effektuing ikke vsionede i FMKs snitflade. Ved en effektuing på en lægemiddelordination vil hvken medicinkortets ell lægemiddelordinationens vsionsnumm blive ændret. En effektuing har intet vsionsnumm, idet den ikke kan ændres. Den påvirk ikke lægemiddelordinationen ell medicinkortet som en ændring, idet d ved oprettelsen af en lægemiddelordination forudset en ell fle effektuing. En receptordination har intet vsionsnumm, denne kan hell ikke ændres og kun en besked sendt til apoteket. Udstedelse af en recept påvirk ikke lægemiddelordinationens ell medicinkortets vsionsnumm, idet d hved ikke sk en ændring af patientens medicining, men kun sendes en besked til et apotek. Medicinkortets vsionsnumm ændres ikke hvis d tilknyttes receptordination direkte på dette. Det muligt at "ophøje" de receptordination, d findes på medicinkortet, til lægemiddelordination. Først når en receptordination bliv anvendt til at danne en lægemiddelordination vil d ske en ændring af medicinkortets vsionsnumm. Det først på dette tidspunkt, at lægen træff en beslutning om at foretage en ændring i patientens medicining på medicinkortet. Opslag på aktuelt medicinkort, med dato og tid ell med vsionsnumm Ved opslag på en patients medicinkort kan dette foretages med tre forskellige variant af forespørgselen: Opslag på det aktuelle medicinkort. Opslag med en dato og tid. Opslag på vsionsnumm. Et opslag på det aktuelle medicinkort og et opslag med den nuværende dato og tid vil give samme resultat patientens aktuelle medicining. Ved et opslag på en tidlige vsion kan dette ske med angivelse af dato og tid ell på et vsionsnumm. Ved opslag med vsionsnummet vil medicinkortet blive returnet som det så ud på det tidspunkt hvor lægen opdatede medicinkortet til denne vsion, dvs. svarende til det tidspunkt hvor vsionen blev oprettet. Denne præcising har relevans specielt i de tilfælde hvor en lægemiddelordination sepones idet gyldighedspioden udløb. At gyldighedspioden udløb medfør ikke en ændring af medicinkortets vsionsnumm (d sk ikke en opdating), i modsætning til en ændring hvor lægen aktivt vælg at sepone nu ved at kalde FMK. 10

11 Figur 1: Vsioning På ovenstående figur illustres de forholdene omkring opslag med vsionsnumm og tidspunkt. En lægemiddelordination oprettes, hved får medicinkortet vsionen 42. D sk en anden opdating til vsion 43, og på et tidspunkt inden d opdates til vsion 44 sepones lægemiddelordinationen idet gyldighedspionen udløb. Spørges d på vsion 42 returnes lægemiddelordinationen, idet den oprettet fra og med vsion returnes lægemiddelordinationen, idet den stadig aktiv på det tidspunkt hvor lægen opdatede medicinkortet til denne vsion, dvs. svarende til det tidspunkt hvor vsionen blev oprettet 44 returnes lægemiddelordinationen ikke, idet den ikke længe gyldig. Spørges d på datoen A returnes lægemiddelordinationen ikke, idet den ikke var oprettet endnu på dette tidspunkt. B returnes lægemiddelordinationen, idet den oprettet fra og med dette tidspunkt. Dette svar til at spørge på vsion 42. C, D og E returnes lægemiddelordinationen F, G og H returnes lægemiddelordinationen ikke, idet den fra og med dette tidspunkt ikke længe gyldig. 4.4 Fejlhåndting Hvis d opstår en fejl ved behandling af en forespørgsel vil d blive returnet et fejldokument i stedet for det forventede svar, og den forretningsmæssige del af transaktionen vil blive rullet tilbage. Dvs. at d f.eks. ikke oprettes, opdates ell sepones på nogen af de medsendte medicinkort ell lægemiddelordination, hell ikke selv om d f.eks. forsøges at oprette tre lægemiddelordination i samme kald og den tredje fejl. Kaldet vil dog blive logget. Fejl returnes i XML ifølge Den Gode Websvice. D medsendes en fejlkode. De mulige fejlkod opdelt i følgende intvall: : Typisk brugfejl ell fejl forårsaget af afsenystemet. Eksempelvis 2 Cpr-nr (PsonIdentifi) findes ikke : Applikationsfejl Eksempelvis 3000 Intn sv fejl : Validingsfejl, rolle-rettighedsfejl m.v. Eksempelvis 4200 Ingen roll pass på brugen En liste af fejl FMK return findes i afsnittet Fejlkod og -tekst. 11

12 Udov en fejlkode returnes en fejl-tekst og en liste af key-value par d uddyb specifikke værdi for fejlen (values) samt hvilken del af datamodellen denne værdi tilhør (keys). En key vil typisk stemme ovens med navnet på et af de ml element i response-dokumentet som fejlen knytt sig til. Nedenfor d et eksempel på hvordan body-delen af et fejldokument kan se ud (de indsat nogle få linieskift i teksten hund). <soapenv:envelope mlns:soapenv=" mlns:wsse=" mlns:wsu=" mlns:medcom=" mlns:medicinecard =" id="envelope"> <soapenv:head> <wsse:security> <wsu:timestamp> <wsu:created> t19:06:51z</wsu:created> </wsu:timestamp> </wsse:security> <medcom:head> <medcom:securitylevel>1</medcom:securitylevel> <medcom:linking> <medcom:flowid>flowid</medcom:flowid> <medcom:messageid>aaabof7thjiabqvhn2+ky1npu0k=</medcom:messageid> <medcom:inresponsetomessageid>aaabof7tglifkibq3eievnpu0k= </medcom:inresponsetomessageid> </medcom:linking> </medcom:head> </soapenv:head> <soapenv:body> <soapenv:fault> <faultcode>sv</faultcode> <detail> <medcom:faultcode>3</medcom:faultcode> <medicinecard :faulttet>medicinkortet findes ikke i vsion 999 </medicinecard :faulttet> <medicinecard :faultdetails> <medicinecard :keyvalueset> <medicinecard :key>medicinecardvsion </medicinecard :key> <medicinecard :value>999</medicinecard :value> </medicinecard :keyvalueset> <medicinecard :keyvalueset> <medicinecard :key>psonidentifi</medicinecard :key> <medicinecard :value> </medicinecard :value> </medicinecard :keyvalueset> </medicinecard :faultdetails> </detail> <faultstring>medicinkortet findes ikke i vsion 999</faultstring> </soapenv:fault> </soapenv:body> </soapenv:envelope> 4.5 Sikkhedsmodel Sikkhedsmodellen for det fælles medicinkort baset på MedComs "Den Gode Websvice" og SOSI projektet. Se me hom i dokumentet "Sikkhed Projekt Fælles Medicin" [sosi]. 12

13 Data, d anvendes forretningsmæssigt, f.eks. sygehusafdelingsnumm, ydnumm og autorisationsnumm, bør medsendes i den forretningsmæssige del af dokumentet, og ikke hentes fra dokumentheaden. Det kan ikke udelukkes at f.eks.: En sekretær på en sygehusafdeling logg ind med SKS-sygehusafdelingsnumm med 6 cifre og foretag en opdating af data på et afsnit angivet med 7 cifre. En lægepraksis har to ydnumre, d logges ind med det ene men sendes data for begge. Skal d sene opstilles regl for hvorvidt dette skal være muligt bør validingen af disse regl holdes adskilt fra den forretningsmæssige implementing. Dette bør ske for at minime risikoen for at ændring i sikkhedsmodellen påvirk denne. Systemautorisation D foretages autorisation af klient system. Denne whitelist-baset, og skal sikre at kun software, d godkendt til at benytte medicinkortet, kan kalde dets svices. Konkret skal d tilføjes SOAP head blocks, d unikt identific det software, d ønsk at kalde medicinkortet. Bemærk at denne identifikation ikke en del af ID kortet, men implementes som selvstændige XML-element i SOAP headen indkapslet i et WhitelistingHead element. Det dfor ikke bundet til en session, men kan varie fra en forespørgsel til næste. SOAP Hea til system autorisation D tilføjes et WhitelistingHead element med flg. XML element til SOAP headen. Alle af type s:string: SystemOwnName SystemName SystemVsion OrgResponsibleName OrgUsingName OrgUsingID RequestedRole Systemautorisation tænkt som en udvidelse af Den Gode Websvice, og und standardising i NSI regi. RequestedRole elementet beskrevet i afsnittet Roll og Rettighed. SystemOwnName SystemOwnName elementet indehold det entydige navn på levandøren af afsenystemet. Navn Type Aritet Værdisæt Eksempel sdsd:systemownname s:string 1 Udfaldsrummet diktes via det Centrale Virksomheds Regist <SystemOwnName>Pharma</SystemOwnName> SystemName SystemName elementet indehold navnet på afsenystemet. Navn Type Aritet sdsd:systemname s:string 1 13

14 Værdisæt Eksempel Udfaldsrummet diktes alene af levandøren af afsenystemet <SystemName>Medicinmodulet</SystemName> SystemVsion SystemVsion elementet indehold vsionen på afsenystemet. Navn Type Aritet Værdisæt Eksempel sdsd:systemvsion s:string 1 Udfaldsrummet diktes alene af levandøren af afsenystemet <SystemVsion>1.0</SystemVsion> OrgResponsibleName OrgResponsibleName indehold det entydige navn på den organisation, d har ansvaret for it-systemet. Det bemærkes, at organisationen meget vel kan være en ikke-sundhedsfaglig organisation d måske endda ikke engang kan identifices via en klassifikation som CVR som i tilfældet en driftsafdeling i en region. Dfor anvendes d ikke klassifikation for denne attribut. OrgResponsibleName entydig. Navn Type Aritet Værdisæt Eksempel sdsd:orgresponsiblename s:string 1 Udfaldsrummet diktes af den ansvarlige organisation <OrgResponsibleName>LægepraksislevandørXYZ</OrgResponsibleName > OrgUsingName OrgUsingName indehold det entydige navn på den organisation, hvor brugen aktuelt befind sig når websvice kaldet udføres. Navnet på organisationen modsvar det id d findes i attributten OrgUsingID givet ved klassifikationen angivet i attributten OrgUsingID@NameFormat Navn Type Aritet Værdisæt Eksempel sdsd:orgusingname s:string 1 Udfaldsrummet diktes af den i OrgUsingID anvendte klassifikation <OrgUsingName>ROS Infektionsmedicinsk Amb.</OrgUsingName> OrgUsingID OrgUsingID indehold det entydige id på den organisation, hvor brugen aktuelt befind sig når websvice kaldet udføres. Klassifikationen hvortil id et hør angivet i attributten OrgUsingID@NameFormat og headen OrgUsingName angiv navnet på organisationen hørende til id et. Navn Type Aritet Eksempel sdsd:orgusingid s:string 1 <OrgUsingID NameFormat="medcom:sor"> </OrgUsingID> 14

15 Klassifikationssættet i attributten OrgUsingID@NameFormat angiv den klassifikation, som attributtne OrgUsingID og OrgUsingName hent sine værdi fra. Bemærk at attributten skal anvendes i XML dokument uden namespace prefi, selvom det selvfølgelig definet i et namespace. Navn Type Aritet Format Eksempel sdsd:orgusingid@nameformat s:string 1 medcom:ynumb : Ydregistet [YDER] medcom:pnumb : CVR-P [CVR] medcom:skscode : SHAK kode [SKS] medcom:cvrnumb : CVR numm [CVR] medcom:communalnumb : Kommunekode [KOMMKODE] medcom:sor : SOR kode [SOR] <OrgUsingID NameFormat="medcom:skscode">650402</OrgUsingID> Eksempel Alle XML element i WhitelistingHead elementet fra namespace: WhitelistingHead elementet fra namespace: <soapenv:envelope mlns:si=" mlns:soapenv=" mlns:ns=" mlns:ns1=" mlns:sdsd=" mlns:sdsd =" mlns:medcom=" mlns:oas=" <soapenv:head> <sdsd201206:whitelistinghead> <sdsd:systemownname>levandør A</sdsd:SystemOwnName> <sdsd:systemname>system A</sdsd:SystemName> <sdsd:systemvsion>1.5</sdsd:systemvsion> <sdsd:orgresponsiblename>ros IT-afdeling</sdsd:OrgResponsibleName> <sdsd:orgusingname>ros Infektionsmedicinsk Amb.</sdsd:OrgUsingName> <sdsd:orgusingid NameFormat="medcom:skscode">3800A0J</sdsd:OrgUsingID> <sdsd:requestedrole>læge</sdsd:requestedrole> </sdsd201206:whitelistinghead> <! > </soapenv:head> <soapenv:body> <! > </soapenv:body> </soapenv:envelope> Fejlmeddels for systemautorisation Hvis en af de krævede element mangl, ell det kaldende system ikke autoriset til at kalde FMK, returnes en SOAP fault med fejlkode 4300 (Manglende system autorisation). 15

16 Roll og rettighed Hvt kald til FMK's snitflade kræv at brugen af FMK anvend en MOCES ell et POCES signatur. Informationne i denne signatur bliv anvendt til at vific den rolle som brugen ønsk at få i FMK. I RequestedRole-elementet i SOAP headen skal d angives hvilken rolle som brugen ønsk at anvende i det pågældende kald. En brug kan have adskillige mulighed, f.eks. kan en autoriset læge selvfølgelig angive Læge rollen, men kan også anvende Borg rollen. D skelnes mellem sundhedsfaglige roll, hvor d kræves at d angives en MOCES (medarbejd) signatur og borg roll d kræv at d angives et POCES (Psonlig) signatur og endelig den centrale administrator (NSI) rollen hvor d skal angives et MOCES. Hvis d angives en sundhedsfaglig rolle skal den være en af følgende. I parentes angives hvilke kriti d grundlag for validing af rollen: Læge (Autorisationsregist) Tandlæge (Autorisationsregist) Jordemod (Autorisationsregist) Sygeplejske (Autorisationsregist) Social- og sundhedsassistent (Autorisationsregist) Social- og sundhedshjælp (Trust) Sundhedsplejske (Trust) Farmaceut (Trust) Farmakonom (Trust) Assistent for Læge (Bemyndigelsesregist, Autorisationsregist) Assistent for Tandlæge (Bemyndigelsesregist, Autorisationsregist) Assistent for Sygeplejske (Bemyndigelsesregist, Autorisationsregist) Assistent for Jordemod (Bemyndigelsesregist, Autorisationsregist) Assistent for Social- og sundhedsassistent (Bemyndigelsesregist, Autorisationsregist) Hvis d angives en borgrolle skal det være en af følgende. Borg (CPR regist) Forældmyndighed (CPR forældre- og barnregist) Værge (CPR værge- og umyndiggørelsesregist) Administratorrollen Web administrator (FMK Administrator liste) Hvis d angives en rolle som psonen ikke bettiget til return FMK fejlbeskeden: 4200 Ingen roll pass på brugen Eksempel på brug af RequestedRole Rollens angives i RequestedRole-elementet: <RequestedRole>Tandlæge<RequestedRole> Det kræves af sviceaftagsystemet, at den pågældende pson validet og det en betingelse at opslaget på borgens data relevant, eksempelvis at d en behandlrelation mellem sundhedspsonen 16

17 og borgen. For at anvende de nye roll skal disse felt dfor specifices i SOAP headen. Se afsnit om Systemautorisation for ydlige oplysning. Medhjælp for sundhedsfaglig baset på bemyndigelse Und normal anvendelse af FMK vil det være den sundhedsfaglige som udfør opdating og opslag med sin digitale signatur. Eksempelvis læg har ofte en lægesekretær til at foretage selve tastearbejdet, hvorfor d et teknisk behov for at medhjælpen kan lave opslag og opdating på vegne af den sundhedsfaglige pson. For at løfte denne opgave d i FMK implementet et bemyndigelsesregist hvor den sundhedsfaglige kan oprette de pson d bemyndiges til at age på vegne af den sundhedsfaglige. Registet kan vedligeholdes af den sundhedfaglige via fmk-online.dk. Adgang som medhjælp for en sundhedsfaglig pson, kræv at d angives en MOCES signatur, samt at strukturen OnBehalfOf sættes i SOAP headen med den sundhedsfagliges autorisationskode. Følgende regl gæld for medhjælp for sundhedsfaglig: At medhjælpen oprettet som medhjælp for den sundhedsfaglige i FMKs bemyndigelsesregist. Medhjælpen benytt sin egen digitale medarbejd signatur, idet SOSI ID kortet bliv signet med medhjælpens signatur. Medhjælpen angiv autorisationsnummet på den sundhedsfaglige pson som d handles på vegne af. Autorisationsnummet skrives ind i OnBehalfOf SOAP headen. At RequestedRole sat til den korrekte assistent rolle i hvt kald til FMK. Eksempel på angivelse af På vegne af : <OnBehalfOfStructure> <AuthorisationIdentifi>BR56T</AuthorisationIdentifi> </OnBehalfOfStructure> Hvis medhjælprollen angivet i RequestedRole ikke kan vifices ell medhjælpen ikke oprettet i bemyndigelsesregistet returnes: 4200 Ingen roll pass på brugen Trust baset medhjælp for sundhedsfaglige For godkendte system det muligt at angive en medhjælpsrolle uden at d først oprettet en bemyndigelse i FMKs bemyndigelsesregist. Godkendelsen knyttet til det enkelte system (Se afsnit System autorisation). Intnt i FMK vil d være en liste af de system samt systemvsion, d godkendt til at anvende medhjælp uden bemyndigelse. Reglne for at anvende medhjælpsrollen uden bemyndigelse adskill sig ved at det ikke påkrævet at medhjælpen oprettet i FMKs centrale bemyndigelsesregist, men at d i det lokale system etablet en tilsvarende validing af medhjælpsaftalen mellem den sundhedsfaglige pson og medhjælpen. Adgangen til FMK for medhjælp uden bemyndigelse identisk med adgang for medhjælp med bemyndigelse. D angives en MOCES signatur, samt at strukturen OnBehalfOf sættes i SOAP headen med den sundhedsfagliges autorisationskode. Det valides at den medsendte autorisationskode aktiv i autorisationsregistet, og såfremt dette tilfældet acceptes brugen som medhjælp for sundhedspsonen. 17

18 Hvis systemet ikke godkendt til medhjælp uden bemyndigelse ell den medsendte autorisationskode ikke kan vifices returnes: 4200 Ingen roll pass på brugen Rettighed Systemet anvend en række rettighed, som listet og beskrevet i det følgende. BorgOpslag Opslag på oplysning i medicinkortet (hund lægemiddelordination, effektuing, receptordination m.m.) og auditloggen. Borge må hente oplysning om sig selv, om des evt. børn und 15 år, som de har forældremyndighed ov samt for pson, de måtte være værge for, men må ikke ells hente oplysning om pson i al almindelighed. Ved opslag i auditloggen d tilknyttet visse restriktion, så man kun kan slå op på oplysning, d relevante for rollen og psonen. SundhedsfagligOpslag Opslag på oplysning i medicinkortet (hund lægemiddelordination, effektuing, receptordination m.m.) og auditloggen. Ved opslag i auditloggen d tilknyttet visse restriktion, så man kun kan slå op på oplysning, d relevante for rollen og psonen. Recept Receptudstedelse, hund tilbagekaldelse, ugyldiggørelse og annulling af recept. Lægemiddelordination Oprettelse og ændring af lægemiddelordination i FMK incl. seponing og pausing Effektuing Effektuing af lægemiddelordination, opret og slet effektuing (indgivelse og udleving af lægemidl). Privatmarking Oprettelse og fjnelse af privatmarking på lægemiddelordination. Det skal bemærkes, at man strengt taget ikke behøv at have denne rettighed for at kunne opdate lægemidelordinationen m.v. VisPrivatmarketVærdispring Opslag på privatmarket lægemiddelordination med anvendelse af reglen om værdispring. VisPrivatmarketSamtykke Opslag på privatmarket lægemiddelordination med patientens samtykke. Suspending Suspending og frigivelse af medicinkort ved indlæggelse og udskrivelse. Afstemning Afstemning af medicinkort. LøsRecept Ændring af status på løs receptordination (tilknytning til lægemiddelordination m.v.). 18

19 Tilknytning Oprettelse af tilknytning til organisation for patient. Ophævelse af tilknytning. Opslag på tilknytning for en patient. BestilEffektuing Bestilling af effektuing samt fornyelse af recept. Opslag på bestilling. Ophæv bestilling. Recept Lægemiddelordination Effektuing Privatmarking VisPrivatmarketVærdispring VisPrivatmarketSamtykke Suspending Afstemning LøsRecept Tilknytning BestilEffektuing Læge Tandlæge Sygeplejske Jordemod Social- og sundhedsassistent Social- og sundhedshjælp Sundhedsplejske Farmaceut Farmakonom Assistent for Læge Assistent for Tandlæge Assistent for Sygeplejske Assistent for Sygeplej Assistent for Jordemod Assistent for Social- og sundhedsassistent Rolle Borg BorgOpslag SundhedsfagligOpslag Nedenstående tabel vis hvilke rettighed d knyttet til de enkelte roll i systemet. Tildelingen af rettighed til roll kan til enhv tid ændres af Lægemiddelstyrelsen. D findes en svice som kan bruges til at hente de gældende rettighed for den aktuelle brug (og dmed den aktuelle rolle). 19

20 BestilEffektuing Tilknytning LøsRecept Afstemning Suspending VisPrivatmarketSamtykke VisPrivatmarketVærdispring Privatmarking Effektuing Lægemiddelordination Recept SundhedsfagligOpslag Rolle BorgOpslag Forældmyndighed Værge Web administrator Krævede rettighed for anvendelse af svices Hent medicinkort 1 (2) Ny hent medicinkort 1 (2) Hent medicinkort i PDF 1 (2) Hent medicinkortvsion 1 Medicinafstemning på FMK BestilEffektuing Tilknytning LøsRecept Afstemning Hent lægemiddelordination 1 (2) Ny hent lægemiddelordination 1 (2) (4) (5) Opdat lægemiddelordination (5) Pausing af lægemiddelordination Opret lægemiddelordination Suspending VisPrivatmarketSamtykke VisPrivatmarketVærdispring Privatmarking Effektuing Lægemiddelordination Recept SundhedsfagligOpslag Svice BorgOpslag Nedenstående tabel vis hvilke rettighed som krævet for at kalde systemets svices. For enkelte svices vil det afhænge af brugens rolle og/ell indholdet i requestet, om en given rettighed krævet ell ej. I sådanne tilfælde angives nærme forklaring som en nummet note nedenfor. (3) (6) 20

21 Ophæv pausing af lægemiddelordination Sepon lægemiddelordination Af-sepon lægemiddelordination Søg seponede lægemiddelordination Opret effektuing Slet effektuing Søg effektuing 1 Hent receptordination 1 Ny hent receptordination 1 Opret receptordination Opret recept til praksis Opret recept uden CPR Opret/ophæv tilknytning af receptord. BestilEffektuing Annull recept Mark recept som 'ikke aktuel' Fortryd 'mark recept som ikke aktuel' Suspending af medicinkort Gensuspending af medicinkort Frigiv medicinkort 7 Opdating af medicinkort Hent auditlog Tilknytning LøsRecept Afstemning Suspending VisPrivatmarketSamtykke VisPrivatmarketVærdispring Privatmarking Effektuing Lægemiddelordination Recept SundhedsfagligOpslag Svice BorgOpslag ( ) ( ) ( ) ( ) (7) (7) (7) 1 Hent rettighed Opret tilknytning til organisation Ophæv tilknytning til organisation Hent tilknytning Not: 21

22 1. Disse svices kræv enten rettigheden Borgopslag ell rettigheden Sundhedsfagligopslag. Borgopslag belagt med ekstra restriktion med hensyn til hvilke psons data d kan tilgås. Med rollen Borg må man kun tilgå egne data. Med rollen Forældmyndighed må man kun tilgå data for børn und 15 år, som systemet ved at man har forældmyndighed ov (hvilket som udgangspunkt kun omfatt børn født eft medio 2004). Med rollen Værge må man kun se data for umyndiggjorte pson, som man registret som værge for. 2. Disse svices skjul som udgangspunkt privatmarkede data, men med en input paramet kan man vælge at inklude privatmarkede data også, med henvisning til enten værdispring ell samtykke (se evt. fle detalj om i sektionen Privatmarking und afsnittet 5.1). Hvis denne input paramet sat kræves den tilsvarende rettighed for at svices kan udføres, henholdsvis VisPrivatmarketVærdispring ell VisPrivatmarketSamtykke. 3. Rettigheden Recept kræves, hvis requestet inklud en oprettelse af en recept. 4. Rettigheden Effektuing kræves, hvis requestet oprett ell slett en effektuing af en lægemiddelordination. 5. Rettigheden Privatmarking kræves, hvis requestet sætt ell fjn en privatmarking på en lægemiddelordination. 6. Rettigheden LøsRecept kræves, hvis requestet tilknytt en recept til en lægemiddelordination. 7. Svicen Opdating af medicinkort kan indeholde enhv af de andre svices, som opdat medicinkort, og vil kræve de rettighed som de konkret indeholdte svices kræv. Den Gode Web Svice og tidsangivelse Denne vsion af medicinkortet bases på vsion af Den Gode Web Svice [dwgs]. Vsion indehold en tilføjelse til vsion 1.0, d kræv at alle tid skal angives i Zulu tid, hvilket det samme som UTC (Coordinated Univsal Time). I praksis angives dette ved at sætte et Z eft tidsangivelsen, eks T16:57:00Z for dato/tid, 21:42:00Z for tid og Z for dato, samt at korrige for de 1-2 tims forskel (vint og sommtid henholdsvis) d mellem dansk tid og UTC. Undtagels til Zulu tid Følgende felt skal ikke indbettes i Zulu-tid, da d tale om tidspunkt som altid skal tolkes i forhold til den tidszone som patienten befind sig i: DoseTime (anvendt i Dose-elementet) Eksempelvis skal patienten tage sin medicin kl. 9, 15 og 21 uanset hvor han befind sig i vden og tidne ref således til den tidszone patienten befind sig i. Tiden skal angives på formen: HH:mm:ss, eks. 09:20:00 Logning Regl for logning bestemt af psondataloven og sundhedsloven. Se me hom i dokumentet "Sikkhed Projekt Fælles Medicin". For at kunne logge hvilken organisation d står for et opslag/opdating af FMK, det nødvendigt at CareProvidName i SOSI ID kortet udfyldt. Det FMK klient systemets ansvar at den korrekt angivet, idet den ikke kan valides i FMK. Eksempel på angivelse af organisation: <Attribute Name="medcom:CareProvidName"> 22

23 <AttributeValue>Anæstesiologisk ovafd., Gentofte hospital</attributevalue> </Attribute> CareProvidName må maimalt være på 50 tegn. 4.6 Timing angivelse i response head For alle web svices på FMK kan d udtrækkes information om tidsanvendelsen på det pågældende web svice kald. Følgende tid angives: Den totale tid som FMK kaldet har taget Den tid som FMK har brugt på at kalde receptsven inkl. netværkstiden Den tid som receptsven angiv at den har brugt på et givent kald Eksempel: <TimingListStructure> <TimingStructure> <SystemName>FMK</SystemName> <SviceName>Hent medicinkortvsion</svicename> <TimeInMilliseconds>720</TimeInMilliseconds> </TimingStructure> <TimingStructure> <SystemName>FMK_receptsv</SystemName> <SviceName>getLatestStatusChangeDate</SviceName> <TimeInMilliseconds>701</TimeInMilliseconds> </TimingStructure> <TimingStructure> <SystemName>receptsv</SystemName> <SviceName>getPrescriptionMedicationOvview</SviceName> <TimeInMilliseconds>496</TimeInMilliseconds> </TimingStructure> </TimingListStructure> TimingListStructure placet i SOAP headen på web svice responset. Hvis d udføres fle kald i en længe kæde det vigtigt at TimingListStructure bæres med ov fra response til response samtidig med at d tilføjes tidsmåling. Formålet med timing angivelsne at d kan opbygges et kaldetræ med angivelse af tidsforbrug på de enkelte kald. Et medicinmodul som kald FMK mål tiden det tag at kalde FMK og få svar tilbage. FMK kald i nogen tilfælde vide til receptsven. Denne tid måles og indsættes i svaret til medicinmodulet. Medicinmodulet kan således se at det tog eksempelvis 1,2 sekund at kalde hent medicinkort svicen inkl netværkstid, som tilsvarende brugte 496 ms på at kalde receptsven. Hvis stien endnu længe på grund af afkoblingskomponenten og SOSI-GW, bliv tidsmålingne endnu me intessante, da de giv et billede af hvor tiden bruges i systemet. 4.7 Kommunikation med receptsv Oprettelse af recept gennem FMK sk ved at FMK kald en websvice på receptsven. Dvs. i modsætning til oprettelse af recept via EDIFACT sk oprettelsen øjeblikkeligt i samme kald. En recept d ikke kan oprettes vil medføre at kaldet til receptsv og FMK vil rulle tilbage. Dimod til vil FMKs tidlige kald til receptsven ikke rulle tilbage, dvs. at recept oprettet i samme kald til FMK med ud fra andre lægemiddelordination vil ikke blive rullet tilbage. Dette kan f.eks. optræde, når d FMK kaldes med fle opret recept dokument i samme kald. 23

24 Oprettelse af recept valides af både FMK og receptsv. FMK valid f.eks. at pakningen findes på lægemidlet på den lægemiddelordination recepten oprettes ud fra (kun for lægemidl i taksten). Receptsven foretag andre validing. Bemærk at receptsven bl.a. tillad et andet og begrænset tegnsæt end FMK. Nedenstående hentet fra Den Gode XML Recept afsnit 2: Indholdet i alle essentielle felt i datagrundlaget skal ovføres i uændret form til applikationens database. Dog må, og typografiske hjælpetegn fjnes og felt concatenes, hvis funktionaliteten ikke forringes. Tegnsættet i databasen skal untøtte samtlige tegn i datagrundlaget. I praksis betyd dette, at d skal benyttes ISO Følgende tegn giv faringsmæssigt problem og må dfor ikke anvendes: Tegn [ \ ] { } Code Page 865 (decimalt) Tegn, d normalt ikke findes på tastatur: Semigrafik (CP 865 decimalt 169, 170, , 244, 245, 251, 254, 255) og styretegn (CP 865 decimalt 1-31) må hell ikke anvendes. 4.8 Angivelse at seneste repliking I FMK vil recept blive hentet fra en lokal repliket database i stedet for via websvices fra receptsven. Alle læsning vil ske fra replikaet, hvorimod receptoprettels fortsat sk gennem en receptsv websvice. Recept oprettet gennem FMK vil automatisk blive opdatet i replikaet. I normal drift vil den lokale database maksimalt være 30 minutt eft receptsven. I fejlsituation det dog relevant at vide præcis, hvornår sidste repliking fandt sted. Denne oplysning indsat i response headen som eksempelvis: <PrescriptionReplicationStatusStructure> <LatestReplicationDateTime> T11:52:00Z</LatestReplicationDateTime> </PrescriptionReplicationStatusStructure> Tiden angives i tim og minutt. Sekund sættes altid til Klassifikation, standard Stamdata til klassifikation definet i en fælles kendt kilde. Denne fælles kilde i så høj grad som muligt lægemiddelstyrelsens takst (Medicinpris). 24

25 I element, hvor d refes til takstdata, angives Medicinpris som kilde og takstvsionen ell år og takstuge angives. Eksemplne hund vis de to variant, hvor den øvste så vidt muligt bør anvendes: <Indication> <Code source="medicinpris" date=" ">123</code> <Tet>Mod lungebetændelse</tet> </Indication> <Indication> <Code source="medicinpris" yearandweek=" ">123</code> <Tet>Mod lungebetændelse</tet> </Indication> Takst og takstvsion Fra og med FMK 1.4 statt kildeangivelsen i source-attributten og evt. en takstvsion i date- ell yearandweek-attributten elementet PriceListVsionWeek. I FMK 1.2 og tidlige var d kun mulighed for at angive taksten som kilde, og med en fælles takstvsion. I FMK 1.4 d således åbnet mulighed for at angive andet end taksten som kilde. Af hensyn til bagud-kompatibilitet det dog foreløbigt stadigt krævet at kod fra taksten stamm fra samme takstvsion (f.eks. indikation, administrationsvej, enhed, ). Dimod d mulighed for at d for et lægemiddel henvises til en anden takstvsion. Typisk anvendes dette hvor kodesæt fra seneste takst indlæst i systemet, men hvor d skal oprettes/opdates ud fra en ældre lægemiddelordination. For Medicinpris svar datoen svar til takstens systemfil felt 03, d indehold takstens ikrafttrædelsesdato på formen ååååmmdd. Altnativt kan system d kun anvend de ordinære takst, som udkomm planmæssigt hv 14. dag, angive årstal og gældende takstuge fra taktstens systemfil felt 09. Årstal og ugenumm bliv af FMK konvtet til datoen for den første takst denne uge. I data returnet fra FMK vil takstdatoen blive returnet, også selv om d angivet årstal og ugenumm. Angivelse af den eksakte takstdato bør anvendes om muligt. For dosing anvendes takstens dosingskod ikke. D anvendes i stedet en ell fle struktur i XML elementet. Ud ov taksten anvendes d enkelte andre klassifikation, f.eks. for organisation (SKS og yd), for læg (autorisation) osv. Kild for de anvendte klassifikation beskrevet for de relevante element. En specifikation af Lægemiddelstyrelsens takst og et sæt eksempel-fil kan findes på: Taksten hentes fra Lægemiddelstyrelsens FTP-sv som hidtil. Tabell i taksten navngivet LMS01 til LMS32, nedenfor henvises til disse tabell. Administrationsvej Lægemidlets administrationsvej skal angives med kode og eventuelt tekst ifølge Medicinpris (Lægemiddelstyrelsens takst) i tabellen LMS11. D anvendes data fra kolonnne "Kode" og "Tekst". Eksempl (kode - tekst): IH - Til inhalation IM - Intramuskulær anvendelse OR - Oral anvendelse Bemærk at ikke alle kod i LMS11 vil være relevante. Administrationsvejen findes i XML elementet RouteOfAdministration, eksempel hund: <RouteOfAdministration> 25

26 <Code source="medicinpris" date=" ">or</code> <Tet>Oral anvendelse</tet> </RouteOfAdministration> I Code-elementets source-attribut angives kilde til datasættet. For administrationsvejen dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. Indikation Indikation skal fortrinsvist angives med kode og eventuel tekst ifølge Medicinpris (Lægemiddelstyrelsens takst). Såfremt d i taksten ikke kan findes en nødvendig indikation kan indikationen undtagelsesvist angives i fritekst. Såfremt d findes en kode og tekst for en indikation i taksten skal disse dog anvendes. Indikationen angives ifølge LMS 26, hvor kolonnne "Indikationstekst" og "Indikationstekst, total" anvendes. Eksempl (kode - tekst): 1 - til forebyggelse af caries mod smt til behandling af alvorlig virusinfektion Indikationen findes i XML elementet Indication. <Indication> <Code source="medicinpris" date=" ">123</code> <Tet>mod lungebetændelse</tet> </Indication> I Code-elementets source-attribut angives kilde til datasættet. For indikationen dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. I øvrigt d mulighed for at angive en indikation i fritekst. Lægemiddelform Lægemidlets form skal angives med kode og eventuelt tekst ifølge Medicinpris (Lægemiddelstyrelsens takst) i tabellen LMS22. D anvendes data fra kolonnne "Kode" og "Tekst". Eksempl (kode - tekst): TAB - tablett TABFILM - filmovtrukne tablett INJSOSE - opløsning og suspension til injektionsvæske, suspension, fyldt injektionssprøjte D kan anvendes både aktive og inaktive tm, dvs. samtlige kod. Lægemiddelformen findes i XML elementet DrugForm. <DrugForm> <Code source="medicinpris" date=" ">tabfilm</code> <Tet>filmovtrukne tablett</tet> </DrugForm> I Code-elementets source-attribut angives kilde til datasættet. For lægemiddelformen dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. 26

27 ATC Lægemidlets ATC skal angives med kode og eventuelt tekst ifølge Lægemiddelstyrelsens takst i tabellen LMS12. D anvendes kolonnne "ATC-niveau 1" til "ATC-niveau 5" til ATC og kolonnen "Tekst". ATC skal angives på det højeste kendte niveau, dvs. bedst med en sammensat kode fra kolonnne "ATC-niveau 1" til "ATC-niveau 5". Eksempl (kode - tekst): C01AA04 - Digitoin N - Nvesystemet N02BE01 - Paracetamol ATC begyndende med Q anvendes ikke, idet disse dækk vetinære lægemidl. ATC findes i XML elementet ATCStructure. <ATC> <Code source="medicinpris" date=" ">n02be01</code> <Tet>Paracetamol</Tet> </ATC> I Code-elementets source-attribut angives kilde til datasættet. For ATC dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. Enhed for pakningsstørrelse Enhed for pakningsstørrelse angives med kode og eventuelt tekst ifølge Lægemiddelstyrelsens takst i tabellen LMS15. D anvendes data fra kolonnne "Kode" og "Tekst" og kun rækk hvor kolonnen "Enhedstype" indehold værdien 4. Eksempl (kode - tekst): MG - mm ML - ml ST - stk UN - enhed Pakningsstørrelsen og enheden hfor findes i XML elementet PackageSize. <PackageSize> <Value>20</Value> <UnitCode source="medicinpris" date=" ">st</unitcode> <UnitTet>stk.</UnitTet> </PackageSize> I Code-elementets source-attribut angives kilde til datasættet. For pakningsstørrelse dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. Enhed for lægemiddelstyrke Enhed for lægemiddelstyrke angives med kode og eventuelt tekst ifølge Lægemiddelstyrelsens takst i tabellen LMS15. D anvendes data fra kolonnne "Kode" og "Tekst" og kun rækk hvor kolonnen "Enhedstype" indehold værdien 3. 27

28 Eksempl (kode - tekst): MG - mg ML - ml MGG - mg/g GB - gigabecquel Styrkeenheden for alle lægemidl bør være på formen "mængde aktivt stof" / "mængde". Eksempl (navn, form, styrke): Imacillin, granulat til oral suspension, 50 mg/ml Primcillin, filmovtrukne tablett, 250 mg/tablet I sidste tilfælde angiv taksten ofte kun 250 mg (altså mængde af aktivt stof), idet d undforstået "pr. tablet" ell lignede. Lægemiddelstyrken og enheden hfor findes i XML elementet DrugStrength. <DrugStrength> <Value>5</Value> <UnitCode source="medicinpris" date=" ">mgm</unitcode> <UnitTet>mg/ml</UnitTet> <Tet source="medicinpris"date=" ">5 mg/ml</medicinecard :tet> </DrugStrength> Eventuelt kan det forekomme, at doseingsteksten i taksten afvig fra den tekst d vil fremkomme ved simpelt at sammensætte den numiske værdi og enhedsteksten. I nedenstående eksempel ville dette være 5 mg/ml, men i tekst-elementet angivet til 12,5 mg/2,5 ml. Dette sk hvor lægemidlet leves i fyldte injektionssprøjt ell lignende. <DrugStrength> <Value>5</Value> <UnitCode source="medicinpris" date=" ">mgm</unitcode> <UnitTet>mg/ml</UnitTet> <Tet source="medicinpris"date=" ">12,5 mg/2,5 ml</medicinecard :tet> </medicinecard :drugstrength> I Code-elementets source-attribut angives kilde til datasættet. For enheden for lægemiddelstyke dette altid Medicinpris for taksten. Attributten date ell yearandweek skal altid forekomme og skal henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. I øvrigt d mulighed for at d angivet en lægemiddelstyrke som en tekst definet i taksten. Enhed for lægemiddeldosis I FMK skal d doses i total mængde, og ikke i mængden af aktivt stof. Total mængde i ovenstående to eksempl (und Enhed for lægemiddelstyrke ) angivet i ml ell antal tablett. Den totale mængde kan angives f.eks. i antal (tablett, kapsl, suppositori, sug, pust osv), i masse (typisk mg) ell i volumen (typisk ml). I FMK d vedtaget, at dosing skal fortrinsvis angives i antal. Kun for lægemidl hvor dette ikke giv mening kan massenenhed ell volumenenhed anvendes. Årsagen htil, at dosing i antal den langt mest udbredte måde at angive en en dosing på, både på sygehuse, og hos praktisende læg. På apotek, i hjemmesygeplejen og for patienten anvendes d stort set kun dosing i antal, for lægemid hvor dette muligt. 28

29 I den nuværende FMK vsion findes d tre mulige måd at angive enheden på: Medicinpris angiv at enheden findes i Medicinpris (Lægemiddelstyrelsens takst). I dette tilfælde skal attributten date ell yearandweek forekomme og henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. Dosingsforslag angiv at enheden stamm fra dosingsforslag tidlige udsendt og fremov udstillet på stamdatamodulet på den nationale sviceplatform (NSP). Lokal angiv at enheden definet i et lokalt system, og ikke nødvendigvis svar til hvad d kan findes i taksten ell i dosingsforslagene. En lokal enhed skal være så entydig at andre sundhedspson, apotek og patient har mulighed for at forstå dosingen. Eksempl (tekst i ental - tekst i fltal): tablet - tablett kapsel - kapsl pust - pust dråbe - dråb Enhedne kan angives i ental ell i fltal. Dette gør det muligt at præsente aftagen for en læsevenlig tekst. Enhedne skal angives i XML elementet DosageQuantityUnitTet. <Dosage> <Structure>... <UnitTet source="lokal" date=" ">stk</unittet>... </Structure> </Dosage> Se afsnit 4.15 for en gennemgang af strukturede dosing. I FMK d i den aktuelle vsion ingen validing af dosingsenheden. D arbejdes dog fortsat på at skaffe datagrundlag hfor. Det dfor vigtigt at sikre at systemet d hent data fra FMK kan håndte ukendte dosingsenhed. Dvs. at systemet ikke fejl ell eventuel foretag en fejlagtig omregning. Desuden at system d ovfør data til FMK kun anvend alment forståelige enhed. Idet d ikke findes et datagrundlag hfor, dette stadig en vurdingssag. Type af effektuing Typen af effektuing kan være: indgivet udlevet en- ell flgangs apoteksudleving dosisdispenset apoteksudleving Denne liste fuldstændig, og typne definet i XML skemaet. De to første typ angiv at lægen direkte har indgivet ell udleve lægemidlet. De to sidste typ angiv hvad d foretage på apoteket: En "almindelig" udleving, hvor d ikke skelnes mellem en engangsudleving og en reitet udleving, og en dosisdispenset udleving. D skelnes ikke mellem engangsudleving og flgangsudleving idet apoteket alligevel kan foretage en engangsudleving af fle gange. 29

30 Typen af effektuingen findes i XML elementet EffectuationMethod. D anvendes ingen attributt til kildeangivelse. Aktive substans På et lægemiddel kan d angives hvilke aktive substans d indgår. Dette specielt intessant i forbindelse med lægemidl uden for taksten og for magistrelle lægemidl. Aktive substans findes i Medicinpris (Lægemiddelstyrelsens takst) i LMS30. D anvendes data fra kolonnen "Substans". Eksempl: Paracetamol Caffein Betula vrucosa Ehrh. (Vortebirk, synonym af B. pendula Roth) D findes i taksten ikke information om hvilke standard den aktive substans angivet eft. Altnativt kan de aktive substans angives som fritekst. Hvis aktive substans angivet ved oprettelsen af en lægemiddelordination, vil de tilsvarende blive returnet ved sene forespørgsl. I øvrige tilfælde bliv substans ikke returnet fra FMK. <Substances> <ActiveSubstance> <Tet source="medicinpris">natriumchlorid</tet> </ActiveSubstance> </Substances> I Code-elementets source-attribut angives kilde til datasættet. For enheden for en aktiv substans kan dette være: Medicinpris for taksten. I dette tilfælde skal attributten date ell yearandweek forekomme og henvise til den anvendte takstvsion, se i øvrigt Takst og takstvsion. Chemical Abstract (CAS) for angivelse med Chemical Abstract som kilde. Local for en angivelse eft en lokal anvendt standard. Håndting af inkonsistente stamdataangivels I det tilfælde hvor d angives en kode og en fritekst for et givet sæt af stamdata og d ikke konsistens mellem disse, vil friteksten blive gemt sammen med koden. Ved eftfølgende visning vil stamdata blive fremsøgt ud fra koden, og kan således potentielt afvige fra den indtastede fritekstværdi Registring af pson og organisation på FMK Ved registring af ændring (oprettels, opdating, seponing osv.) på FMK skal d angives hvilken ell hvilke pson d involvet i denne handling. Afhængigt af situationen kan d indgå en ell fle pson, og registringen kan dfor være me ell mindre kompleks. I XML-dokumentne i FMK 1.2 findes d et enkelt sæt element til registring af psonen og organisationen d har taget beslutning om ændringen. I FMK 1.4 udvides XML-dokumentne således at d også kan indgå en registring af psonen og organisationen d indrapport ændringen. Desuden udvides FMK 1.4 med en validing af psonne i XML-dokumentne. Det dfor nødvendigt med en klar specifikation og fælles forståelse af hvorledes elementne anvendes. 30

31 Aktør Vi defin dfor de følgende fire aktør, hvor d vil være et ovlap afhængigt af situationen: Beslutningstag Beslutningstagen lægen, sygeplejsken m.v. d har haft kontakten til patienten, og som har truffet beslutningen om at patientens medicining skal ændres. Beslutningstagen kan have retten til at ændre patientens medicining på baggrund af sin egen autorisation, ell via en rammeordination, instruks ell lignende. I FMK 1.4 skal beslutningstagen og dennes organisation registres i XML-dokumentet i CreatedBy / ModifiedBy m.v. Ansvarlig for ordinationen Såfremt beslutningstagen, f.eks. i kraft af sin autorisation, ikke i sig selv har ret til at ændre patientens medicining, skal d optræde en anden pson som ansvarlig for ordinationen. Eksempelvis kan en sygeplejske handle ud fra en instruks ell rammeordination. D vil h findes en læge d ansvarlig for instruksen ell rammeordinationen. Psonen ansvarlig for ordinationen findes ikke i FMK. Patienten har ikke kontakt den ansvarlige for ordinationen, ell nødvendigvis vidende om at vedkommende findes. Ctifikatej Ctifikatejen psonen d registr en ændring på FMK. Dvs. psonen d anvend LPS, EPJ- ell EOJ-systemet, ell altnativt FMK-online. Ctifikatejen kan f.eks. være en læge, sygeplejske ell en lægesekretær. Ctifikatejen altid identificet via sit MOCES-ctifikat, d anvendes til at få adgang, og kald til FMK vil dfor altid med sikkhed kunne relates til en ctifikatej. Information omkring ctifikatejen kan findes i ReportedBy-elementet, d anvendes som følg: Såfremt ctifikatej adskill sig fra beslutningstag skal ReportedBy anvendes til at registre information omkring ctifikatej og dennes organisation. D valides at det samme pson d optræd på ctifikatet og i ReportedBy. Er ctifikatej den same som beslutningstag anvendes CreatedBy / ModifiedBy (dvs. som i FMK 1.2). I dette tilfælde valides at det samme pson d optræd på ctifikatet og i CreatedBy / ModifiedBy m.v. Ansvarlig for kaldet til FMK Kaldet til FMK kan indeholde en ansvarlig for kaldet til FMK. Dette angives som på vegne af i head-elementet ved kaldet til FMK. Psonen ansvarlig for kaldet til FMK valides via FMKs bemyndigelsesregist, altnativt valides at systemet trustet. Denne dfor (set isolet for FMK) validet, men mindre sikk end ctifikatej. Ændret af patient ell anden pson I FMK 1.4 untøtt snitfladen, at en pson d ikke en autoriset sundhedspson kan ændre FMK. Eksempelvis kan FMK på et tidspunkt tillade, at en patient logg på FMK-online og selv privatmark en lægemiddelordination. Af ModifiedBy vil d dved fremgå at patienten selv har opdatet lægemiddelordinationen og medicinkortet. 31

32 Tilsvarende kan det tænkes, at andre pson i fremtiden kan få adgang til at opdate information på FMK. Eksempelvis at en social- og sundhedsassistent registr en effektuing. I denne situation skal psonen, psonens rolle og evt. organisation registres på medicinkortet. At det ikke længe (kun) en autoriset sundhedpson d involvet vil ikke ændre ovenstående forhold. Forskellige aktør i samme kald På FMK kan d genelt foretages fle ens opdating i samme kald. F.eks. kan d oprettes fle lægemiddelordination i samme kald af denne svice. Desuden kan svicen pdating af medicinkort anvendes til at foretage forskellige typ af opdating på samme CPR-numm. F.eks. ved udskrivning fra sygehus kan en ell fle lægemiddelordination sepones, nye kan oprettes og medicinkortet kan frigives, alt i samme kald. I FMK 1.4 snitfladen ændret, således at oprettet af, ændret af m.v. flyttet ind i på f.eks. lægemiddelordinationen, således at d forbedt mulighed for at d f.eks. i samme kald kan oprettes fle lægemiddelordination m.v. d besluttet af fle læg, men indrapportet af samme sundhedspson. Eksempl Praksislæge oprett selv en lægemiddelordination Det simplest mulige tilfælde opstår hvor en praksislæge selv eksempelvis oprett en lægemiddelordination på FMK ved en almindelig konsultation. Beslutningstag: Ansvarlige for ordinationen: Ctifikatej: Ansvarlige for kaldet til FMK: Praksislægen selv, angives i CreatedBy Praksislægen selv (indgår ikke i FMK) Praksislægen selv, ReportedBy anvendes ikke Praksislægen selv, på vegne af anvendes ikke ReportedBy anvendes ikke og d valides dfor at ctifikatej lig med beslutningstag, dvs. at d ovensstemmelse med psonen angivet i MOCES-ctifikatet og indholdet i CreatedBy. På vegne af anvendes ikke. Praksislægens lægesekretær oprett en lægemiddelordination I dette tilfælde oprett praksislægens medhjælp en lægemiddelordination på FMK på vegne af praksislægen. Beslutningstag: Ansvarlige for ordinationen: Ctifikatej: Ansvarlige for kaldet til FMK: Praksislægen selv, angives i CreatedBy Praksislægen selv (indgår ikke i FMK) Praksislægens medhjælp, angives i ReportedBy Praksislægen, angives i på vegne af ReportedBy anvendes og d valides dfor at ctifikatej lig med hvad d angivet i ReportedBy, dvs. at d ovensstemmelse med psonen angivet i MOCES-ctifikatet og indholdet i ReportedBy. På vegne af anvendes, og det valides at praksislægen har bemyndiget medhjælpen, ell at systemet trustet. Sygehuslæge ordin, en anden sygehuslæge oprett på FMK En situation d kan opstå ved udskrivning fra sygehus, at en læge A har oprettet en ordination i EPJ-systemet. På tidspunktet hvor patienten udskrives skal d oprettes en ny lægemiddelordination på FMK ud fra ordinationen, og dette foretages af læge B. 32

33 Beslutningstag: Ansvarlige for ordinationen: Ctifikatej: Ansvarlige for kaldet til FMK: Sygehuslæge A, angives i CreatedBy Sygehuslæge A selv (indgår ikke i FMK) Sygehuslæge B, angives i ReportedBy Sygehuslæge B, på vegne af anvendes ikke ReportedBy anvendes og d valides dfor at ctifikatej lig med hvad d angivet i ReportedBy, På vegne af anvendes ikke. Sygehuslæge ordin, en medhjælp oprett på FMK Som en udvidelse af forrige eksempel det ikke en anden sygehuslæge d oprett på FMK, men dennes medhjælp. Beslutningstag: Ansvarlige for ordinationen: Ctifikatej: Ansvarlige for kaldet til FMK: Sygehuslæge A, angives i CreatedBy Sygehuslæge A selv (indgår ikke i FMK) Sygehuslæge B's medhjælp, angives i ReportedBy Sygehuslæge B, angives i på vegne af ReportedBy anvendes og d valides dfor at ctifikatej lig med hvad d angivet i ReportedBy, På vegne af anvendes, og det valides at sygehuslæge B har bemyndiget medhjælpen, ell at sytstemet trustet. Sygeplejske ordin, en medhjælp oprett på FMK Som en en ydlige komplicing af forrige eksempel det en sygeplejske d ordin ud fra en rammeordination. Beslutningstag: Ansvarlige for ordinationen: Ctifikatej: Ansvarlige for kaldet til FMK: Sygeplejske, angives i CreatedBy Sygehuslæge A (indgår ikke i FMK) Sygehuslæge B's medhjælp, angives i ReportedBy Sygehuslæge B, angives i på vegne af ReportedBy anvendes og d valides dfor at ctifikatej lig med hvad d angivet i ReportedBy, På vegne af anvendes, og det valides at sygehuslæge B har bemyndiget medhjælpen, ell at systemet trustet. I dette tilfælde vil sygehuslæge A ikke være synlig. Sygehuslæge A kan f.eks. være den ansvarlige ovlæge i akutmodtagelsen, og det vil digennem lokalt være klart at sygeplejsken igennem sin arbejdssituation på akutmodtagelsen må ordine medicin, og at den ansvarlige ovlæge skal sikre at dette sk på ansvarlig vis, f.eks. ud fra uddannelse, instruks, rammeordination ell lignende Lægemiddelordinationens gyldighedsintval En lægemiddelordinations gyldighedsintval definet som intvallet fra den oprettet til den seponet. Oprettelsesdatoen sættes automatisk af FMK. Seponingsdatoen valgfri. Hvis den ikke angives vil lægemiddelordinationen være gyldig indtil vide. Pausing af lægemiddelordinationen Lægemiddelordinationens sammenhængende gyldighedsintval kan afbrydes af en midltidig pausing. Pausingen gyldig fra det tidspunkt, hvor svicen på FMK kaldes. Pausingen ophæves ved igen at kalde en svice på FMK, hvorved lægemiddelordinationens pausing ophæves fra dette tidspunkt. En pauset lægemiddelordination vil stadig blive returnet på patientens aktuelle medicinkort, den betragtes stadig som en del af patientens aktuelle medicining. 33

34 Seponing af lægemiddelordinationen Uanset om lægemiddelordinationens seponingsdato angivet ell ej kan lægemiddelordinationen sepones, med gyldighed fra det tidspunkt hvor svicen kaldes. Hvis ingen seponingsdato angivet, lægemiddelordinationen gyldig indtil den aktivt bliv seponet. En lægemiddelordination kan dog også opdates med et nyt gyldighedsintval, og dmed få tilknyttet en seponingsdato. Hvis en lægemiddelordination sepones med Sepon lægemiddelordination vil dens seponingsdato blive sat. Seponede lægemiddelordination vil ikke blive returnet på patientens aktuelle medicinkort. Ændring af lægemiddelordinationen Ved dosisændring ell udstedelse af en ny recept, det vigtigt at dette sk på den oprindelige lægemiddelordination. Sk dette ikke, mistes historikken på lægemiddelordinationens forløb. Seponing af lægemiddelordinationen og eftfølgende oprettelse af en ny lægemiddelordination, bør kun finde sted, såfremt behandlingen med det aktive indholdsstof skal ophøre. Det vigtigt, bl.a. af hensyn til patientsikkheden, at denne regel ovholdes. Lægemiddelordinationens oprettelsesdato Lægemiddelordinationens oprettelsesdato sættes automatisk af FMK til det tidspunkt, hvor oprettelsen sk i FMK. Lægemiddelordinationens startdato D kan angives en startdato for en lægemiddelordination. Ved en nyoprettelse sættes den lig med dags dato. Ved registring på FMK af en lægemiddelordination, som patienten allede i behandling med, kan datoen angives tilbagedatet. Startdatoen vil oftest kunne fremsøges i journal, men også data fra Receptsven (endnu ikke tilknyttede recept) vil kunne bidrage som kilde til oplysningen. I de tilfælde hvor en sammenhængende behandling startet tidlige end dags dato, men lægen ikke har kendskab til datoen, d mulighed for at marke dette med feltet startet tidlige, dato ukendt. Intvallet fra lægemiddelordinationens startdato til seponingsdato kaldes for behandlingsintvallet. Lægemiddelordinationens seponingsdato Lægemiddelordinationens seponingsdato ikke obligatorisk. Hvor lægemidlet skal gives til et kendt tidspunkt ell i en kendt piode vil lægemiddelordinationens seponingsdato være bestemt haf. Dette betegnes i visse system som en temporær behandling. Altnativt kan seponingsdato udelades, h anvend visse system begrebet fast behandling. Er d ingen seponingsdato vil lægemiddelordinationen blive returnet på det aktuelle medicinkort. Har lægemiddelordinationen en seponingsdato, og denne passet, vil lægemiddelordinationen ikke længe blive returnet på det aktuelle medicinkort. Lægemiddelordinationens seponingsdato kan aktivt tildeles sene i en lægemiddelordinations levetid via en opdating af lægemiddelordinationen. Lægemidlet kan sepones øjeblikkeligt, hvorved seponingsdatoen sættes til dags dato. 34

35 4.12 Dosingens gyldighedsintval Dosingens startdato Dosingens startdato obligatorisk. Denne vil ofte være dags dato, datoen afspejl den tidligste dato, hvor lægemidlet vil være til rådighed. Ved udstedelse af recept startdatoen ikke sikk, idet patienten kan vente en tid med at afhente lægemidlet på apoteket. D vil i FMK ikke blive taget højde for denne usikkhed, ligesom d hell ikke kan tages højde for, at patienten vent med at tage lægemidlet, ell helt undlad at gøre det. Dosingens startdato kan dog også fremdates, hvor d et klinisk behov hfor. Dosingens slutdato Dosingens slutdato ikke obligatorisk. Hvor lægemidlet kan tages eft behov ell i variende mængde kan slutdatoen udelades. Ells kan slutdatoen bestemmes ud fra startdatoen og den gennemsnitlige dagsdosis. Dosingens start- og slutdato har ingen indflydelse på om lægemiddelordinationen vil blive returnet på patientens aktuelle medicinkort Sammenhæng mellem lægemiddelordinationens behandlingsintval og dosingens gyldighedsintval Dosingens gyldighedsintval skal altid være en delmængde af lægemiddelordinationens gyldighedsintval. Dosingen kan således ikke starte før lægemiddelordinations oprettelsesdato. Figurne hund illustr nogle eksempl på sammenhænge. Figur 2: Lægemiddelordination hvor startdatoen og seponingsdatoen svar til dosingens start- og slutdato. Figur 3: Lægemiddelordination hvor startdatoen tilbagedatet. Dosingens startdato dags dato, slutdatone ens. De to ovenstående figur illustr sammenhængen mellem lægemiddelordinationens og dosingens gyldighedsintval. I begge tilfælde d tale om en temporær behandling, på figur 3 lægemiddelordinationens startdato tilbagedatet. Behovet for tilbagedating af en temporær behandling næppe hyppigt forekommende. 35

36 Figur 4: Lægemiddelordination uden seponingsdato. Dosingen har en anden start og slutdato. Figur 5: Lægemiddelordination og dosing uden seponings- og slutdato. På figurne ovenfor vist lægemiddelordination for to faste behandling. I det første tilfælde har dosingen en slutdato, i det andet tilfælde ikke. Forskellen kan f.eks. opstå idet d på figur 4 skal udstedes en recept med en fast daglig dosis og dosis på figur 5 eft behov. Figur 6: Ændring af dosing via opdating af lægemiddelordinationen Figur 7: Ændring af dosing, dosingne har ingen slutdato På figur 6 og 7 d vist to eksempl på en lægemiddelordination med to dosisændring. På figur 6 dosisændringne foretaget når den forrige dosis ophørt. På figur 7 dosisændringne foretaget selv om 36

37 den forrige dosis ikke ophørt. Idet en ændring af dosis foretages ved at lægemiddelordinationen opdates d kun den sidste dosing d gyldig (vist ved at de forrige dosing streget ud). Fremdating Ovordnet frarådes d at opdate FMK med dato frem i tiden. Handling registret frem i tiden vil i sagens natur være behæftet med en vis usikkhed. D kan dog alligevel være nogle områd, hvor det rent arbejdsgangsmæssigt giv mening. Eksempelvis kan d for en patient, som indlagt på sygehuset fredag, besluttes at patienten skal udskrives mandag. Fredag bliv d oprettet lægemiddelordination med behandlingsstart fra mandag. Såfremt denne arbejdsgang anvendes, skal d tages højde for, at patienten alligevel ikke kan udskrives (f.eks. hvis patientens tilstand mod forventning forværres), og at de nyoprettede lægemiddelordination dfor skal sepones i en sene arbejdsgang Sammenhæng mellem gyldighedsintvall og recepten På nuværende tidspunkt giv lægen instruktion til apoteket om at udleve et lægemiddel ved at d udstedes en recept. På FMK sk dette gennem receptsven, teknisk ved at FMK ud fra data i svicekaldet og data på lægemiddelordinationen dann Den Gode XML recept, d sendes gennem receptsven til apoteket. D endnu ikke definet en entydig sammenhæng mellem lægemiddelordinationens gyldighedsintval, dosingens gyldighedsintval og receptens udstedelsesdato, antal udleving m.v. Det anbefales at dosingens start- og slutdato følg receptens oprettelsdato og forventet slutdato. For dosing eft behov kan d ikke bestemmes en forventet slutdato og h kan dosingens slutdato undlades. Det skal dog være klart at ovenstående kun en anbefaling, ikke en regel Strukturet dosing I det fælles medicinkort indføres d en mulighed for at beskrive dosing af lægemidl på strukturet form. Dosingsstrukturen indført af fle årsag: Fælles format Det fælles medicinkort skal anvendes via lægepraksissystem (LPS), speciallægesystem og EPJ-system. D dfor behov for en struktur, d gør det muligt at ovføre en dosing fra disse typ af system. Dosing i lægepraksissystem vil typisk enten ske via takstens dosingskod (i omkring 2/3 af tilfældene) ell i fritekst. Dosing i EPJ-system angives i me komplicede struktur. Begrænset antal kod Takstens dosingskod en endelig liste af kod og tekst. En del forholdsvist simple dosing kan ikke ovsættes til dosingskod, simpelthen fordi koden ikke findes. F.eks. findes d ingen kode for 7 tablett dagligt. Klar adskillelse af dosing, form og administrationsvej En del dosingskod indehold ud ovdosingen også information omkring lægemidlets form og administrationsvejen. Dette gør genbrugeligheden mindre og kodesættet større. 37

38 Eksempelvist indehold dosingsteksten "1 dråbe i højre øje 8 gange daglig" både formen "dråbe" og administrationsvejen "højre øje". En lang række kod adskilles kun af lægemidlets form, f.eks. nedenstående uddrag: 2 tablett daglig 2 kapsl daglig 2 lamell daglig 2 dos daglig Ovsættelse fra struktur, hent medicinkort og lægemiddelordination Idet et medicinkort ell en lægemiddelordination hentes fra Det fælles medicinkort skal d i mange tilfælde ske en ovsættelse fra dosingsstrukturen til en intn repræsentation i LPS/EPJ-systemet. Det forventes at denne ovsættelse skal ske assistet, og at en stor del af de simple dosing uden vide kan importes. Det anbefales at d så vidt muligt anvendes dosing på formen morgen + middag + aften +nat. En væsentlig del af dosingne vil kunne angives på denne form. Sammen med en strukturet dosing vil d blive returnet en dosingsovsættelse, dvs. en ovsættelse af den strukturede dosing til en lang og en kort tekst. For dosing med fle piod vil d blive returnet dosingsovsættels for hv piode og for alle piod samlet. Kort dosingsovsættelse Den strukturede dosing ovsættes til en kort tekst, hvor dette muligt. Den korte tekst så tæt på den formuling d hidtil har været benyttet, f.eks. "2 tablett dagligt", og på højst 70 tegn. Det dog ikke altid muligt at ovsætte dosingsstrukturen til en kort tekst, og denne vil dfor ikke altid findes i svaret. Det må forventes at kun et begrænset sæt af de modtagne dosingsstruktur kan ovsættes til dosingskod. D bør dfor und alle omstændighed implementes en funktionalitet til at vise dosingsstrukturne. Lang dosingsovsættelse Den lange dosingsovsættelse vil altid blive returnet, såfremt d eksist en strukturet dosing på lægemiddelordinationen. For dosing eft skema i eget system og i fritekst vil d ikke blive returnet nogen ovsættelse. Den lange dosingsovsættelse først og fremmest tænkt brugt i de tilfælde hvor LPS/EPJ-systemet modtag en dosing som ikke kan håndtes i systemet. Elles bør dosingen så vidt muligt angives på samme måde som dosing oprettet lokalt, dvs. vises i felt, tabell m.v. Systemets bruge bør kun undtagelsesvist præsentes for den lange dosingsovsættelse. Den lange dosingsovsættelse tæt relatet til dosingsstrukturen. Først præcises hvornår dosingen start. Denne dato altid datoen for dosingens start, som angivet i den strukturede dosing. Dosingens startdato tilføjes for at undgå misforståelse af hvorvidt dosingen start en mandag (idet den første dag i dosingens forløb tidlige var vist som dag 1 ), ell hvorvidt dosingen f.eks. start dags dato ell datoen for lægemiddelordinationen. 38

39 Heft fortsættes linjen med information omkring evt. gentagelse (den strukturede dosings itationsintval) og hvorvidt dosingen ophør eft det angivne forløb, dvs. om dosingen itet ell ej. Altnativt kan d angives at dosing kun foretages på den angive dato, såfremt dosingen kun gives en enkelt dag. Heft kan d være supplet med information om at dosingen vari (at de daglige dosing forskellige ) og at dosingen har et komplekst forløb (at dosingen ikke udelukkende sk på fortløbende dage). Eksempl på lang dosingsovsættelse 1 tablet morgen, ovsat til lang tekst: Dosingsforløbet start onsdag den 18. april 2012 og gentages hv dag: Dosingsforløb: 1 tablet morgen 1 tablet morgen dag 1, 1 tablet morgen og aften dag 2 Dosingsforløbet start onsdag den 18. april 2012, forløbet gentages hv 2. dag. Bemærk at dosingen vari: Dosingsforløb: Onsdag den 18. april 2012: 1 tablet morgen Torsdag den 19. april 2012: 1 tablet morgen + 1 tablet aften Nedtrapning: Dosingsforløbet start onsdag den 18. april 2012 og ophør eft det angivne forløb. Bemærk at dosingen vari: Dosingsforløb: Onsdag den 18. april 2012: 2 stk morgen + 2 stk middag + 2 stk aften Torsdag den 19. april 2012: 2 stk morgen + 1 stk middag + 2 stk aften Fredag den 20. april 2012: 1 stk morgen + 1 stk middag + 2 stk aften Lørdag den 21. april 2012: 1 stk morgen + 1 stk aften Søndag den 22. april 2012: 1 stk morgen + 1 stk aften Mandag den 23. april 2012: 1 stk aften Dosing eft behov med maksimal daglig dosis: Dosingsforløbet start fredag den 13. april 2012 kl. 20:06:00 og gentages hv dag: Dosingsforløb: 2 stk eft behov højst 1 gang daglig Dosing eft behov: Dosingsforløbet start lørdag den 1. januar 2011: Dosingsforløb: Eft behov: 2 stk eft behov ved smt Gennemsnitlig daglig dosis For strukturede dosing kan d i en del tilfælde begnes en gennemsnitlig daglig dosis, evt. som et intval for dosing angivet som et intval (f.eks. 2-3 stk 2 gange daglig). Den gennemsnitlige daglige dosis returnes såfremt: dosingen angivet på strukturet form, dosingen ikke helt ell delvist kan ske eft behov dosingen gentaget ell sk ov et fast angivet antal dage (dvs. at dag 0 ikke forekomm). 39

40 Ovsættelse til struktur, oprettelse ell opdating Skal d oprettes en lægemiddelordination, ell skal en eksistende lægemiddelordination opdates skal d medsendes en dosing. Denne skal så vidt muligt angives på strukturet form. I den strukturede dosing det muligt at angive en lang række form for dosing, f.eks. også op- ell nedtrapning. Det dog ikke givet at alle form for dosing kan ovføres til medicinkortet. F.eks. vil et anti-koagulationsskema ikke kunne ovføres til det fælles medicinkort, men skal i stedet angives som dosing eft skema i eget system. Det desuden muligt at angive dosing i fritekst. Denne mulighed skal dog kun undtagelsesvist benyttes. F.eks. må fritekst-dosingen fra en en strukturet dosing ikke returnes i dette element, idet dette vil medføre et tab af datakvalitet og gøre en sene brug af disse data i andre sammenhænge umulig. Ved ovførsel fra et medicinkort i et EPJ-system kan det i visse tilfælde være nødvendigt at ovsættelsen sk assistet. D skal kun ovføres de lægemiddelordination til det fælles medicinkort som fortsættes eft at patienten udskrevet, enten ved at patienten hjemsendes med et ell fle lægemidl, ell ved at d udstedes en recept. En del af dosingne i EPJ-systemet, som relevante for patientens vide medicining eft at patienten udskrevet, vil kunne ovføres direkte til det fælles medicinkort. Hvor stor en del dette udgør, vil afhænge af EPJ-systemets medicinkort. Dosingstekst I den nuværende takst findes d et antal dosingstekst knyttet til lægemidlne. Disse dosingstekst vedligeholdes p.t. af Lægemiddelstyrelsen, men skal ikke opfattes som vejledende ell anbefalede, og fortrinsvis til brug på apotekne til angivelse på labels. I dag anvendes disse dosingstekst i visse lægepraksissystem som foreslag til lægen. Lægemiddelstyrelsen betænkelig ved denne anvendelse. D opfordres til at d først og fremmest anvendes strukturede dosing på formen antal morgen + middag + aften + nat. I afsnittet Strukturet dosing side 97 beskrives XML elementne for dosingsstrukturen, og i afsnittet Dosingstruktur supplende beskrivelse side 110 findes en række eksempl Vsioning af svices FMK 1.3 og 1.4 defines i en separat WSDL-fil og via et selvstændigt endpoint. FMK 1.2 vil stadig være tilgængeligt, men som separate websvices. Alle vsion vil tilgå de samme data, men forskellene i snitfladne vil nødvendigvis betyde at ikke alle oplysning oprettet via en vsion tilgængelige, når de hentes via en anden vsion. End-points Hv vsion af snitfladen vil få tildelt et særskilt end-point, FMK 1.3 og 1.4 vil få end-point: Actions Action prefi for de enkelte websvices ligeledes påvirket af de samtidigt aktive snitflad. For FMK 1.3 og 1.4 benyttes følgende prefi: 40

41 Namespaces FMK skemane placet i name spaces d navngives med datoen for snitfladen. Skemane for FMK 1.3 og 1.4 findes alle i samme namespace: mlns:medicinecard=" 41

42 5 Svices I det følgende gennemgås de svices som FMK udstill. For hv svice beskrives forespørgselsbeskeden, svarbeskeden og fejlmeddelels. En oprettelse ell opdating af data d ikke foregået ud fra et opdatet medicinkort vil, som beskrevet i afsnittet Vsionsnumming, medføre, at d foretages en logning og det tomme element VsionMismatchWarning vil returnes i svar-dokumentet. Dette element udeladt i de følgende eksempl. 5.1 Hent medicinkort Svicen Hent medicinkort return et ell fle medicinkort med tilknyttede aktive lægemiddelordination, og afhængigt at de medsendte parametre med recept og effektuing. Ved opslag med dato og til ell med et specifikt vsionsnumm returnes medicinkortet som det så ud på dette tidspunkt (ved opslag med vsionsnumm svarende til tidspunktet vsionen blev oprettet). D kan dved returnes lægemiddelordination d aktuelt ikke længe aktive, men seponede ell udløbne. Forespørgsel Et eksempel på en forespørgsel eft det aktuelle medicinkort ses hund. Denne vil returne et medicinkort med de aktive lægemiddelordination, eventuelt et tomt medicinkort, for psonen med dette CPR-numm, såfremt CPR-nummet kendt af FMK. Hvis CPR-nummet ikke kendt sendes en fejlbesked. <GetMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <NegativeConsent> <ConsentGiven> <FromDate> </FromDate> <ToDate> </ToDate> </ConsentGiven> </NegativeConsent> <IncludePrescriptionMedications>true</IncludePrescriptionMedications> <IncludeEffectuations>true</IncludeEffectuations> <IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications> </GetMedicineCardRequest> Privatmarking Med det optionelle element NegativeConsent angives at d også ønskes returnet lægemiddelordination market med privatmarking. Årsagen htil skal angives ved anvendelse af en af de to XML-element: ConsentOvridden såfremt opslaget sk for nødvendig til varetagelse af en åbenbar almen intesse ell af væsentlige hensyn til patienten. ConsentGiven såfremt opslaget sk eft mundtlig ell skriftlig samtykke. Disse to typ af forespørgsl vil blive logget specielt. Såfremt opslaget sk eft patientens samtykke, skal d i kaldet angives i hvilket datointval dette samtykke sk. Værdien kan evt. anvendes i forbindelse med opfølgning på logdata, men har i øvrigt ingen indvirkning på omfanget af de returnede data. 42

43 I vsion 1.2. af snitfladen var det kun nødvendigt at give NegativeConsent elementet med én gang indenfor 24 tim. Eftfølgende kald, indenfor 24 tim, ville så også inklude eventuelle privatmarkede lægemiddelordination. Dette ændret i vsion 1.4 af snitfladen. I vsion 1.4 skal NegativeConsent elementet gives med hv gang eventuelle privatmarkede lægemiddelordination ønskes inkludet i responset. Valg af indhold i response Request-dokumentet indehold en række felt til angivelse af, hvad d ønskes returnet i responset. Medicinkort-delen og lægemiddelordination returnes altid. Dov kan d angives: IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordination. Dette uanset om receptordinationne knyttet til lægemiddelordination ell aktuelle løse receptordination. IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektuing. I så fald gæld dette både effektuing på lægemiddelordination og effektuing på receptordination, dog vil effektuing på receptordination ikke blive returnet hvis IncludePrescriptionMedications false. IncludeNonRelevantPrescriptionMedications: Sættes elementet til true vil løse receptordination blive returnet, uanset om de market som uaktuelle ell ej. Sættes elementet til false vil løse recept market som uaktuelle ikke blive returnet. Flaget har ingen mening, såfremt IncludePrescriptionMedications false. Med "løse" receptordination (evt. også omtalt som løse recept) menes receptordination d ikke tilknyttet en lægemiddelordination, og som oprettet uden om det fælles medicinkort på f.eks. EDIFACT-, papir- ell telefonrecept. FMK hent receptordination fra Receptsven. Forespørgsel på tidlige vsion Ønskes d en tidlige vsion af medicinkortet kan d forespørges ud fra vsionsnumm. Forespørges d på en vsion d ikke findes (dvs. med en høje værdi en den aktuelle vsion) vil kaldet fejle. <GetMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <Vsion> </Vsion> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> <IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications> </GetMedicineCardRequest> Kombinationen af en vsions- og en IncludeNonReviewedOnly-angivelse result i løse recept, d begnes som følg: Receptne skal være nye end den seneste receptgennemgang d tidlige end datoen for denne vsion, og ældre end medicinkortvsions seneste gyldighedstidspunkt. Endelig kan d forespørges eft medicinkortet som det så ud på et givent tidspunkt, dvs. med et tidsstempel. <GetMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <DateTime> T09:51:00Z</DateTime> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> <IncludeNonRelevantPrescriptionMedications>false</IncludeNonRelevantPrescriptionMedications> </GetMedicineCardRequest> 43

44 De tre typ af forespørgsl kan kombines i samme kald. Kombinationen af en vsions- og en IncludeNonReviewedOnly-angivelse result i løse receptordination, d begnes som følg: Receptne skal være nye end den seneste receptgennemgang d tidlige end datoen for denne vsion, og ældre end denne medicinkortvsions seneste gyldighedstidspunkt. Svar D returnes et medicinkort uden effektuing, ell eventuelt fle vsion af samme medicinkort. Såfremt d endnu ikke oprettet data på medicinkortet, men patienten findes, vil d blive returnet en medicinkort-ovsigt med vsionsnumm 0 og uden elementet ModifiedStructure. Det returnede dokument vil indeholde psoninformation. <GetMedicineCardResponse> <MedicineCard> <Patient> <Pson> <Name> <GivenName>Rob</GivenName> <Surname>Müll</Surname> </Name> <PsonIdentifi> </PsonIdentifi> </Pson> <Address> <StreetName>Magnolievej</StreetName> <StreetBuildingIdentifi>842</StreetBuildingIdentifi> <FloorIdentifi>4</FloorIdentifi> <PostCodeIdentifi>8653</PostCodeIdentifi> <DistrictName>Them</DistrictName> </Address> </Patient> <Vsion>0</Vsion> </MedicineCard> </GetMedicineCardResponse> Elementet GetMedicineCardResponse vi indeholde et ell fle MedicineCard-element. Responset kan indeholde fle medicinkort som svar, idet d kan forespørges på f.eks. fle vsion ell fle tidspunkt. En nærme gennemgang af indholdet i MedicineCard-elementet findes i afsnittet Medicinkort og lægemiddelordination. 5.2 Hent medicinkort som PDF dokument Svicen gør det muligt at hente et medicinkort som et PDF dokument. Formålet hmed at kunne præsente et medicinkort på papir, hvor formatet fælles uanset hvilket system lægen brug. PDF udgaven af medicinkortet kan være til patienten selv ell til lægen. Forespørgsel Forespørgslen sendes i MedicineCardAsPDFRequest-elementet. Opslaget på medicinkortet i PDF-format har de samme mulighed for at slå op på historiske vsion som den almindelige forespørgsel til at hente medicinkort (se beskrivelsen i afsnit 5.1 Hent medicinkort). Idet d returnes et standardiset print for enten borg ell læge skal print-typen vælges, og d kan ikke vælges om printet skal indeholde recept (løse ell tilknyttede) ell effektuing. 44

45 I elementet PrintType angives typen af PDF: Med læge angives at udskriften til lægens brug. Med borg angives at d i udskriften anvendt tm m.v. tilpasset borgens behov. <GetMedicineCardAsPDFRequest> <PsonIdentifi> </PsonIdentifi> <PrintType>læge</PrintType> </GetMedicineCardAsPDFRequest> Svar I svaret fra FMK vil d være et ell fle PDF dokument encoded i BASE64. Hvt MedicineCard-element vil indeholde et enkelt PDF-dokument, returnes d fle PDF dokument vil disse findes i hv des struktur. Er d linieskift i strengen i MedicineCard-elementet kan det være nødvendigt at fjne disse, alt eft hvilken decod d anvendes (f.eks. java.mail.intnet.mimeutility ikke følsom ov for linieskift mens JAXB ). <GetMedicineCardAsPDFResponse> <MedicineCard> <[CDATA[JVBERi0LjQKJeLjz9MKNCAwIG9iaiA8PC9MZW5ndGggMzEL0ZpbHRlci9GbGF0ZURlY29kZT4+ c3ryzwftcnicxvfbtsmwelznfxmsoil2upwqnobscakquj5g6k1wk9jfdiv4b6bi3alqfplslyz s7oz8lfyvcx5agvbojijq8qlwnytoxigqk4mg5jqq3rrredtlphwihkpwnkrxknwkb6pdpco2eca KyIfiDcrlRZeGY3m1EkKPqitgGnQk0TG2EPKeLjwqhujeZrzke1kY+Q5X08NefTiSO7b0hJU... bya4idagui9taxplidk+pgpzdgfydhhyzwykmta4maoljuvprgo=]]> </MedicineCard> </GetMedicineCardAsPDFResponse> Anvendes en standard decod processen til at danne en PDF-fil simpel, følgende eksempel anvend java.mail.intnet.mimeutility (fejlhåndting m.v. udeladt): String encodedpdf = (strengen i MedicineCard-elementet) if(encodedpdf.startswith("<![cdata[")&&encodedpdf.endswith("]]>")) encodedpdf = encodedpdf.substring(9, encodedpdf.length()-3); BuffedInputStream is = new BuffedInputStream(MimeUtility.decode( new ByteArrayInputStream(encodedPDF.getBytes()), "BASE64")); BuffedOutputStream os = new BuffedOutputStream( new FileOutputStream("medicinkort.pdf")); byte[] buff = new byte[is.available()]; is.read(buff); os.write(buff); is.close(); os.close(); 5.3 Hent medicinkort-vsion Ved opdating af data på et medicinkort skal d sikres, at dette sk på seneste vsion af medicinkortet. Hent medicinkort-vsion-svicen gør det muligt at kontrolle, om d findes en nye vsion, end den d findes lokalt i LPS ell EPJ-systemet. Forespørgsel I forespørgselen sendes kun patientens CPR-numm. <GetMedicineCardVsionRequest> <PsonIdentifi> </PsonIdentifi> 45

46 </GetMedicineCardVsionRequest> Svar FMK svar med patientens CPR-numm og medicinkortets vsionsnumm. Desuden returnes datoen for den sidste statusændring på patientens recept på receptsven. <GetMedicineCardVsionResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <PrescriptionMedicationDateTime> T12:31:16.0Z</PrescriptionMedicationDateTime> </GetMedicineCardVsionResponse> Såfremt d ikke kan opnås forbindelse til Receptsven, kaldet til receptsven fejl ell lignende vil d være tilføjet et element "PrescriptionSvError", d indehold en fejlbesked i tekstform (elementet ikke vist h). Seneste vsion fra FMK vil blive returnet, også selvom dette ikke kan returnes fra Receptsven. 5.4 Suspending af medicinkort Ved indlæggelse på sygehus skal sygehusets EPJ-system hente patientens medicinkort fra FMK, og heft vil patientens medicining registres i EPJ-systemet. Det skal markes i FMK, at denne ikke længe afspejl patientens aktuelle medicining. Dette sk ved at EPJ-systemet send en besked til FMK, d suspend medicinkortet. Det vil fremgå af beskeden, hvilket sygehus ell hvilken sygehusafdeling og hvilken læge d har foretaget suspendingen. SKS-koden for sygehuset ell sygehusafdelingen anvendes som nøgle. En patients medicinkort kan kun være suspendet med en enkelt marking ad gangen, og det ikke muligt for andre sygehuse ell sygehusafdeling at frigive medicinkortet. Ved en ambulant behandling, hvor medicinkortet løbende opdates, skal d ikke ske en suspending. Ved en kortvarig indlæggelse ell en indlæggelse, hvor d ikke foretages ændring på medicinkortet det ikke nødvendig at foretage en suspending. D kan forekomme situation, hvor det nødvendigt at indlægge en patient på et andet sygehus ell en anden sygehusafdeling end den d har foretaget suspendingen. Det andet sygehus ell den anden afdeling kan ovtage suspendingen ved at foretage en gensuspending som beskrevet i afsnittet Gensuspending af medicinkort Altnativt kan medicinkortet opdates og suspendingen ophæves, hvoreft det igen suspendes af den anden afdeling. Forespørgsel Ved suspending angives patientens CPR-numm og medicinkortets vsionsnumm. Heft angives information om sygehuset hvor patienten indlægges og oplysning om lægen, d har foretaget handlingen. <SuspendMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <SuspendedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> 46

47 <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </SuspendedBy> </SuspendMedicineCardRequest> Svar I svaret returnes patientens CPR-numm og vsionsnumm. <SuspendMedicineCardResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> </SuspendMedicineCardResponse> 5.5 Gensuspending af medicinkort Svicen til gensuspending gør det muligt at at et andet hospital ell en anden afdeling kan ovtage suspendingen af patientens medicinkort. Såfremt ovflyttelsen sk i samme EPJ-system d ikke behov for at ovføre information via FMK. I stedet kan denne svice anvendes. Forespørgsel Ved gensuspending angives patientens CPR-numm og medicinkortets vsionsnumm. Heft angives information om sygehuset hvortil patienten ovføres og - hvis det kendt - oplysning om lægen, d har foretaget handlingen. <ResuspendMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <SuspendedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>PKDXD</AuthorisationIdentifi> <Name>Tri Dalsgaard</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Amtssygehus</Name> <AddressLine>Tage-Hansens Gade 2</AddressLine> <AddressLine>8000 Århus C</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="sks">7004</identifi> </Organisation> </SuspendedBy> </ResuspendMedicineCardRequest> Svar I svaret returnes patientens CPR-numm og vsionsnumm. <ResuspendMedicineCardResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> 47

48 </ResuspendMedicineCardResponse> 5.6 Ophæv suspending af medicinkort (frigiv medicinkort) Suspendingen ophæves, når patienten udskrives fra sygehuset. Forud for suspendingen ophæves det vigtigt at sikre sig, at medicinkortet igen opdatet, så det svar til patientens aktuelle medicining. Frigivelse af medicinkortet skal ske, eft lægen har opdatet patientens medicining ved udskrivning. H angives udlevede lægemidl og lægemidl d udstedt på recept. EPJ-systemet skal sikre at opdatingen sk på den seneste vsion af medicinkortet. I (sjældne) tilfælde kan det ske, at medicinkortet på FMK opdatet mens det suspendet. EPJ-systemet kan f.eks. anvende svicen Hent medicinkort-vsion htil. Forespørgsel Ved frigivelse af medicinkortet angives patientens CPR-numm og medicinkortets vsionsnumm. Heft angives samme SKS-sygehusnumm ell SKS-sygehusafdelingsnumm som ved suspendingen af medicinkortet. D dimod ikke et krav om, at lægen den samme som ved suspendingen. <UnsuspendMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>VWG6Z</AuthorisationIdentifi> <Name>Tese Bundgård</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Amtssygehus</Name> <AddressLine>Tage-Hansens Gade 2</AddressLine> <AddressLine>8000 Århus C</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="sks">7004</identifi> </Organisation> </ModifiedBy> </UnsuspendMedicineCardRequest> Svar I svaret returnes patientens CPR-numm og medicinkortets vsionsnumm. <UnsuspendMedicineCardResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> </UnsuspendMedicineCardResponse> 5.7 Sæt marking for medicinafstemning Denne svice mark at en læge har taget stilling til medicinkortet og at lægemiddelordinationne på medicinkortet på det angivne tidspunkt repræsentede patientens aktuelle medicinske behandling. Opmærksomheden henledes på, at marking for medicinafstemning ikke påvirk eftfølgende visning af medicinkortets løse recept. Såfremt de løse recept også gennemgået og vurdet, skal de enkeltvis tilknyttes en lægemiddelordination ell markes som 'ikke aktuel', se svicen Mark receptordination som ikke aktuel for det sidste. 48

49 Forespørgsel Ved marking af medicinafstemning skal patientens CPR-numm og medicinkortets vsionsnumm angives. Desuden medsendes data om lægepraksis ell sygehus samt om lægen, d har foretaget markingen. Endelig medsendes tidspunktet. <SetMedicineCardReviewedRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <ReviewedDateTime> T13:10:44Z</ReviewedDateTime> </SetMedicineCardReviewedRequest> Svar I svaret returnes patientens CPR-numm og vsionsnumm. <SetMedicineCardReviewedResponse> <PsonIdentifi> </PsonIdentifi> <Vsion> </Vsion> </SetMedicineCardReviewedResponse> 5.8 Hent lægemiddelordination Svicen "Hent lægemiddelordination" hent en ell fle lægemiddelordination. Afhængigt af de medsendte parametre kan responset indeholde receptordination og effektuing på lægemiddelordinationen. En lægemiddelordination har et unikt ID, lægemiddelordinations-id ell DrugMedicationIdentifi, som tildeles af FMK, og som anvendes ved opslag direkte på lægemiddelordinationen. Forespørgsel Eksemplet vis en forespørgsel eft seneste vsion af lægemiddelordination. For at sikre at alle lægemiddelordination hør til samme medicinkort medsendes patientens CPR-numm. <GetDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <Identifi> </Identifi> <NegativeConsent> <ConsentGiven> <FromDate> </FromDate> <ToDate> </ToDate> </ConsentGiven> </NegativeConsent> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest> 49

50 Privatmarking Med det optionelle element NegativeConsent angives at såfremt en ell fle af lægemiddelordinationne market med privatmarking sk forespørgselen af en af to årsag, disse angives ved anvendelse af en af de to XML-element: ConsentOvridden såfremt opslaget sk for nødvendig til varetagelse af en åbenbar almen intesse ell af væsentlige hensyn til patienten. ConsentGiven såfremt opslaget sk eft mundtlig ell skriftlig samtykke. Disse to typ af forespørgsl vil blive logget specielt. Såfremt opslaget sk eft patientens samtykke, skal d i kaldet angives i hvilket datointval dette samtykke sk. Værdien kan evt. anvendes i forbindelse med opfølgning på logdata. Valg af indhold i response Request-dokumentet indehold to felt til angivelse af, hvad d ønskes returnet i responset, ud ov data direkte på lægemiddelordinationen: IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordination knyttet til lægemiddelordinationen. IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektuing på lægemiddelordinationen. Forespørgsel på tidlige vsion Ønskes d en tidlige vsion af lægemiddelordinationen kan d forespørges ud fra vsionsnumm. <GetDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <IdentifiAndVsion> <Identifi> </Identifi> <Vsion> </Vsion> </IdentifiAndVsion> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest> Endeligt kan d forespørges eft lægemiddelordinationen som det så ud på et givent tidspunkt, dvs. med et tidsstempel. <GetDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <IdentifiAndDateTime> <Identifi> </Identifi> <DateTime> T08:34:44Z</DateTime> </IdentifiAndDateTime> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest> De tre typ af forespørgsl kan kombines i samme kald. Svar D returnes et ell fle lægemiddelordination med disses effektuing. <GetDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> 50

51 <DrugMedication> <Identifi>1</Identifi> <Vsion> </Vsion> <PreviousVsion> </PreviousVsion> <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 2</AddressLine> <AddressLine>8660 Skandborg</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </By> <DateTime> T08:46:34.0Z</DateTime> </Created> <BeginEndDate> <CreatedDateTime> T08:46:34.0Z</CreatedDateTime> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </BeginEndDate> <Indication> <Code source="medicinpris" date=" ">121</code> <Tet>mod mellemørebetændelse</tet> </Indication> <RouteOfAdministration> <Code source="medicinpris" date=" ">or</code> <Tet>Oral anvendelse</tet> </RouteOfAdministration> <Drug> <ATC> <Code source="medicinpris" date=" ">j01ce02</code> <Tet>Phenoymethylpenicillin</Tet> </ATC> <Identifi source="medicinpris" date=" "> </identifi> <Name>Primcillin</Name> <Form> <Code source="medicinpris" date=" ">oragras</code> <Tet>granulat til oral suspension</tet> </Form> <Strength> <Value>50</Value> <UnitCode source="medicinpris" date=" ">mgm</unitcode> <UnitTet>mg/ml</UnitTet> </Strength> <Substances> <ActiveSubstance> <Tet source="medicinpris" date=" ">phenoymethylpenicillinkalium</tet> </ActiveSubstance> </Substances> </Drug> <Dosage> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <EndDate> </EndDate> <UnitTet source="dosingsforslag">ml</unittet> 51

52 <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>noon</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>70</Quantity> </Dose> </Day> </Structure> <Type>temporær</Type> </Dosage> <DosageTranslation> <ShortTet>70 ml morgen, middag og aften</shorttet> <LongTet>Dosingsforløbet start torsdag den 9. august 2012 og gentages hv dag: Dosingsforløb: 70 ml morgen + 70 ml middag + 70 ml aften </LongTet> <AvageDailyDosage>210</AvageDailyDosage> <UnitTet source="dosingsforslag">ml</unittet> </DosageTranslation> <SubstitutionAllowed>true</SubstitutionAllowed> </DrugMedication> </GetDrugMedicationResponse> Svaret vil indeholde nul ell fle lægemiddelordination. Elementet DrugMedication nærme beskrevet i afsnittet Medicinkort og lægemiddelordination. 5.9 Opret lægemiddelordination Denne svice gør det muligt at oprette en ell fle lægemiddelordination på et medicinkort. Suspending Det muligt at oprette en lægemiddelordination på et suspendet medicinkort. Hvis d foretaget oprettelse ell opdating af lægemiddelordination, imens medicinkortet har været suspendet, vil lægen på det tidspunkt, suspendingen ophæves, blive informet hom. Det sk ved, at lægen altid skal foretage ændring på et opdatet medicinkort, og d vil blive returnet en advarsel hvis dette ikke ovholdes. Lægen kan således hente det opdatede medicinkort, og kan deft foretage oprettels ell ændring på medicinkortet. Oprettelse af receptordination sammen med lægemiddelordination En typisk arbejdsgang at d oprettes en lægemiddelordination hvoreft d med det samme oprettes en receptordination, således at patienten kan afhente lægemidlet på apoteket. I svicekaldet til oprettelse af en lægemiddelordination det dfor muligt at tilknytte en ell fle receptordination, d oprettes tilknyttet til lægemiddelordinationen. 52

53 Oprettelse af tilknytning af recept til lægemiddelordination I forbindelse med at data fra eksistende "løse" receptordination anvendes til at oprette nye lægemiddelordination, skal de "løse" receptordination knyttes til de netop oprettede lægemiddelordination. I svicekaldet det dfor muligt at tilknytte et antal løse receptordination. Privatmarking Ved oprettelsen af en lægemiddelordination det muligt at marke at patienten har bedt om privatmarking på lægemiddelordinationen. Relation til ovordnet lægemiddelordination En lægemiddelordination kan have en relation til en ovordnet lægemiddelordination. Dette kan f.eks. anvendes til at angive at en lægemiddelordination indehold et lægemiddel d gives som supplement til et andet lægemiddel, hvor det andet lægemiddel findes i den ovordnede lægemiddelordination. Relationen angives som en relation fra en lægemiddelordination til dennes ovordnede lægemiddelordination, og angives i elementet ParentIdentifi. Det således muligt at en lægemiddelordination ovordnet lægemiddelordination for fle andre lægemiddelordination. Ved oprettelse valides d som det eneste, at d findes en lægemiddelordination med det id d angives. Ved opdating valides det dimod ikke om lægemiddelordinationen stadig aktiv m.v. Forespørgsel I request-dokumentet skal d medsendes et CPR-numm på den patient som skal have tilføjet en lægemiddelordination på medicinkortet. Desuden skal d medsendes et vsionsnumm på medicinkortet for at sikre at afsenystemet arbejd med opdatede data (se Vsionsnumming ). D medsendes information omkring organisationen (sygehuset, lægepraksisen,...) og lægen som har foretaget oprettelsen. Data til oprettelse af en ell fle lægemiddelordination medsendes i elementet CreateDrugMedication, hund kan d også oprettes effektuing på lægemiddelordinationen og d kan oprettes receptordination (effektuing og receptordination ikke vist i dette eksempel). <CreateDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </CreatedBy> <DrugMedication> <ParentIdentifi> </ParentIdentifi> <BeginEndDate> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </BeginEndDate> <Indication> <Code source="medicinpris" date=" ">121</code> 53

54 </Indication> <RouteOfAdministration> <Code source="medicinpris" date=" ">or</code> </RouteOfAdministration> <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Primcillin</Name> </Drug> <Dosage> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <EndDate> </EndDate> <UnitTet source="dosingsforslag">ml</unittet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>noon</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>70</Quantity> </Dose> </Day> </Structure> </Dosage> <SubstitutionAllowed>true</SubstitutionAllowed> </DrugMedication> </CreateDrugMedicationRequest> Svar Svaret fra FMK indehold det medsendte CPR-numm og et nyt vsionsnumm. Desuden returnes ID og vsionsnumre for de nyoprettede lægemiddelordination, effektuing og recept (de sidste ikke vist hund). <CreateDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <VsionMismatchWarning/> <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </CreateDrugMedicationResponse> 5.10 Opdat lægemiddelordination Svicen "Opdat lægemiddelordination" gør det muligt at ændre en ell fle parametre på en ell fle lægemiddelordination. Det muligt at opdate lægemiddelordination på et suspendet medicinkort. Ved opdatingen sendes den komplette lægemiddelordination til FMK. Dvs. at det ikke muligt at udelade optionelle element såfremt de fortsat ønskes på lægemiddelordinationen - FMK ovskriv med den nye vsion og mg ikke. 54

55 Svicen foretag ingen kontrol af om ændringen klinisk lovlig ell meningsfyldt. Skal d foretages en sådan kontrol og vurding skal dette ske i EPJ- ell praksissystemet ell af lægen selv. Bemærk at en ændring også kan omfatte lægemiddelordinationens start- og seponingsdato. Såfremt lægemiddelordinationen seponet kan den ligeledes samtidigt afsepones, dette gøres ved at opdate lægemiddelordinationen og angive Unwithdraw -elementet. Såfremt lægemiddelordinationen ikke seponet og Unwithdraw sat til true vil kaldet fejle. Svicen til opdating af lægemiddelordination indehold ikke effektuing. En effektuing kan ikke opdates, og oprettelse af effektuing skal ske via et separat svicekald ell evt. via bulk svicen opdat medicinkort. Effektuing på lægemiddelordination kan slettes via en separat svice, se afsnittet Slet effektuing. Forespørgsel Ved opdating af lægemiddelordinationen skal patientens CPR-numm og medicinkortets vsionsnumm medsendes for at sikre at lægen arbejd på opdatede data for den korrekte patient. D medsendes information omkring organisationen (sygehuset, lægens praksis,...) og lægen som har foretaget opdatingen. <UpdateDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </ModifiedBy> <DrugMedication> <Identifi> </Identifi> <BeginEndDate> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </BeginEndDate> <Indication> <Code source="medicinpris" date=" ">121</code> </Indication> <RouteOfAdministration> <Code source="medicinpris" date=" ">or</code> </RouteOfAdministration> <Drug> <ATC> <Code source="medicinpris" date=" ">j01ca01</code> <Tet>Ampicillin</Tet> </ATC> <Identifi source="medicinpris" date=" "> </identifi> <Name>Ampicillin "NordMedica"</Name> </Drug> <Dosage> 55

56 <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <EndDate> </EndDate> <UnitTet source="dosingsforslag">tablet</unittet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>1</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>1</Quantity> </Dose> </Day> </Structure> <Type>engangs</Type> </Dosage> <SubstitutionAllowed>true</SubstitutionAllowed> </DrugMedication> </UpdateDrugMedicationRequest> Svar <UpdateDrugMedicationResponseStructure> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <VsionMismatchWarning/> <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </UpdateDrugMedicationResponseStructure> 5.11 Pausing af lægemiddelordination D mulighed for at en ell fle lægemiddelordination pauses. Dette kan f.eks. ske hvis patienten i en piode und ambulant behandling, hvorimod d normalt ikke behov for en pausing hvis patienten indlægges på sygehus, idet d i denne situation ofte vil ske en suspending af patientens medicinkort. Pausing sk altid uafhængigt af lægemiddelordinationens vsionsnumm, dvs. på seneste vsion og på det tidspunkt, hvor kaldet modtages af FMK. I snitfladen for FMK 1.4 d forbedt for at pausingen kan have en optionel startdato og en optionel slutdato. Dette kan dog ikke anvendes endnu. Forespørgsel I dokumentet sendt til FMK skal patientens CPR-numm og medicinkortets vsionsnumm først angives. Heft følg information omkring hvor dette foretaget, dvs. information omkring lægepraksis ell sygehus, og hvilken læge d har foretaget opdatingen. Til sidst et ell fle id' for de lægemiddelordination d skal pauses. <PauseDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <PausedBy> <AuthorisedHealthcareProfessional> 56

57 <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </PausedBy> <DrugMedication> <Identifi> </Identifi> </DrugMedication> </PauseDrugMedicationRequest> Svar I svaret returnes først patientens CPR-numm og medicinkortets vsionsnumm, og heft et element med lægemiddelordinationens ID og vsionsnumm for hv lægemiddelordination d ved kaldet blevet pauset. <PauseDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </PauseDrugMedicationResponse> 5.12 Ophæv pausing af lægemiddelordination Denne svice ophæv pausing af en ell fle lægemiddelordination. Det ikke et krav, at d den samme læge ell organisation, dvs. sygehus ell praksis, d ophæv pausingen, som den d oprindeligt har foretaget den. Forespørgsel Dokumentet svar, bortset fra navngivning, til dokumentet for pausing. Patientens CPR-numm og medicinkortets vsionsnumm skal først angives. Heft organisation og læge, og til sidst et antal lægemiddelordinations-id for de lægemiddelordination hvor pausingen skal ophæves. <UnpauseDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> 57

58 </Organisation> </ModifiedBy> <DrugMedication> <Identifi> </Identifi> </DrugMedication> </UnpauseDrugMedicationRequest> Svar I svaret returnes patientens CPR-numm og medicinkortets vsionsnumm. <UnpauseDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </UnpauseDrugMedicationResponse> 5.13 Sepon lægemiddelordination En ell fle lægemiddelordination på et medicinkort kan sepones ved brug af denne svice. D skal angives hvilken organisation (lægepraksis ell sygehusafdeling) og hvilken læge (autorisationsnumm) d udfør seponingen. Seponingen skal ske på opdatede data, sk dette ikke vil d blive returnet en advarsel. Seponede lægemiddelordination returnes ikke på en forespørgsel om det aktive medicinkort. Lægemiddelordinationens ophørsdato har ikke samme betydning som en seponing, da d ved en seponing f.eks. skal ovvejes om en igangværende dosisdispensing skal stoppes. En seponet lægemiddelordination kan afsepones ell opdates med et flag d angiv at lægemiddelordination ønskes afseponet, se Opdat lægemiddelordination. Forespørgsel Ved seponing skal patientens CPR-numm og medicinkortets vsionsnumm angives. Heft angives information om lægepraksis ell sygehus samt om lægen, d har foretaget seponingen. De sidste to element beskrevet i afsnittene 6.6 Organisation og 6.7 Læge. For hv lægemiddelordination, d skal sepones, skal lægemiddelordinationens ID angives. <WithdrawDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <WithdrawnBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </WithdrawnBy> <DrugMedication> <Identifi> </Identifi> 58

59 </DrugMedication> </WithdrawDrugMedicationRequest> Svar I svaret fra FMK returnes patientens CPR-numm og vsionsnumm på medicinkortet. Desuden lægemiddelordinationens ID og vsionsnumm, d tælles op på hv lægemiddelordination d ved kaldet blevet seponet. <WithdrawDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </WithdrawDrugMedicationResponse> 5.14 Afsepon lægemiddelordination Svicen fjn en seponing på lægemiddelordination. Såfremt denne svice anvendes på lægemiddelordination d ikke allede seponet, vil kaldet fejle. Eft afseponing foretaget vil lægemiddelordinationen være at finde på alle vsion af medicinkortet og alle vsion af lægemiddelordinationen. Dette kald skal betragtes som en omgørelse af en seponing d sket ved en fejl, og ikke som en livscyklus-hændelse på en lægemiddelordination. Forespørgsel UnwithdrawRequest-dokumentet anvendes til at slette effektuing. Foruden de obligatoriske felt for opdating skal d angive hvilken altnativt hvilke lægemiddelordination d ønskes afseponet. <UnwithdrawDrugMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <DrugMedication> <Identifi> </Identifi> </DrugMedication> </UnwithdrawDrugMedicationRequest> I svaret returnes medicinkortets cpr og vsionsnumm, samt en eventuel vsions advarsel. Desuden returnes de enkelte lægemiddelordination son blevet afseponet, samt des vsionsnumre. <UnwithdrawDrugMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> 59

60 <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedication> </UnwithdrawDrugMedicationResponse> 5.15 Søg eft seponede lægemiddelordination Seponede og udløbne lægemiddelordination returnes ikke ved opslag på det aktuelle medicinkort, og de lægemiddelordination d var seponede ell udløbne for en given tidlige vsion returnes ikke ved opslag på denne (se afsnit ). Denne svice gør det muligt at finde frem til eventuelle seponede ell udløbne lægemiddelordination, enten alle seponede lægemiddelordination ell de lægemiddelordination d på et givent tidspunkt var seponede. Forespørgsel Forespørgslen indehold patientens CPR-numm og eventuelt en dato som anvendes til få returnet medicinkortet, som det så ud på dette tidspunkt. Udelades denne dato svar det til at søge på det aktuelle tidspunkt. Desuden det muligt at begrænse de returnede data til kun at indeholde lægemiddelordination d seponet ell udløbet på ell eft et givent tidspunkt. Denne dato kan defines i WithdrawnAftDateTime. Med elementet NegativeConsentRequest angives at d også ønskes returnet effektuing med privatmarking. <SearchWithdrawnDrugMedicationsRequest> <PsonIdentifi> </PsonIdentifi> <DateTime> T00:00:00.0Z</DateTime> <WithdrawnAftDateTime> T00:00:00.0Z</WithdrawnAftDateTime> </SearchWithdrawnDrugMedicationsRequest> Svar FMK svar med patientens CPR-numm og en række ID' for lægemiddelordination d var seponet på det pågældende tidspunkt, ell eventuelt ingen ID hvis d ikke findes noget resultat. <SearchWithdrawnDrugMedicationsResponse> <PsonIdentifi> </PsonIdentifi> <Identifi> </Identifi> <Identifi> </Identifi> <Identifi> </Identifi> </SearchWithdrawnDrugMedicationsResponse> 5.16 Hent receptordination Det muligt at hente receptordination gennem FMK. Receptordinationne hentes ud fra receptordinations-id, som kan findes i svar fra de to svices "Hent medicinkort" og "Hent lægemiddelordination". 60

61 Forespørgsel Forespørgslen indehold patientens CPR-numm, det et krav at receptne, d heft spørges eft, hør til denne patient. <GetPrescriptionMedicationRequest> <PsonIdentifi> </PsonIdentifi> <Identifi> </Identifi> <IncludeEffectuations>false</IncludeEffectuations> </GetPrescriptionMedicationRequest> Svar Svaret indehold en ell fle recept svarende til recept-id i forespørgslen. Receptsven vil returne recept i Prescription elementet, d svar til recepten, de oprettet på. Se i receptsvens snitfladebeskrivelse for ydlige information. <GetPrescriptionMedicationResponse> <PsonIdentifi> </PsonIdentifi> <PrescriptionMedication> <Identifi> </Identifi> <AuthorisationDateTime> T09:30:47.0Z</AuthorisationDateTime> <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </By> <DateTime> T09:30:47Z</DateTime> </Created> <LatestEffectuationDateTime> T10:12:03Z</LatestEffectuationDateTime> <TminatedDateTime> T10:12:03Z</TminatedDateTime> <DelivyInformation>Til plejehjemmet</delivyinformation> <OrdInstruction>Leves sammen med øvrige bestilling,</ordinstruction> <OrdInstruction>se separat besked</ordinstruction> <Delivy> <Priority>send til anden adresse samme dag</priority> <StreetName>Margrethepladsen 6</StreetName> <PostCode>8660</PostCode> <ContactName>An Anen</ContactName> </Delivy> <ReimbursementClause>klausulbetingelse opfyldt</reimbursementclause> <SinglePrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">84194</packagenumb> <PackageQuantity>1</PackageQuantity> <DosageTet>1 tablet morgen og aften ved måltid</dosagetet> </SinglePrescriptionDispensing> <Indication> <Code source="medicinpris" date=" ">121</code> </Indication> <Drug> <ATC> <Code source="medicinpris" date=" ">j01ce02</code> <Tet>Phenoymethylpenicillin</Tet> 61

62 </ATC> <Identifi source="medicinpris" date=" "> </identifi> <Name>Primcillin</Name> <Form> <Code source="medicinpris" date=" ">tabfilm</code> <Tet>filmovtrukne tablett</tet> </Form> <Strength> <Value>250</Value> <UnitCode source="medicinpris" date=" ">mg</unitcode> <UnitTet>milligram</UnitTet> </Strength> <Substances> <ActiveSubstance> <Tet source="chemical Abstract (CAS)">Phenoymethylpenicillinkalium</Tet> </ActiveSubstance> </Substances> </Drug> <SubstitutionAllowed>true</SubstitutionAllowed> <Status>und behandling</status> </PrescriptionMedication> </GetPrescriptionMedicationResponse> 5.17 Opret receptordination ud fra lægemiddelordination Skal d udstedes en receptordination ud fra lægemiddelordinationen anvendes den hund beskrevne svice. Oprettelse af receptordination sk på receptsven via FMK, dvs. at FMK vil oprette receptordination på receptsven inden kaldet return et response til det kaldende system. Forespørgsel Patientens CPR-numm og medicinkortets vsionsnumm angives først i dokumentet, og hund data om lægepraksis ell sygehus samt om lægen d oprett receptne. Hund findes en ell fle CreatePrescriptionMedicationStructure-element, for hv af disse oprettes en recept. Elementet CreatePrescriptionMedicationStructure indehold kun supplende information, recepten oprettes med en kombination af data fra lægemiddelordinationen og recepten. Elementet beskrevet i afsnit 6.4. <CreatePrescriptionMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </CreatedBy> <PrescriptionMedication> <DrugMedicationIdentifi> </DrugMedicationIdentifi> <AuthorisationDateTime> T09:30:47.0Z</AuthorisationDateTime> <ReceivOrganisation> <Name>Skandborg Apotek</Name> <Type>Apotek</Type> <Identifi source="ean-lokationsnumm"> </identifi> 62

63 </ReceivOrganisation> <SystemName>FMK-online</SystemName> <SinglePrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">412</packagenumb> <PackageQuantity>1</PackageQuantity> <DosageTet>1 tablet morgen og aften</dosagetet> </SinglePrescriptionDispensing> </PrescriptionMedication> </CreatePrescriptionMedicationRequest> Svar I svaret returnes et CreatedPrescriptionMedicationStructure-element for hv recept d oprettet. Elementet indehold lægemiddelordinationens ID og receptens ID. <CreatePrescriptionMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <PrescriptionMedication> <DrugMedicationIdentifi> </DrugMedicationIdentifi> <PrescriptionMedicationIdentifi> </PrescriptionMedicationIdentifi> </PrescriptionMedication> </CreatePrescriptionMedicationResponse> Varenummintvall Pakningnes varenumre valides såfremt d X i kolonnen "Tilladt og valides i taksten". Såfremt d X i en af kolonnne "Tilladt og valides ikke" ell "Magistrelt, tilladt og valides ikke" valides varenummet ikke. Endeligt afvises varenumre hvor d ikke X i en af de tre kolonn, ell hvor nummet ikke i en af de angivne si. Varenumm fra Varenumm til Tilladt og valides i taksten Tilladt og valides ikke Magistrelt, tilladt og valides ikke X X X X X X Tekst Farmaceutiske spacialitet - Nordiske varenumre Frihandel/Mærkevar Råvar, Kemikali, Drog Farmaceutiske spacialitet - Nordiske varenumre Galenika (bulk) Frihandelsvar Til intn brug i virksomhed Divse (Lægemiddelstyrelsen) f.eks. magistrelle lægemidl Til intn brug i virksomhed Mærkevar og enkelte specialitet 63

64 X X X Mærkevar og enkelte specialitet Sygehusapoteknes magistrelle lægemidl Mærkevar og enkelte specialitet Frihandelsvar/Mærkevar Til intnt brug i virksomhedne Til intnt brug i virksomhedne Til intnt brug i virksomhedne D dog en række undtagels til ovenstående nummsi, idet visse varenumre forbeholdt gebyr mm. Disse varenumre kan ikke anvendes, og vil blive afvist. Varenumm Tekst Telefonreceptgebyr Udligning af for meget ell for lidt udbetalt tilskud Porto EDB-Gebyr Udbringningsbebyr Administrationsgebyr Indbetning af dansknes køb af lægemidl i Norden Vagtgebyr Levancehonorar Håndkøb, V-mærket Håndkøb, frihandelsvare Håndkøb, apotekforbeholdt Industrispecialitet Magistrel (Bek. nr. 961, 4) Farmaceutiske specialitet på udlevingstilladelse i hht. lml Salg af dosisdispensede lægemidl mellem to apotek Dosispakningsgebyr - pakket fra eget apotek Dosispakningsgebyr - pakket fra andet apotek Dosisekspedition Svicegebyr - pakket fra eget apotek Svicesgebyr - pakket fra andet apotek 64

65 Svicesgebyr Dosisgebyr ved salg mellem apotek Leving af apotekforbeholdte lægemidl fra håndkøbsudsalg Sprit (magistrel) Magistrelle lægemidl, dog bilag 2 i bek. nr Medicinpris-sekretariatet Uden avance 5.18 Opret recept til pson uden CPR-numm Skal d oprettes en ell fle receptordination til en pson uden CPR-numm anvendes CreatePrescriptionMedicationWithoutCPR dokumentet. Forespørgsel Modsat den oprindelige svice angives d eftfølgende ikke CPR-numm ell medicinkort vsionsnumm. Heft følg OrganisationStructure og DoctorStructure som CreatePrescriptionMedicationRequestStructure. I stedet for at psoninformation kan findes ved stamdataopslag, skal dette medsendes i PatientWithoutCPR-elementet. Hund findes det sædvanlige PsonNameStructure-element, samt obligatoriske felt til fødselsdato og køn. Eventuelt kan d tilføjes en adresse (ikke vist h). Apoteket har kun mulighed for at hente recept, d ikke adresset til dette apotek, og ikke har et CPR-numm angivet, ved at søge på enten fornavn, eftnavn og fødselsdato ell på fornavn, eftnavn og postnumm. Fornavn og eftnavn dfor obligatoriske i svicen, desuden vil FMK valide at enten fødselsdato ell postnumm udfyldt. Heft følg et antal element, d indehold information omkring pakning m.v. Bortset fra, at elementet DrugMedicationIdentifi ikke findes, svar indholdet til CreatePrescriptionMedicationStructureType, dog de to gange tre lini OrdInstruction og DelivyInformation samlet i DelivyInformationAndOrdInstruction. <CreatePrescriptionMedicationWithoutCPRRequest> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </CreatedBy> <Patient> <Pson> <Name> <GivenName>Ma</GivenName> <Surname>Mustmann</Surname> 65

66 </Name> <BirthDate> </BirthDate> <Gend>male</Gend> </Pson> <Address> <StreetName>Mossøvej</StreetName> <StreetBuildingIdentifi>12</StreetBuildingIdentifi> <PostCodeIdentifi>8660</PostCodeIdentifi> <DistrictName>Skandborg</DistrictName> </Address> </Patient> <PrescriptionMedication> <AuthorisationDateTime> T09:30:47.0Z</AuthorisationDateTime> <ReceivOrganisation> <Name>Skandborg Apotek</Name> <Type>Apotek</Type> <Identifi source="ean-lokationsnumm"> </identifi> </ReceivOrganisation> <SystemName>FMK-online</SystemName> <SinglePrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">442</packagenumb> <PackageQuantity>1</PackageQuantity> <DosageTet>1 tablet eft behov ved smt</dosagetet> </SinglePrescriptionDispensing> <Indication> <Code source="medicinpris">151</code> <Tet>Mod stærke smt</tet> </Indication> <SubstitutionAllowed>true</SubstitutionAllowed> </PrescriptionMedication> </CreatePrescriptionMedicationWithoutCPRRequest> Svar Response-dokumentet indehold en ell fle receptordinations-id: <CreatePrescriptionMedicationWithoutCPRResponse> <Identifi> </Identifi> </CreatePrescriptionMedicationWithoutCPRResponse> 5.19 Opret receptordination til brug i praksis Svicen anvendes til at lægen kan oprette receptordination til brug i egen praksis. Forespørgsel CreatePrescriptionMedicationForUseInPracticeRequest-dokumentet anvendes til at oprette receptordination med lægemidl til brug i lægens praksis. Bortset fra, at PatientWithoutCPR ikke findes, svar indholdet hund til CreatePrescriptionMedicationForPsonWithoutCPRRequest-dokumentet. Svar Response- dokumentet indehold en ell fle receptordinations-id, igen tilsvarende CreatePrescriptionMedicationForPsonWithoutCPRResponse. 66

67 5.20 Opret ell ophæv tilknytning af receptordination til lægemiddelordination Denne svice gør det muligt at tilknytte receptordination til lægemiddelordination. Svicen kan anvendes hvor arbejdsgangen det omvendte af hvad FMK umiddelbart lægg op til. Dvs. i de tilfælde hvor d først oprettes en receptordination og sene oprettes en lægemiddelordination. Svicen kan eventuelt også anvendes til at knytte andre "løse" receptordination til lægemiddelordination. D desuden mulighed for at ophæve en recepordinations tilknytning til en lægemiddelordination, således at receptordinationen i stedet direkte tilknyttes medicinkortet. Er receptordinationen allede tilknyttet en lægemiddelordination vil et nyt forsøg på at tilknytte fejle. Skal en receptordination tilknyttes en anden lægemiddelordination det nødvendigt først at ophæve den eksistende tilknytning, dette kan ske i samme kald. Er receptordinationen ikke tilknyttet nogen lægemiddelordination vil et forsøg på at ophæve tilknytningen blive ignoret. Forespørgsel Forespørgslen indehold patientens CPR-numm. Det et krav at de receptordination og lægemiddelordination d heft indgår hør til denne patient. I eksemplet nedenfor ophæves først tilknytningen af receptordinationen med id Heft tilknyttes denne receptordination og også receptordinationen med id til lægemiddelordinationen med id Endeligt tilknyttes et andet sæt receptordination og lægemiddelordination sammen. <AttachOrDetachPrescriptionMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <DetachPrescriptionMedication> <Identifi> </Identifi> </DetachPrescriptionMedication> <AttachPrescriptionMedication> <DrugMedicationIdentifi> </DrugMedicationIdentifi> <Identifi> </Identifi> </AttachPrescriptionMedication> </AttachOrDetachPrescriptionMedicationRequest> Svar FMK svar med patientens CPR-numm og medicinkortets vsionsnumm. Bemærk i øvrigt at selv om medicinkortets vsionsnumm ikke opdates af attach- og detach-opationen returnes det i responset. <AttachOrDetachPrescriptionMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> 67

68 </AttachOrDetachPrescriptionMedicationResponse> 5.21 Mark receptordination som ikke aktuel Svicen anvendes til at marke en ell fle receptordination som ikke aktuelle. Funktionen tænkes anvendt i forbindelse med oprydning / afstemning af en patients medicinkort. Recept på lægemidl, d ikke længe relevante for patientens aktuelle tilstand og den aktuelle medicining kan markes som ikke aktuelle. Eftfølgende opslag på medicinkortet vil ikke vise recept, som market som ikke aktuelle Markingen ny og statt den tidlige funktionalitet for medicinafstemning og receptgennemgang. Denne marking fjnede automatisk alle løse recept, som var oprettet før markingen blev sat. Marking af en en ell fle recept som ikke aktuelle gør at oprydning i løse recept kan ske gradvist og fle klinike kan være involvet. Forespørgsel I request-dokumentet sendes patientes CPR-numm, medicinkortets vsion og information omkring organisation og læge. Heft følg en ell fle receptordinations-id på receptordination d skal markes som ikke aktuelle. <MarkPrescriptionMedicationDeprecatedRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <PrescriptionMedication> <Identifi> </Identifi> </PrescriptionMedication> </MarkPrescriptionMedicationDeprecatedRequest> Svar I svaret returnes patientens CPR-numm, medicinkortets vsion (som i øvrigt uændret), eventuelt med VsionMismatchWarning en advarsel om at det medsendte vsionsnumm ikke det aktuelle, og heft receptordinations-id på receptordination market som ikke aktuelle. <MarkPrescriptionMedicationDeprecatedResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <PrescriptionMedicationIdentifi> </PrescriptionMedicationIdentifi> </MarkPrescriptionMedicationDeprecatedResponse> 68

69 5.22 Ophæv mark receptordination som ikke aktuel Svicen anvendes til at ophæve en marking af en ell fle receptordination som ikke aktuelle. Forespørgsel og svar svar til svicen Mark receptordination som ikke aktuel Annull receptordination Svicen anvendes til at annulle en ell fle receptordination. Ved kald til denne svice kald FMK vide til receptsven, hvor receptordinationen annulles. Dette forudsætt dog at receptordinationens status tillad denne statusændring. Annulling af en recept vil typisk finde sted i forbindelse med seponing af en lægemiddelordination. Såfremt d eksist en tilhørende 'åben' recept på Receptsven, bør denne annulles. Annulling af recept på Receptsven også relevant ved oprydning / marking som 'ikke relevant'. Hvis medicinen ikke længe relevant for patienten, bør recepten også annulles på Receptsven, såfremt recepten ikke allede afsluttet. Forespørgsel I request-dokumentet sendes patientes CPR-numm, medicinkortets vsion og information omkring organisation og læge. Heft følg en ell fle receptordinations-id på recept d skal annulles. <CancelPrescriptionMedicationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <PrescriptionMedication> <Identifi> </Identifi> </PrescriptionMedication> </CancelPrescriptionMedicationRequest> Svar I svaret returnes patientens CPR-numm, medicinkortets vsion (som i øvrigt uændret), eventuelt med VsionMismatchWarning en advarsel om at det medsendte vsionsnumm ikke det aktuelle, og heft receptordinations-id på receptordination d annullede. Endeligt kan element PrescriptionSvError returne en fejlbesked fra receptsven. <CancelPrescriptionMedicationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <PrescriptionMedicationIdentifi> </PrescriptionMedicationIdentifi> </CancelPrescriptionMedicationResponse> 69

70 5.24 Hent effektuing Når et apotek udlev på baggrund af en receptordination, vil effektuing blive knyttet til receptordinationen. Såfremt recepten, når den udstedes, knyttet til en bestemt vsion af en lægemiddelordination og lægemiddelordinationen opdates, vil effektuing på denne recept, forsat være knyttet til recepten. D vil dfor kunne forekomme effektuing på tidlige vsion af en lægemiddelordination. Svicen til at hente effektuing gør det muligt at hente i et tidsintval, dvs. d kan hentes effektuing d oprettet siden sidste kald på et CPR-numm. Forespørgsel Forespørgselen indehold først patientens CPR-numm. Heft to felt til angivelse af et dato- og tidsintval. Udelades et ell begge dato- og tidsfeltne anvendes i stedet uendeligt i begge retning. Dvs. en forespørgsel hvor både FromDateTime og ToDateTime udeladt vil returne samtlige effektuing kendt af FMK, dog kan FMK begrænse antallet af effektuing d returnes, som sene beskrevet. D mulighed for at angive hvorvidt følgende typ af effektuing d ønskes returnet: Angives IncludeEffectuationsOnDrugMedications til true vil effektuing direkte på lægemiddelordination blive returnet. Angives IncludeEffectuationsOnPrescriptionMedicationsOnDrugMedications til true vil effektuing på recept knyttet til lægemiddelordination blive returnet. Angives IncludeEffectuationsNoOnDrugMedications til true vil effektuing på løse recept, dvs. på recept d ikke knyttet til en lægemiddelordination, blive returnet. Endeligt kan d for de første to typ af effektuing være tilfælde hvor effektuingen knyttet til en lægemiddelordination hvor d angivet privatmarking. Er dette tilfældet, og lægemiddelordinationen kendt og hentet af en tilsvarende årsag, kan d med elementet NegativeConsentRequest angives at d også ønskes returnet effektuing med privatmarking. <SearchEffectuationsRequest> <PsonIdentifi> </PsonIdentifi> <FromDateTime> T00:00:00Z</FromDateTime> <ToDateTime> T09:30:00Z</ToDateTime> <IncludeEffectuationsOnDrugMedications>true</IncludeEffectuationsOnDrugMedications> <IncludeEffectuationsOnPrescriptionMedicationsOnDrugMedications>true </IncludeEffectuationsOnPrescriptionMedicationsOnDrugMedications> <IncludeEffectuationsNotOnDrugMedications>true</IncludeEffectuationsNotOnDrugMedications> <NegativeConsent> <ConsentOvridden/> </NegativeConsent> </SearchEffectuationsRequest> Svar Svaret fra FMK indehold først patientens CPR-numm. Heft returnes effektuingne i en struktur d afspejl des sammenhæng med en lægemiddelordination (i DrugMedication elementet), med en receptordination på en lægemiddelordination (i PrescriptionMedication elementet und DrugMedication elementet) ell som en løs recept (i PrescriptionMedicaiton elementet uden for en DrugMedication). Nyeste effektuing returnes først. Om nødvendigt kan FMK begrænse antallet af returnede effektuing i et enkelt response. I så fald markes dette i responset med MoreAvailable-elementet. D 70

71 kan eftfølgende spørges med tidspunktet for oprettelsen af den ældste effektuing i responset, dvs. med tidsintvallet [oprindelig fradato ældste dato i responset] Eksempel: Første Request udføres på tidspunktet :43:51 Request: CPR = ; tidsintval = [ :43:51; :43:51] Response: Effektuing oprettet :52:32 Effektuing oprettet :13:21... Effektuing oprettet :11:44 MoreAvailable Næste request udføres umiddelbart heft, idet d modtaget et MoreAvailable-flag Request: CPR = ; tidsintval = [ :43:51; :11:44] Response: Effektuing oprettet :55:01 Effektuing oprettet :31:13 D foretages heft ikke fle forespørgsl, idet d h ikke modtaget et MoreAvailable-flag. <SearchEffectuationsResponse> <PsonIdentifi> </PsonIdentifi> <DrugMedication> <Identifi> </Identifi> <Effectuation>... </Effectuation> <PrescriptionMedication> <Identifi> </Identifi> <Effectuation>... </Effectuation> </PrescriptionMedication> </DrugMedication> <PrescriptionMedication> <Identifi> </Identifi> <Effectuation>... </Effectuation> </PrescriptionMedication> <MoreAvailable/> </SearchEffectuationsResponse> Effektuing på lægemiddelordination med privatmarking kan blive returnet. Disse vil ikke være market med en separat negativ samtykke angivelse, denne findes på lægemiddelordinationen. Tilsvarende, såfremt d ikke ønskes returnet effektuing med privatmarking, så vil dette ikke blive market i svaret. Det forudsættes at patientens medicinkort allede hentet når denne svice kaldes Opret effektuing Denne svice oprett en ell fle nye effektuing på en eksistende lægemiddelordination. Effektuingen foretages af lægen ell dennes medhjælp ved at medicinen udleves ell indgives i patienten. Effektuing på receptordination kan ikke oprettes via denne svice. Lægen kan oprette en receptordination, som apoteket eftfølgende kan ekspede en ell eventuelt fle gange. Via receptsven 71

72 modtages d besked, d knytt apotekets effektuing på receptordinationen og dmed på lægemiddelordinationen. Forespørgsel I forespørgslen skal det sikres, at d arbejdes på den seneste vsion af både medicinkortet og dmed også på seneste vsion af lægemiddelordinationen. D skal medsendes information omkring lægens organisation (sygehus, praksis mm) og lægen, begge dele for lægen d foretag opdatingen af medicinkortet. Efektuingen kan foretages og angives på forskellig vis. Indholdet af effektuingen definet i elementet CreateEffectuation. <CreateEffectuationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </CreatedBy> <DrugMedication> <Identifi> </Identifi> <Effectuation> <DateTime> T12:48:03.0Z</DateTime> <EffectuationMethod>indgivet</EffectuationMethod> <DoseQuantity>2</DoseQuantity> <DosageQuantityUnitTet source="dosingsforslag">ml</dosagequantityunittet> <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Solu-cortef</Name> </Drug> </Effectuation> </DrugMedication> </CreateEffectuationRequest> Svar I responset returnes en ell fle ID for effektuingne (EffectuationIdentifi), i en struktur, d gør det muligt at relate dem til medicinkortet og lægemiddelordinationne. Rækkefølgen i øvrigt bevaret i forhold til request-dokumentet. <CreateEffectuationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <DrugMedication> <Identifi> </Identifi> <EffectuationIdentifi> </EffectuationIdentifi> </DrugMedication> </CreateEffectuationResponse> 72

73 5.26 Slet effektuing Svicen slett en effektuing på en lægemiddelordination. Bemærk at det en effektuing af en lægemiddelordination og ikke en effektuing af en recept. Effektuing ikke vsionede i FMKs snitflade, og dfor vil vsionsnummet for hvken medicinkortet ell lægemiddelordinationen ændres ved en sletning. Forespørgsel DeleteEffectuationRequestStructure-dokumentet anvendes til at slette effektuing. Foruden de obligatoriske felt for opdating skal d angive hvilken altnativt hvilke effektuing d ønskes slettet. <DeleteEffectuationRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>2Q5TK</AuthorisationIdentifi> <Name>Tess Christoffsen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="yd">66974</identifi> </Organisation> </ModifiedBy> <Effectuation> <Identifi> </Identifi> </Effectuation> </DeleteEffectuationRequest> Svar I svaret returnes medicinkortets CPR-numm og vsionsnumm, samt en eventuel vsions advarsel. <DeleteEffectuationResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> </DeleteEffectuationResponse> 5.27 Opdating af medicinkort (bulk svice) Denne svice kan anvendes, når det nødvendigt at opdate fle ting på samme medicinkort i samme transaktion, se også afsnittet "Transaktion". Svicen indehold element fra svices til oprettelse og opdating af data. Forekomm d receptoprettels i svicekaldet vil disse blive udført eft at evt. øvrige opation på FMK udført med success. Kald fra FMK til Receptsven ikke transaktionelle, så d en principiel risiko for at d kan opstå en fejl eft recept oprettet, hvoreft oprettelse af receptne ikke vil blive rullet tilbage. Forespørgsel I dokumentet sendt til FMK skal patientens CPR-numm og medicinkortets vsionsnumm først angives. 73

74 Heft angives information om lægepraksis ell sygehus samt om lægen, d har foretaget opdatingen. Disse to element beskrevet i afsnittene Organisation og Autoriset sundhedspson. Det skal således sikres at alle opdating foretaget af samme læge. D kan således ikke ske en automatisk bulkning af fle forskellige kald. Heft det muligt at tilføje element fra svices, d opdat data på medicinkortet. For svices omkring suspending kan d højst angives et enkelt request af hv type, de andre d ingen begrænsning på. Rækkefølgen vilkårlig. Skal d udføres opdating, oprettels m.v. skal dette ske på en lægemiddelordination med et kendt ID. Således det f.eks. ikke muligt først at oprette en lægemiddelordination i elementet CreateDrugMedicationStructure og heft oprette effektuing på denne i elementet CreateEffectuationOnDrugMedicationStructure i samme kald. Effektuingne skal i stedet angives direkte i CreateDrugMedicationStructure. På FMK vil ændringne være registret som samtidige, og såfremt bare én opdating fejl, vil hele kaldet rulle tilbage, og intet andet end log-information vil blive skrevet. I eksemplet hund sættes en marking for medicinafstemning, medicinkortet frigives og d oprettes en lægemiddelordination i samme kald. <UpdateMedicineCardRequest> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <ModifiedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </ModifiedBy> <SetMedicineCardReviewed> <ReviewedDateTime> T14:30:40Z</ReviewedDateTime> </SetMedicineCardReviewed> <UnsuspendMedicineCard/> <CreateDrugMedication> <BeginEndDate> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </BeginEndDate> <Indication> <Code source="medicinpris" date=" ">121</code> </Indication> <RouteOfAdministration> <Code source="medicinpris" date=" ">or</code> </RouteOfAdministration> <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Primcillin</Name> </Drug> <Dosage> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> 74

75 <EndDate> </EndDate> <UnitTet source="dosingsforslag" date=" ">ml</unittet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>noon</Time> <Quantity>70</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>70</Quantity> </Dose> </Day> </Structure> </Dosage> <SubstitutionAllowed>true</SubstitutionAllowed> </CreateDrugMedication> </UpdateMedicineCardRequest> Svar I svaret returnes de relevante id. Bemærk at d ingen id returnes for suspending, frigivelse, oprettelse af tilknytning af recept til lægemiddelordination, ophævelse af tilknytning af recept til lægemiddelordination samt andre svices hvor de selvstændige svicekald kun return CPR-numm og vsionsid. Rækkefølgen bevaret i forhold til request-dokumentet. I eksemplet hund, som svar til request-dokumentet ovenfor, returnes kun lægemiddelordinations-id og vsion. SetMedicineCardRevirewed og UnsuspendMedicineCard har ingen tilsvarende response-undelement. <UpdateMedicineCardResponse> <PsonIdentifi> </PsonIdentifi> <MedicineCardVsion> </MedicineCardVsion> <CreatedDrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> </CreatedDrugMedication> </UpdateMedicineCardResponse> 5.28 Hent rettighed FMK udstill en svice, d gør det muligt at forespørge hvilke rettighed d tildelt brugen. Svicen tag et antal parametre, d gør det muligt at bruge svicen i tre forskellige situation. Forespørgsel Den første variant af forespørgselen anvendes når d ønskes et opslag på samtlige roll og rettighed definet i systemet. Roll og rettighed kan dved hentes af LPS ell EPJ-systemet m.v. og caches. <GetPmissionsRequest> <GetAllPmissions/> </GetPmissionsRequest> D kan foretages opslag på rettighedne for den rolle d kaldes med, samt et evt. "på vegne af" element. 75

76 <GetPmissionsRequest> <GetCallsPmissions/> </GetPmissionsRequest> Endeligt kan d foretages opslag for rettighed til et specifikt CPR-numm, som angives i kaldet. Dette opslag kan f.eks. anvendes i forbindelse med borgens opslag. Rollen tages fra headen, incl. en evt. angivelse af forældre- ell værgolle. <GetPmissionsRequest> <GetCallsPmissionsToPson> <PsonIdentifi> </PsonIdentifi> </GetCallsPmissionsToPson> </GetPmissionsRequest> Svar I alle tre tilfælde returnes d data eft samme skema. Indholdet vil dog varie afhængigt af requestet, således at d enten returnes rettighed for en enkelt ell for samtlige roll. Tildelingen af rettighed til roll kan til enhv tid ændres af Lægemiddelstyrelsen. Eksempel, rettighed for ydlige roll ikke vist, men antydet med.... <GetPmissionsResponse> <RolesPmissions> <RequestedRole>Læge</RequestedRole> <Pmission>Afstemning</Pmission> <Pmission>Effektuing</Pmission> <Pmission>Lægemiddelordination</Pmission> <Pmission>LøsRecept</Pmission> <Pmission>Privatmarking</Pmission> <Pmission>Recept</Pmission> <Pmission>SundhedsfagligOpslag</Pmission> <Pmission>Suspending</Pmission> <Pmission>VisPrivatmarketSamtykke</Pmission> <Pmission>VisPrivatmarketVærdispring</Pmission> </RolesPmissions>... </GetPmissionsResponse> Ovenstående rettighed svar til hvad d beskrevet i afsnit 4.5 Sikkhedsmodel, og de i afsnit 4.5 beskrevne rettighed definet i XML-skemaet. Tildelingen af rettighed designet således at en fleksibel udvidelse af både roll og rettighed mulig. D således også mulighed for at returne nye rettighed, d endnu ikke kendte og definede i XML-skemaet, i nedenstående eksempel returnes således en tænkt rettighed til CaveOpslag. XML-skemaet definet således at dette vil være et validt response, og klientsystem skal ignore rettighed d ikke kendte. <GetPmissionsResponse> <RolesPmissions> <RequestedRole>Borg</RequestedRole> <Pmission>BorgOpslag</Pmission> <Pmission>CaveOpslag</Pmission> </RolesPmissions> </GetPmissionsResponse> 76

77 6 XML eksempl I eksemplne i dette afsnit gennemgås FMKs dokumentformat i detalj. Eksemplne beskriv så meget indhold fra XML skemane som muligt. Den teknisk fuldstændige dokumentation dog i sidste ende XML skemadefinitionne, så det vigtigt at forholde sig til den komplette skemadefinition. I eksemplne hund namespaces og eventuelle namespace-aliases udeladt for at fremme eksemplnes læsbarhed. 6.1 Medicinkort og lægemiddelordination Svicen hent medicinkort return patientens medicinkort. Indholdet af det returnede medicinkort vari afhængigt af patientens lægemiddelordination, receptordination og effektuing og af parametre på kaldet. Rodelement i svaret på hent medicinkort GetMedicineCardResponse. I rodelementet namespaces og eventuelle namespace-aliases klæret, disse dog udeladt h. <GetMedicineCardResponse> <PsonIdentifi> </PsonIdentifi> Responset indehold et ell fle medicinkort-vsion, alle tilhørende samme CPR-numm (fle hvis d forespørges på fle vsion). Først i svaret returnes information omkring patienten. Se gennemgangen und "Patientinformation". <MedicineCard> <Patient> <Pson> <Name> <GivenName>Anita</GivenName> <Surname>Anen</Surname> </Name> <PsonIdentifi> </PsonIdentifi> </Pson> <Address> <StreetName>Margrethepladsen</StreetName> <StreetBuildingIdentifi>4</StreetBuildingIdentifi> <PostCodeIdentifi>8000</PostCodeIdentifi> <DistrictName>Århus</DistrictName> </Address> </Patient> Medicinkortet indehold medicinkortets vsionsnumm. Bemærk, at i modsætning til FMK 1.2 vsionsnummet ikke nødvendigvis fortløbende. Se afsnittet Vsionsnumming for en nærme beskrivelse af hvorledes indholdet af FMK vsiones. Medicinkortet indehold relation til den forrige vsion af medicinkortet (allførste vsion har dog ikke en tidlige vsion), og historiske vsion indehold også en relation til den eftfølgende vsion. Idet d kan forekomme samtidige opdating kan d i sjældne tilfælde forekomme fle samtidige vsion for både forrige og næste vsion. Eksemplet h vis således et medicinkortet i en vsion d ikke den første vsion, men hell ikke den aktuelle. <Vsion> </Vsion> <PreviousVsion> </PreviousVsion> 77

78 <NetVsion> </NetVsion> Heft returnes information omkring sidste ændring af medicinkortet i elementet Modified. Se beskrivelse af indholdet i afsnittene "Organisation og Autoriset sundhedspson". Desuden returnes tidspunktet hvor ændringen registret i FMK. <Modified> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>1B2F7</AuthorisationIdentifi> <Name>Henrik Hansen</Name> <SpecialityCode source="medicinpris" date=" ">psyk</specialitycode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 12</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="ydnumm">12121</identifi> </Organisation> </By> <DateTime> T09:30:47Z</DateTime> </Modified> Såfremt medicinkortet suspendet, idet patienten indlagt og mediciningen håndtes af sygehusets EPJ-system, vil information om indlæggelsesstedet, og evt. lægen d ansvarlig for indlæggelsen, følge. Disse gennemgået und "Organisation" og "A". Desuden returnes tidspunktet hvor dette registret i FMK. Elementet Suspended indehold den fulde information om suspendingen, idet suspendingen ikke nødvendigvis den sidst foretagne ændring. <Suspended> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </By> <DateTime> T09:12:41Z</DateTime> </Suspended> Hvis en læge på et tidspunkt har market at d foretaget en medicinafstemning på medicinkortet, vises d information om hvem (organisation og læge) d har udført den seneste marking, og hvornår det sket. Elementet Reviewed indehold informationen på medicinkortet. <Reviewed> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>757RR</AuthorisationIdentifi> <Name>Ekhardt Jørgensen</Name> </AuthorisedHealthcareProfessional> <Organisation> 78

79 <Name>Århus Univsitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks">7026</identifi> </Organisation> </By> <DateTime> T09:11:12Z</DateTime> </Reviewed> Medicinkortet kan indeholde en marking af at medicinkortet ugyldigt. Markingen kan sættes og fjnes af den dataansvarlige (SNSI), eventuel på opfordring af en læge, og betyd at d sket en fejl und opdating af medicinkortet således at det ikke længe retvisende. Medicinkortet skal eftfølgende enten ignores ell bringes tilbage i korrekt stand. Af hensyn til sidstnævnte det dfor muligt at hente og opdate ugyldige medicinkort. <IsInvalid/> Patientens medicinkort kan indeholde lægemiddelordination med privatmarking. Hvis medicinkortet hentes uden at angive at lægemiddelordination med privatmarking ønskes returnet vil medicinkortet i stedet indeholde et ell fle DrugMedicationWithNegativeConsent-element. Hi findes id og vsionsnumm for privatmarkede lægemiddelordination. <DrugMedicationWithNegativeConsent> <Identifi> </Identifi> <Vsion> </Vsion> </DrugMedicationWithNegativeConsent> Heft indehold MedicineCard-dokumentet et antal lægemiddelordination. Lægemiddelordinationne kan returnes med eventuelle receptordination og effektuing på patientens medicinkort, afhængigt af parametre på kaldet (se Hent medicinkort ). Lægemiddelordination-elementet indehold en identifikation af lægemiddelordinationen, lægemiddelordination-id og vsionsnumm. Bemærk, at i modsætning til FMK 1.2 vsionsnummet ikke nødvendigvis fortløbende. Se afsnittet Vsionsnumming for en nærme beskrivelse af hvorledes indholdet af FMK vsiones. Lægemiddelordinationen indehold relation til den forrige vsion af medicinkortet (første vsion har dog ikke en tidlige vsion), og historiske vsion indehold også en relation til den eftfølgende vsion. Idet d kan forekomme samtidige opdating kan d i sjældne tilfælde forekomme fle samtidige vsion for både forrige og næste vsion. Eksemplet h vis således et lægemiddelordinationen i en vsion d ikke den første vsion, men hell ikke den aktuelle. <DrugMedication> <Identifi> </Identifi> <Vsion> </Vsion> <PreviousVsion> </PreviousVsion> <NetVsion> </NetVsion> Lægemiddelordinationen vil i Created-elementet have en angivelse af den organisation (dvs. praksis, sygehus m.v.) hvorfra lægemiddelordinationen indbettet samt hvilken læge d har oprettet lægemiddelordinationen. Indholdet i disse to element beskrevet und Organisation og Autoriset sundhedspson". Desuden indehold elementet tidspunktet for hvornår lægemiddelordinationen oprettet på medicinkortet. <Created> 79

80 <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>1B2F7</AuthorisationIdentifi> <Name>Henrik Hansen</Name> <SpecialityCode source="medicinpris" date=" ">psyk</specialitycode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 12</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="ydnumm">12121</identifi> </Organisation> </By> <DateTime> T09:30:47.0Z</DateTime> </Created> Er lægemiddelordinationen ændret siden oprettelsen vil d i Modified-elementet blive returnet information omkring tidspunktet for seneste ændring (DateTime), organisationen (Organisation) og lægen (Doctor) d har foretaget dette, de sidste to element beskrevet und Organisation og Autoriset sundhedspson". Er d sket ændring mellem oprettelsen og seneste ændring vil disse ikke blive returnet (f.eks. i form af ydlige Modified -element), men skal søges i de tidlige vsion. <Modified> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>TH3VJ</AuthorisationIdentifi> <Name>Ulf Johannesen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægehuset Fanø</Name> <Type>Yd</Type> <Identifi source="yd">27548</identifi> </Organisation> </By> <DateTime> T15:31:10Z</DateTime> </Modified> Såfremt lægemiddelordinationen pauset vil nedenstående element angive dette. Hi kan ses hvilken organisation og læge d har foretaget pausingen, og hvornår det sket. Indholdet und Paused-elementet beskrevet und Organisation og Autoriset sundhedspson". <Paused> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>TH3VJ</AuthorisationIdentifi> <Name>Ulf Johannesen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægehuset Fanø</Name> <Type>Yd</Type> <Identifi source="yd">27548</identifi> </Organisation> </By> <DateTime> T15:31:10Z</DateTime> </Paused> Ved opslag på direkte på lægemiddelordination kan d også returnes lægemiddelordination d seponede. D anvendes samme skema, så disse også definet i medicinkortet, men seponede 80

81 lægemiddelordination vil ikke blive returnet ved oplag på medicinkortet, det samme gæld i øvrigt også lægemiddelordination d udløbne. Ved oplag på den aktuelle vsion idet d kun returnes aktuelle lægemiddelordination, ved opslag på tidlige vsion, idet de lægemiddelordinationne kun returnes hvis på dette tidspunkt aktuelle, og i den form de da havde. Se i øvrigt Hent lægemiddelordination og Søg eft seponede lægemiddelordination svices. <Withdrawn> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>1B2F7</AuthorisationIdentifi> <Name>Henrik Hansen</Name> <SpecialityCode source="medicinpris" date=" ">psyk</specialitycode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 12</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="ydnumm">12121</identifi> </Organisation> </By> <DateTime> T11:04:11Z</DateTime> </Withdrawn> Såfremt lægemiddelordinationen privatmarket vil denne indeholde et HasNegativeConsent-element. <HasNegativeConsent/> Lægemiddelordinationens gyldighedsintval findes i BeginEndDate-elementet. I svaret fra FMK angives lægemiddelordinationens oprettelsestidspunkt i elementet CreatedDateTime, tidspunktet sættes af FMK. Hund angives lægemiddelordinationens startdato og seponingsdato, altnativt kan dato og tid angives, ell det kan angives at startdato og seponingsdato ukendte. Se en beskrivelse haf i afsnittet Lægemiddelordinationens start- og slutdato. <BeginEndDate> <CreatedDateTime> T09:30:47.0Z</CreatedDateTime> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </BeginEndDate> 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 sene ved modtagelsen f.eks. i et EPJ-system være seponet, idet datoen ændret, indehold lægemiddelordination-elementet ingen direkte angivelse af status. Lægemiddelordinationens indikation skal angives, se en beskrivelse und "Indikation". <Indication> <Code source="takst" date=" ">121</code> <Tet>mod mellemørebetændelse</tet> </Indication> D skal angives en administrationsvej. Administrationsvejen i de fleste tilfælde givet ud fra lægemidlet. Administrationsvejen skal angives ud fra taksten, se afsnittet "Administrationsvej". <RouteOfAdministration> <Code source="takst" date=" ">or</code> <Tet>Oral anvendelse</tet> </RouteOfAdministration> 81

82 Lægemiddelordinationen skal indeholde et lægemiddel. Et lægemiddel kan være et takst-lægemiddel (definet med et drug-id i Lægemiddelstyrelsens Medicinpris), et lægemiddel uden for taksten (dvs. uden drug-id) ell et magistrelt lægemiddel. Magistrelle lægemidl anvendes sjældent, d kan ikke udstedes recept hpå, og de skal ikke forveksles med lægemidl uden for taksten. Et lægemiddel defines som svarende til et drug-id for lægemidl i taksten. Dvs. at kombinationspræparat m.m, d indehold fle aktive substans, anses for at være ét lægemiddel, hvorimod kombinationsbehandling skal angives i fle lægemiddelordination. Hund vist et eksempel på et takst-lægemiddel med et drug-id i Identifi-elementet, en nærme gennemgang findes i afsnittet "Lægemiddel". <Drug> <ATC> <Code source="takst" date=" ">j01ce02</code> <Tet>Phenoymethylpenicillin</Tet> </ATC> <Identifi source="takst" date=" "> </identifi> <Name>Primcillin</Name> <Form> <Code source="takst" date=" ">tabfilm</code> <Tet>filmovtrukne tablett</tet> </Form> <Strength> <Value>400.0</Value> <UnitCode source="takst" date=" ">mg</unitcode> <UnitTet>milligram</UnitTet> <Tet source="takst" date=" ">400 mg</unitcode> </Strength> <Substances> <ActiveSubstance> <Tet source="takst" date=" ">phenoymethylpenicillin</tet> </ActiveSubstance> </Substances> </Drug> D skal angives en dosing på lægemiddelordinationen. I eksemplet angivet en strukturet dosing, at lægemidlet skal tages dagligt som 1 tablet morgen og aften ved måltid. Elementet gennemgås separat i und "osing". Dosage-elementet h for et opslag på FMK returnes d en dosingsovsættelse i elementet. Se evt. afsnit "". <Dosage> <Structures> <UnitTet source="dosingsforslag">tablet</unittet> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <EndDate> </EndDate> <SupplementaryTet>ved måltid</supplementarytet> <Day> <DayNumb>1</DayNumb> <Dose> <Time>morning</Time> <Quantity>1</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>1</Quantity> </Dose> </Day> </Structure> 82

83 <DosageTranslation> <ShortTet>1 tablet morgen og aften ved måltid</shorttet> <LongTet>Dosingsforløbet start fredag den 10. februar 2012 og gentages hv dag: Dosingsforløb: 1 tablet morgen + 1 tablet aften</longtet> <AvageDailyDosage>2</AvageDailyDosage> </DosageTranslation> </Structures> <Type>temporær</Type> </Dosage> På lægemiddelordinationen kan angives om lægemidlet må substitues. Dette specielt relevant når d skal oprettes receptordination ud fra lægemiddelordinationen. <SubstitutionAllowed>true</SubstitutionAllowed> Lægemiddelordinationen kan heft indeholde effektuing og receptordination (de sidste også indeholdende effektuing). Eksemplet på lægemiddelordinationen h indehold ikke effektuing ell receptordination, eksempl på disse findes und Effektuing og Receptordination. </DrugMedication> Medicinkortet kan ligeledes indeholde løse receptordination, dvs. receptordination d ikke knyttet til en lægemiddelordination. Dokumentet for løse receptordination det samme som for receptordination på lægemiddelordination, og eksempl findes und Receptordination. </MedicineCard> </GetMedicineCardResponse> 6.2 Receptordination Receptordination findes i PrescriptionMedication-elementet. Receptordination kan returnes ved opslag på medicinkortet, på lægemiddelordination ell som et separat opslag. I alle tilfælde skemadefinitionen den samme. Hund vist et eksempel på svaret ved et separat opslag på en receptordination. Rodelement i svaret på hent receptordination GetPrescriptionMedicationResponse. I rodelementet namespaces og eventuelle namespace-aliases klæret, disse dog udeladt h. I responset medsendes patientens CPR-numm. <GetPrescriptionMedicationResponse> <PsonIdentifi> </PsonIdentifi> I responset vil d forekomme 0 ell fle receptordination. Receptordinationen har et id d genet af receptsven. Dimod receptordination ikke vsionede, så de indehold ikke et vsionsnumm. <PrescriptionMedication> <Identifi> </Identifi> Receptordinationen indehold en lægens autorisationsdato. <AuthorisationDateTime> T09:30:47.0Z</AuthorisationDateTime> På recepten findes d information omkring den organisation d har oprettet den samt lægen d har foretaget oprettelsen, samt dato og tid dette foretaget på receptsven. Dog kan d returnes receptordnation uden at d angivet autorisationsnumm på lægen d har oprettet receptordinationen. Dette vil typisk forekomme på recept apoteket har modtaget via papir, fa ell telefon. 83

84 <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>1B2F7</AuthorisationIdentifi> <Name>Henrik Hansen</Name> <SpecialityCode source="medicinpris" date=" ">psyk</specialitycode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 12</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="ydnumm">12121</identifi> </Organisation> </By> <DateTime> T09:30:47.0Z</DateTime> </Created> Såfremt receptordinationen tidlige effektuet (dvs. at apoteket har ekspedet ud fra receptordinationen) angives seneste dato og -tid hfor. <LatestEffectuationDateTime> T09:42:02.0Z</LatestEffectuationDateTime> Såfremt apoteket har bestemt at d ikke længe kan ekspedes ud fra receptordinationen dette angivet. Typisk vil tidspunktet svare til LatestEffectuationDateTime, f.eks. idet en engangsudleving ell sidste reitede udleving foretaget og dmed afsluttet, ell ved at apoteket har ugyldiggjort recepten. At recepten afsluttet har ingen betydning for hvorvidt lægemiddelordinationen gyldig. <TminatedDateTime> T10:12:03Z</TminatedDateTime> Receptordinationen kan indeholde i alt 3 element til enten en ordre-instruktion ell til levingsinformation. Elementne kan blandes og forekomme i en vilkårlig rækkefølge. <DelivyInformation>Til plejehjemmet</delivyinformation> <OrdInstruction>Leves sammen med øvrige bestilling,</ordinstruction> <OrdInstruction>se separat besked</ordinstruction> Levingsinformation til første udleving Når lægen udsted en recept det muligt for lægen sætte visse typ af information til første udleving: Levinginformation ell ordre instruktion (DelivyInformation ell OrdInstruction). Denne består af i alt højst 3 element med fritekst. Samt: Levingens prioritet (Delivy/Priority) til angivelse forsendelsesmåde. "samme dag" betyd første ordinære leving, eft omstændighedne med apotekets egen transport ell f.eks. med rutebil. Det betyd ikke omgående leving, d findes ingen kode forhfor, dette må angives i OrdInstruction ell aftales på anden måde. Adresse (Delivy/StreetName) ell PseudoAdresse (Delivy/PseudoAddress). StreetName udfyldes kun hvis medicinen skal sendes til anden adresse end angivet und patienten, og PseudoAddress anvendes ved andet end gadenavn f.eks. plejehjem ell håndkøbdsudsalg. Postnumm (Delivy/PostCode), postnumm på levingsadresse. Kontakt navn (Delivy/ContactName), navn på stedfortræd på levingsadresse ell navn på levingsadressen. 84

85 Ved en eventuel genbestilling, foretaget af patienten selv, kan denne levingsinformationen ændres på hv eftfølgende udleving. På receptsven findes disse typ af information dfor ikke på selve recepten (egentligt receptordinationen), men på effektuingen (i receptsv-tminologi på første deludleving). Dette har den følgevirkning, at de ovenfor nævnte information først kan vises når apoteket har ekspedet recepten, og effektuingen vises på FMK. Informationen hentes altid fra første udleving, idet det denne d angivet af lægen, også selv om patienten eftfølgende vælg en anden levingsadresse ell lignende. <Delivy> <Priority>send til anden adresse samme dag</priority> <StreetName>Margrethepladsen 6</StreetName> <PostCode>8660</PostCode> <ContactName>An Anen</ContactName> </Delivy> --Lægen kan angive at patienten og receptordinationen opfyld kravene til at patienten kan få tilskud. Indholdet i elementet aktuelt kun den faste tekst klausulbetingelse opfyldt. <ReimbursementClause>klausulbetingelse opfyldt</reimbursementclause> Udlevingen kan enten angives til at ske med en enkelt udleving, som en reitet udleving (dvs. me end en enkelt udleving fra samme recept) ell som en dosisdispenset receptordination. Dette adskilt i forskellige typ, idet d forskellige krav til dataelement, og for sene at kunne ændre ell udvide definitionen, f.eks. for en dosisdispenset recept. Enkelt udleving I det følgende beskrives en recept med en enkelt udleving i elementet SinglePrescriptionDispensing. For en enkeltudleving findes pakningens varenumm for den ordinede pakning i PackageNumb-elementet. Er varenummet tilknyttet en frihandelsvare, ell et andet varenumm, hvor informationen ikke findes i Medicinpris, det nødvendigt at angive en pakningsstørrelse, idet dette ikke kan slås op i FMK og Receptsvens stamdata. Angives d en pakningsstørrelse på noget d ikke en frihandelsvare ignores elementet. Pakningsstørrelsen for frihandelsvar angives i elementet FreeTradePackageSizeTet, d ikke vist hund. Antal pakning findes i elementet PackageQuantity. Receptordinationen skal indeholde en dosingsangivelse i DosageTet som en kort tekst. Denne kan evt. være dannet på baggrund af en strukturet dosing. Indholdet af DosageTet skal være kort og forståelig for patienten. Receptordinationen kan eventuelt også indeholde et DosageCode-element, hvor en eventuel dosingskode fra taksten angives. Anvendelse af takstens dosingskod dog udgået og stattet af strukturede dosing, recept oprettet gennem FMK indehold således ikke dosingskod, og det anbefales dfor ikke at implemente funktionalitet d anvend dosingskoden. <SinglePrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">84194</packagenumb> <PackageQuantity>1</PackageQuantity> <DosageTet>1 tablet morgen og aften ved måltid</dosagetet> </SinglePrescriptionDispensing> 85

86 Reitet udleving I det følgende beskrives en recept med reitet udleving i elementet ReitatedPrescriptionDispensing. For en reitet udleving findes pakningens varenumm for den ordinede pakning i PackageNumb-elementet. Er varenummet tilknyttet en frihandelsvare, ell et andet varenumm, hvor informationen ikke findes i Medicinpris, det nødvendigt at angive en pakningsstørrelse, idet dette ikke kan slås op i FMK og Receptsvens stamdata. Angives d en pakningsstørrelse på noget d ikke en frihandelsvare ignores elementet. Pakningsstørrelsen for frihandelsvar angives i elementet FreeTradePackageSizeTet, d ikke vist hund. Antal af reitation angives i ReitationNumb. Bemærk at antallet af reitation 1 mindre end antal udleving, angives 3 reitation vil d normalt kunne udleves 4 gange fra receptordinationen. D skal angives hvor lang tid d mindst skal gå mellem udleving fra receptordinationen, dette angives med en numisk værdi i ReitationIntval, og en enhed hfor ("dag", "uge" ell "måned") i ReitationIntvalUnit. Antal pakning pr. udleving findes i elementet PackageQuantity. Receptordinationen skal indeholde en dosingsangivelse i DosageTet som en kort tekst. Denne kan evt. være dannet på baggrund af en strukturet dosing. Indholdet af DosageTet skal være kort og forståelig for patienten. Receptordinationen kan eventuelt også indeholde et DosageCode-element, hvor en eventuel dosingskode fra taksten angives. Anvendelse af takstens dosingskod dog udgået og stattet af strukturede dosing, recept oprettet gennem FMK indehold således ikke dosingskod, og det anbefales dfor ikke at implemente funktionalitet d anvend dosingskoden. <ReitatedPrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">84194</packagenumb> <ReitationNumb>1</ReitationNumb> <ReitationIntval>2</ReitationIntval> <ReitationIntvalUnit>ug</ReitationIntvalUnit> <PackageQuantity>1</PackageQuantity> <DosageTet>1 tablet morgen og aften ved måltid</dosagetet> </ReitatedPrescriptionDispensing> Dosisdispenset udleving I det følgende beskrives en dosisdispenset recept i elementet DoseDispensedPrescriptionDispensing. På nuværende tidspunkt skal pakningens varenumm angives, idet det et teknisk krav ved kommunikation med apoteknes system. Varenummet valides på samme måde som for en enkelt- ell reitet udleving, og desuden kontrolles det at lægemidlet dosisdispensbart. Modsat de andre typ dosing det ikke relevant at angive antal pakning. Lægen kan ønske at få tilsendt en kopi af dosingskortet, dette angives med true i elementet CopyRequired. Receptordinationen skal indeholde en dosingsangivelse i DosageTet som en kort tekst. Denne kan evt. være dannet på baggrund af en strukturet dosing. Indholdet af DosageTet skal være kort og forståelig for patienten. Receptordinationen kan eventuelt også indeholde et DosageCode-element, hvor en eventuel dosingskode fra taksten angives. Anvendelse af takstens dosingskod dog udgået og stattet af strukturede dosing, recept oprettet gennem FMK indehold således ikke dosingskod, og det anbefales dfor ikke at implemente funktionalitet d anvend dosingskoden. Ved oprettelsen af dosisdispensede receptordination det ifølge receptbekendtgørelsen og receptsven et krav, at dosisdispensingen som minimum har en slutdato. Dosisdispensingens start- og 86

87 slutdato hentes fra den strukturede dosing, ell altnativt fra lægemiddelordinationen såfremt de ikke findes på dosingen. <DoseDispensedPrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">84194</packagenumb> <CopyRequired>true</CopyRequired> <DosageTet>1 tablet morgen og aften ved måltid</dosagetet> <StartDate> </StartDate> <EndDate> </EndDate> </DoseDispensedPrescriptionDispensing> --Information omkring lægemidlets indikation (optionelt) og lægemidlet returnes, se beskrivelse und disse. <Indication> <Code source="medicinpris" date=" ">113</code> <Tet>mod høfeb</tet> </Indication> <Drug>... </Drug> D returnes information omkring hvorvidt substitution tilladt. <SubstitutionAllowed>true</SubstitutionAllowed> Eventuelt kan d været angivet en fritekst til supplende information. <SupplementaryInformation>Husk at dette skal gives som supplement til dosisdisp.</supplementaryinformation> Receptordinationens aktuelle status retunes. Mulige værdi : "åben" "afsluttet" "annullet" "kladde" "inaktiv" "delvist udlevet" "und behandling" "ugyldig" "web ekspedet" "ovført til dosiskort" D endnu ikke foretaget udleving på ordinationen. Ordinationen afsluttet af apoteket og d kan ikke foretages fle udleving. En aktør har annullet receptordinationen (svarende til seponet, inaktiv ell ugyldig). Oprindeligt at ordinationen und oprettelse. Udleving kan ikke foretages. Aldrig taget i anvendelse i denne form. (I anvendt til at marke hjemmesygeplejens bestilling.) Patienten har inaktivet ordinationen via sundhed.dk. D kan ikke foretages udleving. D foretaget mindst én udleving, og d kan foretages mindst én udleving endnu. Et apotek har ordinationen und behandling. Ordinationen låst for alle andre end dette apotek. En ordination kan kun ekspedes hvis den und behandling af det lokationsnumm, d ønsk at ekspede den. Denne lås indført for at garante at den samme udleving ikke blive ekspedet to gange. Apoteket kan marke en ordination som ugyldig. D skal markes hvilket apotek d har foretaget dette, og angives en årsag. Oprindeligt at ekspeditionen ekspedet via receptsvens apotek-webbrugflade. Aldrig taget i anvendelse. Ordination til dosisdispensing har et afvigende statusforløb: Status start som Åben, heft hent apoteket ordinationen og sætt evt. status til 87

88 Und behandling. På det tidspunkt hvor den første ekspedition af en ordination sk med en marking af at lægemidlet dosisdispenset sættes status til Ovført til dosiskort. Dette betyd at ordinationen fremeft låst for alle andre end dette apotek. Bemærk at p.t. det ikke muligt at ændre denne status, dvs. at ordination ovført til dosiskort ikke kan ovgå til almindelig (reitet) udleving, hell ikke i fejltilfælde. <medicinecard :status>åben</medicinecard :status> Ved opslag direkte på receptordinations-id kan d returnes information omkring hvorvidt receptordinationen market som ikke relevant (ikke vist h). Endeligt returnes eventuelle effektuing på receptordinationen (ikke vist h). 6.3 Effektuing En udleving kan ske på to måd, enten ved at lægen ell en anden sundhedspson udlev ell indgiv lægemidlet, ell ved at lægen udsted en receptordination hvoreft lægemidlet kan ekspedes en ell fle gange på et apotek. På FMK d ingen væsentlige forskelle på de to typ af udleving (ell evt. en indgivelse), og de betegnes samlet som effektuing. Effektuing foretaget af lægen ell en anden sundhedspson optræd kun på lægemiddelordinationen, mens effektuing foretaget på et apotek kun optræd på receptordinationen. Effektuing kan returnes ved opslag på medicinkortet, på lægemiddelordination, på recept og via direkte opslag på effektuing. Hund vist et eksempel på responset på et opslag på effektuing. Opslaget på effektuingen return dokumentet SearchEffectuationResponse, hvor første element patientens CPR-numm. <SearchEffectuationsResponse> <PsonIdentifi> </PsonIdentifi> Heft indehold dokument effektuing und element DrugMedication, und DrugMedication og PresciptionMedication ell und PrescriptionMedication for hhv. effektuing på lægemiddelordination, på recept på lægemiddelordination ell på løse recept. Hund vist et eksempel på en effektuing på en lægemiddelordination, elementet DrugMedication angiv dette, og elementet Identifi indehold lægemiddelordinationens id. Effektuing på lægemiddelordination med dette id vil følge heft. <DrugMedication> <Identifi> </Identifi> En effektuing findes i Effektuation-elementet. Effektuingens id returnes i identifi-elementet. <Effectuation> <Identifi> </Identifi> Til effektuingen d angivet et tidspunkt. Sk effektuingen ov længe tid angives starttidspunktet. <DateTime> T09:30:47Z</DateTime> Typen af effektuing kan være "indgivet", "udlevet", "en- ell flgangs apoteksudleving" ell "dosisdispenset apoteksudleving". Se afsnittet "Type af effektuing". <EffectuationMethod>indgivet</EffectuationMethod> 88

89 D angives hvor effektuingen sket, i hhv. OrganisationStructure og DoctorStructure. Disse to element beskrevet i separate afsnit, und "Organisation" og "A". <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>21M12</AuthorisationIdentifi> <Name>An Anen</Name> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægne Vestgade</Name> <AddressLine>Vestgade 12</AddressLine> <AddressLine>8660 Skandborg</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Yd</Type> <Identifi source="ydnumm">1ksm2</identifi> </Organisation> </By> <DateTime> T09:30:47Z</DateTime> </Created> Ved effektuingen d udlevet ell indgivet medicin. Effektuingen kan angives på fle måd, som beskrevet hund. Effektuing som angivet på lægemiddelordinationen Udføres effektuingen ved at lægen ell evt. en anden sundhedspson som f.eks. en sygeplejeske udlev ell indgiv lægemidlet, vil effektuingen kunne svare eksakt til hvad d angivet på lægemiddelordination. D således ikke behov for at supple med udlige information, elementet IsEffectuatedAccordingToDrugMedication angiv dette. <IsEffectuatedAccordingToDrugMedication/> Effektuing med altnativt lægemiddel D kan angives en effektuing med information om et lægemiddel. Dette anvendes såfremt lægemidlet ikke svar til hvad d angivet i lægemiddelordinationen, idet d substitues. Såfremt det muligt bør lægemiddelordinationen dog opdates. Dosingen svar til hvad d angivet på lægemiddelordinationen. <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Diabact UBT</Name> </Drug> Effektuing med altnativt lægemiddel og dosing D kan angives en effektuing med information om et lægemiddel og en dosing. Dette anvendes såfremt lægemidlet ikke svar til hvad d angivet i lægemiddelordinationen, idet d substitues, og lægemidlet gives med en anden dosing. Såfremt det muligt bør lægemiddelordinationen dog opdates. <DoseQuantity>35</DoseQuantity> <DosageQuantityUnitTet source="dosingsforslag">mg</dosagequantityunittet> <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Diabact UBT</Name> </Drug> 89

90 Effektuing med altnativt lægemiddel D kan angives en effektuing med information om et lægemiddel. Dette anvendes såfremt lægemidlet ikke svar til hvad d angivet i lægemiddelordinationen, idet d substitues. Såfremt det muligt bør lægemiddelordinationen dog opdates. Dosingen svar til hvad d angivet på lægemiddelordinationen. <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Diabact UBT</Name> </Drug> Effektuing af hel pakning D kan angives, at effektuingen sket ved at d udlevet en ell fle hele pakning. Denne variant anvendes specielt ved effektuing på apotek, men kan dog også anvendes ved udleving hos lægen m.v. Først angives antal pakning og pakningens varenumm. Pakningens varenumm bør svare til lægemidlet angivet på lægemiddelordinationen. <PackageQuantity>1</PackageQuantity> <PackageNumb>16937</PackageNumb> Pakningens størrelse angives. Dette angives på strukturet vis som numisk værdi og kode og tekst for enhed, ell altnativt som fritekst i elementet PackageSizeTet. <PackageSize> <Value>1</Value> <UnitCode source="medicinpris" date=" ">st</unitcode> <UnitTet>stk</UnitTet> </PackageSize> Endeligt angives lægemidlet. Hund angivet et minimalt eksempel, data returnet fra FMK vil blive supplet med opslag i stamdata for lægemidl i taksten, dvs. at ydlige information vil findes, se evt. afsnittet Lægemidl i Medicinpris (taksten) <Drug> <Identifi source="medicinpris" date=" "> </identifi> <Name>Diabact UBT</Name> </Drug> </Effectuation> </DrugMedication> </SearchEffectuationsResponse> 6.4 CreatePrescriptionMedication - Oprettelse af recept ud fra lægemiddelordination Dokumentet CreatePrescriptionMedication anvendes når d skal oprettes en recept ud fra en lægemiddelordination. Se afsnit 5.17 for en beskrivelse af denne svice. D skal angives et lægemiddelordinations-id som udstedelsen af recepten skal ske ud fra, og knyttes til. <CreatePrescriptionMedication> <DrugMedicationIdentifi> </DrugMedicationIdentifi> Ved oprettelsen af en recept skal d angives en dato og et tidspunkt hvor "brevet" lavet færdig ell godkendt. 90

91 <AuthorisationDateTime> T11:08:11Z</AuthorisationDateTime> Receptens modtag kan angives. Udelades elementet forbliv recepten uadresset (dvs. adresset til receptsven). D angives navn og EAN-lokationsnumm på modtagen. <ReceivOrganisation> <Name>Skandborg Apotek</Name> <AddressLine>Adelgade 27</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Apotek</Type> <Identifi source="ean-lokationsnumm"> </identifi> </ReceivOrganisation> Navnet på afsendens edb-system skal fremgå, og vil blive ovført til apotekets system. <SystemName>FMK-online</SystemName> Receptordinationen kan indeholde i alt 3 element til enten en ordre-instruktion ell til levingsinformation. Elementne kan blandes og forekomme i en vilkårlig rækkefølge. <DelivyInformation>Til plejehjemmet</delivyinformation> <OrdInstruction>Leves sammen med øvrige bestilling,</ordinstruction> <OrdInstruction>se separat besked</ordinstruction> Eventuelt kan d angives levingsinformation. I elementet skal d angives en levingsprioritet, et gadenavn og husnumm i StreetName ell altnativt en PseudoAddress ved andet end et gadenavn, f.eks. plejehjem ell håndkøbsudsalg. Heft evt. et postnumm og evt. et navn på stedfortræd på levingsadresse. <Delivy> <Priority>send til anden adresse samme dag</priority> <StreetName>Margrethepladsen 6</StreetName> <PostCode>8660</PostCode> <ContactName>An Anen</ContactName> </Delivy> Lægen kan angive at patienten og receptordinationen opfyld kravene til at patienten kan få tilskud. Indholdet i elementet aktuelt kun den faste tekst klausulbetingelse opfyldt. <ReimbursementClause>klausulbetingelse opfyldt</reimbursementclause> Udlevingen kan enten angives til at ske med en enkelt udleving, som en reitet udleving (dvs. me end en enkelt udleving fra samme recept) ell som en dosisdispenset receptordination. Dette adskilt i forskellige typ, idet d forskellige krav til dataelement, og for sene at kunne ændre ell udvide definitionen, f.eks. for en dosisdispenset recept. I eksemplet hund vist en receptordination til en enkelt udleving. Denne og de øvrige typ beskrevet i afsnittene Enkelt udleving, Reitet udleving og Dosisdispenset udleving. <SinglePrescriptionDispensing> <PackageNumb source="medicinpris" date=" ">590497</packagenumb> <PackageQuantity>1</PackageQuantity> <DosageTet>2 tablett morgen og aften</dosagetet> </SinglePrescriptionDispensing> </CreatePrescriptionMedication> 91

92 6.5 Patientinformation Information omkring patienten findes i PatientStructure-elementet. Dette element opbygget med samme struktur som allede standardisede OIO element, d også anvendes i FMK 1.2, men dog ændret til medicinkort-skemadefinitionen. Patient-elementet indehold patientens navn og CPR-numm. I data fra CPR-registet findes data for f.eks. nyfødte, som endnu ikke har fået et navn, Pson/Name dfor ikke obligatorisk. Tilsvarende Address ikke obligatorisk, idet d findes pson d ikke har en adresse i CPR-registet, f.eks. pson d udvandrede. I øvrigt ikke alle element obligatoriske, og ikke alle element vist hund, hvilket fremgår af skemadefinitionen. <Patient> <Pson> <Name> <GivenName>Anita</GivenName> <Surname>Anen</Surname> </Name> <PsonIdentifi> </PsonIdentifi> </Pson> <Address> <MailDelivySublocationIdentifi>Bakkegården</MailDelivySublocationIdentifi> <StreetName>Vestgade</StreetName> <StreetBuildingIdentifi>2</StreetBuildingIdentifi> <FloorIdentifi>4</FloorIdentifi> <SuiteIdentifi>TH</SuiteIdentifi> <DistrictSubdivisionIdentifi>Svejstrup</DistrictSubdivisionIdentifi> <PostCodeIdentifi>8660</PostCodeIdentifi> <DistrictName>Skandborg</DistrictName> </Address> </Patient> For pson d har ansøgt og fået bevilliget navne- og adressebeskyttelse, vil navne og adresse oplysning været anonymiset. Elementet Name kan være stattet af et tomt NameProtected-element, og elementet Address kan være stattet af et tomt AddressProtected-element. 6.6 Organisation Elementet OrganisationStructure og variant haf indehold information omkring en praksis, et sygehus, et privatsygehus, ell andre organisation lægen tilknyttet. For organisationen skal d angives information omkring navn. Heft angives op til 5 linj med adresseinformation, evt. telefonnumm og evt. -adresse. Heft angives typen af organisation. D kan angives Sygehus, Yd, Apotek, Kommune og Administrator. Desuden skemaet konstruet således at mulige organisationstyp kan udvides uden at skemadefinitionen skal ændres. Organisationen skal identifices ved en identifi (OrganisationIdentifi skema). I source skal d angives SKS for sygehuse ell sygehusafdeling d identifices med en SKS-kode, Yd for lægepraksis, privathospital m.v. d identifices med et ydnumm. Apotek kan identifices med EAN-lokationsnumm, CVR ell CVR-P numm, afhængigt af i hvilken sammenhæng apoteket optræd (addresset til apotek, ekspedet af apoteks-filial m.v). Endeligt kan en lægen være tilknyttet en kommune hvor kommunekoden anvendes som identifi, eksempelvis hvis lægen tilknyttet den kommunale 92

93 hjemmepleje. Skemaet for organisationens identifi ligeledes konstruet således at mulige typ af identifis kan udvides uden at skemadefinitionen skal ændres. <Organisation> <Name>Klinisk Mikrobiologisk afdeling</name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>Århus N</AddressLine> <TelephoneNumb> </TelephoneNumb> <Type>Sygehus</Type> <Identifi source="sks"> </identifi> </Organisation> 6.7 Autoriset sundhedspson Dette element anvendes til at angive en en autoriset sundhedspsons autorisationsnumm og navn, begge element skal angives. Elementet anvendes sammen med en læge- og sygehusorganisation. Desuden kan lægens specialekode angives. <AuthorisedHealthcareProfessional> <AuthorisationIdentifi>1B2F7</AuthorisationIdentifi> <Name>Henrik Hansen</Name> <SpecialityCode source="medicinpris" date=" ">psyk</specialitycode> </AuthorisedHealthcareProfessional> Elementet svar til elementet tidlige navngivet Doctor. Idet FMK løbende udvidet til at give adgang til fle autorisede sundhedspson end læg (sygeplejsk, tandlæg osv.) navngivningen ændret til at afspejle dette. 6.8 Indikation Indikation angives med dette element. Indikationskoden findes i Medicinpris (taksten), se afsnittet "Indikation" und "Klassifikation, standard". Indikationen obligatorisk på en lægemiddelordination og skal fortrinsvis angives strukturet. I denne variant skal indikationskoden altid angives, og hvis indikationsteksten også angives skal denne svare til koden ifølge taksten med ikrafttrædelsesdato som angivet i PriceListVsionDate ell PriceListVsionWeek. <Indication> <Code source="medicinpris" date=" ">113</code> <Tet>mod høfeb</tet> </Indication> Altnativt kan indikationen angives som fritekst. <Indication> <FreeTet>Mod græspollenallgi</freetet> </Indication> 6.9 Lægemiddel Oplysning omkring et lægemiddel kan angives på fle måd. Enten for et lægemiddel i taksten, et lægemiddel uden for taksten (en frihandelsvare m.v.) og for et magistrelt lægemiddel. 93

94 Lægemidl i Medicinpris (taksten) For lægemidl i taksten kan d angives en ATC-kode og -tekst. ATC-koden og dennes tekst findes i ATC-elementet, hi skal ATC-koden altid angives. Teksten angives med Medicinpris som kilde angivet i source-elementet (ud fra takstens LMS01 felt 15) og teksten kan angives (svarende til LMS12 felt 8). Teksten skal angives med samme niveau som ATC-koden angivet. Hvis teksten angives skal denne svare til koden, ifølge taksten med ikrafttrædelsesdato som angivet i date ell yearandweek. For lægemidl i Medicinpris skal drug-id og lægemiddelnavn altid angives. Kilden angives i source-attributten til Medicinpris med takstvsionen i date ell yearandweek. Lægemidlets drug-id findes i taksten LMS01 felt 1 og lægemidlets navn i LMS01 felt 6. Lægemidlets form angives i Form-elementet. Koden for lægemidlets form angives eft takstens LMS22 felt 1. Kilden angives i source-attributten til Medicinpris med takstvsionen i date ell yearandweek. Den dtil hørende tekst kan angives i DosageFormTet som i takstens LMS01 felt 7. Igen skal tekst og kode høre sammen. Se evt. "Lægemiddelform" und "Klassifikation, standard". Lægemidlets styrke angives i Strength-elementet. Værdien kan angives fra 0.01 til ,99 og enheden skal angives som kode, eventuelt også som tekst. Styrkeenhedens kilde angives i source-attributten til Medicinpris med takstvsionen i date ell yearandweek. Se afsnittet "Enhed for lægemiddelstyrke" und "Klassifikation, standard" for enhedskod. Hvis enhedsteksten angives skal denne svare til koden. Pakningsstørrelsen angives desuden i tekstform i Tet-elementet, svarende til takstens LMS01 felt 10. Det sidste skal dog ikke forveksles med en fritekst. H skal kilden igen angives i Tet-elementets attributt. Elementet SubstancesStructure kan indeholde lægemidlets aktive substans. Dette specielt intessant at afsenden angiv for lægemidl uden for taksten og for magistrelle lægemidl, for lægemidl i taksten vil FMK finde de aktive substans ved opslag i taksten. Kilden kan angives som Medicinpris, sammen med en takstvsion. <Drug> <ATC> <Code source="medicinpris" date=" ">j01ce02</code> <Tet>Phenoymethylpenicillin</Tet> </ATC> <Identifi source="medicinpris" date=" "> </identifi> <Name>Primcillin</Name> <Form> <Code source="medicinpris" date=" ">tabfilm</code> <Tet>filmovtrukne tablett</tet> </Form> <Strength> <Value>400.0</Value> <UnitCode source="medicinpris" date=" ">mg</unitcode> <UnitTet>milligram</UnitTet> <Tet source="medicinpris" date=" ">400 mg</tet> </Strength> <Substances> <ActiveSubstance> <Tet source="medicinpris" date=" ">phenoymethylpenicillin</tet> </ActiveSubstance> </Substances> </Drug> Lægemidl d ikke definet i Medicinpris Ud ov lægemidl definet i Medicinpris (taksten) kan FMK indeholde f.eks. frihandelsvar, godkendelsespræparat m.v. For disse kan d angives et drugid i Identifi-elementet, i så fald angives 94

95 kilden til "Local" i source-attributten, i så fald vil drugid ikke blive validet, og d vil ikke blive supplet med stamdata. D kan evt. angives en date ell yearandweek, FMK vil dog ikke tillægge disse to attributt en betydning. Identifi-elementet kan også udelades. Bortset fra ovenstående d ingen ændring i indholdet. D kan udstedes receptordination på lægemidl d ikke definet i Medicinpris, såfremt d kendes et varenumm hpå. <Drug> <Identifi source="local"> </identifi> <Name>Meclofenamsyre</Name> <Form> <Code source="medicinpris" date=" ">tabfilm</code> <Tet>filmovtrukne tablett</tet> </Form> <Strength> <Value>400.0</Value> <UnitCode source="medicinpris" date=" ">mg</unitcode> <UnitTet>milligram</UnitTet> <Tet source="medicinpris" date=" ">400 mg</tet> </Strength> <Substances> <ActiveSubstance> <Tet source="chemical Abstract (CAS)" date=" ">meclofenamsyre</tet> </ActiveSubstance> </Substances> </Drug> Magistrelle lægemidl For magistrelle lægemidl angives ikke ATC, lægemiddel-id og lægemiddelnavn. I stedet angives en forskrift i elementet DetailedDrugTet. Nedenstående eksempel vis information omkring et magistrelt lægemiddel. Desuden d angivet værdi og kod, men ingen tekst for enhed mm. Bemærk i øvrigt at d ikke kan udstedes receptordination på magistrelle lægemidl. <Drug> <DetailedDrugTet>Pethidininjektionsvæske 2% 20 ml. 20 ml isotonisk natriumchloridopløsning svar til 0,180 g NaCl. 0,4 g pethidinhydrochlorid svar til 0,4 0,19 = 0,076 g NaCl. D må tilsættes 0,180-0,076 = 0,104 g NaCl</DetailedDrugTet> <Form> <Code source="medicinpris" date=" ">injv</code> <Tet>injektionsvæske</Tet> </Form> <Substances> <ActiveSubstance> <Tet source="local" date=" ">pethidinhydrochlorid</tet> </ActiveSubstance> </Substances> </Drug> 6.10 Lægemiddelordinationens start- og slutdato Lægemiddelordinationens start- og slutdato kan angives i fle variant. Først i elementet tidspunkt for oprettelsen på FMK, CreatedDateTime. Denne værdi sættes af FMK, og returnes ved eftfølgende opslag. Heft angives d et tidspunkt for behandlingens start. Dette kan enten være en dato, dato og tid ell en angivelse af at behandlingen startet på en tidlige ukendt dato. 95

96 Endeligt angives d et tidspunkt for behandlingens slut. Igen kan dette enten være en dato, dato og tid ell en angivelse af at behandlingen slut ikke afgjort. Variantne for behandlingens start og slut kan blandes uden begrænsning. Hund vist tre eksempl på de forskellige variant. <DrugMedicationBeginEndDate> <CreatedDateTime> T11:39:22Z</CreatedDateTime> <TreatmentStartDate> </TreatmentStartDate> <TreatmentEndDate> </TreatmentEndDate> </DrugMedicationBeginEndDate> <DrugMedicationBeginEndDate> <CreatedDateTime> T11:39:22Z</CreatedDateTime> <TreatmentStartDateTime> T12:00:00Z</TreatmentStartDateTime> <TreatmentEndDateTime> T18:00:00Z</TreatmentEndDateTime> </DrugMedicationBeginEndDate> <DrugMedicationBeginEndDate> <CreatedDateTime> T11:39:22Z</CreatedDateTime> <TreatmentStartedPreviously/> <TreatmentEndingUndetmined/> </DrugMedicationBeginEndDate> 6.11 Dosing Dosingsinformation skal angives enten på strukturet form, hvilket omtales sene, som en fritekst ell med et flag d vis at dosingsinformationen findes på skema i lokalt system. Dosing som fritekst Dosing kan angives som fritekst, såfremt det ikke muligt at angive en dosing på strukturet form. Er det muligt at anvende den strukturede form skal dette ske. Ved angivels af dosing i fritekst skal d fra og med FMK 1.4 supples med en type, f.eks. engangs, fast, eft behov osv, se Type af dosing. Såfremt d returnes dosing som fritekst oprettet via tidlige vsion af FMK kan d ikke returnes en type, h returnes i stedet ikke angivet, det dog ikke lovligt at anvende ikke angivet ved oprettelse gennem 1.4 snitfladen. <Dosage> <FreeTet>0,3-0,4 IE/kg/dag fordelt ov 3 til 6 gange dagligt i forbindelse med måltid ell eft behov. Ved hård fysisk aktivitet kan dosis øges til 0,6 IE/kg/dag</FreeTet> <Type>kombinet</Type> </Dosage> Dosing eft skema i lokalt system Er dosingen så kompleks at den ikke kan angives i medicinkortet kan d med flaget AdministrationAccordingToSchemeInLocalSystem angives at dosingen ikke findes på medicinkortet men skal findes i et lokalt system. Er det muligt at avende medicinkortets stukturede dosingselement skal dette ske. Ved angivels af dosing i fritekst skal d fra og med FMK 1.4 supples med en type, f.eks. engangs, fast, eft behov osv, se Type af dosing. Såfremt d returnes dosing som fritekst oprettet via tidlige vsion af FMK kan d ikke returnes en type, h returnes i stedet ikke angivet, det dog ikke lovligt at anvende ikke angivet ved oprettelse gennem 1.4 snitfladen. <Dosage> 96

97 <AdministrationAccordingToSchemaInLocalSystem/> <Type>fast</Type> </Dosage> Strukturet dosing Dosingsinformation på medicinkortet skal fortrinsvis angives på strukturet form. Strukturede dosing kan anvendes til både simple dosing, f.eks. en engangsdosis, medicining eft behov ( 1 stk ved smt ), en løbende dosing ("1 stk 3 gange daglig") ell til at opbygge et dosingsskema, evt. til op- ell nedtrapning. D kan angives et antal dosingspiod med eftfølgende strukturede dosing på en lægemiddelordination, hvor følgende krav skal ovholdes: Dosingne skal eftfølge hinanden uden hull. Skal d i en piode ikke foretages en dosing skal dette eksplicit angives ved at oprette en piode med en tom dosingsstruktur. Med undtagelse af følgende regel må dosing ikke være ovlappende. Dosing d ikke indehold dos eft behov må ovlappe dosing d udelukkende indehold dos eft behov. I så fald skal PN dosingens start- og slutdato være sammenfaldende med start- og slutdato for en ell to af de øvrige dosing. Dosing med fle piod angives altid med samme enhed. Dosingen på strukturet form angives som definet i XML-skemaet Structures (navngivet DosageStructures.sd), d indehold nedenstående element. Element market med grå stamm fra dosingsovsættelsen, og findes kun ved opslag på medicinkort og lægemiddelordination, se afsnittet udn tabellen. Strucures Rod-elemetet for en ell fle den strukturede dosing UnitTet Enheden for dosing. D skal fortrinsvis anvendes dosing i antal, dvs. antal tablett, kapsl, pust, sug, dråb m.v. Dosing i mængde, dvs. millilit, milligram m.v. bør kun anvendes hvis lægemidlet ikke meningsfyldt kan doses i antal. UnitTets Såfremt enheden for dosing skal angives en ental og fltal anvendes UnitTets i stedet for UnitTet. Enhedne angives i feltne hund. Singular Enhed for dosing i ental, f.eks. kapsel, dråbe m.v. Plural Enhed for dosing i fltal, f.eks. kapsl, dråb m.v. Strucure Rod-elemetet for en enkelt strukturet dosing ItationIntval Værdien angiv eft hvor mange dage dosingen i de følgende Day-element skal gentages. F.eks. angiv 1 at dosingen den samme hv dag, 7 at dosingen den samme hv uge. 97

98 NotItated I stedet for et ItationIntval kan d angives at dosingen ikke itet. Angives dette gentages dosingen ikke. Dosing d ikke itede anvendes f.eks. ti en engangsdosis, en op- ell nedtrapning ell ved en ren dosing eft behov (dvs. hvor d ikke et antal mulige daglige dosing eft behov, men hvor dosingen kan tages eft behov uden begrænsning). I tidlige skemavsion den tilsvarende konstruktion lavet ved at ItationIntval sat til 0. StartDate Dato for hvornår dosingen skal begynde (inklusiv). StartDateTime Altnativt dato og tidspunkt for hvornår dosingen skal begynde. Denne variant anvendes først og fremmest ved ovførsel af information fra EPJ-system. EndDate Dato for hvornår dosingen skal ophøre (inklusiv). EndDateTime Altnativt dato og tidspunkt for hvornår dosingen skal ohøre. Denne variant anvendes først og fremmest ved ovførsel af information fra EPJ-system. DosageEndingUndetmined I stedet for EndDate og EndDateTime kan dette element anvendes. Dosingen således gyldig til lægemiddelordinationens ophørsdato, indtil lægemiddelordinationen ændres ell sepones, ell indtil d ikke findes fle Day-element med en dosis. I tidlige skemavsion den tilsvarende konstruktion lavet ved at EndDate og EndDateTime udeladt. SupplementatyTet Eventuel supplende fritekst. F.eks. 2 dråb daglig i højre øje hvis f.eks. administrationsvej ell lægemiddelform ikke i sig selv giv tilstrækkelig information. Bemærk at den supplende tekst ikke må ændre dosingens værdi, f.eks. det ikke hensigtsmæssigt at angive en strukturet dosing på "2 dråb" og i den supplende tekst angive "i hvt øje". Day Et ell fle Day-element d grupp dosing på dage. Dosing foretaget samme dag skal således gruppes und samme Day-element, og forekomm d fle Day-element skal disse sortes eft 98

99 dagsnumm (hvilket dog ikke kan valides i skemadefinitionen, men valides ved kald til FMK). DayNumb Værdien angiv dagens numm i forløbet. Er dosingen gentaget (dvs. at et ItationIntval angivet) skal dagens numm være mindre ell lig med denne. DayNumb anvendes til itede dosing (f.eks. 1 tablet daglig ) og til ikke-itede dosing, dvs. hvor dosingen ikke gentaget (NotItated anvendt). Hved angives en ikke-gentagen dosing, f.eks. en engangsdosing ( til injektion ved lægen ) ell f.eks. en op- ell nedtrapning ("Dag 1: 2 tablet, Dag 2: 1 tablett). Dose Hv dag d optræd i dosingen indehold en ell fle dosing. Time En dosis kan optionelt være angivet til at ske til et bestemt tidspunkt, hvilket angives i Time-elementet. Time kan indeholde en af de faste tekst morning, noon, evening og night ell et tidspunkt. Forekomm elementet ikke skal den angive dosis tages en gang daglig (evt. eft behov). Quantity Den numiske dosis angives i Quantity-elementet. Dosisangives i intvallet, Enheden definet samlet for alle dosing i UnitTet. MinimalQuantity Som altnativ til en numisk dosis kan d angives et intval i MinimalQuantity- og MaimalQuantity-elementne. Begge inklusive, og skal altid angives. Eksempelvis for en dosing 1-2 tablett ved smt MaimalQuantity Se hov. IsAccordingToNee d Flaget angiv at denne dosis kan tages eft behov (som en del af en PN-dosing). AnyDay Som altnativ til Day kan d angives et enkelt AnyDay-element. Indholdet af AnyDay svar til Day, bortset fra at DayNumb ikke defines, og IsAccordingToNeed skal forekomme. AnyDay anvendes i de tilfælde hvor dosingsstrukturen skal angive en dosing d kan ske vilkårlig, dvs. at det en udelukkende PN-dosing. I tidlige skemavsion den tilsvarende 99

100 konstruktion lavet ved at DayNumb sat til 0. DosageTranslation Dosingsovsættelse for den enkelte strukturede dosing elementet findes på. Findes kun på skema ved opslag på FMK. ShortTet Kort dosingsovsættelse LongTet Lang dosingsovsættelse AvageDailyDosage Gennemstnitlig dagsdosis, altnativ minimalog maimal- MinimalAvageDailyDosage Minimum gennemsnitlig dagsdosis MaimalAvageDailyDosage Maksimal gennemsnitlig dagsdosis EmptyStructure Elementet angiv en piode uden dosing StartDate Som StartDate ovenfor StartDateTime Som StartDateTime ovenfor EndDate Som EndDate ovenfor EndDateTime Som EndDateTime ovenfor DosageEndingUndetmined Som DosageEndingUndetmined ovenfor DosageTranslationCombined Dosingsovsættelse for den samlede strukturede dosing. Findes kun på skema ved opslag på FMK, og returnes kun hvis d me end et enkelt Structure-element. ShortTet Kort dosingsovsættelse LongTet Lang dosingsovsættelse AvageDailyDosage Gennemstnitlig dagsdosis, altnativ minimalog maimal- MinimalAvageDailyDosage Minimum gennemsnitlig dagsdosis MaimalAvageDailyDosage Maksimal gennemsnitlig dagsdosis Dosingsovsættels Ved opslag på medicinkort ell lægemiddelordination vil FMK returne en ell fle dosingsovsættels. Elementet Structure vil indeholde dosingsovsættels for den piode af den strukturede dosing som elementet findes på. Findes d me end en enkelt strukturet dosing vil elementet Structures desuden indeholde en samlet dosingsovsættelse for alle piod. Er d kun en enkelt strukturet dosing vil elementet være udleladt. D blive returnet en lang tekst i LongTet-elementne. Denne indehold dosingstidne, en evt. dosing eft behov samt en linje for hv dag d doses, dvs. en linje for hv Day-element i den strukturede dosing. 100

101 For en del af de hyppigst anvendte typ af dosing kan dosingsstrukturen ovsættes til en kort tekst i ShortTet-elementet. Dette vil dog ikke altid være muligt, f.eks. for komplicede dosing ell dosing d genelt fald uden for de struktur d hyppigst anvendes i taksten. For dosing d ikke eft behov (dvs. at elementet IsAccordingToNeed ikke forekomm) kan d begnes en gennemsnitlig daglig dosing. Værdien for den gennemsnitlige daglige dosing angives i elementet AvageDailyDosage, og enheden hfor i elementet UnitTet. Såfremt d dosingen helt ell delvist angivet i intvall (i MinimalQuantity og MaimalQuantity) returnes i stedet en minimum- og maksimumværdi i MinimalAvageDailyDosage og MaimalAvageDailyDosage. <DosageTranslation> <ShortTet>1 dråbe middag og aften</shorttet> <LongTet>Dosingsforløbet start lørdag den 1. januar 2011 og gentages hv dag: Dosingsforløb:\n"+ 1 dråbe middag + 1 dråbe aften</longtet> <AvageDailyDosage>6</AvageDailyDosage> </DosageTranslation> Supplende tekst D kan være nødvendigt at dosing supples med fritekst, f.eks. "2 dråb daglig i venstre øje". D h egentlig ikke tale om en ren dosing, men en dosing supplet med en administrationsvej, en betingelse ell en vejledning. Det hved vigtigt at dosingen i strukturen ikke ændres, f.eks. dosingen "2 dråb daglig i begge øjne" ikke lovlig, idet friteksten "i begge øjne" fordobl den angivne dosing. Teksten skal i stedet være f.eks. "4 dråb daglig (2 dråb i hvt øje)", hvor teksten i parentes en fritekst. Dosingstidspunkt De eksakte dosingstidspunkt i Time-elementet udgør en særlig udfordring i forhold til entydig definition. Et givet klokkeslæt skal præsentes ens, uafhængigt af om det somm- ell vinttid. Værktøjne (f.eks. Ais, kan ikke skelne). Vi defin dfor, at d skal angives en tidszone for dosingstidspunkt. Følgende lidt specielle fortolkning anvendes dudov: Ved skrivning af dosingstidspunkt kompenses kun for tidszonen, IKKE for eventuel Sommtid. Ved læsning af data gæld selvfølgelig vice vsa. Rent praktisk vil dette betyde at skrevne og læste tidspunkt skal justes med en time hvis man på læseell skrivetidspunktet befind sig i sommtid. Type af dosing Ved opslag på en dosing d angivet på strukturet vis vil FMK afgøre dosingens type og returne denne, se hund. Ved oprettelse ell opdating af en lægemiddelordination vil den angivne type blive validet såfremt den angivet på den strukturede dosing, den ikke ens med den af FMK begnede dosing vil FMK returne en fejlbesked. FMK anvend nedenstående definition af typ af dosing: engangs : En dosing med kun en enkelt dosis, d ikke gives eft behov. temporær : En dosing med en slutdato ell en dosing d ikke gentaget (elementet NotItated anvendt i stedet for ItationIntval). Desuden skal dosingen ikke helt ell delivist gives eft behov. fast : En itet dosing uden slutdato, d ikke helt ell delvist gives eft behov. eft behov : En dosing d udelukkende gives eft behov. Dosingen kan evt. have en begrænsning på en maksimal dagsdosis. 101

102 kombinet : En dosing d både gives (temporært ell fast) og eft behov. ikke angivet : Anvendes for dosing oprettet gennem vsion før FMK 1.3 / 1.4, og hvor det ikke muligt at bestemme typen, dvs. at dosingen som fritekst ell som eft skema i lokalt system. D kan ikke oprettes dosing med typen ikke angivet via FMK 1.3 / 1.4. Eksempl For eksempl henvises til afsnit Dosingstruktur supplende beskrivelse side 110 sidst i dette dokument Pakningsstørrelse Pakningsstørrelsen, som kan anvendes ved effektuing, angives med dette element. D skal angives en værdi og en enhed (kode og evt. tekst). Værdien kan angives fra 0.01 til ,99 og enheden skal angives som kode, eventuelt også som tekst. I FMK vsion 1.4 stamm enhedskoden fra Medicinpris (taksten), se afsnittet "Enhed for pakningsstørrelse" und "Klassifikation, standard". Hvis enhedsteksten angives skal denne svare til koden, ifølge taksten med ikrafttrædelsesdato som angivet i attributten date ell yearandweek. <PackageSize> <Value>50</Value> <UnitCode source="medicinpris" date=" ">st</unitcode> <UnitTet>stk.</UnitTet> </PackageSize> Altnativt kan pakningsstørrelsen angives i tekstform. Dette skal igen svare til teksten for pakningsstørrelse som angivet i Medicinpris, og ikke et felt til fritekst. <PackageSize> <PackageSizeTet>5 penne 3 ml</packagesizetet> </PackageSize> 102

103 7 Fejlkod og -tekst Teks Kode t Namespace krævet for XML-elementet \"{0}\" Cpr-nr {0}PsonIdentifi) findes ikke Medicinkortet {0} findes ikke i vsion {1} Medicinkortet {0} allede suspendet af organisation {1} Medicinkortet {0} ikke suspendet Medicinkortet {0} suspendet af en anden organisation: {3}{4}). Input: {1}{2} cpr {0} ikke tilknyttet et autorisationsnumm cpr {0} ikke gyldigt i autorisationstabellen cpr {0} ikke tilknyttet autorisationsnumm {1} Opslag på medicinkort ældre end to år ikke tilladt. Medicinkort datet {0} Svicen kaldt med forkt rodelement-navn. Kaldt med rodelement {0} namespace {1}. Rodelementet {2} med namespace {3} forventet 22 Svicen kaldt med forkt rodelement-namespace. Kaldt med {0} namespace {1}. Rodelementet {2} med namespace {3} forventet 101 Den angivne indikationskode {0} kunne ikke findes i taksten med vsionsdatoen {1} Taksten til datoen {0} kunne ikke findes Den angivne administrationsvejskode {0} kunne ikke findes blandt de tilladte kod Lægemiddel id {0} ikke gyldig i taksten med vsionsdatoen {1} Den angivne ATC kode {0} kunne ikke findes i taksten med vsionsdatoen {1} Den angivne lægemiddelform {0} kunne ikke findes i taksten med vsionsdatoen {1} Organisationsstrukturen (OrganisationStructure) indehold et ugyldigt element {0}. Værdien {1} ikke gyldig Kommunekoden (MunicipalityOrganisationIdentifi) {0} kunne ikke findes Autorisationskoden {0} kunne ikke findes Den angivne lægemiddelstyrkeenhedskode( DrugStrengthUnitCode) {0} kunne ikke findes Lægemiddelordinationen med id {0} allede seponet Samme lægemiddelordination opdatet to gange i samme forespørgsel Samme lægemiddelordination bliv både seponet og afseponet. id: {0} Den angivne effekturingsmetode (EffectuationMethodTet) kendes ikke: {0} Det angivne varenumm (PackageNumbIdentifi) {0} kunne ikke findes i taksten med vsionsdatoen {1} 117 Den angivne pakningsstørrelseenhedskode (PackageSizeUnitCode) {0} kunne ikke findes i taksten med vsionsdatoen {1} Recepten med id {0} kunne ikke findes Receptordinationen med id {0} findes ikke på medicinkortet for psonen 103

104 {1} Receptordinationen med id {0} allede tilknyttet en lægemiddelordination Lægemiddelordinationen med id {0} allede pauset Lægemiddelordinationen med id {0} ikke pauset OrganisationsstrukturenOrganisationStructure) indehold hvken ydnumm, SKS-afdelingskode ell kommunekode. EAN-Lokationsnumm anvendes kun til apotek ved receptoprettelse FromDateTime ({0}) skal ligge før ToDateTime{1} DateTime ({0}) skal ligge eft withdrawndate ({1}) Lægemidlet med drugid {0} ifølge taksten {1} ikke dosisdispensbart Lægemiddelordinationen {0} ikke aktiv på tidspunktet {1} D kan ikke oprettes pakning med varenummet {0}, varenummet forbeholdt "{1}" 132 D kan ikke oprettes pakning med varenummet {0}, varenummet uden for de tilladte intvall 134 Pakningen med varenumm {0} ikke relatet til lægemidlet {1} på lægemiddelordinationen {2} ifølge taksten. 139 D kan ikke oprettet en recept på pakningen med varenumm {0}. Lægemiddelordinationen indehold ikke lægemidlets form. D kan ikke oprettes recept på lægemidl uden form 140 Receptordinationen må ikke indeholde både elementet OrdInstruction og elementet DelivyInformation 141 Såfremt receptordinationen indehold me end et DelivyInformation-element skal de være ens: For elementne {1}" og "{2}" Såfremt receptordinationen indehold me end et OrdInstruction-element skal de være ens: For elementne "{1}" og "{2}" Såfremt receptordinationen indehold me end et Delivy-element skal de være ens: For elementne "{1}" og "{2}" 144 Recepten må ikke indeholde både ordination, d skal dosisdispenses og ordination, d ikke skal Fra-datoen skal være før til-datoen: {0} - {1} Takst vsionen angivet med tidszone: {0} Telefonnumm skal angives ved receptudstedelse, idet det ikke kan findes i stamdata for afsend 149 Indikationen skal være angivet i forespørgslen ved receptudstedelse til pson uden CPR-numm 150 Indikationen skal være angivet på lægemiddelordinationen ved receptudstedelse Dosisdispensingens slutdato skal være angivet ved receptudstedelse af dosisdispensede receptordination Dosingsenheden {0} findes ikke på tidspunktet {1} Takst vsionen for gammel. Den angivne takstdato {0} me end {1} dage gammel 159 Pakningsstørrelsen kan kun angives i fritekst for pakning d ikke findes i taksten 160 D blev angivet en tom dosingsfritekst 104

105 161 Pakningsstørrelsen skal angives i fritekst for pakning d ikke findes i taksten Lægemiddelordinationen med id {0} ikke seponet D blev angivet en tom indikationskode Fra-datoen kan ikke ligge før 1900, angivet dato: {0} Psonen med cpr {0} market som afdød og d kan dfor ikke oprettes recept Lægemiddelordinationen med id {0} findes ikke Fejl i dosingen: {0} Fejl i dosingen: Dosingen indehold ikke andre værdi end 0 Fejl i dosingstidspunktet: {0} Når et Dosage element indehold et {0} element skal det også indeholde et Type element 224 Når et Dosage element indehold Structure og et Type element skal disse stemme ovens. Angivet dosistype \"{0}\" mens dosistype begnet ud fra Structure elementet \"{1}\" Fejl i dosingen: Datoen {0} i elementet {1} skal være eft Opdating af medicinkort forespørgsel tom. cpr: {0} Fejl i effektuingen: Mangl lægemiddel ell pakning Fejl i klausulbetingelse. Apoteket håndt kun \"klausulbetingelse opfyld\" Effektuing med id {0} findes ikke Et af følgende element mangl: CreatedBy, ModifiedBy, SuspendedBy, WithdrawnBy ell PausedBy D mangl et CreatedBy element En Organisation med Type {0} ikke supportet En Organisation med Type {0} og Identifi source {1} ikke supportet D må ikke optræde me end et {0} element i et UpdateMedicineCardRequest Elementet {0} skal have sat en date attribut når source attributten sat til "Medicinpris" Startdatoen {0} i requested sene end slutdatoen {1} Elementet {0} ikke supportet endnu Et {0} element med værdi {1} ikke supportet endnu Elementet {0} med værdi {1} ikke supportet Lægemiddelordinationen med id {0} kan ikke genbestilles da receptordinationen med id {1} allede und behandling 411 Kunne ikke finde en åben ell delvis udlevet recept på lægemiddelordinationen {0} Patientrelationen med id {0} findes ikke For få søgeparametre Fejl und fremsendelse af forespørgsel til PEM: {0}{1}) Intn sv fejl Samtidig retransmission af besked med msgid {0} Requestet genbrug msgid {0} som allede brugt i et ikke identisk request 3003 Samtidig opdating af medicinkortet {0} fejlede 3100 Metoden {0} endnu ikke implementet 105

106 Svicen {0} ikke untøttet Skemavalidingsfejl {0} Idkort kunne ikke behandles: {0} SOSI ml fejl SOSI ugyldig signatur Manglende SOSI ID kort Manglende organisationskode Ingen roll pass på brugen Fle forskellige roll pass på brugen - angiv ønsket rolle Betingels for den ønskede rolle ikke tilstede Rollen {0} har ikke rettighed til {1} Brug uden autorisationsnumm har ikke adgang til data med privatmarking Manglende system autorisation, {0} Medhjælp med cpr {0} allede knyttet til lægen med cpr {1} Medhjælp med cpr {0} allede knyttet til en læge Det angivne medhælp cpr {0} tilhør en læge Borge har kun ret til at invoke metoden {0} på eget medicinkort" 106

107 8 Refenceliste Refence Dokument FMK1.0 FMK - Svicebeskrivels v2.0.5.pdf FMK1.2.6 FMK - Snitfladebeskrivelse pdf begreb Begrebsdefinition i FMK ls usecase Det Fælles Medicinkort - Use Cases v pdf sosi dgws Den Gode Websvice pdf 107

108 9 Ændring 9.1 Ændring fra til I FMK d indført en række ændring, beskrevet hund. Dette medfør, at d indføres et antal nye skema og svices i namespacet: GetMedicineCard UpdateMedicineCard GetDrugMedication UpdateDrugMedication GetDrugMedication CreateEffectuation SearchEffectuation GetPrescriptionMedication Ændring af lægemiddelstyrke Ved angivelse af lægemiddelstyke findes d Medicinpris ( taksten ) både en numisk angivelse af styrke supplet med enhed og en angivelse som tekst. Idet d i visse tilfælde forskelle i hvorledes dette angivet (men ikke en reel forskel i styrke) vil FMK fra kunne indeholde begge typ. Ændringen indført i skemaet for DrugStrength og medfør følgeændring i nedenstående rodskema: UpdateMedicineCardRequest GetMedicineCardResponse CreateDrugMedicationRequest UpdateDrugMedicationRequest GetDrugMedicationResponse CreateEffectuationRequest SearchEffectuationResponse GetPrescriptionMedicationResponse Ændring til lægemiddelstyrke omtalt und Lægemiddel side 93 og eftfølgende. Dosing med fle piod D indført dosing med fle piod. Desuden placingen af dosingsovsættelsen flyttet (kortog lang dosingstekst m.v.), således at d kan returnes en dosingsovsættelse for den samlede piode såvel som de enkelte piod. Dette medfør ændring i nedenstående rodskema: UpdateMedicineCardRequest GetMedicineCardResponse CreateDrugMedicationRequest UpdateDrugMedicationRequest GetDrugMedicationResponse Udvidelsen af de strukturede dosing med fle piod omtalt: 108

109 Afsnit 4.15 Strukturet dosing side 37. XML beskrivelse afsnit 6.11 Dosing side 96. Eksempl og supplende beskrivelse afsnit 10 Dosingstruktur supplende beskrivelse side

110 10 Dosingstruktur supplende beskrivelse Dette afsnit beskriv FMKs dosingsstruktur, og indehold en række eksempl. FMKs dosingsstruktur ells fastlagt ved et XML-skema samt et sæt validingsregl, disse nærme beskrevet i afsnittet Strukturet dosing side 37 og afsnittet Strukturet dosing side 97. I FMK d mulighed for at anvende en ell fle strukturede dosing, en dosing i fritekst og et flag til angivelse af at dosingen eft skema i et lokalt system, men ikke eksportet til FMK. Strukturede dosing bør dog anvendes ovalt hvor det muligt Medicinskema og strukturet dosing Ideen bag FMKs dosingsstruktur at stille et antal uendelige store medicinskema til rådighed. Et enkelt medicinskema kan indeholde uendeligt mange dage, og uendeligt mange daglige dosing. Desuden supples d med en mulig angivelse af et itationsintval, dvs. at dosingen gentages eft et antal dage, således at faste dosing kan angives. En lægemiddelordination kan indeholde fle eftfølgende medicinskema, således at dosingen kan varies. Hund illustret en tænkt grafisk vsion af FMKs medicinskema (lette simplificet, hvilket vi vend tilbage til sene). 110

111 Eksempel: 2 tablett morgen og aften En dosing skal have et starttidspunkt og kan have et sluttidspunkt. Hund starttidspunktet angivet til datoen Dosingen gentages eft 1 dag. Dvs. at kun dosingen for en enkelt dag angivet (Dag 1), denne dosing anvendes for alle eftfølgende dage. Dette også illustret med den røde pil. Enheden d anvendes for alle dosing Tablett. D ikke angivet en supplende tekst. D kun angivet to daglige dos, 2 tablett morgen og 2 tablett aften. Dosingen således svarende til en fast dosing 2 tablett morgen og aften, første gang den FMKs strukturede dosing afspejl dette skema. XML-dokumentet hund svar således til indholdet af ovenstående skema. 111

112 XML: 2 tablett morgen og aften Dosingen doses med dosingenheden tablett, som angivet i UnitTet. Kilden til dosingsenheden angivet til Dosingsforslag i source-attributten. Dosing indehold en strukturet dosing, d gentages eft 1 dag, angivet i ItationIntval. Dosingens startdato (uden tidszoneangivelse) angivet i StartDate, og d ikke angivet et sluttidspunkt for dosingen, i stedet elementet DosageEndingUndetmined anvendt. Heft følg dosingen for ell fle dage angivet i et ell fle Day element. I dette eksempel kun for dag 1, som angivet i Numb-elementet. Dag 1 indehold to dos, hhv. morgen og aften. Begge dos ens, med en mængde 2 angivet i Quantity-elementet. <Dosage> <Structures> <UnitTet source="dosingsforslag">tablett</unittet> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>2</Quantity> </Dose> <Dose> <Time>evening</Time> <Quantity>2</Quantity> </Dose> </Day> </Structure> </Structures> </Dosage> 10.2 Form for daglige dos De daglige dosing kan angives på fle form, og formne kan blandes. FMK still følgende form til rådighed: Morgen, middag, aften ell nat: Dosis gives på dette tidspunkt. Det eksakte klokkeslæt kan lokalt tilpasses patientens behov, tidspunkt for stuegang, tidspunkt for hjemmesygeplejens besøg ell lignende. Klokkeslæt: Et eksakt klokkeslæt, f.eks. 13:30:00 Uden angivelse : Dosis skal tages i løbet af dagen, men d ikke angivet et nærme tidspunkt. 112

113 Eksempel: 2 tablett kl. 18 og kl. 22 Dette eksempel svar til det forrige, bortset fra at de to daglige dos ikke sk morgen og aften, men kl. 18:00:00 og kl. 22:00:00. I forbindelse med eksport af data fra EPJ-system skal bemærkes, at klokkeslæt d udelukkende skyldes at d i EPJ-systemet definet tidspunkt for stuegang ikke skal eksportes til FMK. Det dfor nødvendigt at skelne mellem klokkeslæt d vigtige for en korrekt dosing og klokkeslæt d skyldes tidspunkt for stuegang på den sygehusafdeling patienten indlagt. I stedet bør disse dosing oprette med f.eks. en dosing morgen, middag, aften og nat. Eventuelt kan d foretages en automatisk konvting ud fra lokale parametre, eksempelvis: 03:00:01 09:00:00 morgen 09:00:01 15:00:00 middag 15:00:01 21:00:00 aften 21:00:01 03:00:00 nat 113

114 XML: 2 tablett morgen og aften Dosingen hund svar til forrige XML dokument, indholdet i Time-elementne tidspunktne 18:00:00 og 22:00:00. Bemærk at XML time elementet altid med sekun præcision, dette kan evt. i en lokal visning afkortes til tim og minutt. Indholdet af Time-elementet kan være en af de fire faste tekst morning, noon, evening, night ell et tidpunkt angivet som et klokkeslæt. Elementet således ikke et fritekst-felt, og d kan f.eks. ikke skrives morgen (på dansk), early morning, aftnoon ell lignende. <Dosage> <Structures> <UnitTet source="dosingsforslag">tablett</unittet> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <Day> <Numb>1</Numb> <Dose> <Time>18:00:00</Time> <Quantity>2</Quantity> </Dose> <Dose> <Time>22:00:00</Time> <Quantity>2</Quantity> </Dose> </Day> </Structure> </Structures> </Dosage> 114

115 Eksempel: 2 tablett 3 gange dagligt I dette eksempel gives d 2 tablett 3 gange dagligt, men tidspunktne ikke nærme angivet. Dosing som f.eks. 2 tablett 3 gange daglig findes først og fremmest da denne form hyppigt anvendt i dag. Så vidt en dosing morgen+middag+aften+nat giv mening skal denne foretrækkes, idet de giv en klare angivelse af dosingen, og morgen+middag+aften+nat som minimum krævet håndtet af alle system d anvend FMK. Fortolkningen af denne form for dosing vil normalt være, at såfremt d angivet fle daglige dos skal disse fordeles jævnt i løbet af dagen, hvorfor en morgen+middag+aften(+nat) dosing bør foretrækkes. Specielt hvor d gives en enkelt dosis dagligt kan formen uden tidspunkt dog være hensigtsmæssig. 115

116 XML: 2 tablett 3 gange dagligt I dette eksempel d angivet tre Dose-element uden et Time-element, dvs. uden nærme tidsangivelse. <Dosage> <Structures> <UnitTet source="dosingsforslag">tablett</unittet> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <Day> <Numb>1</Numb> <Dose> <Quantity>2</Quantity> </Dose> <Dose> <Quantity>2</Quantity> </Dose> <Dose> <Quantity>2</Quantity> </Dose> </Day> </Structure> </Structures> </Dosage> 116

117 10.3 Dosing eft behov (PN-dosing) Samtlige form for daglige dos kan supples med et flag d angiv at dosen eft behov (PN). Eksempel: 2 tablett morgen middag og aften eft behov ved smt Eksemplet hund vis en dosing eft behov. D kan angives en supplende tekst d i dette tilfælde angiv en betingelse for at en PN dosis kan tages, i eksemplet ved smt. Dosingen udtrykk at d tre gange i løbet af dagen (morgen, middag og aften) ved smt kan tages 2 tablett. Dosingen sig dved også, at d f.eks. ikke kan tages 2 tablett nat i stedet for morgen, ell at d kan tages 2 tablett nat hvis patienten stadig har smt. D kan altså højst tages 6 tablett i løbet af dagen. 117

118 XML: 2 tablett morgen middag og aften eft behov ved smt I eksemplet de tre dos på tidspunktne morning, noon og evening market med det tomme element IsAccordingToNeed, dvs. at de tre dos alle eft behov. D tilføjet et SupplementaryTet-element til den supplende betingelse ved smt. Denne tekst anvendes også til dosingsovsættelsne, hvorfor en passende anvendelse af store og små bogstav ikke uden betydning. <Dosage> <Structures> <UnitTet source="dosingsforslag">tablett</unittet> <Structure> <ItationIntval>1</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <SupplementaryTet>ved smt</supplementarytet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> <Dose> <Time>noon</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> <Dose> <Time>evening</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> </Day> </Structure> </Structures> </Dosage> Bemærk at den supplende tekst ikke skal indeholde eft behov ell en lignende formuling, men en betingelse og evt. en vejledning. Informationen om at dosingen eft behov skal udelukkende angives med flaget på dosne. Det muligt at blande en fast, temporær, m.v. dosing og en dosing eft behov i samme Structure-element. Eksempelvis 2 smtestillende tablett morgen, middag og aften supplet med 2 PN til natten, såfremt patienten stadig har smt. Dette kan også gøres i to separate Structure-element, et med den faste/temporære/... dosing og et med PN dosingen (se eksemplet Dosing med fle piod ). Såfremt dette ikke muligt i det lokale system kan d lokalt oprettes to ordination. D skal dog sikres, at dette ikke medfør at FMK opdates med to lægemiddelordination alene af denne grund. 118

119 For visse PN-typ af dosing ønskes dosingen kun gjort afhængig af betingelsen i den supplende tekst. Dette en undtagelse fra den ells faste regel, at dos oprettes på en given dag, og dette kun muligt for PN dosing. Eksempel: 2 sug ved anstrengelse I dette tilfælde ønskes d en dosing d kun begrænset af, at dosis (2 sug) kan tages ved anstrengelse. Det dved muligt at tage 2 sug et vilkårligt antal gange dagligt. Dosingen udtrykk at d vilkårligt ofte kan tages 2 sug ved anstrengelse. Dosingen sig dved også, at det principielt uskadeligt at tage 2 sug mange gange i løbet af dagen. Dosing af denne type anvend samme XML struktur, men med få variant: 119

120 XML: 2 sug ved anstrengelse I dette XML dokument d ændret fle element: Elementet ItationIntval stattet af det tomme element NotItated, det angiv at dosingen ikke gentaget. Dosingen hell ikke knyttet til en bestemt dag, hvorfor elementet Day stattet af AnyDay. Dette element indehold ikke et Numb til dagens numm, og kan kun bruges til PN dosing hvorfor elementet IsAccordingToNeed altid vil være til stede. <Dosage> <Structures> <UnitTet source="dosingsforslag">sug</unittet> <Structure> <NotItated/> <StartDate> </StartDate> <DosageEndingUndetmined/> <SupplementaryTet>ved anstrengelse</supplementarytet> <AnyDay> <Dose> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> </AnyDay> </Structure> </Structures> </Dosage> 10.4 Dosingens dage Dosingens dos altid indplacet i medicinskemaet på en given dag, den eneste undtagelse hfra en bestemt type af PN dosing, som vist i 2 sug ved anstrengelse i Dosing eft behov (PN-dosing) hov. Langt størstedelen af dosingne sk ved en daglig gentagen dosing. Dette dog ikke en begrænsning, en dosing kan gentages eft et vilkårligt antal dage. Ud ov 1 dag d oftest anvendt itationsintvall på 2, 7 ell 30 dage. 120

121 Eksempel: 1 kapsel morgen dag 1, 1 kapsel morgen og aften dag 2 Eksemplet vis en dosing med to dage, d gentages. Den ene dag gives 1 kapsel morgen, den anden dag 1 kapsel morgen og aften. Itationsintvallet må ikke vælges større end nødvendigt for at angive dosingen korrekt. Haves eksempelvis et klientsystem, d som udgangspunkt har et medicinskema på 7 dage, kan det være vanskeligt at udtrykke en dosis som f.eks. 1 stk dag 1 og 2 stk dag 2 korrekt, uden at d forekomm to eftfølgende dage med samme dosis. Den rigtige løsning ikke at sætte itationsintvallet til 14 for at løse det problem, i stedet skal itationsintvallet h være

122 XML: 1 kapsel morgen dag 1, 1 kapsel morgen og aften dag 2 I XML dokumentet d definet en dosing d gentages eft 2 dage, som angivet i ItationIntval. Tilsvarende findes d to Day-element med hhv. dagsnumm 1 og 2 angivet i Numb-elementet. I eksemplet d desuden vist at enheden kan angives i ental og fltal. Dette specielt væsentligt hvor d angives en lokalt definet dosingsenhed, som ukendt af FMK, og som skal anvendes i forskellige form i ental og fltal til dosingsovsættelsen. <Dosage> <Structures> <UnitTets source="dosingsforslag"> <Singular>kapsel</Singular> <Plural>kapsl</Plural> </UnitTets> <Structure> <ItationIntval>2</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <SupplementaryTet>ved måltid</supplementarytet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> </Day> <Day> <Numb>2</Numb> <Dose> <Time>morning</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> <Dose> <Time>evening</Time> <Quantity>2</Quantity> <IsAccordingToNeed/> </Dose> </Day> </Structure> </Structures> </Dosage> Såfremt dosingen gentaget, dvs. at d anvendt ItationIntval kan d ikke defines en dag med Numb større end hvad angivet i ItationIntval. Såfremt dosingen ikke gentaget, og NotItated anvendt, dette ikke et krav. I XML dokumentet behøv d ikke at findes Day-element for alle dage. 122

123 Eksempel: 1 kapsel hv 7. dag I eksemplet h gives en kapsel hv 7. dag om morgenen ved måltid. XML: 1 kapsel hv 7. dag I XML dokumentet d definet en dosing d gentages eft 2 dage, som angivet i ItationIntval. Tilsvarende findes d to Day-element med hhv. dagsnumm 1 og 2 angivet i Numb-elementet. <Dosage> <Structures> <UnitTets source="dosingsforslag"> <Singular>kapsel</Singular> <Plural>kapsl</Plural> </UnitTets> <Structure> <ItationIntval>7</ItationIntval> <StartDate> </StartDate> <DosageEndingUndetmined/> <SupplementaryTet>ved måltid</supplementarytet> <Day> <Numb>1</Numb> <Dose> <Time>morning</Time> <Quantity>1</Quantity> </Dose> </Day> </Structure> </Structures> </Dosage> 123

124 Bemærk at dosingens starttidspunkt defin hvilken dag d angives som dag 1. I ovenstående eksempel dag 1 tirsdag den 20. novemb Dag 1 således ikke nødvendigvis en mandag, hell ikke for en dosing d gentages ugentligt. Præsentationen i det lokale system kan dog være andledes, hvis det lokale medicinskema indrettet således at dag 1 altid en mandag Itationsintval Hovedparten af de eksempl d indtil nu har været vist har haft et itationsintval, d angiv eft hvor mange dage dosingen skal gentages. Det naturligvis også muligt at angive dosing d ikke skal gentages. Dette kan være engangsdos, f.eks. 1 tablet morgen den 20. novemb, ell dosing med variede dos, d skal gives ov et antal dage, eksempelvis en op- ell nedtrapning. Eksempel: Nedtrapning Ved en op- ell nedtrapning angives ikke noget itationsintval. Dette eksempel vis en nedtrapning ov 10 dage, d dog ingen begrænsning i ov hvor lang en piode en dosing kan angives. 124