Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » fmk » extensions » hent_dosisdispenseringskort
fmk:extensions:hent_dosisdispenseringskort

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
fmk:extensions:hent_dosisdispenseringskort [2020-01-07 14:48] – sasfmk:extensions:hent_dosisdispenseringskort [2026-03-06 08:53] (current) – external edit 127.0.0.1
Line 5: Line 5:
   * Integreret i anvendersystemet via den nedenfor beskrevet service, som et dynamisk dosiskort. Hvad angår dynamisk visning af dosisdispenseringskort i anvendersystemer for sundhedsfaglige, anbefaler SDS at man anvender [[fmk:1.4.4:hent_dosiskort_som_pdf|Hent dosisdispenseringskort som PDF]]. Der sker fortsat små justeringer af dosisdispenseringskortet, som løbende kan rettes på det centrale pdf.   * Integreret i anvendersystemet via den nedenfor beskrevet service, som et dynamisk dosiskort. Hvad angår dynamisk visning af dosisdispenseringskort i anvendersystemer for sundhedsfaglige, anbefaler SDS at man anvender [[fmk:1.4.4:hent_dosiskort_som_pdf|Hent dosisdispenseringskort som PDF]]. Der sker fortsat små justeringer af dosisdispenseringskortet, som løbende kan rettes på det centrale pdf.
  
-For at hente dosisdispenseringskortet skal man kalde med et af følgende request-formater. De indeholder alle patientens CPR-nr. (PersonIdentifier) og giver mulighed for at inkludere en detaljeret specifikation (IncludeDetailedSpecification). En detaljeret specifikation betyder, at dosisdispenseringen leveres, ikke bare i skema-form, men desuden også i en form hvor man direkte kan aflæse indholdet af hver pose (DoseDispensedUnit).+For at hente dosisdispenseringskortet skal man kalde med et af følgende request-formater. De indeholder alle patientens CPR-nr. (PersonIdentifier) og giver mulighed for at inkludere en detaljeret specifikation (IncludeDetailedSpecification). En detaljeret specifikation betyder, at dosisdispenseringen leveres, ikke bare i skema-form, men desuden også i en form hvor man direkte kan aflæse indholdet af hver pose (DispensableUnit).
  
 Den første variant bruges til at hente dosisdispenseringens **aktuelle periode**, altså dosisdispenseringskort med den periode, hvor **StartDate-EndDate** omfatter dags dato (hvis en sådan er kendt i FMK). Hvis patienten har flere forskellige dosisdispenseringskort, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt. Den første variant bruges til at hente dosisdispenseringens **aktuelle periode**, altså dosisdispenseringskort med den periode, hvor **StartDate-EndDate** omfatter dags dato (hvis en sådan er kendt i FMK). Hvis patienten har flere forskellige dosisdispenseringskort, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt.
Line 43: Line 43:
 </code> </code>
  
-Den fjerde variant bruges til at hente dosisdispenseringen **uden perioder**. Det resulterer at der ses bort fra de indberettede dosisdispenseringsperioder og der returneres blot en 'dummy-periode' med alt dosisdispenseret medicin på tværs af dosisdispenseringsperioder. +Den fjerde variant bruges til at hente en **dosisdispenseringsperiode på en specifik dato**, altså dosisdispenseringskort med den periode, hvor **StartDate-EndDate** omfatter en angiven dato. Hvis patienten har flere forskellige dosisdispenseringskort med en periode på den givne dato, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt.
-** Bemærk ** med denne variant er det ikke tilladt at requeste detaljer (IncludeDetailedSpecification).+
  
 <code xml> <code xml>
Line 50: Line 49:
     <PersonIdentifier source="CPR">1403837853</PersonIdentifier>     <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
     <RequestedPeriod>     <RequestedPeriod>
-        <IgnorePeriods/>+        <RequestedDate>2016-06-10</RequestedDate>
     </RequestedPeriod>     </RequestedPeriod>
 +    <IncludeDetailedSpecification/>
 </GetDoseDispensingCardRequest> </GetDoseDispensingCardRequest>
 </code> </code>
  
-Den sidste variant bruges til at hente en **dosisdispenseringsperiode på en specifik dato i fortiden**, altså dosisdispenseringskort med den periode, hvor **StartDate-EndDate** omfatter en given dato (som er dags dato eller tidligere). Hvis patienten har flere forskellige dosisdispenseringskort med en periode på den givne dato, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt.+Den sidste variant bruges til at hente dosisdispenseringen **uden perioder**. Det resulterer at der ses bort fra de indberettede dosisdispenseringsperioder og der returneres blot en 'dummy-periode' med alt dosisdispenseret medicin på tværs af dosisdispenseringsperioder. 
 +** Bemærk ** med denne variant er det ikke tilladt at requeste detaljer (IncludeDetailedSpecification).
  
 <code xml> <code xml>
Line 61: Line 62:
     <PersonIdentifier source="CPR">1403837853</PersonIdentifier>     <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
     <RequestedPeriod>     <RequestedPeriod>
-        <RequestedDate>2016-06-10</RequestedDate>+        <IgnorePeriods/>
     </RequestedPeriod>     </RequestedPeriod>
-    <IncludeDetailedSpecification/> 
 </GetDoseDispensingCardRequest> </GetDoseDispensingCardRequest>
 </code> </code>
  
 +**Bemærk** Der er en grundlæggende forskel på IgnorePeriods og de øvrige måder at hente eksplicit kort på.
 +Alle de øvrige former returnerer en eller flere specifikke dosisdispenseringsperioder. Det vil sige der returneres den version af data der var/er gældende for denne specifikke periode, og der returneres kun information som vedrører perioden.
  
 ==== Response ==== ==== Response ====
  
-Svaret fra servicen varierer i de forskellige faser i udrulningen af dosisdispensering. 
 Tidligere har FMK vist et beregnet dosiskort, denne funktionalitet er blevet udfaset og der vil derfor ikke returneres et dosiskort før apoteket har taget dosisdispensering via FMK i brug. Tidligere har FMK vist et beregnet dosiskort, denne funktionalitet er blevet udfaset og der vil derfor ikke returneres et dosiskort før apoteket har taget dosisdispensering via FMK i brug.
  
-I den sidste fase vil der være tale om et 'eksplicit' dosisdispenseringskort. Det vil sige, hvis apoteket har indberettet et dosisdispenseringskort på FMK, og der pakkes ud fra dette i den pågældende periode, så vil det også være dette dosisdispenseringskort, der returneres.+Der vil nu kun kunne returneres et 'eksplicit' dosisdispenseringskort. Det vil sige, hvis apoteket har indberettet et dosisdispenseringskort på FMK, og der pakkes ud fra dette i den pågældende periode, så vil det også være dette dosisdispenseringskort, der returneres. Elleres returneres et tomt dosisdispenseringskort.
  
 Et response kan for eksempel se ud som nedenstående, som er inkl. detaljeret specifikation. Hvis request-strukturen ikke indeholder **IncludeDetailedSpecification**-elementet, så undlades DetailedSpecification-strukturerne i responset. Et response kan for eksempel se ud som nedenstående, som er inkl. detaljeret specifikation. Hvis request-strukturen ikke indeholder **IncludeDetailedSpecification**-elementet, så undlades DetailedSpecification-strukturerne i responset.
Line 85: Line 86:
  
 **Privatmarkerede lægemiddelordinationer** vises uden nogen detaljer, medmindre man kalder med angivelse af samtykke eller værdispring. Dette angives i en ConsentHeader (læs evt. mere om dette [[fmk:1.4.6:soap_header_--_specifikt_omkring_samtykke|her]]). Navnet på denne struktur er forskelligt i 1.4.4.E2 (DoseDispensedMedicationWithNegativeConsent) og 1.4.6.E2 (PrivateDoseDispensedMedication). Udleveringsapoteket og pakkeapoteket har implicit samtykke til at se data, såfremt det er relevant i en aktuel bestilling, og i forbindelse med dosisdispensering er der altid en aktuel bestilling til den kommende dosispakning. **Privatmarkerede lægemiddelordinationer** vises uden nogen detaljer, medmindre man kalder med angivelse af samtykke eller værdispring. Dette angives i en ConsentHeader (læs evt. mere om dette [[fmk:1.4.6:soap_header_--_specifikt_omkring_samtykke|her]]). Navnet på denne struktur er forskelligt i 1.4.4.E2 (DoseDispensedMedicationWithNegativeConsent) og 1.4.6.E2 (PrivateDoseDispensedMedication). Udleveringsapoteket og pakkeapoteket har implicit samtykke til at se data, såfremt det er relevant i en aktuel bestilling, og i forbindelse med dosisdispensering er der altid en aktuel bestilling til den kommende dosispakning.
- 
-Et dosisdispenseringskort der er vedligeholdt på FMK returneres den **PlannedAdministration** som apoteket har indberettet. 
  
 Response-strukturen kan indeholde et element kaldet **DoseDispensingOnHold**, såfremt dosisdispenseringen aktuelt er sat i bero. Denne struktur leveres med, såfremt dosisdispenseringen er sat i bero på kaldstidspunktet, uanset hvilken/hvilke perioder der hentes. Response-strukturen kan indeholde et element kaldet **DoseDispensingOnHold**, såfremt dosisdispenseringen aktuelt er sat i bero. Denne struktur leveres med, såfremt dosisdispenseringen er sat i bero på kaldstidspunktet, uanset hvilken/hvilke perioder der hentes.
  
 Herunder vises et eksempel på en response-struktur i 1.4.6.E2 format hvor patienten har fået registeret et dosisdispenseringskort på FMK af apoteket. Herunder vises et eksempel på en response-struktur i 1.4.6.E2 format hvor patienten har fået registeret et dosisdispenseringskort på FMK af apoteket.
 +
 +**Bemærk:** FMK returnere altid max 1 dosisdispenseringsperiode med statussen "Planlagt" og denne vil altid være den periode med den tidligeste startdato. Dette kunne være ved nyopstart på DD, hvis man henter med nuværende og kommende periode, hvor nuværende periode er overskreder tidsfrist for ændring, men apoteket har ikke fået taget den under behandling. Så vil den fremtidige periode (såfremt denne også er blevet oprettet) IKKE være en del af svaret, da denne også vil have status planlagt.
  
 <code xml> <code xml>
Line 480: Line 481:
 ==== Advarsler ==== ==== Advarsler ====
  
-For det eksplicitte dosisdispenseringskort vil der kunne returneres nedenstående advarsler: +En liste af advarsler for det eksplicitte dosisdispenseringskort kan findes her: [[Advarsler til Dosisdispensering]]
- +
-[[Advarsler til Dosisdispensering]] +
- +
-Advarsler på overordnet niveau +
-^ Kode ^ Tekst ^ Severity ^  +
-|4201|Pakkeapotekets sortiment er ukendt|medium| +
-|5003|Der findes dosisdispenserede recepter, der ikke er på dosisdispenseringskortet|high| +
-|6001|Der forefindes planlagte administrationer på samme sekvensnummer, som har forskellige indtagelses-vejledning|medium| +
- +
-Advarsler under den enkelte DoseDispensedMedication +
-^ Kode ^ Tekst ^ Severity ^  +
-|2211|Privatmarkeret lægemiddelordination. Dosisdispenseringskortet vises uden detaljer om dette præparat!|low| +
-|2322|Der er ingen gyldig recept|medium| +
-|2341|Lægemiddelordinationens behandling er afsluttet|high| +
-|2421|Der ændres dosis i perioden|low| +
-|2511|Lægemidlet er pauseret|low| +
-|4131|Det valgte lægemiddel er ikke i samme substitutionsgruppe som lægemiddelordinationens lægemiddel|high| +
-|4141|Lægemidlet må ikke substitueres|high|  +
-|4211|Lægemidlet er ikke i pakkeapotekets sortiment|low| +
-|4301|FMK har ikke verificeret overensstemmelse mellem mængderne i ordinationen og det planlagte|low| +
-|4302|Der er ikke overensstemmelse mellem den ordinerede mængde og den pakkede mængde|high| +
-|5001|Lægemiddelordinationen er opdateret efter tilknytningen til dosisdispenseringskortet|high| +
-|5002|Der mangler planlagt administration af lægemidlet|high|+
  
  
fmk/extensions/hent_dosisdispenseringskort.1578408501.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki