User Tools

Site Tools


fmk:1.6.0:xml-elementer:udlevering

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:1.6.0:xml-elementer:udlevering [2025-10-29 10:40] – [Udlevering] lbdofmk:1.6.0:xml-elementer:udlevering [2026-03-06 08:53] (current) – external edit 127.0.0.1
Line 3: Line 3:
 I 1.6.0 er modellen for udleveringer blevet ændret væsentligt fra tidligere snitfladeversioner. Mere præcist dækker begrebet "udlevering" nu over både "[[fmk:1.4.6:effektuering|effektuering på recept]]" og "[[fmk:1.4.4:Opret effektuering|effektuering på lægemiddelordination]]" fra 1.4.x-snitfladen. I korte træk repræsenterer en udlevering, at patienten har sin medicin til rådighed. I 1.6.0 er modellen for udleveringer blevet ændret væsentligt fra tidligere snitfladeversioner. Mere præcist dækker begrebet "udlevering" nu over både "[[fmk:1.4.6:effektuering|effektuering på recept]]" og "[[fmk:1.4.4:Opret effektuering|effektuering på lægemiddelordination]]" fra 1.4.x-snitfladen. I korte træk repræsenterer en udlevering, at patienten har sin medicin til rådighed.
  
-Udleveringen er altid knyttet til et udleveringsgrundlag og kan være knyttet til en bestilling. Hvis der er tale om en apoteksudlevering, vil udleveringsgrundlaget typisk være enten en recept, en praksisrecept eller dosisdispensering. Apoteket kan oprette en bestilling på udleveringsgrundlaget og oprette en udlevering knyttet til denne -- denne funktionalitet er uændret fra 1.4.6, blot med ny terminologi. Se evt. [[fmk:1.6.0:xml-elementer:bestilling|Bestilling]]. +Udleveringen er altid knyttet til et udleveringsgrundlag og kan være knyttet til en bestilling. Hvis der er tale om en apoteksudlevering, vil udleveringsgrundlaget typisk være enten en recept, en praksisrecept eller dosisrecept. Apoteket kan oprette en bestilling på udleveringsgrundlaget og oprette en udlevering knyttet til denne -- denne funktionalitet er uændret fra 1.4.6, blot med ny terminologi. Se evt. [[fmk:1.6.0:xml-elementer:bestilling|Bestilling]]. 
  
-Medicin, der udleveres i forbindelse med behandling, registreres som en udlevering tilknyttet et udleveringsgrundlag af typen ‘Udleveret ved behandling’. Dette foregår via servicen [[fmk:1.6.0:services:Registrer udlevering]], som altså erstatter servicen [[fmk:1.4.4:Opret effektuering|Opret effektuering (1.4.4)]] på 1.4.x-snitfladen. +Medicin, der udleveres i forbindelse med behandling, registreres som en udlevering tilknyttet et udleveringsgrundlag af typen ‘Direkte udlevering i forbindelse med behandling’. Dette foregår via servicen [[fmk:1.6.0:services:Registrer udlevering]], som erstatter servicen [[fmk:1.4.4:Opret effektuering|Opret effektuering (1.4.4)]] på 1.4.x-snitfladen. 
  
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#HandoverType| skema]]+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#HandoverType| skemadefinition på udlevering]]
  
 ==== UdleveringsID  (Identifier) ==== ==== UdleveringsID  (Identifier) ====
  
-Udleverings-elementet indeholder først et Identifier-element for udleveringen.+Udleveringselementet indeholder først et Identifier-element for udleveringen.
  
-==== ID for Udleveringsgrundlag og bestilling (WarrantIdentifier, OrderIdentifier) ====+==== ID for bestilling ( OrderIdentifier) ====
  
-Udleveringen er altid tilknyttet et udleveringsgrundlag, og kan være tilknyttet en bestilling. Udleverings-elementet indeholder derfor altid en WarrantIdentifier og optionelt en OrderIdentifier.  +En udlevering er typisk tilknyttet en bestilling, hvis der er tale om en apoteksudlevering. Handoverelementet indeholder derfor optionelt en OrderIdentifier.
- +
-En udlevering er typisk tilknyttet en bestilling, hvis der er tale om en apoteksudlevering.+
  
 ==== Udleveringstidspunkt (DateTime) ==== ==== Udleveringstidspunkt (DateTime) ====
Line 25: Line 23:
 ==== Oprettet af (Created) ==== ==== Oprettet af (Created) ====
  
-Created-elementet indeholder information omkring aktøren der har oprettet udleveringen. Dette element er obligatorisk. +Createdelementet indeholder information omkring aktørender har oprettet udleveringen. Dette element er obligatorisk. 
 Se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]].  Se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. 
  
Line 33: Line 31:
 ==== Indrapporteret af (ReportedBy) ==== ==== Indrapporteret af (ReportedBy) ====
  
-Elementet ReportedBy indeholder information omkring personen der har indrapporteret versionen af udleveringen til FMK, dvs. "certifikatejer"+Elementet ReportedBy indeholder information omkring personender har indrapporteret versionen af udleveringen til FMK, dvs. "certifikatejer"
  
 ==== Udlevering af en eller flere pakninger (Package) ==== ==== Udlevering af en eller flere pakninger (Package) ====
Line 39: Line 37:
 Ved udlevering af en eller flere pakninger optræder et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#PackageHandoverType|Package]]  element. I Package angives der først antal pakninger i PackageQuantity.  Ved udlevering af en eller flere pakninger optræder et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#PackageHandoverType|Package]]  element. I Package angives der først antal pakninger i PackageQuantity. 
  
-I PackageNumber angives pakningens varenummer. Ved angivelse af varenummer skal der i source-attributten angives hvad kilden til varenummer er, se [[fmk:generel:varenumre|Varenumre]]:+I PackageNumber angives pakningens varenummer. Ved angivelse af varenummer skal der i source-attributten angiveshvad kilden til varenummer er, se [[fmk:generel:varenumre|Varenumre]]:
  
   * Ved oprettelse af udleveringer af lægemidler i intervallet for Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = "Medicinpriser" og date = dato for den aktuelle takst der refereres til.    * Ved oprettelse af udleveringer af lægemidler i intervallet for Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = "Medicinpriser" og date = dato for den aktuelle takst der refereres til. 
   * Ved oprettelse af udleveringer af frihandelsvarer angives source = "Frihandelsvare". Attributten date er her ikke krævet.    * Ved oprettelse af udleveringer af frihandelsvarer angives source = "Frihandelsvare". Attributten date er her ikke krævet. 
  
-Pakningsstørrelsen angives i PackageSize. Der angives en pakningsstørrelse som en numerisk værdi (Value), kode for enhed (UnitCode) og tekst for enhed (UnitText). For UnitCode angives source = "Medicinpriser" og date = dato for den aktuelle takst der refereres til. +Pakningsstørrelsen angives i PackageSize. Der angives en pakningsstørrelse som en numerisk værdi (Value), kode for enhed (UnitCode) og tekst for enhed (UnitText). For UnitCode angives source = "Medicinpriser" og date = dato for den aktuelle takstder refereres til. 
  
 Sidst kan der i ''BatchNumber''-elementet angives batchnummer for den udleverede pakning. Sidst kan der i ''BatchNumber''-elementet angives batchnummer for den udleverede pakning.
Line 52: Line 50:
  
 Ved udlevering af pakninger kan der være substitueret til et andet lægemiddel end angivet af lægen.  Ved udlevering af pakninger kan der være substitueret til et andet lægemiddel end angivet af lægen. 
-Dette fremgår, hvis der er tale om et takstlægemiddel implicit via det varenummer der er angivet, og det er derfor ikke tilladt at angive 'SubstitutedDrug'. Men hvis varenummeret ikke er fra "Medicinpriser" kan lægemidlet ikke nødvendvis udledes derfra.  +Dette fremgår, hvis der er tale om et takstlægemiddelimplicit via det varenummerder er angivet, og det er derfor ikke tilladt at angive 'SubstitutedDrug'. Men hvis varenummeret ikke er fra "Medicinpriser"kan lægemidlet ikke nødvendigvist udledes derfra.  
-I dette tilfælde angives det substiturerede lægemiddel som et SubstitutedDrug element, se afsnittet [[fmk:1.6.0:xml-elementer:laegemiddel|Lægemiddel]].+I dette tilfælde angives det substituerede lægemiddel som et SubstitutedDrug element, se afsnittet [[fmk:1.6.0:xml-elementer:laegemiddel|Lægemiddel]].
  
 ==== Udlevering af enkelte enheder (SingleUnits) ==== ==== Udlevering af enkelte enheder (SingleUnits) ====
Line 65: Line 63:
 ==== Sekundær udlevering (UsesSecondaryHandover) ==== ==== Sekundær udlevering (UsesSecondaryHandover) ====
  
-Hvis borgeren ikke får udleveret al medicinen på én gang, men i stedet får udleveret i mindre doseringer, kan disse mindre udleveringer registreres på FMK som //sekundære udleveringer//+Hvis borgeren ikke får udleveret al medicin på én gang, men i stedet får udleveret i mindre portioner, kan disse mindre udleveringer registreres på FMK som //sekundære udleveringer//
  
-Hvis udleveringen foregår via sekundær udlevering, er flaget ''UsesSecondaryHandover'' sat på udleverings-elementetHernæst kan en række ''SecondaryHandover''-elementer forekomme med informationer om de enkelte sekundære udleveringer. Se [[fmk:1.6.0:xml-elementer:sekundær udlevering|Sekundær udlevering]] for yderligere detaljer.+Hvis udleveringen foregår via sekundær udlevering, er flaget ''UsesSecondaryHandover'' sat på udleveringselementetHerefter kan en række ''SecondaryHandover''-elementer forekomme med informationer om de enkelte sekundære udleveringer. Se [[fmk:1.6.0:xml-elementer:sekundær udlevering|Sekundær udlevering]] for yderligere detaljer.
  
 ==== Kommentar fra den udleverende organisation (HandoverComment) ==== ==== Kommentar fra den udleverende organisation (HandoverComment) ====
Line 79: Line 77:
 ==== Ansvarlig organisation (ResponsibleOrganisation) ==== ==== Ansvarlig organisation (ResponsibleOrganisation) ====
  
-Et optionelt element af typen [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#OrganisationType| OrganisationType]], som beskriver den udleverende organisation. Kan f.eks. angives, hvis den udleverende organisation er andet apoteksfilial end detsom som er angivet på [[fmk:1.6.0:xml-elementer:bestilling|bestillingen]].+Et optionelt element af typen [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#OrganisationType| OrganisationType]], som beskriver den udleverende organisation. Det kan f.eks. angives, hvis den udleverende organisation er anden apoteksfilial end den, som er angivet på [[fmk:1.6.0:xml-elementer:bestilling|bestillingen]]. 
 + 
 +===== Eksempler ===== 
 + 
 +== Eksempel 1 == 
 + 
 +Nedenstående er et eksempel på en apoteksudlevering af 2 pakker af et substitueret lægemiddel. Da der er tale om en apoteksudlevering, er der angivet en ''OrderIdentifier''. Der er blevet udleveret med henblik på sekundær udlevering, deraf flaget ''UsesSecondaryHandover''.  
 + 
 +<code xml "Handover-pharmacy.xml"> 
 + 
 +<Handover> 
 +    <Identifier>324123074823974</Identifier> 
 +    <OrderIdentifier>132423478342</OrderIdentifier> 
 +    <DateTime>2025-04-22T11:16:56Z 
 +    <Created> 
 +        <By> 
 +            <HealthcareProfessional> 
 +                <Indentifier source="CPR">2012850101</Indentifier> 
 +                <Name>Hanne Jensen</Name> 
 +            </HealthcareProfessional> 
 +            <Role>Apoteksansat</Role> 
 +            <Organisation> 
 +                <Identifier source="EAN-Lokationsnummer">123456789</Identifier> 
 +                <Type>Apotek</Type> 
 +                <Name>Aarhus Kobbergade Apotek</Name> 
 +                <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine> 
 +                <TelephoneNumber>00000000</TelephoneNumber> 
 +                <EmailAddress>ABC@XYZ.com</EmailAddress> 
 +            </Organisation> 
 +        </By> 
 +        <DateTime>2025-04-24T17:01:09Z</DateTime> 
 +    </Created> 
 +    <Package> 
 +        <PackageQuantity>2</PackageQuantity> 
 +        <PackageNumber source="Medicinpriser" date="2025-03-10">789</PackageNumber> 
 +        <PackageSize> 
 +            <Value>40</Value> 
 +            <UnitCode source="Medicinpriser" date="2025-03-10">stk</UnitCode> 
 +            <UnitText>stk</UnitText> 
 +        </PackageSize> 
 +        <SubstitutedDrug> 
 +            <Identifier source="Medicinpriser" date="2025-03-10">28101234504</Identifier> 
 +            <Name>Eksemplificin</Name> 
 +            <Form> 
 +                <Code source="Medicinpriser" date="2025-03-10">TAB</Code> 
 +                <Text>tabletter</Text> 
 +            </Form> 
 +            <Strength> 
 +                <StrengthItem> 
 +                    <Value>50</Value> 
 +                   <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode> 
 +                   <UnitText>mg</UnitText> 
 +                </StrengthItem> 
 +            </Strength> 
 +        </SubstitutedDrug> 
 +        <BatchNumber>3423W</BatchNumber> 
 +     </Package> 
 +     <UsesSecondaryHandover/> 
 +     <SecondaryHandover> 
 +         <Identifier>2131230918231</Identifier> 
 +         <DateTime>2025-04-25T10:36:27Z</DateTime> 
 +         <Created> 
 +             <By> 
 +                 <HealthcareProfessional> 
 +                     <Indentifier source="CPR">1208911078</Indentifier> 
 +                     <Name>Mikkel Smed Hansen</Name> 
 +                 </HealthcareProfessional> 
 +                 <Role>Kommunal ansat til medicinhåndtering</Role> 
 +                 <Organisation> 
 +                     <Identifier source="SOR">987654321</Identifier> 
 +                     <Type>kommune</Type> 
 +                     <Name>Nordfyns Kommune</Name> 
 +                     <AddressLine>Østergade 23, 5400 Bogense</AddressLine> 
 +                     <TelephoneNumber>99999999</TelephoneNumber> 
 +                     <EmailAddress>XYZ@ABC.com</EmailAddress> 
 +                 </Organisation> 
 +             </By> 
 +             <DateTime>2025-04-25T10:45:27Z</DateTime> 
 +         </Created> 
 +         <SingleUnits> 
 +             <DoseQuantity>5</DoseQuantity> 
 +             <DosageQuantityUnitText>stk</DosageQuantityUnitText> 
 +         </SingleUnits> 
 +     </SecondaryHandover>  
 +     <HandoverComment>Substitueret grundet restordre</HandoverComment> 
 +     <ResponsibleOrganisation> 
 +         <Identifier source="EAN-Lokationsnummer">123456789</Identifier> 
 +         <Type>Apotek</Type> 
 +         <Name>Aarhus Kobbergade Apotek</Name> 
 +         <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine> 
 +         <TelephoneNumber>00000000</TelephoneNumber> 
 +         <EmailAddress>ABC@XYZ.com</EmailAddress> 
 +     </ResponsibleOrganisation 
 +</Handover> 
 + 
 +</code> 
 + 
 +== Eksempel 2 == 
 + 
 +Hvis der er blevet udleveret medicin ved behandling, kan udleveringen se ud som nedenfor. 
 + 
 + 
 +<code xml "Handover-treatment.xml"> 
 + 
 +<Handover> 
 +    <Identifier>324123074823974</Identifier> 
 +    <DateTime>2025-04-22T11:16:56Z 
 +    <Created> 
 +        <By> 
 +            <HealthcareProfessional> 
 +                <Identifier source="Autorisation">2Q5TK</Identifier> 
 +                <Name>Tess Christoffersen</Name> 
 +                <Information type="SpecialityCode">7170</Information> 
 +            </HealthcareProfessional> 
 +            <Role>Læge</Role> 
 +            <Organisation> 
 +                <Identifier source="Yder">66974</Identifier> 
 +                <Type>Yder</Type> 
 +                <Name>Lægerne Vestergade</Name> 
 +                <AddressLine>Vestergade 2</AddressLine> 
 +                <AddressLine>8660 Skanderborg</AddressLine> 
 +                <TelephoneNumber>86521348</TelephoneNumber> 
 +                <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> 
 +            </Organisation> 
 +        </By> 
 +        <DateTime>2026-08-02T09:58:05Z</DateTime> 
 +    </Created> 
 +    <SingleUnits> 
 +        <DoseQuantity>12</DoseQuantity> 
 +        <DosageQuantityUnitText>stk</DosageQuantityUnitText> 
 +    </SingleUnits> 
 +    <HandoverComment>Udleveret til patienten</HandoverComment> 
 +</Handover> 
 + 
 +</code> 
fmk/1.6.0/xml-elementer/udlevering.1761734433.txt.gz · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki