This is an old revision of the document!
Table of Contents
Hent nye bestillinger
Recepter der enten oprettes med en bestilling eller senere får tilknyttet en bestilling til et apotek lægges klar til afhentning af apoteket. Bestillingerne skal hentes løbende, og senest indenfor 10 dage. Bestillinger, der er ældre end 10 dage, vil ikke blive returneret i denne service. Se afsnittet Bestillinger klar til afhentning.
Ved opslag angives der:
- Identifier for apoteket der skal hentes for.
- Optionelt hvor mange recepter + bestillinger der højst ønskes returneret. FMK har dog også en 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. Hvis ikke alle recepter returnes, vil svaret indeholde elementet MoreAvailable.
Efter opslag markeres recepter + bestillinger som hentet vha. servicen Kvitter for bestillinger. 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. Juridisk betragtes dette ikke som data der hentes, men som beskeder der er sendt til en angivet modtager.
Bemærk, at apotekssystemet skal kunne håndtere, at der returneres data på trods af at disse er markeret som “afhentet” vha. Kvitter for bestillinger. Dette kan f.eks. opstå kortvarigt ved skift mellem driftscentre.
Desuden skal apotekssystemet kunne håndtere at der returneres recepter 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
- GetNewOrdersRequest.xml
<GetNewOrdersRequest> <OrganisationIdentifier source="EAN-Lokationsnummer">5790000170609</OrganisationIdentifier> <MaxResultSize>10</MaxResultSize> </GetNewOrdersRequest>
Svar
Svaret indeholder først Organisationsid der er forespurgt på (til fejlsøgning m.v.).
Herefter et antal Prescriptions-elementer, sorteret med ældste først.
Et Prescriptions-element indeholder nul eller flere recepter og bestillinger, til samme person/organisation. Informationen omkring den patient eller organisation (ved recepter til brug i praksis), som recepten er udstedt til findes først, herefter en eller flere recepter til denne. Hvis recepter er tilknyttet et ugyldigt medicinkort vil svaret indholde elementet IsInvalid.
1.4.6.E6 elementet PrescriptionType i svaret er udvidet med et optionelt DrugMedicationEnded element som advarer om at ordinationen ikke længere er gyldig, dette kan fx være at behandlingen er afsluttet, eller at behandlingen er seponeret.
- GetNewOrdersResponse.xml
<GetNewOrdersResponse> <OrganisationIdentifier source="EAN-Lokationsnummer">5790000170609</OrganisationIdentifier> <Prescriptions> <Patient> <Person> <Name> <GivenName>Søren</GivenName> <Surname>Sørensen</Surname> </Name> <PersonIdentifier source="CPR">2902704321</PersonIdentifier> <BirthDate>1973-02-01</BirthDate> <Gender>male</Gender> </Person> <Address> <StreetName>Margrethepladsen</StreetName> <StreetBuildingIdentifier>20</StreetBuildingIdentifier> <PostCodeIdentifier>8000</PostCodeIdentifier> <DistrictName>Århus</DistrictName> </Address> </Patient> <IsInvalid/> <Prescription> <Identifier>1341404068848001001</Identifier> <AttachedToDrugMedicationIdentifier>13143641280998</AttachedToDrugMedicationIdentifier> <CreatedFromDrugMedicationVersion>1341404071666006001</CreatedFromDrugMedicationVersion> <AuthorisationDateTime>2014-11-19T09:30:47.0Z</AuthorisationDateTime> <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> <ValidFromDate>2014-11-19</ValidFromDate> <ValidToDate>2014-11-30</ValidToDate> <PackageRestriction> <PackageNumber source="Medicinpriser">2917</PackageNumber> <PackageSize> <Value>30</Value> <UnitCode source="Medicinpriser">ST</UnitCode> <UnitText>stk</UnitText> </PackageSize> <PackageQuantity>1</PackageQuantity> </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> <DosageText>1 tablet morgen og aften</DosageText> <SubstitutionAllowed>true</SubstitutionAllowed> <Status>åben</Status> <Order> <Identifier>1341404068915001002</Identifier> <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> </Prescription> <Prescription> <Identifier>1341404068849001001</Identifier> <AuthorisationDateTime>2014-11-19T09:30:47.0Z</AuthorisationDateTime> <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> <ValidFromDate>2014-11-19</ValidFromDate> <ValidToDate>2014-11-30</ValidToDate> <PackageRestriction> <PackageNumber source="Medicinpriser">2917</PackageNumber> <PackageSize> <Value>30</Value> <UnitCode source="Medicinpriser">ST</UnitCode> <UnitText>stk</UnitText> </PackageSize> <PackageQuantity>1</PackageQuantity> </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> <DosageText>1 tablet morgen og aften</DosageText> <SubstitutionAllowed>true</SubstitutionAllowed> <Status>åben</Status> <Order> <Identifier>1341404068915001002</Identifier> <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> </Prescription> </Prescriptions> <Prescriptions> <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> <Prescription> <Identifier>1341404068849001001</Identifier> <AuthorisationDateTime>2014-11-19T09:30:47.0Z</AuthorisationDateTime> <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> <ValidFromDate>2014-11-19</ValidFromDate> <ValidToDate>2014-11-30</ValidToDate> <PackageRestriction> <PackageNumber source="Medicinpriser">474718</PackageNumber> <PackageSize> <Value>300</Value> <UnitCode source="Medicinpriser">ST</UnitCode> <UnitText>stk</UnitText> </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> <DosageText>efter behov</DosageText> <SubstitutionAllowed>false</SubstitutionAllowed> <Status>åben</Status> <Order> <Identifier>1341404068915001002</Identifier> <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> </Prescription> </Prescriptions> </GetNewOrdersResponse>
