Differences

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

--- fmk:1.4.6:hent_til_apotek [2015-04-14 11:03] – [Svar] shp
+++ fmk:1.4.6:hent_til_apotek [2015-08-27 07:04] (current) – removed usk
@@ Line 1: / Line 1: @@
-====== Hent til apotek ======
-Lægemiddelordination + tilladelser der enten oprettes med en bestilling eller senere får tilknyttet en bestilling til et apotek lægges klar til afhentning af apoteket. Se afsnittet [[apo:generel:bestillinger_klar_til_afhentning|Bestillinger klar til afhentning]].
-Desuden lægges anmodninger om at overdrage bestillinger fra et apotek (1) til en andet apotek (2) klar til afhentning af apoteket (1). Se afsnittet [[fmk:1.4.6:opret_anmodning_om_overdragelse_af_bestilling|Opret anmodning om overdragelse af bestilling]]
-Ved opslag angives der:
-  * Lokationsnummer for apoteket der skal hentes for. (Se dog afklaring [[apo:2.0:afklaring:hvorledes_identificeres_apotekerne|Hvorledes identificeres apotekerne]])
-  * Optionelt hvor mange lægemiddelordinationer + receptordinationer + bestillinger og anmodninger der højst ønskes returneret. FMK har dog også en konfigurerbar parameter, der angiver hvor meget der højst kan  returneres, og der vil aldrig blive returneret mere end hvad denne værdi angiver. Under normale driftsforhold returneres ældste data først.
-Efter opslag markeres lægemiddelordination + receptordination + bestillinger og anmodninger om at overdrage bestillinger som hentet vha. servicen [[fmk:1.4.6:marker_hentet_til_apotek|Marker hentet til apotek]]. Sker dette ikke vil samme data ((Dog kan der ske data ikke er eksakt de samme ved en efterfølgende forespørgsel, idet der under unormale driftsforhold kan være en forsinkelse i replikering mellem driftcentre. )) blive returneret ved næste opslag. Denne funktionalitet sikrer, at data ikke mistes f.eks. hvis forbindelsen mellem apotekssystemet og FMK tabes efter at FMK er kaldt men før svaret er indlæst i apotekssystemet.
-Opslaget kan ske med anvendelse af funktionscertifikat. Dette kræver dog, at der ved en efterfølgende manuel arbejdsgang opslag foretages et opslag på FMK. Se [[apo:generel:opslag_med_funktionscertifikat|Opslag med funktionscertifikat]] (og afklaring [[apo:2.0:afklaring:anvendelse_af_funktionscertifikat|Anvendelse af funktionscertifikat]]).
-Bemærk, at apotekssystemet skal kunne håndtere at der returneres data på trods af at disse er markeret som "afhentet" vha. [[fmk:1.4.6:marker_hentet_til_apotek|Marker hentet til apotek]]. Dette kan f.eks. opstå kortvarigt ved skift mellem driftscentre.
-Desuden skal apotekssystemet kunne håndtere at der returneres lægemiddelordinationer + receptordinationer i en ældre version, på trods af at disse netop er hentet (f.eks. ved opslag på CPR-nummer) og ekspederet. FMK vil generelt fjerne ældre versioner klar til afhentning, men dette kan ikke altid garanteres. Igen kan dette kortvarigt opstå ved skift mellem driftscentre. De ældre versioner kan ignoreres.
-===== Forespørgsel =====
-<code XML GetToPharmacyRequest.xml>
-<?xml version="1.0" encoding="UTF-8"?>
-<GetToPharmacyRequest xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 GetToPharmacyRequest.xsd" xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-	<OrganisationIdentifier source="EAN-Lokationsnummer">5790000170609</OrganisationIdentifier>
-	<MaxResultSize>1000</MaxResultSize>
-</GetToPharmacyRequest>
-</code>
-===== Svar =====
-Et eksempel på et svar er vist herunder.
-Svaret indeholder først lokationsnummeret der er forespurgt på (til fejlsøgning m.v.).
-Herefter et antal Medications-elementer eller AquireOrder-elementer, sorteret med ældste først.
-Et Medications-element indeholder nul eller flere lægemiddelordinationer med tilhørende receptordinationer og bestillinger samt nul eller flere løse receptordinationer og bestillinger, til samme person. Informationen omkring personen og dennes adresse findes først, herefter en eller flere [[fmk:1.4.6:laegemiddelordination|lægemiddelordinationer]] eller [[fmk:1.4.6:receptordination|receptordinationer]] til denne.
-Et AquireOrder-element indeholder en anmodning om at overdrage bestillinger, se [[Opret anmodning om overdragelse af bestilling]] og [[Opdater anmodning om overdragelse af bestilling]].
-AquireOrderResponse-elementer indeholder svar på anmodninger om overdragelse, som det kaldende apotek selv har sendt.
-XML kommentarer (<!-- ... -->) er indsat i eksemplet, disse vil ikke findes i svaret fra FMK.
-<code xml GetToPharmacyResponse.xml>
-<?xml version="1.0" encoding="UTF-8"?>
-<GetToPharmacyResponse>
-    <OrganisationIdentifier source="EAN-Lokationsnummer">5790000170609</OrganisationIdentifier>
-    <!-- Example Drug Medications and/or Prescription Medications -->
-    <Medications>
-        <PersonAndAddress>
-            <Person>
-                <Name>
-                    <GivenName>Søren</GivenName>
-                    <Surname>Sørensen</Surname>
-                </Name>
-                <PersonIdentifier source="CPR">2902704321</PersonIdentifier>
-                <AlternativePersonIdentifier source="Erstatnings-CPR">ABCD041234</AlternativePersonIdentifier>
-            </Person>
-            <Address>
-                <StreetName>Margrethepladsen</StreetName>
-                <StreetBuildingIdentifier>20</StreetBuildingIdentifier>
-                <PostCodeIdentifier>8000</PostCodeIdentifier>
-                <DistrictName>Århus</DistrictName>
-            </Address>
-        </PersonAndAddress>
-        <DrugMedication>
-            <Identifier>13143641280998</Identifier>
-            <Version>1341404071666006001</Version>
-            <PreviousVersion>1341404070012003001</PreviousVersion>
-            <Created>
-                <By>
-                    <AuthorisedHealthcareProfessional>
-                        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
-                        <Name>Tess Christoffersen</Name>
-                        <SpecialityCode source="Medicinpriser" date="2014-11-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>2014-11-19T09:30:47.0Z</DateTime>
-            </Created>
-            <BeginEndDate>
-                <TreatmentStartDate>2014-11-18</TreatmentStartDate>
-                <TreatmentEndDate>2014-11-30</TreatmentEndDate>
-            </BeginEndDate>
-            <Indication>
-                <Code source="Medicinpriser" date="2014-11-18">121</Code>
-                <Text>mod mellemørebetændelse</Text>
-            </Indication>
-            <RouteOfAdministration>
-                <Code source="Medicinpriser" date="2014-11-18">OR</Code>
-                <Text>oral anvendelse</Text>
-            </RouteOfAdministration>
-            <Drug>
-                <ATC>
-                    <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code>
-                    <Text>Phenoxymethylpenicillin</Text>
-                </ATC>
-                <Identifier source="Medicinpriser" date="2014-11-18">28100902676</Identifier>
-                <Name>Primcillin</Name>
-                <Form>
-                    <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code>
-                    <Text>filmovertrukne tabletter</Text>
-                </Form>
-                <Strength>
-                    <Value>250.0</Value>
-                    <UnitCode source="Medicinpriser" date="2014-11-18">MG</UnitCode>
-                    <UnitText>mg</UnitText>
-                    <Text source="Medicinpriser" date="2014-11-18">250 mg</Text>
-                </Strength>
-                <Substances>
-                    <ActiveSubstance>
-                        <SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium
-                        </SubstanceText>
-                    </ActiveSubstance>
-                </Substances>
-            </Drug>
-            <Dosage>
-                <Structures>
-                    <UnitTexts source="Doseringsforslag">
-                        <Singular>tablet</Singular>
-                        <Plural>tabletter</Plural>
-                    </UnitTexts>
-                    <Structure>
-                        <IterationInterval>1</IterationInterval>
-                        <StartDate>2014-11-18</StartDate>
-                        <EndDate>2014-11-30</EndDate>
-                        <Day>
-                            <Number>1</Number>
-                            <Dose>
-                                <Time>morning</Time>
-                                <Quantity>2</Quantity>
-                            </Dose>
-                            <Dose>
-                                <Time>evening</Time>
-                                <Quantity>2</Quantity>
-                            </Dose>
-                        </Day>
-                        <DosageTranslation>
-                            <ShortText>1 tablet morgen og aften</ShortText>
-                            <LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag:
-                                Doseringsforløb:
-tablet morgen og aften
-                            </LongText>
-                            <AverageDailyDosage>2</AverageDailyDosage>
-                        </DosageTranslation>
-                    </Structure>
-                </Structures>
-                <Type>temporær</Type>
-            </Dosage>
-            <PrescriptionMedication>
-                <Identifier>1341404068848001001</Identifier>
-                <Version>1341404068848001001</Version>
-                <AttachedToDrugMedicationIdentifier>13143641280998</AttachedToDrugMedicationIdentifier>
-                <CreatedFromDrugMedicationVersion>1341404071666006001</CreatedFromDrugMedicationVersion>
-                <Created>
-                    <By>
-                        <AuthorisedHealthcareProfessional>
-                            <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
-                            <Name>Tess Christoffersen</Name>
-                            <SpecialityCode source="Medicinpriser" date="2014-11-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>2014-11-19T09:30:47.0Z</DateTime>
-                </Created>
-                <ValidToDate>2014-11-30</ValidToDate>
-                <Dosage>
-                    <Structures>
-                        <UnitTexts source="Doseringsforslag">
-                            <Singular>tablet</Singular>
-                            <Plural>tabletter</Plural>
-                        </UnitTexts>
-                        <Structure>
-                            <IterationInterval>1</IterationInterval>
-                            <StartDate>2014-11-18</StartDate>
-                            <EndDate>2014-11-30</EndDate>
-                            <Day>
-                                <Number>1</Number>
-                                <Dose>
-                                    <Time>morning</Time>
-                                    <Quantity>2</Quantity>
-                                </Dose>
-                                <Dose>
-                                    <Time>evening</Time>
-                                    <Quantity>2</Quantity>
-                                </Dose>
-                            </Day>
-                            <DosageTranslation>
-                                <ShortText>1 tablet morgen og aften</ShortText>
-                                <LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag:
-                                    Doseringsforløb:
-tablet morgen og aften
-                                </LongText>
-                                <AverageDailyDosage>2</AverageDailyDosage>
-                            </DosageTranslation>
-                        </Structure>
-                    </Structures>
-                    <Type>temporær</Type>
-                </Dosage>
-                <PackageRestriction>
-                    <PackageNumber source="Medicinpriser">2917</PackageNumber>
-                    <PackageSize>
-                        <Value>30</Value>
-                        <UnitCode source="Medicinpriser">stk</UnitCode>
-                    </PackageSize>
-                    <PackageQuantity>1</PackageQuantity>
-                    <DosageText>1 tablet morgen og aften</DosageText>
-                </PackageRestriction>
-                <Indication>
-                    <Code source="Medicinpriser" date="2014-11-18">121</Code>
-                    <Text>mod mellemørebetændelse</Text>
-                </Indication>
-                <Drug>
-                    <ATC>
-                        <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code>
-                        <Text>Phenoxymethylpenicillin</Text>
-                    </ATC>
-                    <Identifier source="Medicinpriser" date="2014-11-18">28100902676</Identifier>
-                    <Name>Primcillin</Name>
-                    <Form>
-                        <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code>
-                        <Text>filmovertrukne tabletter</Text>
-                    </Form>
-                    <Strength>
-                        <Value>250.0</Value>
-                        <UnitCode source="Medicinpriser" date="2014-11-18">MG</UnitCode>
-                        <UnitText>mg</UnitText>
-                        <Text source="Medicinpriser" date="2014-11-18">250 mg</Text>
-                    </Strength>
-                    <Substances>
-                        <ActiveSubstance>
-                            <SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium
-                            </SubstanceText>
-                        </ActiveSubstance>
-                    </Substances>
-                </Drug>
-                <Order>
-                    <Identifier>1341404068915001002</Identifier>
-                    <Version>1341404068915001003</Version>
-                    <Created>
-                        <By>
-                            <Patient/>
-                        </By>
-                        <DateTime>2014-11-18T14:59:02</DateTime>
-                    </Created>
-                    <OrderedAtPharmacy>
-                        <Name>Skanderborg Apotek</Name>
-                        <AddressLine>Adelgade 27</AddressLine>
-                        <AddressLine>8660 Skanderborg</AddressLine>
-                        <Type>Apotek</Type>
-                        <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
-                    </OrderedAtPharmacy>
-                    <Status>Bestilt</Status>
-                </Order>
-            </PrescriptionMedication>
-        </DrugMedication>
-        <PrescriptionMedication>
-            <Identifier>1341404068849001001</Identifier>
-            <Version>1341404068847001001</Version>
-            <Created>
-                <By>
-                    <AuthorisedHealthcareProfessional>
-                        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
-                        <Name>Tess Christoffersen</Name>
-                        <SpecialityCode source="Medicinpriser" date="2014-11-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>2014-11-19T09:30:47.0Z</DateTime>
-            </Created>
-            <ValidToDate>2014-11-30</ValidToDate>
-            <Dosage>
-                <Structures>
-                    <UnitTexts source="Doseringsforslag">
-                        <Singular>tablet</Singular>
-                        <Plural>tabletter</Plural>
-                    </UnitTexts>
-                    <Structure>
-                        <IterationInterval>1</IterationInterval>
-                        <StartDate>2014-11-18</StartDate>
-                        <EndDate>2014-11-30</EndDate>
-                        <Day>
-                            <Number>1</Number>
-                            <Dose>
-                                <Time>morning</Time>
-                                <Quantity>2</Quantity>
-                            </Dose>
-                            <Dose>
-                                <Time>evening</Time>
-                                <Quantity>2</Quantity>
-                            </Dose>
-                        </Day>
-                        <DosageTranslation>
-                            <ShortText>1 tablet morgen og aften</ShortText>
-                            <LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag:
-                                Doseringsforløb:
-tablet morgen og aften
-                            </LongText>
-                            <AverageDailyDosage>2</AverageDailyDosage>
-                        </DosageTranslation>
-                    </Structure>
-                </Structures>
-                <Type>temporær</Type>
-            </Dosage>
-            <PackageRestriction>
-                <PackageNumber source="Medicinpriser">2917</PackageNumber>
-                <PackageSize>
-                    <Value>30</Value>
-                    <UnitCode source="Medicinpriser">stk</UnitCode>
-                </PackageSize>
-                <PackageQuantity>1</PackageQuantity>
-                <DosageText>1 tablet morgen og aften</DosageText>
-            </PackageRestriction>
-            <Indication>
-                <Code source="Medicinpriser" date="2014-11-18">121</Code>
-                <Text>mod mellemørebetændelse</Text>
-            </Indication>
-            <Drug>
-                <ATC>
-                    <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code>
-                    <Text>Phenoxymethylpenicillin</Text>
-                </ATC>
-                <Identifier source="Medicinpriser" date="2014-11-18">28100902676</Identifier>
-                <Name>Primcillin</Name>
-                <Form>
-                    <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code>
-                    <Text>filmovertrukne tabletter</Text>
-                </Form>
-                <Strength>
-                    <Value>250.0</Value>
-                    <UnitCode source="Medicinpriser" date="2014-11-18">MG</UnitCode>
-                    <UnitText>mg</UnitText>
-                    <Text source="Medicinpriser" date="2014-11-18">250 mg</Text>
-                </Strength>
-                <Substances>
-                    <ActiveSubstance>
-                        <SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium
-                        </SubstanceText>
-                    </ActiveSubstance>
-                </Substances>
-            </Drug>
-            <Order>
-                <Identifier>1341404068915001002</Identifier>
-                <Version>1341404068915001003</Version>
-                <Created>
-                    <By>
-                        <Patient/>
-                    </By>
-                    <DateTime>2014-11-18T14:59:02</DateTime>
-                </Created>
-                <OrderedAtPharmacy>
-                    <Name>Skanderborg Apotek</Name>
-                    <AddressLine>Adelgade 27</AddressLine>
-                    <AddressLine>8660 Skanderborg</AddressLine>
-                    <Type>Apotek</Type>
-                    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
-                </OrderedAtPharmacy>
-                <Status>Bestilt</Status>
-            </Order>
-        </PrescriptionMedication>
-    </Medications>
-    <!-- Example Aquire Order Request  -->
-    <AquireOrder>
-        <Identifier>1341404071221007001</Identifier>
-        <Version>1341404071221007002</Version>
-        <Created>
-            <By>
-                <Other>
-                    <Name>
-                        <GivenName>Anne</GivenName>
-                        <Surname>Andersen</Surname>
-                    </Name>
-                    <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
-                </Other>
-                <Role>Farmakonom</Role>
-                <Organisation>
-                    <Name>Fanø Apotek</Name>
-                    <AddressLine>Hovedgaden 64</AddressLine>
-                    <AddressLine>6720 Fanø</AddressLine>
-                    <Type>Apotek</Type>
-                    <Identifier source="EAN-Lokationsnummer">5790000171330</Identifier>
-                </Organisation>
-            </By>
-            <DateTime>2014-11-18T11:22:33</DateTime>
-        </Created>
-        <Order>
-            <Identifier>1341404069982001002</Identifier>
-            <Version>1341404071848001002</Version>
-            <Aquire>
-                <AquireToPharmacy>
-                    <Name>Fanø Apotek</Name>
-                    <AddressLine>Hovedgaden 64</AddressLine>
-                    <AddressLine>6720 Fanø</AddressLine>
-                    <Type>Apotek</Type>
-                    <Identifier source="EAN-Lokationsnummer">5790000171330</Identifier>
-                </AquireToPharmacy>
-                <Comment>Kan ikke hente i Skanderborg pga. højvande</Comment>
-            </Aquire>
-        </Order>
-    </AquireOrder>
-    <!-- Example Aquire Order Response  -->
-    <AquireOrderResponse>
-        <Identifier>1341404071221009001</Identifier>
-        <Version>1341404071221009002</Version>
-        <Modified>
-            <By>
-                <Other>
-                    <Name>
-                        <GivenName>Joan</GivenName>
-                        <Surname>Jensen</Surname>
-                    </Name>
-                    <PersonIdentifier source="CPR">1202681234</PersonIdentifier>
-                </Other>
-                <Role>Farmakonom</Role>
-                <Organisation>
-                    <Name>Odder Apotek</Name>
-                    <AddressLine>Rosensgade 14</AddressLine>
-                    <AddressLine>8300 Odder</AddressLine>
-                    <Type>Apotek</Type>
-                    <Identifier source="EAN-Lokationsnummer">5790000170968</Identifier>
-                </Organisation>
-            </By>
-            <DateTime>2014-11-18T11:22:33</DateTime>
-        </Modified>
-        <Order>
-            <Identifier>1341404069982001002</Identifier>
-            <Version>1341404071848001002</Version>
-            <Aquire>
-                <AquireToPharmacy>
-                    <Name>Skanderborg Apotek</Name>
-                    <AddressLine>Adelgade 27</AddressLine>
-                    <AddressLine>8660 Skanderborg</AddressLine>
-                    <Type>Apotek</Type>
-                    <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
-                </AquireToPharmacy>
-                <Status>afvist</Status>
-                <Comment>Er afsendt</Comment>
-            </Aquire>
-        </Order>
-    </AquireOrder>
-</GetToPharmacyResponse>
-</code>