This is an old revision of the document!
Table of Contents
Beskrivelse af extension E1
I forbindelse med planlægningen af FMK 1.4.4 snitfladen blev der på en række teknikermøder diskuteret hvilken funktionalitet snitfladen skulle stille til rådighed. En række ønsker blev prioriteret højt af leverandørerne, men nåede af forskellige årsager ikke at komme med i den færdige snitfladebeskrivelse.
For at imødekomme leverandørernes ønsker leveres de væsentligste kandidater i en ny udvidelse af FMK 1.4.4 som får betegnelsen Extension E1.
I tillæg til den nye funktionalitet laves der en udvidelse af GetMedicineCard, der gør det muligt at se datoer for patientrelationer såsom indlæggelse og udskrivelse. Disse datoer stilles til rådighed for at imødekomme certificeringskrav 3.7, der pålægger systemerne at vise disse datoer selvom disse oplysninger efter udfasningen af suspendering/afsuspendering terminologien ikke er umiddelbart tilgængelige på medicinkortet. Dette retter Extension E1 op på.
Med Extension E1 udvides snitfladerne med følgende ny funktionalitet.
Udvidelse af Hent medicinkort servicen med DD-info.
Udvidelsen består i at der i et GetMedicineCardResponse inkluderes information om seneste dosisdispenserede apoteksudlevering såfremt der findes dosisdispenserede recepter tilknyttet patienten, samt information om hvorvidt der findes åbne recepter til dosisdispensering.
Dette skal ses i sammenhæng med et nyt godkendelseskrav GK 6.3: ”Et system skal særlig fremhævet vise, hvornår og fra hvilket apotek der seneste er foretaget en dosisdispenseret apoteksudlevering (effektuering).”
Informationen tilføjes til svaret og beregnes i alle tilfælde, også såfremt IncludePrescriptionMedications er sat til false og svaret derfor ikke indeholder recepter.
Information om seneste dosisdispenserede effektuering returneres som resultat, og angives i et nyt LatestDosageDispensingEffectuation element i GetMedineCardResponse strukturen. Elementet medsendes ikke hvis der ikke findes dosisdispenserede effektueringer.
Information om hvorvidt der findes åbne recepter til dosisdispensering returneres i elementet HasOpenDosageDispensingPrescriptions.
Herunder ses et eksempel på et svar fra GetMedicineCard servicen, hvor information om seneste dosisdispenserede apoteksudlevering er inkluderet:
<GetMedicineCardResponse> <MedicineCard> <Patient> .. </Patient> .. <LatestDosageDispensingEffectuation> <Created> <By> <Organisation> <Name>Skanderborg Apotek</Name> <AddressLine>Adelgade 27</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <Type>Apotek</Type> <Identifier source="CVR-P">1003153308</Identifier> </Organisation> </By> <DateTime>2013-11-20T15:59:12.0Z</DateTime> </Created> </LatestDosageDispensingEffectuation> <HasOpenDosageDispensingPrescriptions>true</HasOpenDosageDispensingPrescriptions> .. </MedicineCard> </GetMedicineCardResponse>
Udvidelse af Hent medicinkort servicen med informationer om receptanmodninger
Udvidelsen består i at der i et GetMedicineCardResponse inkluderes information om, hvorvidt der eksisterer receptanmodninger på den pågældende borger.
Dette skal ses i sammenhæng med et nyt godkendelseskrav GK 3.12, samt skærpelserne i GK 12.3: ”Systemer, skal give brugeren mulighed for at slå op på receptanmodninger fra hjemmeplejen.”.
For at kunne understøtte disse krav, har det været nødvendigt at hente alle medicinanmodninger for samtlige borgere, der hentes medicinkort på. Da kun et fåtal af alle borgere har receptanmodninger, har der været ønsker om at informationen tilføjes til medicinkortet, når der ligger receptanmodninger på den pågældende borger.
Information om eksisterende receptanmodninger ligger i elementet <OrderedPrescriptionMedicationsExist>. Dette element er et flag, der blot fortæller at der eksisterer receptanmodninger, men som ikke uddyber status eller antal af disse receptanmodninger. Det enkelte system må, når <OrderedPrescriptionMedicationsExist> elementet eksisterer, selv hente og præsentere receptanmodningerne for brugeren, i henhold til godkendelseskriterierne.
Herunder ses et eksempel på et svar fra GetMedicineCard-servicen, hvor der på borgeren eksisterer receptanmodninger:
<GetMedicineCardResponse> <MedicineCard> <Patient> .. </Patient> .. <OrderedPrescriptionMedicationsExist>true</OrderedPrescriptionMedicationsExist> .. </MedicineCard> </GetMedicineCardResponse>
Borgerudført privatmarkering
I den fremtidige FMK 1.4.6 snitflade bliver det muligt med et nyt kald at privatmarkere en lægemiddelordination uden at opdatere selve lægemiddelordinationen. Dette kald tænkes primært anvendt når borgere selv ønsker at privatmarkere ordinationer.
Dette nye kald er implementeret på samme måde som i FMK 1.4.6 snitfladen, se evt. Privatmarker lægemiddelordination
Hent recepter og effektueringer
FMK snitfladerne giver allerede i dag mulighed for at hente alle recepter og receptudleveringer, men eftersom recepter på seponerede lægemiddelordinationer ikke kommer med ud i det aktuelle medicinkort, kræver det at man kombinerer svaret fra adskillige kald til FMK for at få en komplet liste af borgerens recepter. Extension E1 tilbyder defor at man med GetMedicineCard kaldet kan vælge også at hente seponerede ordinationer, samt at man med GetPrescriptionMedication kaldet, kan vælge at inkludere alle recepter eller blot åbne.
GetMedicineCard udvides til at kunne hente seponerede ordinationer
Med GetMedicineCard servicen har man allerede i dag mulighed for at ”parameterisere” på forskellige måder, se evt Hent medicinkort. Med Extension E1 udvides disse parametre:
- Der er tilføjet en ny parameter “IncludeWithdrawnDrugMedications”, der sættes hvis man ønsker at få seponerede ordinationer returneret også. Ordinationer seponeret efter den angivne dato vil blive returneret med tilhørende effektueringer og recepter.
<GetMedicineCardRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IncludeWithdrawnDrugmedications> <WithdrawnAfterDateTime>2013-11-19T09:30:47.0Z</WithdrawnAfterDateTime> </IncludeWithdrawnDrugmedications> <IncludePrescriptionMedications>true</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> <IncludeNonRelevantPrescriptionMedications>true</IncludeNonRelevantPrescriptionMedications> </GetMedicineCardRequest>
Med den nye “IncludeWithdrawnDrugMedications” sat vil seponerede lægemiddelordinationer blive returneret og afhængig af “IncludeEffectuations” og “IncludePrescriptionMedications” returneres også recepter og deres effektueringer tilhørende de seponerede lægemiddelordinationer.
GetPrescriptionMedication kan hente recepter på CPR nummer
GetPrescriptionMedication servicen er i FMK 1.4.4 begrænset til, at man skal kende identifiers på de recepter, man ønsker at hente. Se evt. Hent receptordination. Med denne udvidelse muliggøres det at hente alle recepter på et CPR.
Alternativt til identifiers, kan der med Extension E1 med parameteren IncludeAllPrescriptionMedications, angives hvorvidt alle recepter skal inkluderes i svaret eller med parameteren IncludeOpenPrescriptionMedications, angives hvorvidt det kun er åbne recepter, der inkluderes i svaret.
<GetPrescriptionMedicationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IncludeAllPrescriptionMedications/> <IncludeEffectuations>true</IncludeEffectuations> </GetPrescriptionMedicationRequest>
<GetPrescriptionMedicationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IncludeOpenPrescriptionMedications/> <IncludeEffectuations>true</IncludeEffectuations> </GetPrescriptionMedicationRequest>
Svaret vil være en sekvens af receptordinationer tilsvarende kaldet til ”HentReceptordination”. Svaret sorteres efter oprettelsesdato (Created.DateTime) for recepterne.
<GetPrescriptionMedicationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <PrescriptionMedication> <Identifier>21298478</Identifier> <AuthorisationDateTime>2014-03-29T09:30:47.0Z</AuthorisationDateTime> <Created> <By> <AuthorisedHealthcareProfessional> ... </By> <DateTime>2013-11-19T09:30:47.0Z</DateTime> </Created> … <Status>PartiallyDelivered</Status> <Effectuation> <Identifier>21298478</Identifier> … </Effectuation> </PrescriptionMedication> .. </GetPrescriptionMedicationResponse>
Ny service: Hent liste over Medicinkort versioner for flere CPR numre
Der er udviklet en ny service som returnerer medicinkortversioner for et antal CPR-numre. Denne liste kan bl.a. anvendes til bootstrap af klientsystemer, dvs. genindlæsning af medicinkortversionsdata i tilfælde af advis-problemer. Dermed kan klientsystemerne få oplysninger om seneste medicinkortversion for en række CPR-numre og afgøre om lokalt gemte medicinkort er identiske med de aktuelle på FMK.
Servicen vil stort set være identisk med den eksisterende GetMedicineCardVersion. I stedet for at angive et enkelt CPR-nummer, kaldes der i stedet med en liste af CPR-numre, og der returneres en liste af versionsdata – et resultat pr. CPR-nummer. Hvert enkelt resultat består som i den eksisterende service af et cpr-nummer, seneste versionsnummer, samt en række ekstra information om medicinkortet.
For at sikre en fornuftig svartid, begrænses antallet af CPR-numre pr. kald til 100. Herunder ses et eksempel på kald til servicen med angivelse af 3 cpr-numre.
<GetMedicineCardVersionListRequest> <PersonIdentifier>1111111118</PersonIdentifier> <PersonIdentifier>0101603040</PersonIdentifier> <PersonIdentifier>0910924656</PersonIdentifier> </GetMedicineCardVersionListRequest>
Herunder ses et eksempel på svar fra servicen. For det første CPR-nummer er der fundet et medicinkort samt en række ændringer. For det andet CPR-nummer er der udelukkende fundet et medicinkort, og for det tredje CPR-nummer findes der intet medicinkort (version = 0) - men dog en række ændringer omhandlende en løs recept:
<GetMedicineCardVersionListResponse> <MedicineCardVersionListItem> <PersonIdentifier>1111111118</PersonIdentifier> <MedicineCardVersion>1428570555317001999</MedicineCardVersion> <MedicineCardInformationChange> <InformationChangeType>PrescriptionMedicationDateTime</InformationChangeType> <ChangeDateTime>2015-01-09T12:31:16.0Z</ChangeDateTime> </MedicineCardInformationChange> <MedicineCardInformationChange> <InformationChangeType>EffectuationDateTime</InformationChangeType> <ChangeDateTime>2015-01-09T14:31:16.0Z</ChangeDateTime> </MedicineCardInformationChange> <MedicineCardInformationChange> <InformationChangeType>PrescriptionAttachmentChange</InformationChangeType> <ChangeDateTime>2015-01-09T12:20:17.0Z</ChangeDateTime> </MedicineCardInformationChange> ... </MedicineCardVersionListItem> <MedicineCardVersionListItem> <PersonIdentifier>0101603040</PersonIdentifier> <MedicineCardVersion>1428570555317001999</MedicineCardVersion> </MedicineCardVersionListItem> <MedicineCardVersionListItem> <PersonIdentifier>0910924656</PersonIdentifier> <MedicineCardVersion>0</MedicineCardVersion> <MedicineCardInformationChange> <InformationChangeType>PrescriptionMedicationDateTime</InformationChangeType> <ChangeDateTime>2015-01-08T09:17:16.0Z</ChangeDateTime> </MedicineCardInformationChange> <MedicineCardInformationChange> <InformationChangeType>EffectuationDateTime</InformationChangeType> <ChangeDateTime>2015-01-08T09:17:16.0Z</ChangeDateTime> </MedicineCardInformationChange> </MedicineCardVersionListItem> </GetMedicineCardVersionListResponse>
Anvendelse af VOCES certifikat
Der er mulighed for at kalde “Hent liste over Medicinkort versioner” vha. System rollen og et VOCES certifikat. Indholdet af request'et skal ikke ændres i dette tilfælde men være som ovenfor.
Datoer og historik på relationer
Denne udvidelse berører FMK og POR snitfladerne. Udvidelsen består i at indføre datoer for oprettelse af patientrelationer. Denne dato er en forudsætning for at kunne blive certificeret til FMK 1.4.4. Da relationer også modtages med FMK GetMedicineCard servicen, vil udvidelsen også berøre denne service.
Desuden gives der i POR mulighed for at hente historiske data på patientdata og relationer.
Datoer for patientrelationer returneres i GetMedicineCard
Udvidelsen består i at svaret på et HentMedicinkort kald, se evt. Medicinkort, indeholder oprettelsestidspunkter for relationer.
<GetMedicineCardResponse> <MedicineCard> <Patient> ... </Patient> <Version>1341404069183002002</Version> <PreviousVersion>1341404058779001006</PreviousVersion> <Modified> .. </Modified> <PatientOrganisationRelation> <Identifier>13143641110921</Identifier> <CreatedBy> <By> <Other> <Name> <GivenName>Helle</GivenName> <Surname>Hansen</Surname> </Name> </Other> <Role>Assistent for Læge</Role> <Organisation> <Name>Århus Universitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumber>89495566</TelephoneNumber> <EmailAddress>AarhusUniversitetshospital@auh.rm.dk</EmailAddress> <Type>Sygehus</Type> <Identifier source="SKS">7026</Identifier> </Organisation> </By> <!-- Oprettelsestidspunktet for relationen --> <DateTime>2013-11-19T09:30:47.0Z</DateTime> </CreatedBy> <Organisation> <Name>Århus Universitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumber>89495566</TelephoneNumber> <EmailAddress>AarhusUniversitetshospital@auh.rm.dk</EmailAddress> <Type>Sygehus</Type> <Identifier source="SKS">7026</Identifier> </Organisation> <Type>Indlagt</Type> </PatientOrganisationRelation> </MedicineCard> </GetMedicineCardResponse>
Udvidelse af opslag på relation
Udvidelsen består i at der returneres dato for oprettelser af relationer. Samtidig bliver det muligt at hente slettede relationer ved at anvende den nye parameter “IncludeRemovedRelations”.
De slettede relationer inkluderer datoer, hvilket gør det muligt at opbygge en historik over relationerne såfremt klientsystemet måtte ønske dette.
Nedenstående eksempel viser oplag hvor der anmodes om slettede relationer:
<GetPatientOrganisationRelationRequest> <PersonIdentifier>1111111118</PersonIdentifier> <IncludeRemovedRelations>true</IncludeRemovedRelations> </GetPatientOrganisationRelationRequest>
I svaret returneres i dette eksempel to relationer.
For hver relation returneres først relationens ID. Herefter hvem der har oprettet relationen i “Created” og evt. hvem der har slettet relationen i “Removed”. Se evt. Modifikator.
<GetPatientOrganisationRelationResponse> <PersonIdentifier>1111111118</PersonIdentifier> <Relation> <Identifier>12313213211001001</Identifier> <Created> <By> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier> <Name>Tess Christoffersen</Name> <SpecialityCode source="Medicinpriser" date="2013-09-18">PSYK</SpecialityCode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </By> <DateTime>2013-10-01T00:00:00Z</DateTime> </Created> <Organisation> <Name>Hjemmesygeplejen i Skanderborg kommune</Name> <AddressLine>Adelgade 42</AddressLine> <TelephoneNumber>86504202</TelephoneNumber> <EmailAddress>hjemmesygeplejen@skanderborg.dk</EmailAddress> <Type>Kommune</Type> <Identifier source="Kommunekode">746</Identifier> </Organisation> <Type>Visiteret til hjemmesygeplejen</Type> </Relation> <Relation> <Identifier>1215364523002002</Identifier> <Created> <By> <Other> <Name> <GivenName>Helle</GivenName> <Surname>Hansen</Surname> </Name> </Other> <Role>Assistent for Læge</Role> <Organisation> <Name>Århus Universitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumber>89495566</TelephoneNumber> <Type>Sygehus</Type> <Identifier source="SKS">7026</Identifier> </Organisation> </By> <DateTime>2013-10-01T00:00:00Z</DateTime> </Created> <Removed> <By> <Other> <Name> <GivenName>Hanne</GivenName> <Surname>Bulow</Surname> </Name> </Other> <Role>Assistent for Læge</Role> <Organisation> <Name>Århus Universitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumber>89495566</TelephoneNumber> <Type>Sygehus</Type> <Identifier source="SKS">7026</Identifier> </Organisation> </By> <DateTime>2013-11-01T00:00:00Z</DateTime> </Removed> <Organisation> <Name>Århus Universitetshospital, Skejby</Name> <AddressLine>Brendstrupgårdsvej 100</AddressLine> <AddressLine>8200 Århus N</AddressLine> <TelephoneNumber>89495566</TelephoneNumber> <Type>Sygehus</Type> <Identifier source="SKS">7026</Identifier> </Organisation> <Type>Indlagt</Type> </Relation> </GetPatientOrganisationRelationResponse>