EpisodeOfCare

EpisodeOfCare representerer en pasients omsorgsepisode i Open Aidn. Ressursen brukes av integrasjoner som trenger å vite hvilke pasienter som er relevante for en organisatorisk enhet, avdeling eller omsorgskontekst.

Open Aidn eksponerer foreløpig HL7 FHIR R4-grunnressursen EpisodeOfCare. En formell Aidn-profil kan bli publisert senere.

Standarder og profiler

Endepunkter

Metode Path Påkrevd scope Beskrivelse
POST /EpisodeOfCare/_search episodeofcare.search Søk med application/x-www-form-urlencoded body-parametre.
GET /EpisodeOfCare/{id} episodeofcare.read Les én EpisodeOfCare med ID.

Søkeresponser returneres som FHIR Bundle-ressurser med type satt til searchset.

Søkeparametre

Parameter Type Beskrivelse
organization identifier Avdelings-ID brukt til å filtrere omsorgsepisoder etter ansvarlig organisasjon. For dagens Open Aidn-integrasjoner er dette vanligvis avdelings-ID som UUID.
organization.Identifier identifier Samme formål som organization. Bruk denne hvis klienten skiller mellom FHIR-referanser og identifikatorer.
identifier identifier Alias for pasientidentifikator. Løses foreløpig på samme måte som patient.Identifier.
patient.Identifier identifier Pasientidentifikator brukt til å filtrere omsorgsepisoder for én pasient.
type token, repeterbar Filtrerer på tjenestetype. Dagens verdier mappes til IPLOS-koder der det er relevant.
_include token, repeterbar Legger støttede refererte ressurser til responsbundlen.

Minst én av organization / organization.Identifier eller identifier / patient.Identifier bør oppgis. Et søk uten pasient- eller avdelingsfilter returnerer et tomt resultatsett.

Støttede includes

_include-verdi Inkludert ressurs Beskrivelse
EpisodeOfCare:patient Patient Legger refererte pasientressurser til som include-entries.
EpisodeOfCare:managingOrganization Organization Legger refererte ansvarlige organisasjoner til som include-entries.

Inkluderte ressurser legges til som egne bundle entries med Bundle.entry.search.mode = include. Primære EpisodeOfCare-resultater returneres med mode = match.

Responsfelter

Open Aidn kan utvide responsen over tid, men integrasjoner bør foreløpig forvente data i disse feltene:

Felt Beskrivelse
id EpisodeOfCare-identifikator.
meta.lastUpdated Tidspunkt for siste oppdatering når tilgjengelig.
status FHIR EpisodeOfCare-status, for eksempel planned, active, onhold, finished, cancelled eller waitlist.
patient.reference Referanse til pasienten, for eksempel Patient/<id>.
managingOrganization.reference Referanse til avdelingen eller organisasjonen som håndterer omsorgsepisoden, for eksempel Organization/<department-id>.
managingOrganization.identifier Avdelingsidentifikator. Verdien er konfigurert avdelings-ID.
managingOrganization.display Lesbart avdelingsnavn når tilgjengelig.
period.start Starttidspunkt for omsorgsepisoden.
period.end Sluttidspunkt når omsorgsepisoden er avsluttet.
type.coding Koding for tjenestetype. Koder er IPLOS-relaterte der de finnes, med visningstekst for tjenestetypen.

Eksempelsøk

GET /EpisodeOfCare/_search?organization=<DEPARTMENT_ID>&_include=EpisodeOfCare:patient HTTP/1.1
Host: <OPEN_AIDN_FHIR_HOST>
Accept: application/fhir+json
Authorization: Bearer <ACCESS_TOKEN>

Responsen er en FHIR search bundle. Hver matchende EpisodeOfCare viser en pasient som er relevant for avdelingen. Hvis EpisodeOfCare:patient er inkludert, inneholder bundlen også de refererte Patient-ressursene.

Back to the homepage