User Tools

Site Tools


fmk:1.4.4:sogning_pa_receptanmodninger

This is an old revision of the document!


Søgning på receptanmodninger

Denne service giver mulighed for at fremsøge ubehandlede receptanmodninger givet en afsendende eller en modtagende organisation. At en anmodning er ubehandlet betyder, at den ikke er annulleret og der heller ikke er udstedt en recept på baggrund af den.

Kald til denne service logges ikke i de enkelte patienters MinLog, da der (stort set) ingen personfølsomme data returneres, og servicen understøtter således visning af ubehandlede receptanmodninger i oversigtsbilleder.

Forskel mellem 1.4.4E5 og 1.4.4E2+E4

Fra og med snitflade 1.4.4E5 er der ændret i virkemåden for servicen. I tidligere snitflader blev der itereret over personer med receptanmodninger, og FromDateTime blev anvendt som en pagineringsmekanisme.

Dette er ændret fra E5 således at der itereres over individuelle receptanmodninger, hvor FromDateTime nu bruges som filterering af hvilke receptanmodninger som medregnes, således at kun anmodninger lavet på eller efter det specifikke tidspunkt vil blive talt med i servicen. Dette funktionalitet matcher den tidligere EO service hent anmodninger.

I E5 kan der i svar fra servicen returneres en MoreAvailable element, dette betyder at der er flere anmodninger som kan hentes gennem den nye paginering. I requesten kan der i E5 medsendes et PageNumber element, dette gør FMK finder de næste række af anmodninger som ikke var sendt i det foregående request. Bemærk: det indsendte PageNumber returneres også i svaret fra servicen.

Så længde et svar fra servicen indholder en MoreAvailable element, bør klient-systemet kalde servicen igen med det næste PageNumber.

Forespørgsel E2+E4

Her er et eksempel på input XML som anvender den anmodede organisation (PrescribingOrganisation):

SearchPrescriptionRequestsRequest-1.xml
<SearchPrescriptionRequestsRequest>
  <PrescribingOrganisation>
    <Type>Yder</Type>
    <Identifier source="Yder">061069</Identifier>
  </PrescribingOrganisation>
</SearchPrescriptionRequestsRequest>

Her er et eksempel på input XML som anvender den anmodende organisation (OrderingOrganisation):

SearchPrescriptionRequestsRequest-2.xml
<SearchPrescriptionRequestsRequest>
  <OrderingOrganisation>
    <Type>Kommune</Type>
    <Identifier source="Kommunekode">685</Identifier>
  </OrderingOrganisation>
</SearchPrescriptionRequestsRequest>

Forespørgsel E5

Eksempel hvor lægehus henter receptanmodninger hvor der et bedt kun inkluderes de patienter som har receptanmodninger der ikke er ældre end FromDateTime

SearchPrescriptionRequestsRequest-1.xml
<SearchPrescriptionRequestsRequest>
  <PrescribingOrganisation>
    <Type>Yder</Type>
    <Identifier source="Yder">061069</Identifier>
    <FromDateTime>2020-10-15T12:00:00Z</FromDateTime>
  </PrescribingOrganisation>
</SearchPrescriptionRequestsRequest>

Eksempel hvor kommune henter receptanmodninger oprettet hos dem, hvor der bedes om 3 sæt at anmodninger.

SearchPrescriptionRequestsRequest-2.xml
<SearchPrescriptionRequestsRequest>
  <OrderingOrganisation>
    <Type>Kommune</Type>
    <Identifier source="Kommunekode">685</Identifier>
    <FromDateTime>2020-10-10T12:00:00Z</FromDateTime>
    <PageNumber>3</PageNumber>
  </OrderingOrganisation>
</SearchPrescriptionRequestsRequest>

Svar E2+E4

For hver patient returneres CPR, datoen for ældste ubehandlede receptanmodning, samt antallet af ubehandlede receptanmodninger.

SearchPrescriptionRequestsResponse.xml
<SearchPrescriptionRequestsResponse>
  <Patient>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <OldestUnhandledCreatedDateTime>2014-02-06T14:45:23Z</OldestUnhandledCreatedDateTime>
    <NumberOfUnhandled>2</NumberOfUnhandled>
  </Patient>
  <Patient>
    <PersonIdentifier source="CPR">0102031234</PersonIdentifier>
    <OldestUnhandledCreatedDateTime>2014-02-06T14:51:22Z</OldestUnhandledCreatedDateTime>
    <NumberOfUnhandled>1</NumberOfUnhandled>
  </Patient>
</SearchPrescriptionRequestsResponse>

Resultaterne leveres sorteret efter OldestUnhandledCreatedDateTime. Hvis der er mere end N (fx 100) patienter, så returneres de første N samt et HasMore-element på denne form:

<MoreAvailable>
  <NextFromDateTime>2014-02-06T14:51:22Z</NextFromDateTime>
</MoreAvailable>

Og så kan servicen efterfølgende kaldes igen med FromDateTime-element ind til der ikke er flere resultater. Bemærk at datoen i FromDateTime-elementet er ekslusiv, dvs. at svar kun vil indeholder resultater hvor OldestUnhandledCreatedDateTime ligger efter denne dato. Det betyder teknisk set at en patient kan fremkomme i efterfølgende kald, hvis dennes ældste ubehandlede receptanmodning har skiftet status.

Svar E5

For hver patient returneres CPR, datoen for ældste ubehandlede receptanmodning, samt antallet af ubehandlede receptanmodninger.

SearchPrescriptionRequestsResponse.xml
<SearchPrescriptionRequestsResponse>
  <Patient>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <OldestUnhandledCreatedDateTime>2014-02-06T14:45:23Z</OldestUnhandledCreatedDateTime>
    <NumberOfUnhandled>2</NumberOfUnhandled>
  </Patient>
  <Patient>
    <PersonIdentifier source="CPR">0102031234</PersonIdentifier>
    <OldestUnhandledCreatedDateTime>2014-02-06T14:51:22Z</OldestUnhandledCreatedDateTime>
    <NumberOfUnhandled>1</NumberOfUnhandled>
  </Patient>
  ...
  <MoreAvailable>
</SearchPrescriptionRequestsResponse>

Resultaterne leveres sorteret efter OldestUnhandledCreatedDateTime. Hvis der er mere end N (fx 100) patienter, så returneres de første N samt et MoreAvailable element som også er set ovenover.

Er der i requesten medsendt et PageNumber element, er denne også sat ind i responset.

SearchPrescriptionRequestsResponse.xml
<SearchPrescriptionRequestsResponse>
  <Patient>
    ..
  </Patient>
  <Patient>
    ...
  </Patient>
  ...
  <PageNumber>2</PageNumber>
  <MoreAvailable>
</SearchPrescriptionRequestsResponse>

Så længde der returneres et MoreAvailable element, bør servicen kaldes igen med samme FromDateTime, og næste værdi for PageNumber dvs i overstående tilfælde ville næste logiske værdi være 3.

fmk/1.4.4/sogning_pa_receptanmodninger.1603099315.txt.gz · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki