Differences

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

--- fmk:extensions:upload_sortiment [2018-06-13 19:45] – mbe
+++ fmk:extensions:upload_sortiment [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Upload sortiment ======
+====== Upload sortiment (UploadDrugCatalog) ======
-Denne service giver pakkeapoteket mulighed for at udstille sit sortiment overfor udleveringsapoteket. Hensigten er at udleveringsapoteket gennem en validering af dosisdispenseringer og substitutioner op mod pakkeapotekets sortiment kan give pakkeapoteket de bedste forudsætninger for at kunne pakke dosisrullerne uden yderligere dialog med udleveringsapoteket. Dermed reduceres det samlede workflow og pakningen kan ske hurtigere.
+Denne service giver pakkeapoteket mulighed for at udstille sit sortiment. Dette er nødvendigt for at dosisdispenseringskortene kan indeholde visuelle beskrivelser af lægemidler, samt de korte navne, der printes på den enkelte pose på dosisrullen. Det giver andre aktører mulighed for at verificere indholdet af dosisrullen op mod dosisdispenseringskortet på FMK.
-Et sortiment betragtes i denne sammenhæng som værende komplet og dækkende, idet et uploadet sortiment fuldt og helt erstatter det sortiment, FMK eventuelt måtte have modtaget i et tidligere upload.
+Et uploadet sortiment betragtes i denne sammenhæng som værende komplet og dækkende, da det nye sortiment fuldt og helt erstatter det sortiment, FMK eventuelt har modtaget i et tidligere kald til denne service.
-Bemærk: Hvis der endnu ikke er uploadet et sortiment, eller hvis der uploades et sortiment bestående af 0 lægemidler betragtes sortimentet som værende ukendt, og der vil i denne situation IKKE blive valideret op mod sortimentet fra udleveringsapotekets side.
+Bemærk: Hvis der endnu ikke er uploadet et sortiment, eller hvis der uploades et sortiment bestående af 0 lægemidler betragtes sortimentet som værende ukendt, og dosisdispenseringskortet vil derfor mangle visuelle beskrivelser og korte navne for lægemidler.
 ===== Forespørgsel =====
-I request-dokumentet medsendes en identifier på pakkeapotekets organisation, samt et antal lægemidler identifieret med en drug identifier.
+I request-dokumentet medsendes en modifikator, en identifier på pakkeapotekets organisation, et versionsnummer samt et antal lægemidler identificeret med en drug identifier.
-For hvert lægemiddel sendes information om dets korte navn (ShortName), den visuelle beskrivelse (op til 255 tegn) samt information om hvorvidt tabletten kan deles. Sidstnævnte benyttes til at validere at der ikke dosisdispenseres halve eller kvarte tabletter hvis lægemidlet er uden delekærv.
+Modifikatoren der anføres i CreatedBy angiver hvem der har udført uploadet, og kan enten være en apoteksansat eller et system (VOCES). For et eksempel på hvordan man kan udfylde CreatedBy når der kaldes som system henvises til [[fmk:1.4.6:pabegynd_ekspedition_-_automatiseret|Påbegynd ekspedition - automatiseret]]. Se evt. også [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].
-I elementet CreatedBy medsendes information omkring brugeren som har uploadet sortimentet, Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].
+Versionsnummeret er en form for identifikation som pakkeapoteket selv udtrækker og sætter på sortimentet. Det kunne være et løbenummer, en dato eller et mere generelt id. Dermed kan det hurtigt identificeres om udleverings- og pakkeapoteket er enige om hvilken sortimentsversion der anvendes.
+For hvert lægemiddel sendes information om dets korte navn (ShortName), den visuelle beskrivelse (op til 255 tegn) samt information om hvorvidt tabletten kan deles.
+Eksempel på upload af et takstlægemiddel med en historisk version samt et lægemiddel af apotekets egen fremstilling:
+<file xml UploadDrugCatalogRequest.xml>
-Oplysninger om selve dispensering sendes i elementet PlannedDispensing.
+<UploadDrugCatalogRequest>
-Denne består af 4 overordnede informationer:
-  * Identifikation af det dosisdispenseringskort, dispenseringen skal tilknyttes
-  * Identifikation af lægemiddelordinationen, der skal dispenseres.
-  * Angivelse af om, og i givet fald til hvilket lægemiddel, der substitueres.
-  * Angivelse ID på dosisdispenseringskortet
-  * Detaljer om den planlagte administration
-Det er muligt at angive flere PlannedDispensing elementer i samme kald. Dels for at oprette dispensering af flere lægemiddelordinationer ad gangen, men også hvis den samme lægemiddelordination skal 'fordeles' over flere dosisdispenseringskort.
-<file xml CreatePlannedDispensingRequest.xml>
-<CreatePlannedDispensingRequest>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
     <CreatedBy>
         <Other>
@@ Line 44: / Line 34: @@
             <AddressLine>8660 Skanderborg</AddressLine>
             <Type>Apotek</Type>
-	    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
+            <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
         </Organisation>
     </CreatedBy>
-    <PlannedDispensing>
+    <DrugCatalogVersion>2018-05-01 12:42:00</DrugCatalogVersion>
-        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
+    <PackedAtOrganisation>
-        <DrugMedication>
-            <Identifier>1280998</Identifier>
-            <Version>1341404071666006001</Version>
-        </DrugMedication>
-        <Substitution>
-            <SubstitutionChosenByPatient/>
-            <Drug>
-                <Identifier source="Medicinpriser" date="2016-02-22">28100902676</Identifier>
-                <Name>Kaleorid</Name>
-                <Form>
-                    <Code source="Medicinpriser" date="2016-02-22">TAB</Code>
-                    <Text>tabletter</Text>
-                </Form>
-                <Strength>
-                    <Value>750</Value>
-                    <UnitCode source="Medicinpriser" date="2016-02-22">MG</UnitCode>
-                    <UnitText>mg</UnitText>
-                    <Text source="Medicinpriser" date="2016-02-22">750 mg</Text>
-                </Strength>
-            </Drug>
-        </Substitution>
-        <AdministrationInstruction>Synkes hele</AdministrationInstruction>
-        <PlannedAdministration>
-            <UnitTexts>
-                <Singular>tablet</Singular>
-                <Plural>tabletter</Plural>
-            </UnitTexts>
-            <PlannedAdministrationFixed>
-                <PlannedAdministrationStructure>
-                    <IterationInterval>1</IterationInterval>
-                    <StartDate>2017-12-12</StartDate>
-                    <EndDate>2018-12-12</EndDate>
-                    <Day>
-                        <Number>1</Number>
-                        <Dose>
-                            <Time>morning</Time>
-                            <Quantity>1</Quantity>
-                        </Dose>
-                        <Dose>
-                           <Time>noon</Time>
-                           <Quantity>1</Quantity>
-                        </Dose>
-                        <Dose>
-                           <Time>evening</Time>
-                           <Quantity>1</Quantity>
-                        </Dose>
-                    </Day>
-                </PlannedAdministrationStructure>
-            </PlannedAdministrationFixed>
-        </PlannedAdministration>
-    </PlannedDispensing>
-</CreatePlannedDispensingRequest>
-</file>
-=== Dispensering ifølge Lægemiddelordination ===
-Hvis den strukturerede dosering på lægemiddelordinationen er på en form der umiddelbart kan anvendes til dispensering kan den detaljerede planlagte administration udelades og i stedet angives ''AdministrationAccordingToDrugMedication''.
-Hvis der heller ikke skal ske substitution kan kaldet derfor være så simpelt:
-<file xml CreateSimplePlannedDispensingRequest.xml>
-<CreatePlannedDispensingRequest>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-    <CreatedBy>
-        <Other>
-            <Name>
-                <GivenName>Anne</GivenName>
-                <Surname>Andersen</Surname>
-            </Name>
-            <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
-        </Other>
-        <Role>Apoteksansat</Role>
-        <Organisation>
             <Name>Skanderborg Apotek</Name>
             <AddressLine>Adelgade 27</AddressLine>
             <AddressLine>8660 Skanderborg</AddressLine>
             <Type>Apotek</Type>
-	    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
+            <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
-        </Organisation>
+    </PackedAtOrganisation>
-    </CreatedBy>
+    <DrugCatalogEntry>
-    <PlannedDispensing>
+        <Identifier source="Medicinpriser" date="2016-02-22">28100902676</Identifier>
-        <DoseDispensingCardIdentifier>6123412348758</DoseDispensingCardIdentifier>
+        <ShortName>Kaleorid 750mg Tabl</ShortName>
-        <DrugMedication>
+        <Description>Hvide depottabletter med påtrykt logo</Description>
-            <Identifier>1280998</Identifier>
+        <ATC>
-            <Version>1341404071666006001</Version>
+            <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code>
-        </DrugMedication>
+            <Text>Phenoxymethylpenicillin</Text>
-        <AdministrationAccordingToDrugMedication/>
+        </ATC>
-    </PlannedDispensing>
+        <Partable>Halves</Partable>
-</CreatePlannedDispensingRequest>
+        <ValidFrom>2018-05-01</ValidFrom>
+    </DrugCatalogEntry>
+    <DrugCatalogEntry>
+        <Identifier source="Medicinpriser" date="2016-02-22">28100902676</Identifier>
+        <ShortName>Kaleorid 750mg Tabl</ShortName>
+        <Description>Grønne depottabletter uden logo</Description>
+        <Partable>Halves</Partable>
+        <ValidFrom>2017-01-01</ValidFrom>
+        <ValidTo>2018-04-30</ValidTo>
+    </DrugCatalogEntry>
+    <DrugCatalogEntry>
+        <Identifier source="Local">99800902676</Identifier>
+        <ShortName>Adrenaxamin 10mg Tabl</ShortName>
+        <Description>Hvide tabletter i individuel emballage</Description>
+        <Partable>Indivisible</Partable>
+        <ReservedForNonSubstitutableDrugMedications />
+        <ValidFrom>2018-05-01</ValidFrom>
+    </DrugCatalogEntry>
+</UploadDrugCatalogRequest>
 </file>
 ===== Svar =====
-I svaret returneres patientens CPR'nummer samt ID og version for de(t) oprettede dispensering(er). Hvis der oprettes flere i samme kald, returneres ID'erne i samme rækkefølge som de blev angivet i requestet.
-<file xml CreatePlannedDispensingResponse.xml>
+Svaret på et sortimentsupload fungerer primært som en kvittering på om sortimentet er modtaget. Således modtager man alene et element med antallet af lægemidler der er modtaget.
-<CreatePlannedDispensingResponse>
+Bemærk: Får man i stedet en fejl tilbage er intet i sortimentet modtaget (dvs. alt eller intet).
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-    <PlannedDispensing>
-        <Identifier>234241231</Identifier>
-        <Version>1341404079919003002</Version>
-    </PlannedDispensing>
-</CreatePlannedDispensingResponse>
+<file xml UploadDrugCatalogResponse.xml>
+<UploadDrugCatalogResponse>
+    <DrugCatalogSize>478</DrugCatalogSize>
+</UploadDrugCatalogResponse>
 </file>
-Hvis der er valgt AdministrationAccordingToDrugmedication og lægemiddelordinationens dosering ikke er egnet til dosisdispensering, bliver den planlagte dispensering stadig oprettet, men uden planlagt administration og der returneres en advarsel. Eksempel:
-<file xml CreatePlannedDispensingResponseWithWarning.xml>
-<CreatePlannedDispensingResponse>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-    <PlannedDispensing>
-        <Identifier>234241231</Identifier>
-        <Version>1341404079919003002</Version>
-        <Warning>
-            <WarningCode>3122></WarningCode>
-            <WarningText>Fritekstdosering er uegnet til dosisdispensering</WarningText>
-            <Severity>medium</Severity>
-        </Warning>
-    </PlannedDispensing>
-</CreatePlannedDispensingResponse>
-</file>