Differences

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

--- fmk:extensions:upload_sortiment [2018-06-14 09:37] – mbe
+++ fmk:extensions:upload_sortiment [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Upload sortiment (UploadDrugCatalog) ======
-Denne service giver pakkeapoteket mulighed for at udstille sit sortiment overfor udleveringsapoteket. Hensigten er at udleveringsapoteket gennem en validering af lægemidler 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 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 opretter, en identifier på pakkeapotekets organisation, samt et antal lægemidler identifieret med en drug identifier. Opretteren kan være den enkelte apoteksansatte, eller et system. 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]]
+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 Created medsendes information omkring brugeren som har uploadet sortimentet, Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]. Informationen er p.t. til intern brug i FMK og udstilles ikke gennem nogen service.
+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.
-Eksempel på upload af tre lægemidler:
+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>
 <UploadDrugCatalogRequest>
-    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
     <CreatedBy>
         <Other>
@@ Line 34: / 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>
-</UploadDrugCatalogRequest>
-</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>