This is an old revision of the document!
Table of Contents
TODO:
Denne servicebeskrivelse skal tilrettes, så den passer med 1.6.0. Det vil sige:
- Specifikation af IncludeContents-flaget
- Eksempel på brug af IncludeContents-flaget
- Beskrivelse af PackingGroupDetails
- Eksempel på svar (her kan Hent akutte perioder nok bruges som inspiration, da begge dele benytter
EntityWithDispensing-elementet
Hent pakkegruppe
Denne service anvendes af apoteket til at hente en pakkegruppe samt evt. et overblik over de patienter, dosisdispenseringskort og -perioder, der er knyttet til pakkegruppen.
Denne service kan kaldes med VOCES / FOCES certifikat. Det kan blandt andet anvendes af udleveringsapoteket, til automatisering af kald Påbegynd DD ekspedition for alle dosisdispenseringskort i en pakkegruppe, eller til polling fra pakkeapoteket for at afgøre om hele pakkegruppen er klar til pakning.
Forespørgsler til servicen
Der er 3 primære inputs til servicen:
PackingGroupIdentifier: Identifier på pakkegruppenFilterDate: Op til 2 af disse kan angives. Se beskrivelse herunder.IncludeContents: Flag, som markerer, at opsummering af tilknyttede dispenseringskort ønskes
FilterDate er valgfri at benytte, benyttes den ikke vil FMK bruge “nu” og “14 dage”. FilterDate overtager for ProductionTime i 1.4.6, hvor ProductionTime skulle være en dato mellem Deadline og StartDate (Begge inklusive). Da Deadline udgår i 1.6.0, benyttes 1 eller 2 FilterDate til at vælge et tidsrum hvor StartDate skal ligge imellem disse datoer. Angives 1 FilterDate vil FMK søge mellem “nu” og den angivne FilterDate. Angives begge søger FMK perioder hvor StartDate ligger imellem disse datoer.
Her er et eksempel på et request, der blot henter overordnet information om pakkegruppen:
- BasicGetPackingGroupRequest.xml
<GetPackingGroupRequest> <PackingGroupIdentifier>24646345634</PackingGroupIdentifier> </GetPackingGroupRequest>
Dette er et eksempel på et request, der henter en oversigt over hvilke dosiskort der er tilknyttet til en pakkegruppe.
- GetPackingGroupOverviewRequest.xml
<GetPackingGroupRequest> <PackingGroupIdentifier>24646345634</PackingGroupIdentifier> <IncludeContents/> </GetPackingGroupRequest>
Svar fra servicen
Svaret fra servicen indeholder et PackingGroupDetails og en liste af EntityWithDispensing elementer. Disse elementer indeholder følgende:
- Valget mellem
PersonIdentifier,Patient&Organisation. Da det ikke er muligt at bede om patient detailjer i denne service, vilPatientikke kunne forekomme. Men den ligger i skemaer daEntityWithDispensingtypen genbruges i en række andre services. - Optionelt en række
PatientRegistrationelementer. Såfremt der på patienten er registeret nogle af disse, og disse er aktive, vil de fremkomme her. DispensingCardelement, som indeholder en række informationer.
DispensingCard elementet indeholder følgende informationer:
IdentifierID på dispenseringskortetDescriptionBeskrivelse af kortetPackingGroupIdentifier,PackingGroupName,OrderedAtPharmacy&PackedAtOrganisation. Bemærk igen atDispensingOrganisationer inkluderet i skemaet, men det forventes ikke denne værdi vil kunne forekomme fra denne service.- Optionelt en række
DispensingPeriodelementer. Der vil fra denne service altid være mindst 1 periode.
DispensingPeriod elementerne indeholder følgende:
IdentifierID på perioden.CreatedModifikatoren på person som oprettede perioden.- Optionelt
ReportedBy&Modifiedmodifikatorer på personen som indberettede og foretog den seneste ændring.Modifiedforekommer kun såfremt perioden har været ændret mindst 1 gang - Optionelt
ExpectedDeliverytimestamp på hvornår perioden forventes leveret. Statusden nuværende status for perioden.- Optionelt
ProductionIdentifierstregkoden for den pågældende periode. - Optionelt
AcutePacking
