FHIR ServiceRequest

Under etablering- dokumentasjon ikke ferdig

FHIR ServiceRequest er foreslått tatt i bruk for triagering, i meldingstypen Tjenesteforespørsel og push av henvisningsstatus. Annen bruk er relevant på sikt.

Profilen er basert på R4 https://hl7.org/fhir/R4/servicerequest.html

Profil for ServiceRequest

Profilen ligger på Github her https://norskhelsenett.github.io/FHIRCodeAndMore/ExampleIG/output/StructureDefinition-hn-basis-serviceRequest.html

Hvordan feltene benyttes er angitt i figuren under.

Todo: Legg inn figur

identifier (mandatory): En identifikator som identifiserer serviceRequest uavhengig av ressursens id på en FHIR-server. Skal være en GUID. Kan benyttes for å knytte ServiceRequest sammen med eventuelle etterfølgende oppdateringer. Eksempel på bruk under:

<identifier>
        <!-- GUID satt av den som har generert ServiceRequest.  -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>

status (mandatory): Status på ServiceRequest i henhold til FHIR kodeverk eller volven kodeverk 9148

Følgende statuser benyttes foreløpig for triagering, meldingstypen Tjenesteforespørsel.

active: “Order” er gyldig og klar for å bli iverksatt. Det gjelder også når den er sendt fra Helsenorge
completed: Aktiviteten som er beskrevet i “Order” er fullstendig gjennomført. Ingen ytterligere handling vil forekomme. Det gjelder også når oppdatert fra behandler
Følgende statuser blir tatt i bruk senere når det er behov for det: on-hold | revoked | entered-in-error

<status value="active" />

For push av henvisningsstatus brukes koder fra Status på vurdering av henvisning (9148)

<status value="1" />

intent (mandatory): årsak for ServiceRequest i henhold til FHIR kodeverk.

Følgende status benyttes

order: Sendt fra Helsenorge, henvisning …

Verdien order skal benyttes når det foreligger en autorisert og eksplisitt bestilling av en helsetjeneste eller tiltak. Dette innebærer at bestillingen er initiert av en aktør med nødvendig rekvireringsmyndighet og at formålet er å iverksette den forespurte tjenesten.

På Helsenorge brukes også order når innbygger rekvirerer time via tjenesteforespørsel.

Formålet er å angi at forespørselen er en bindende og gjennomførbar bestilling, som skal behandles av mottakende system eller tjenesteleverandør som en konkret oppgave som skal utføres.

<intent value="order" />

category: Kategoriseringa av ønsket tjeneste

Kodet med Snomed CT, eksemple på gyldige kodeverdier

“719410009”: Consultation via video conference
“1269515004”: Face-to-face encounter
“3457005”: Patient referral

De to første kodene brukes for rekvirering av timer via tjenesteforespørsel og den siste for push av henvisnings status og/eller annen henvisningsinformasjon.

Eksempel:

<!-- ServiceRequest skal alltid ha denne code-->
    <category>
         <coding>
            <system value="http://snomed.info/sct"/>
            <code value="1269515004"/>
            <display value="Face-to-face encounter"/>
        </coding>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="719410009"/>
            <display value="Consultation via video conference"/>
        </coding>
    </category>

Priority (mandatory): Prioritet på ServiceRequest i henhold til FHIR kodeverk.

Gyldige kodeverdier

routine
urgent

<priority value="urgent" />

subject (mandatory): identifiser innbygger og det skal benyttes fødselsnummer eller d-nummer.

Eksempel på bruk under:

<subject>
       <type value="Patient" />
        <identifier>
           <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
           <value value="13116900216" />
       </identifier>
</subject>

PerformerType (optional): Rolle til den som skal utføre service request.

Kodet med Snomed eller volven kodeverk 9060?

Eksemple på kodeverdier i bruk:

LE - Lege
309343006 - Medical doctor

Eksempel på bruk under:

<performerType>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="309343006"/>
            <display value="Medical doctor"/>
        </coding>
</performerType>

reasonCode (optional): kodet verdi for begrunnelse for service request

Eksempel på bruk under:

<reasonCode>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="48694002"/>
            <display value="Anxiety"/>
        </coding>
</reasonCode>

occurencePeriod (optional): periode service request ønskes utført

Eksempel på bruk under:

<occurencePeriod>
        <start value="2023-11-15T09:00:00Z"/>
        <end value="2023-11-20T15:30:00Z"/>
</occurencePeriod>

supportingInformation(optional): Hvis det er frykt for smitte eller bevist smitte bør slik informasjonen være referert fra supportingInformation som ‘contained’ ressurs.

note (optional): Kommentar til innhold i serviceRequest

Fritekst inkludert fra innbygger?

<note>
    <text value="Ønsker videokonsultasjon eller fysisk konsultasjon"/>
</note>

extensions (optional):

Det kan være behov for å ha med informasjon om når en aktør har mottatt en “order” inkludert henvisninger. Ofte vil det behovet være løst med bruk av kombinasjon av ServiceRequest og Task, men det finnes også løsninger der dette løses med egen extension.

<extension url="http://helsenorge.no/fhir/StructureDefinition/order-received">
    <valueDateTime value="2025-05-13T09:15:00+01:00" />
</extension>

Eksempel på ServiceRequest

TBD

Constraints

Se https://norskhelsenett.github.io/FHIRCodeAndMore/ExampleIG/output/StructureDefinition-hn-basis-serviceRequest.html#constraints