Differences

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

--- fmk:1.4.6:hent_til_apotek [2015-05-03 12:58] – [Hent til apotek] usk
+++ fmk:1.4.6:hent_til_apotek [2015-08-27 07:04] (current) – removed usk
@@ Line 1: / Line 1: @@
-====== Hent til apotek ======
-Receptordinationer 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 [[Bestillinger klar til afhentning]].
-Desuden lægges anmodninger om at overdrage bestillinger fra et apotek A1 til en andet apotek A2 klar til afhentning af apoteket A1. 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 receptordinationer + bestillinger og anmodninger der højst ønskes returneret. FMK har dog også en (konfigurerbar) grænse for, 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 receptordinationer + 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 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 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 =====
-Svaret indeholder først lokationsnummeret der er forespurgt på (til fejlsøgning m.v.).
-Herefter et antal PrescriptionMedications-elementer og AquireOrder-/AquireOrderResponse-elementer, sorteret med ældste først.
-Et PrescriptionMedications-element indeholder nul eller flere receptordinationer og bestillinger, til samme person/organisation. Informationen omkring den patient eller organisation (ved receptordinationer til brug i praksis), som receptordinationen er udstedt til findes først, herefter en eller flere [[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 PrescriptionMedications -->
-    <PrescriptionMedications>
-        <Patient>
-            <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>
-        </Patient>
-        <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>
-        <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>
-    </PrescriptionMedications>
-    <PrescriptionMedications>
-        <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>
-        <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>
-            <PackageRestriction>
-                <PackageNumber source="Medicinpriser">474718</PackageNumber>
-                <PackageSize>
-                    <Value>300</Value>
-                    <UnitCode source="Medicinpriser">stk</UnitCode>
-                </PackageSize>
-                <PackageQuantity>1</PackageQuantity>
-            </PackageRestriction>
-            <Drug>
-                <ATC>
-                    <Code source="Medicinpriser" date="2014-11-18">N02BE01</Code>
-                    <Text>Paracetamol</Text>
-                </ATC>
-                <Identifier source="Medicinpriser" date="2014-11-18">28101317587</Identifier>
-                <Name>Pamol</Name>
-                <Form>
-                    <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code>
-                    <Text>filmovertrukne tabletter</Text>
-                </Form>
-                <Strength>
-                    <Value>500.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">Paracetamol
-                        </SubstanceText>
-                    </ActiveSubstance>
-                </Substances>
-            </Drug>
-            <Order>
-                <Identifier>1341404068915001002</Identifier>
-                <Version>1341404068915001003</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>
-                <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>
-    </PrescriptionMedications>
-    <!-- Example Aquire Order Request  -->
-    <AquireOrder>
-        <Identifier>1341404071221007001</Identifier>
-        <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>
-        <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>