FHIR ServiceRequest Henvisning

ServiceRequest er en registrering av en forespørsel om at en prosedyre, diagnostikk eller annen tjeneste skal planlegges, foreslås eller utføres for – eller på – en innbygger, slik dette skilles gjennom verdien i feltet ServiceRequest.intent. Prosedyren vil føre til enten en Procedure eller en DiagnosticReport, som igjen kan referere til én eller flere Observation-ressurser. Ressursen kan brukes til å dele relevant informasjon som er nødvendig for å støtte en henvisning eller en forespørsel om overføring av ansvar for behandling (transfer of care) fra én behandler eller organisasjon til en annen.

Hovedformålet med ServiceRequest er å støtte bestilling av prosedyrer for én innbygger). I mange sammenhenger omfatter imidlertid helserelaterte prosesser også diagnostiske undersøkelser på grupper av personer, medisinsk utstyr involvert i helsetjenester. En service request kan representere en ordre som er registrert av en behandler, så vel som et forslag generert av et klinisk beslutningsstøttesystem (CDS). Planlagte prosedyrer som er referert fra en CarePlan, kan også representeres ved hjelp av denne ressursen.

ServiceRequest-ressursen tillater kun forespørsel om én enkelt prosedyre. Dersom en arbeidsflyt krever at flere prosedyrer bestilles samtidig, gjøres dette ved å bruke flere instanser av denne ressursen. Disse instansene kan kobles sammen på ulike måter, avhengig av behovene i arbeidsflyten. For veiledning, se Request pattern. https://hl7.org/fhir/R4/request.html#12.3

På Helsenorge er FHIR ServiceRequest tatt i bruk for 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#root

Referanser til andre ressurser fra ServiceRequest

Generelt gjelder at når en ressurs er referert til da skal benyttes logisk referanse. Unntaket er når ressurs er referert til som del av bundle eller contained (innline). Ressurs i bundle eller contained skal på samme måte bruke logiske referanser.

Beskrivelse av attributter

Hvordan feltene benyttes er angitt i figuren under.

FHIR-elementer

FHIR-elementer

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

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 kan også brukes: on-hold | revoked | entered-in-error samt andre koder etter behov. Gyldige status koder https://hl7.org/fhir/R4/codesystem-request-status.html#4.3.14.89

For noen av statusene anvendes også extension reason code for å sette henvisningsstatus, se egen beskrivelse lengre ned.

Eksempel:

<status value="active" />

intent (mandatory):

Følgende status benyttes: order

<intent value="order" />

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

Gyldige kodeverdier

routine
urgent
stat

Stat brukes for Øhjelp henvisning.
Verdien påvirker ikke utsendelse av varsel, det er håndtert av meta-tag varsling.

<priority value="urgent" />

subject (mandatory): identifiser innbygger og det skal benyttes fødselsnummer eller d-nummer. 2.16.578.1.12.4.1.4.2 (D-nummer) eller 2.16.578.1.12.4.1.4.1 (F-nummer). Kun type Patient kan benyttes og kun som logisk referanse.

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>

requester (mandatory): For push av henvisning er dette henviser. Henviser kan ha PractitionerRole, Practitioner eller Organization og er referert til som contained ressurs. Det er ønskelig at PractitionerRole blir brukt og den må inkludere både rekvirerende organisasjon (Organization) og rekvirerende helsepersonell (Practitioner). I noen tilfeller er det ikke mulig og da kan requester være enten helsepersonell (Practitioner) eller organisasjon (Organization).

"requester": {
    "reference": "#requester-prac",
    "type": "PractitionerRole"
  },

Contained ressurer bruker logisk referanse og Her-Id brukes for helsepersonell og RESH for organisasjon. Attributter i bruk: identifier, name, telecom. Se eksempel.

performer (mandatory): For Push av henvisning til sjukehus er det Organisasjon som har mottatt henvisning som er performer. For spesialisthelsetjenesten refereres det til to organisasjonsnivåer, type “dept” (avdeling) og type “hosp” (sykehus/organisasjon), og begge er påkrevd.

OID Organisasjonsnummer: urn:oid:2.16.578.1.12.4.1.4.101. Type: dept (http://terminology.hl7.org/CodeSystem/organization-type). Attributter som må brukes: identifier.system, telecom. address, name.

"performer": [
    {
      "type": "Organization",
      "reference": "#org-performer"
    }
  ],

    {
      "partOf": {
        "reference": "#org-performer-hosp"
      },
      "identifier": [
        {
          "system": "urn:oid:2.16.578.1.12.4.1.4.102",
          "value": "10013"
        }
      ],
      "name": "Kirurgisk avdeling",
      "type": [
        {
          "coding": [
            {
              "code": "dept"
            }
          ]
        }
      ],
      "resourceType": "Organization",
      "id": "org-performer"
    },

    {
      "identifier": [
        {
          "system": "urn:oid:2.16.578.1.12.4.1.4.101",
          "value": "970948139"
        }
      ],
      "name": "Testsykehuset DIPS",
      "telecom": [
        {
          "system": "phone",
          "value": "75505003"
        }
      ],
      "type": [
        {
          "coding": [
            {
              "code": "hosp"
            }
          ]
        }
      ],
      "resourceType": "Organization",
      "id": "org-performer-hosp"
    },

extensions (optional):

motattDato: 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/no-mottatt-dato">
    <valueDateTime value="2025-05-13T09:15:00+01:00" />
</extension>

Datoen da henvisningen mottas av behandlende organisasjon.

ansiennitetsDato: Første dato henvisningen ble mottatt i spesialisthelsetjenesten – beholdes ved viderehenvisning. Brukes for Henvisning og push av henvisningsstatus

fristDatoForHelsehjelp: Frist for helsehjelp er den datoen spesialisthelsetjenesten har vurdert at pasienten senest må få nødvendig helsehjelp innen, for at det ikke skal oppstå alvorlig helserisiko. Brukes for Henvisning og push av henvisningsstatus

fristDatoForVurdering: Det er juridisk rettighet at alle henvisninger til spesialisthelsetjenesten skal vurderes innen 10 virkedager etter at de er mottatt. Dette kalles fristforvurdering. For barn og unge under 23 år innen psykisk helsevern og tverrfaglig spesialisert rusbehandling (TSB) gjelder samme hovedregel på 10 virkedager, men i særskilte tilfeller kan fristen reduseres til 5 virkedager. Ved kreft og andre tilstander som omfattes av pakkeforløp, gjelder de generelle reglene om 10 virkedager, men her er det ofte fastsatt kortere frister i selve pakkeforløpet, som dermed overstyrer hovedregelen.

vurdertDato: Dato som settes når en forespørsel er vurdert og/eller henvisning er avvist/avsluttet.

statusReason: statusReason gir nærmere informasjon om status og kan være både tekst og/eller kodeverk. Settes i kombinasjon med feltet “status”

Gyldige statusReason-koder per statusverdi:
Entered in error: omgjort, slettet
Revoked: ikke_med_indikasjon, feilregistrert, kapasitet, annet
Completed: videresendt, foresporsel
Active: skalikkerettighetsvurderes, utredning

Se tabell under.

Push av henvisning

Koding ved push av henvisning

Følgende tabell viser koding i pågående implementering (under verifisering). Status på Helsenorge er avledet av koder som er mandatory i ressursen og statusReason.

Status på Helsenorge

Mottatt

Til vurdering

Videresendt

Godtatt

Avslått

Forespørsel besvart

Avsluttet

Feilregistrert

Feilregistert

status

(mandatory)

https://hl7.org/fhir/R4/codesystem-request-status.html#4.3.14.89

draft

on-hold

completed

active

revoked

completed

entered-in-error

statusReason

(optional)

Som text og i eget kodeverk

Videresendt (text)

Skal ikke rettighetsvurderes (text)

utredning (text)

Eget kodeverk:

Forespoersel (text)

omgjort (text)

slettet (text)

Ikke med. indikasjon
Feilregistrert
Manglende kapasitet
Annet

Metadata for push av henvisning

Se generelt bruk av metadata for FHIR resurser på helsenorge: Meta informasjon som kan benyttes for alle FHIR ressurser Følgende metadata tager og lastUpdated er aktuelt å bruke som metadata i push av henvisning. Hvis ikke meta tag er aktuell bør den ikke brukes.

Metadata	Påkrevd/Valgfri

Metadata	Påkrevd/Valgfri
meta.tag - Varsling	Valgfri
meta.security - Tilgangsbegrensning (betinget) Denne er det ikke implementert støtte for i dag, men det er planlagt å utvide med å ta med denne	Obligatorisk (når denne blir implementert)
meta.lastUpdated	Valgfri

Eksempel på ServiceRequest

OBS: I eksemplet brukes 3 delt identifier - se om identifer over.

{
  "resourceType": "ServiceRequest",
  "id": "servicerequest-henvisning",
  "meta": {
    "profile": [
      "http://helsenorge.no/fhir/StructureDefinition/hn-basis-serviceRequest"
    ],
    "lastUpdated": "2025-12-11T09:27:44.518Z"
  },
  "identifier": [
    {
      "system": "urn:uuid",
      "value": "db699441-90c3-af06-e063-020012aca20b",
      "assigner": {
        "reference": "#org-performer-hosp"
      }
    }
  ],
  "extension": [
    {
      "valueDateTime": "2025-10-20",
      "url": "http://helsenorge.no/fhir/StructureDefinition/no-mottatt-dato"
    },
    {
      "valueDateTime": "2025-10-20",
      "url": "http://helsenorge.no/fhir/StructureDefinition/no-ansiennitets-dato"
    },
    {
      "valueDateTime": "2025-10-29",
      "url": "http://helsenorge.no/fhir/StructureDefinition/no-frist-for-vurdering"
    },
    {
      "valueDateTime": "2025-10-20",
      "url": "http://helsenorge.no/fhir/StructureDefinition/no-vurdert-dato"
    },
    {
      "valueDateTime": "2025-10-30",
      "url": "http://helsenorge.no/fhir/StructureDefinition/no-frist-for-helsehjelp"
    }
  ],
  "status": "completed",
  "intent": "order",
  "priority": "routine",
  "subject": {
    "type": "Patient",
    "identifier": {
      "system": "urn:oid:2.16.578.1.12.4.1.4.1",
      "value": "19099624968"
    }
  },
  "occurrencePeriod": {
    "start": "2025-10-20",
    "end": "2025-10-20"
  },
  "authoredOn": "2025-10-20",
  "requester": {
    "reference": "#requester-prac",
    "type": "PractitionerRole"
  },
  "performer": [
    {
      "type": "Organization",
      "reference": "#org-performer"
    }
  ],
  "contained": [
    {
      "identifier": [
        {
          "system": "urn:oid:2.16.578.1.12.4.1.4.101",
          "value": "970948139"
        }
      ],
      "name": "Testsykehuset DIPS",
      "telecom": [
        {
          "system": "phone",
          "value": "75505003"
        }
      ],
      "type": [
        {
          "coding": [
            {
              "code": "hosp"
            }
          ]
        }
      ],
      "resourceType": "Organization",
      "id": "org-performer-hosp"
    },
    {
      "partOf": {
        "reference": "#org-performer-hosp"
      },
      "identifier": [
        {
          "system": "urn:oid:2.16.578.1.12.4.1.4.102",
          "value": "10013"
        }
      ],
      "name": "Kirurgisk avdeling",
      "type": [
        {
          "coding": [
            {
              "code": "dept"
            }
          ]
        }
      ],
      "resourceType": "Organization",
      "id": "org-performer"
    },
    {
      "practitioner": {
        "reference": "#pra-requester"
      },
      "organization": {
        "reference": "#org-requester"
      },
      "resourceType": "PractitionerRole",
      "id": "requester-prac"
    },
    {
      "name": [
        {
          "text": "Test, Fire, Testsykehuset Hf"
        }
      ],
      "resourceType": "Practitioner",
      "id": "pra-requester"
    },
    {
      "name": "Testsykehuset HF",
      "telecom": [
        {
          "system": "phone",
          "value": "75505002"
        }
      ],
      "resourceType": "Organization",
      "id": "org-requester"
    }
  ]
}

 {
  "resourceType": "ServiceRequest",
  "id": "servicerequest-henvisning",
  "meta": {
    "profile": [
      "http://helsenorge.no/fhir/StructureDefinition/hn-basis-serviceRequest"
    ],
    "lastUpdated": "2025-12-11T09:27:44.518Z"
  },
  "identifier": [
    {
      "system": "urn:uuid",
      "value": "244bec42-224b-341c-e063-030012ac8761",
      "assigner": {
        "reference": "#org-performer-hosp"
      }
    }
  ],
  "extension": [
    {
      "valueCodeableConcept": {
        "text": "Slettet"
      },
      "url": "http://helsenorge.no/fhir/StructureDefinition/servicerequest-statusReason"
    }
  ],
  "status": "entered-in-error",
  "intent": "order",
  "priority": "routine",
  "subject": {
    "type": "Patient",
    "identifier": {
      "system": "urn:oid:2.16.578.1.12.4.1.4.1",
      "value": "13116900216"
    }
  },

  "contained": [
    {
      "identifier": [
        {
          "system": "urn:oid:2.16.578.1.12.4.1.4.101",
          "value": "970948139"
        }
      ],
      "name": "Testsykehuset DIPS",
      "telecom": [
        {
          "system": "phone",
          "value": "75505003"
        }
      ],
      "type": [
        {
          "coding": [
            {
              "code": "hosp"
            }
          ]
        }
      ],
      "resourceType": "Organization",
      "id": "org-performer-hosp"
    }
  ]
}

Constraints

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