Encounter
Encounter representerer en omsorgskontakt eller tjenestekontekst for en pasient i Open Aidn.
Open Aidn eksponerer foreløpig utvalgte felter fra HL7 FHIR R4-grunnressursen Encounter. En formell Aidn-profil kan bli publisert senere.
Standarder og profiler
- HL7 FHIR R4: Encounter
- HL7 FHIR R4 search: FHIR search
Endepunkter
| Metode | Path | Påkrevd scope | Beskrivelse |
|---|---|---|---|
POST |
/Encounter/_search |
encounter.search |
Søk med application/x-www-form-urlencoded body-parametre. |
GET |
/Encounter/{id} |
encounter.read |
Les én Encounter med ID. |
Søkeresponser returneres som FHIR Bundle-ressurser med type satt til searchset.
Søkeparametre
| Parameter | Type | Beskrivelse |
|---|---|---|
identifier |
identifier | Alias for pasientidentifikator. Løses foreløpig på samme måte som patient.Identifier. |
patient.Identifier |
identifier | Pasientidentifikator brukt til å filtrere encounters for én pasient. |
type |
token | Tjenestetypefilter. HomeService mappes til Open Aidn-filtrering for hjemmetjeneste. |
location |
identifier | Avdelings- eller lokasjonsidentifikator brukt til å filtrere encounters. |
location.Identifier |
identifier | Samme formål som location. Bruk denne hvis klienten skiller mellom FHIR-referanser og identifikatorer. |
_include |
token, repeterbar | Legger støttede refererte ressurser til responsbundlen. |
Et søk uten pasient- eller lokasjonsfilter returnerer et tomt resultatsett.
Støttede includes
_include-verdi |
Inkludert ressurs | Beskrivelse |
|---|---|---|
Encounter:subject |
Patient |
Legger til refererte pasientressurser. |
Encounter:serviceProvider |
Organization |
Legger til refererte tjenesteytende organisasjoner. |
Encounter:location |
Location |
Legger til refererte lokasjonsressurser. |
Encounter:participant |
Practitioner |
Legger til refererte behandlerdeltakere når tilgjengelig. |
Når lokasjoner inkluderes, kan Open Aidn også inkludere ansvarlig organisasjon som er referert fra den inkluderte Location-ressursen.
Responsfelter
Open Aidn kan utvide responsen over tid, men integrasjoner bør foreløpig forvente data i disse feltene:
| Felt | Beskrivelse |
|---|---|
id |
Encounter-identifikator. |
meta.lastUpdated |
Tidspunkt for siste oppdatering når tilgjengelig. |
status |
FHIR Encounter-status, for eksempel in-progress, finished, cancelled, planned eller unknown. |
subject.reference |
Referanse til pasienten. |
serviceProvider.reference |
Referanse til organisasjonen som leverer tjenesten. |
period |
Start- og sluttid for encounter. |
length |
Ressurstimer per uke når tilgjengelig. |
location.location.reference |
Referanse til avdeling eller lokasjon. |
participant.individual.reference |
Referanse til en behandler eller nærstående som er koblet til encounter. |
type.coding |
Koding og visningstekst for tjenestetype. |
Eksempelsøk
POST /Encounter/_search HTTP/1.1
Host: <OPEN_AIDN_FHIR_HOST>
Accept: application/fhir+json
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer <ACCESS_TOKEN>
location.Identifier=<DEPARTMENT_ID>&_include=Encounter:subject
Responsen er en FHIR search bundle. Primære Encounter-resultater returneres med mode = match; inkluderte ressurser returneres med mode = include.