Det Fælles Medicinkort Snitfladebeskrivelse Vsion 1.3.0 2012-04-13
Vsioning Vsion Dato Forfatt Ændring 0.0.1 2007-04-20 TKN Udkast oprettet på baggrund af use cases og første møde med teknike. 0.0.2 2007-04-30 TKN Ændret til OIO navngivning. Mindre ændring i XML eksempl. 0.0.3 2007-05-02 TKN Ændring og tilføjels eft møde med klinike 0.0.4 2007-05-05 SWA Ændring indsat 0.1.1 2007-05-21 TKN Tilføjet og ændret svices, navngivning strammet op 0.1.2 2007-05-24 SWA Tilføjet kommentar og forslag til ændring 0.1.3 2007-05-30 TKN Ændring eft møde med teknike, fjnet historik, ændret optimistisk låsning, præciset klassifikation. 1.0.0 2007-06-01 TKN Første endelige vsion. 1.1.0 2007-06-27 TKN Ny svice til at oprette ell ophæve tilknytning af receptordination til lægemiddelordination samt nye element i bulk svice. Mulighed for også at forespørge på vsionsnumm og dato i hent medicinkort og hent lægemiddelordination. Ny svice til søgning på seponede lægemiddelordination. Dosing ændret til at indeholde færre forskellige struktur. Lægemiddelstruktur ændret til at kunne indeholde aktive substans. Administrationsvej ændret til ikke obligatorisk i samtlige skema. Mindre fejlrettels i tekst. 1.2.0 2008-01-15 TKN Opdating til snitfladen. Tilføjet afsnit 4.10 - Opdatet af sygehusafdeling, praksis og læge 1.2.1 2008-01-28 TKN I Afsnit 4.9 tilføjet beskrivelse af nuværende opførsel ved fle opdating i samme dokument. Tilføjet fejlliste se afsnit 10. 1.2.2 2008-02-27 MAL, TKN Tilføjet afsnit 5.17 (Medicingennemgang) Revidet 6.1 beskrivelse af MedineCardOvviewStructure (Medicingennemgang) Opdatet beskrivelse af dosingsstruktur afsnit 6.11, tidlige afsnit 4.8.9 (Type af dosing) fjnet, bilag 7 opdatet. Ændret placing af OrganisationStructure og DoctorStructure. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 2
Mindre præcising 2.0 2008-02-29 JHN Ophøjet til vsion 2.0 Bemærkning om tidszon ved dosingstidspunkt (6.11) Tilføjet afsnit om inkonsistente stamdataangivels (4.8.12) 2.0.1 2008-04-03 TKN Medicingennemgang tilføjet til opdat medicinkort (bulk) svice. Mindre ændring i elementnavne i hent medicinkort-vsion. 2.0.2 2008-05-15 TKN DosageStructureTranslation tiltilføjet i MedicineCardResponseStructure/MedicineCardOvviewStru cture/drugmedicationovviewstructure og DrugMedicationResponseStructure/DrugMedicationStructure. Afsnit 6.12 "Dosingsinformation ovsat til tekst" tilføjet. Afsnit om dosingstype fjnet. 2.0.3 2008-05-20 TKN Forekomst af DosageQuantityFreeText uden angivelse af værdi fjnet. Afsnit opdatet. Tilføjet 7 2.0.4 2008-07-08 JHN Ændret i anvendelsen af Zulu tid for 5 felt. Se afsnit. Tilføjet afsnit om timing angivelse i response head. Se afsnit 4.6 2.0.5 2008-07-21 TKN Tilføjet oprettelse af receptordination ud fra lægemiddelordination, afsnit 5.17 og 6.4 1.2.0 2009-03-16 JHN, TKN Dokumentets titel og vsionsnumm ændret således at det følg FMKs vsionsnumm. Opdatet til FMK 1.2 snitfladen. Endvide snitflade vsioning beskrevet. Se ændring i bilag sidst i dette dokument. 1.2.0.1 2009-04-01 TKN PDF print tilføjet 1.2.0.2 2009-04-30 JHN Ændring til definition af lægemiddelordinationens start- og slutdato. 1.2.0.3 2009-05-05 TKN Tilføjet afsnit 1.2.0.4 2009-06-04 JHN Opdating af afsnit 6.1 med ugyldighedsmarking. Afsnit og Error: Refence source not found opdatet med tidsangivelse på dosing. 1.2.0.5 2009-06-26 TKN Opdatet begreb, specielt "receptordination" ændret til "recept". Opret recept ud fra "Den gode XML recept" fjnet 1.2.0.6 2009-06-26 ELS Publicet 1.2.0.7 2009-06-30 TKN Tilføjet beskrivelse af oprettelse af lægemiddelordination med tilknytning af recept (AttachPrescriptionMedicationToThisStructure) Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 3
1.2.0.8 2009-06-30 MAL Tilføjet bemærkning om vaccination i forbindelse med beskrivelse af svice opret effektuing. 1.2.1.0 2009-08-24 TKN Inført valg mellem PriceListVsionDate og PriceListVsionWeek, afsnit 4.9 m.fl. Ændret i OrganisationStructure, således at p-numm (PharmacyIdentifi) stattes af lokationsnumm (EANLocationIdentifi). Håndting af pson i CPR-reg. uden navn ell adresse, afsnit 6.5. 1.2.2.0 2009-10-15 JHN Tilføjet tre nye svices: NewGetPrescriptionMedication, NewGetMedicineCard og NewGetDrugMedication. Denne release svar til releasen af stubbe for 1.2.2. 1.2.2.1 2009-11-16 JHN Opdatet afsnit om teknisk assistance. Ændret negativt samtykke til privat marking, samt opdatet afsnit Error: Refence source not found med beskrivelse af gyldighed for samtykke. Tilføjet afsnit om Angivelse at seneste repliking, afsnit 4.8. 1.2.2.2 2010-06-18 JBU/JHN Tilføje validing af Klausul betingelsen. Det således kun muligt at angive betingelsen klausulbetingelse opfyldt. Tilføjet rettighedsmatrix for lægens medhjælp. 1.2.2.3 2010-08-09 JBU/TOM Opdatet afsnit Error: Refence source not found med information om at privatmarkede lægemiddelordination bliv returnet i anonymiset form. Desuden samtykkets gyldighed kun gældende i 24 tim. Opdatet 6.5 med information om pson med navne og adresse beskyttelse bliv anonymiset. Opdatet afsnit 5.1 med en beskrivelse af receptkompriming. 1.2.2.4 2010-08-19 JHN Håndting af angivelse af autorisationsnumm tilføjet 4.5. 1.2.4.1 2010-10-12 KKR, JHN, TOM Beskrivelse af SOAP heads for system autorisation (whitelisting) i afsnit 4.5 Systemautorisation. Beskrivelse af rolle/rettighedsudvidelse i afsnit 4.5 Roll og rettighed. Samt opdating af afsnit om Medhjælp for sundhedsfaglig baset på bemyndigelse. Tilføjet beskrivelse af svices Opret recept til pson uden CPR-numm og Opret recept til brug i praksis. 1.2.4.2 2011-05-18 JBU Rettelse til beskrivelse af whitelistning. 1.2.4.3 2011-06-06 TOM Rettet figur. Fjnet afsnit OIO og ikke-oio snitflad. Opdatet fejlkod. Tilføjet afsnit 4.7 Kommunikation med receptsv. Tilføjet dosisdispensing start og slutdato und 7.5 CreatePrescriptionMedication - Oprettelse af recept ud fra lægemiddelordination. 1.2.4.4 2011-10-17 TOM Rettet beskrivelse af receptkompriming (afsnit 5.1. und løse recept). Tilføjet beskrivelse af information på effektuing vs. på recept (afsnit 7.2. und information til første udleving ). 1.2.4.5 2011-10-19 TOM Tilføjet bilag FMK Websvice-vsionsmatrix og Rollettighed Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 4
1.2.4.7 2011-12-08 JBU Fjnet henvisning til SupplementaryInformationText som ikke me findes i skema. 1.2.6.1 2011-12-18 JBU FMK 1.2.6. Slet effektuing samt af-sepon lægemiddelordination 1.2.6.2 2012-01-12 USK, TOM Ændret afsnit 4.5 Sikkhedsmodel med ændrede rolle/rettighedsmodel Tilføjet afsnit 7.5 Hent rettighed 1.2.6.3 2012-01-12 JBU,TOM Beskrevet rolle/rettighed medhjælp baset på trust 1.3.0.0 2012-04-13 TOM Opdatet til FMK 1.3 snitflade. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 5
Indhold 1 Indledning...8 2 Medicinkortet...9 2.1 Medicinkortets struktur...9 3 Læsevejledning...11 3.1 Begreb...11 3.2 XML konvention...11 4 Tekniske forhold vedr. anvendelsen af svices...12 4.1 Transaktion...12 4.2 Vsionsnumming...12 4.3 Historik...13 4.4 Fejlhåndting...14 4.5 Sikkhedsmodel...15 4.6 Timing angivelse i response head...24 4.7 Kommunikation med receptsv...25 4.8 Angivelse at seneste repliking...26 4.9 Klassifikation, standard...26 4.10 Opdatet af sygehusafdeling, praksis og læge...30 4.11 Lægemiddelordinationens gyldighedsintval...31 4.12 Dosingens gyldighedsintval...32 4.13 Sammenhæng mellem lægemiddelordinationens behandlingsintval og dosingens gyldighedsintval...32 4.14 Sammenhæng mellem gyldighedsintvall og recepten...34 4.15 Strukturet dosing...35 4.16 Vsioning af svices...37 5 Svices...39 5.1 Hent medicinkort...39 5.2 Hent medicinkort som PDF dokument...41 5.3 Hent medicinkort-vsion...42 5.4 Suspending af medicinkort...43 5.5 Gensuspending af medicinkort...44 5.6 Ophæv suspending af medicinkort (frigiv medicinkort)...45 5.7 Sæt marking for medicinafstemning...45 5.8 Hent lægemiddelordination...46 5.9 Opret lægemiddelordination...49 5.10 Opdat lægemiddelordination...51 5.11 Pausing af lægemiddelordination...53 5.12 Ophæv pausing af lægemiddelordination...54 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 6
5.13 Sepon lægemiddelordination...55 5.14 Afsepon lægemiddelordination...57 5.15 Søg eft seponede lægemiddelordination...57 5.16 Hent receptordination...58 5.17 Opret receptordination ud fra lægemiddelordination...60 5.18 Opret recept til pson uden CPR-numm...63 5.19 Opret recept til brug i praksis...64 5.20 Opret ell ophæv tilknytning af recept til lægemiddelordination...65 5.21 Mark receptordination som ikke aktuel...66 5.22 Annull recept...67 5.23 Hent effektuing...67 5.24 Opret effektuing...69 5.25 Slet effektuing...71 5.26 Bulk opdating af medicinkort...71 5.27 Hent rettighed...73 6 XML eksempl...75 6.1 Medicinkort og lægemiddelordination...75 6.2 Receptordination...81 6.3 Effektuing...84 6.4 CreatePrescriptionMedication - Oprettelse af recept ud fra lægemiddelordination...87 6.5 Patientinformation...88 6.6 Organisation...88 6.7 Læge...89 6.8 Indikation...89 6.9 Lægemiddel...90 6.10 Lægemiddelordinationens start- og slutdato...91 6.11 Dosingsinformation...92 6.12 Dosingsinformation ovsat til tekst...100 6.13 Pakningsstørrelse...101 7 Bilag Fejlkod og -tekst...102 8 Refenceliste...103 9 FMK Websvice vsionsmatrix...105 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 7
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 udviklingsvsion 1.3, d med eftfølgende udvidels idriftsættes som 1.4. Denne vsion dann basis for ydlige funktionalitet til EOJ-system m.v. Snitfladen svar i stor omfang til funktionalitet for FMK 1.2.4 og 1.2.6, og indehold kun i begrænset omfang ny funktionalitet. Det vil dfor med stor sikkhed komme ydlige udvidels, specielt til hjemmesygeplejen. Vsion 1.3. og 1.4 ikke bagud-kompatible, 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. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 8
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 1 Lægemiddelordination 2a Effektuing 2b Lægemiddelordination 3a Receptordination 3b Effektuing 3c Receptordination 4a Effektuing 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 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 9
Effektuing 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 fax ell som telefonrecept. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 10
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 ordination 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 Responseskemane 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. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 11
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 "Bulk opdating af medicinkort". 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 i fremtiden vil være fortløbende. Aktuelt dette tilfældet, men det må forudses at vsionsnummingen i fremtiden ændres til eksempelvis nedenstående format: TTTTTTTTTTSSSSIIII eksempelvis 133283328800420001 Hvor TTTTTTTTTT angiv et tidspunkt som unix tid, SSSS en sub-sekund tæll og IIII et instansnumm 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 NextVsion (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. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 12
Systemet anvend dimod ikke vsionsnummet til at foretage en optimistisk låsning. 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 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 13
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. 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 42 43 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. I de eftfølgende svicebeskrivels angivet typiske fejl. Listen dog ikke udtømmende. I fejlbeskrivelsne med kursiv angivet at d indsættes data, f.eks. - Ukendt CPR-numm 2105731003 - Syntaksfejl i forespørgsel: Value "" is not allowed for element PsonIdentifi Sidste del af beskeden stamm fra XML-parsen, og dfor på engelsk. Ud ov de fejl, d beskrives i de eftfølgende svices, kan d opstå en række genelle fejl i de fleste forespørgsl. Disse ikke nævnt i de enkelte svicebeskrivels. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 14
Syntaksfejl i forespørgsel: detalj Ukendt ydnumm DoctorOrganisationIdentifi Ukendt sygehusafdelingsnumm HospitalOrganisationIdentifi Ukendt autorisationsnumm AuthorisationIdentifi Intn fejl på sv: detalj Desuden skal d foretages en håndting af en eventuel advarsel med elementet VsionMismatchWarningIndicator som beskrevet i afsnittet "Vsionsnumming". En liste ov fejlkod og -tekst findes i bilag 7. 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]. 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. Det dfor ikke bundet til en session, men kan varie fra en forespørgsel til næste. SOAP Heads til system autorisation D tilføjes flg. XML element til SOAP headen. Alle af type xs:string: 1. SystemOwnName 2. SystemName 3. SystemVsion 4. OrgResponsibleName 5. OrgUsingName 6. OrgUsingID System autorisation tænkt som en udvidelse af Den Gode Websvice, og und standardising i NSI regi. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 15
SystemOwnName D introduces en ny SOAP head, som indehold det entydige navn på levandøren af afsendsystemet. Navn sdsd:systemownname Type xs:string Aritet 1 Værdisæt Udfaldsrummet diktes via det Centrale Virksomheds Regist Eksempel <SystemOwnName>Pharma</SystemOwnName> SystemName D introduces en ny SOAP head, som indehold navnet på afsendsystemet. Navn sdsd:systemname Type xs:string Aritet 1 Værdisæt Udfaldsrummet diktes alene af levandøren af afsendsystemet Eksempel <SystemName>Medicinmodulet</SystemName> SystemVsion D introduces en ny SOAP head, som indehold vsionen på afsendsystemet. Navn sdsd:systemvsion Type xs:string Aritet 1 Værdisæt Udfaldsrummet diktes alene af levandøren af afsendsystemet Eksempel <SystemVsion>1.0</SystemVsion> OrgResponsibleName D introduces en ny SOAP head, som 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 sdsd:orgresponsiblename Type xs:string Aritet 1 Værdisæt Udfaldsrummet diktes af den ansvarlige organisation Eksempel <OrgResponsibleName>LægepraksislevandørXYZ</OrgResponsibleName > OrgUsingName D introduces en ny SOAP head, som 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 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 16
Navn sdsd:orgusingname Type xs:string Aritet 1 Værdisæt Udfaldsrummet diktes af den i OrgUsingID anvendte klassifikation Eksempel <OrgUsingName>ROS Infektionsmedicinsk Amb.</OrgUsingName> OrgUsingID D introduces en ny SOAP head, som 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 sdsd:orgusingid Type xs:string Aritet 1 Eksempel <OrgUsingID NameFormat="medcom:sor">348211000016001</OrgUsingID> OrgUsingID@NameFormat 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 prefix, selvom det selvfølgelig definet i et namespace. Navn sdsd:orgusingid@nameformat Type xs:string Aritet 1 Format 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] Eksempel <OrgUsingID NameFormat="medcom:skscode">650402</OrgUsingID> Eksempel: Alle XML element i denne block fra namespace: http://www.sdsd.dk.dgws/2010/08 <soapenv:envelope xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01" xmlns:ns1="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01" xmlns:sdsd="http://www.sdsd.dk/dgws/2010/08" xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:oas="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <soapenv:head> <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> Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 17
<!--... --> </soapenv:head> <soapenv:body> <!--...--> </soapenv:body> </soapenv:envelope> Fejlmeddels for system authorisation 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). 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) 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: Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 18
4200 Ingen roll pass på brugen Eksempel på brug af RequestedRole: <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 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 (se afsnit om Medhjælp for sundhedsfaglig baset på bemyndigelse). 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. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 19
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. 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. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 20
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.). 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 fra FMK 1.2.6 en svice som kan bruges til at hente de gældende rettighed for den aktuelle brug (og dmed den aktuelle rolle). Rolle BorgOpslag SundhedsfagligOpslag Recept Lægemiddelordination Effektuing Privatmarking VisPrivatmarketVærdispring VisPrivatmarketSamtykke Suspending Afstemning LøsRecept Læge x x x x x x x x x x Tandlæge x x x x x x x x x x Sygeplejske x x x x x Jordemod x x x x x Social- og sundhedsassistent x x x x x Social- og sundhedshjælp x x x x x Sundhedsplejske x x x x x Farmaceut x x x x x Farmakonom x x x x x Assistent for Læge x x x x x x x x x Assistent for Tandlæge x x x x x x x x x Assistent for Sygeplejske x x x x x Assistent for Sygeplej x x x x x Assistent for Jordemod x x x x x Assistent for Social- og sundhedsassistent x x x x x Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 21
Rolle BorgOpslag SundhedsfagligOpslag Recept Lægemiddelordination Effektuing Privatmarking VisPrivatmarketVærdispring VisPrivatmarketSamtykke Suspending Afstemning LøsRecept Borg x Forældmyndighed x Værge x Web administrator x x Krævede rettighed for anvendelse af svices 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 et x i parentes. Svice BorgOpslag SundhedsfagligOpslag Recept Lægemiddelordination Effektuing Privatmarking VisPrivatmarketVærdispring VisPrivatmarketSamtykke Suspending Afstemning LøsRecept Hent medicinkort (x) (x) (x) (x) Ny hent medicinkort (x) (x) (x) (x) Hent medicinkort i PDF (x) (x) (x) (x) Hent medicinkortvsion (x) (x) Sæt marking for medicingennemgang x Hent lægemiddelordination (x) (x) (x) (x) Ny hent lægemiddelordination (x) (x) (x) (x) Opret lægemiddelordination (x) x (x) (x) Opdat lægemiddelordination x (x) Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 22
Svice Pausing af lægemiddelordination 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 (x) (x) Hent receptordination (x) (x) BorgOpslag SundhedsfagligOpslag Recept Lægemiddelordination Effektuing Privatmarking VisPrivatmarketVærdispring VisPrivatmarketSamtykke Suspending Afstemning LøsRecept x x x x x x x Opret receptordination x Opret recept til praksis x Opret recept uden CPR x Opret/ophæv tilknytning af receptord. Suspending af medicinkort x Gensuspending x Frigiv medicinkort x Opdating af medicinkort (x) (x) (x) (x) (x) Hent auditlog (x) (x) Hent rettighed x Den Gode Web Svice og tidsangivelse Denne vsion af medicinkortet bases på vsion 1.0.1 af Den Gode Web Svice [dwgs]. Vsion 1.0.1 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. 2008-02-28T16:57:00Z for dato/tid, 21:42:00Z for tid og 2008-02-29Z for dato, samt at korrige for de 1-2 tims forskel (vint og sommtid henholdsvis) d mellem dansk tid og UTC. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 23
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: DosageTimeTime 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"> <AttributeValue>Anæstesiologisk ovafd., Gentofte hospital</attributevalue> </Attribute> CareProvidName må maximalt 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> Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 24
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. 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 undstøtte samtlige tegn i datagrundlaget. I praksis betyd dette, at d skal benyttes ISO 8859-1. Følgende tegn giv faringsmæssigt problem og må dfor ikke anvendes: Tegn Code Page 865 (decimalt) $ 36 @ 64 [ 91 \ 92 ] 93 { 123 } 125 124 156 1 2 171 1 4 172 175 Tegn, d normalt ikke findes på tastatur: Semigrafik (CP 865 decimalt 169, 170, 176-223, 244, 245, 251, 254, 255) og styretegn (CP 865 decimalt 1-31) må hell ikke anvendes. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 25
4.8 Angivelse at seneste repliking I FMK 1.2.2 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 maximalt 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>2009-11-16T11:52:00Z</LatestReplicationDateTime> </PrescriptionReplicationStatusStructure> Tiden angives i tim og minutt. Sekund sættes altid til 00. 4.9 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). 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="2012-02-11">123</code> <Text>Mod lungebetændelse</text> </Indication> <Indication> <Code source="medicinpris" yearandweek="2012-06">123</code> <Text>Mod lungebetændelse</text> </Indication> 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. Mulige kild for de anvendte klassifikation beskrevet i beskrivelsen for de relevante element. En specifikation af Lægemiddelstyrelsens takst og et sæt eksempel-fil kan findes på: http://www.laegemiddelstyrelsen.dk/1024/vislsartikel.asp?artikelid=2073. Taksten hentes fra Lægemiddelstyrelsens FTP-sv som hidtil. Tabell i taksten navngivet LMS01 til LMS32, nedenfor henvises til disse tabell. Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 26
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> <Code source="medicinpris" date="2011-02-27">or</code> <Text>Oral anvendelse</text> </RouteOfAdministration> 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 145 - mod smt 362 - til behandling af alvorlig virusinfektion Indikationen findes i XML elementet Indication. <Indication> <Code source="medicinpris" date="2012-02-11">123</code> <Text>mod lungebetændelse</text> </Indication> 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="2012-02-27">tabfilm</code> <Text>filmovtrukne tablett</text> Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 27
ATC </DrugForm> 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 - Digitoxin 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="2012-02-27">n02be01</code> <Text>Paracetamol</Text> </ATC> 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="2012-02-27">st</unitcode> <UnitText>stk.</UnitText> </PackageSize> 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. Eksempl (kode - tekst): MG - mg ML - ml MGG - mg/g GB - gigabecquel Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 28
Lægemiddelstyrken og enheden hfor findes i XML elementet DrugStrength. <DrugStrength> <Value>5</Value> <UnitCode source="medicinpris" date="2012-02-27">mgm</unitcode> <UnitText>mg/ml</UnitText> </DrugStrength> Enhed for lægemiddeldosis Enhed for lægemiddeldosis angives i mængde -enhed svarende til stk, dos, dråb mm og ikke i styrkeenhed. På nuværende tidspunkt (hvor 1.3 specifikationen skrives) findes d tre mulige måd at angive enheden på: Medicinpris angiv at enheden findes i Medicinpris (Lægemiddelstyrelsens takst). 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 DosageQuantityUnitText. <Dosage> <Structure>... <UnitText source="lokal" date="2011-02-11">stk</unittext>... </Structure> </Dosage> Se afsnit 4.15 for en gennemgang af strukturede dosing. 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 Det Fælles Medicinkort - Snitfladebeskrivelse 1.3.0 29