Swedish Healthcare Service - Health Condition Description
0.1.0 - CI Build Sweden

Swedish Healthcare Service - Health Condition Description - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Services Overview

Services Overview

This Implementation Guide documents four Swedish national healthcare service contracts within the clinicalprocess:healthcond:description domain:

Service Catalog

GetCareDocumentation v3.0

Retrieves journal entries and care documentation for a patient.

Purpose: Provides access to care documentation such as journal notes, treatment plans, and other care-related information.

Version: 3.0
Status: Active

Read more about GetCareDocumentation

GetDiagnosis v2.0

Retrieves registered diagnoses for a patient.

Purpose: Provides access to all diagnoses registered for a patient, including primary, secondary, and related diagnoses.

Version: 2.0
Status: Active

Read more about GetDiagnosis

GetAlertInformation v2.0

Retrieves alert information (hypersensitivity, serious conditions, etc.) for a patient.

Purpose: Provides critical alert information such as allergies, intolerances, serious conditions, and other alerts that healthcare providers need to be aware of.

Version: 2.0
Status: Active

Read more about GetAlertInformation

GetFunctionalStatus v2.0

Retrieves functional status assessments for a patient.

Purpose: Provides access to functional status assessments including ADL (Activities of Daily Living), PADL (Personal ADL), mobility assessments, and other functional evaluations.

Version: 2.0
Status: Active

Read more about GetFunctionalStatus

Common Patterns

All four services follow a common request/response pattern with:

  • Patient identification using Swedish personnummer or samordningsnummer
  • Time period filtering for temporal queries
  • Care unit filtering using HSA-ID
  • Source system filtering for multi-system environments
  • Care contact filtering for episode-based queries

Request Structure

Each service accepts a request with:

  • Required patient ID (personnummer/samordningsnummer)
  • Optional filters for care unit, time period, source system, and care contacts

Response Structure

Each service returns:

  • Document header with metadata (document ID, source system, patient ID, accountable professional)
  • Service-specific content (diagnoses, alerts, documentation, assessments)
  • Legal authenticator information (when applicable)
  • Care contact references

Technical Architecture

Service Endpoint Pattern

https://{environment}/clinicalprocess/healthcond/description/{service}/{version}

Authentication & Authorization

All services require:

  • SITHS card authentication for healthcare professionals
  • Legitimate relationship (legitimt intresse) verification
  • Audit logging of all access

Data Standards

  • HSA-ID: Swedish Healthcare Address Registry identifiers for organizations and units
  • Personnummer: Swedish personal identity numbers (12 digits without separator)
  • Date format: YYYYMMDD
  • Timestamp format: YYYYMMDDHHmmss

For more details on common components and data types, see Common Components.

For business rules and requirements, see Business Rules and Requirements.

For security and legal requirements, see Information Security.