EpisodeOfCare

EpisodeOfCare representerer et omsorgsforløp for en pasient i Open Aidn. Integrasjoner kan bruke ressursen til å finne pasienter som er relevante for en organisasjon, avdeling eller tjeneste.

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

Standarder og profiler

Endepunkter

Metode Bane Påkrevd tilgang Beskrivelse
POST /EpisodeOfCare/_search episodeofcare.search Søk med parametere i en application/x-www-form-urlencoded-forespørsel.
GET /EpisodeOfCare/{id} episodeofcare.read Les én EpisodeOfCare med ID.

Søkeresultater returneres i en FHIR Bundle med type satt til searchset.

Søkeparametre

Parameter Type Beskrivelse
organization identifier Avdelings-ID brukt til å filtrere omsorgsepisoder etter ansvarlig organisasjon. I dagens Open Aidn-integrasjoner er dette vanligvis en UUID.
organization.Identifier identifier Samme formål som organization. Bruk denne hvis klienten skiller mellom FHIR-referanser og identifikatorer.
identifier identifier Alias for pasientidentifikator. Behandles 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. Verdiene som brukes nå, tilsvarer IPLOS-koder der det er relevant.
_include token, repeterbar Legger støttede, refererte ressurser til søkeresultatet.

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

Ressurser som kan inkluderes

_include-verdi Inkludert ressurs Beskrivelse
EpisodeOfCare:patient Patient Legger til refererte pasientressurser.
EpisodeOfCare:managingOrganization Organization Legger til organisasjonen som har ansvar for omsorgsepisoden.

Inkluderte ressurser legges til som egne oppføringer i Bundle-en med Bundle.entry.search.mode satt til include. EpisodeOfCare-ressursene i søkeresultatet returneres med mode satt til match.

Responsfelter

Open Aidn kan legge til felter over tid. Integrasjoner bør foreløpig regne med at følgende felter er tilgjengelige:

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 har ansvar for omsorgsforløpet, for eksempel Organization/<DEPARTMENT_ID>.
managingOrganization.identifier Avdelingsidentifikator. Verdien er avdelings-ID-en som er konfigurert.
managingOrganization.display Navnet på avdelingen når det er 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

POST /EpisodeOfCare/_search HTTP/1.1
Host: <OPEN_AIDN_FHIR_HOST>
Accept: application/fhir+json
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer <ACCESS_TOKEN>

organization=<DEPARTMENT_ID>&_include=EpisodeOfCare:patient

Svaret er en FHIR Bundle. Hver EpisodeOfCare-ressurs i søkeresultatet viser til en pasient som er relevant for avdelingen. Når søket bruker EpisodeOfCare:patient, inneholder Bundle også de refererte Patient-ressursene.

Tilbake til forsiden