WofConnectCapabilityStatement
type: CapabilityStatement
node role: treeRoot
id:
  v: WofConnectCapabilityStatement
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: CapabilityStatement WofConnectCapabilityStatement WOF Connect Capability Statement Implementation Guide Version: 0.1.3 FHIR Version: 4.0.1 Supported Formats: json Published on: 2026-02-10 07:00:00+0000 Published by: Service Well AB Note to Implementers: FHIR Capabilities Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case. This CapabilityStatement instantiates the CapabilityStatement IHE Scheduling Serverversion: 1.0.0) FHIR RESTful Capabilities Mode: server Capabilities by Resource/Profile Summary The summary table lists the resources that are part of this configuration, and for each resource it lists: The relevant profiles (if any) The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them. The required, recommended, and some optional search parameters (if any). The linked resources enabled for _include The other resources enabled for _revinclude The operations on the resource (if any) Resource Type Profile R S U C Searches _include _revinclude Operations Patient http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-patient Additional supported profiles: http://hl7.se/fhir/ig/base/StructureDefinition/SEBasePatient|1.1.0 Y Y identifier Appointment http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-appointment Y Y $find, $book, $hold ActivityDefinition http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-activitydefinition Y Y code HealthcareService http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-healthcareservice Y Y identifier PractitionerRole http://canonical.fhir.link/servicewell/wof-connect/St…
url:
  v: http://canonical.fhir.link/servicewell/wof-connect/CapabilityStatement/WofConnectCapabilityStatement
  l: WofConnectCapabilityStatement
version:
  v: 0.1.3
name:
  v: WofConnectCapabilityStatement
title:
  v: WOF Connect Capability Statement
status:
  v: active
experimental:
  v: false
date:
  v: 2026-02-10T07:00:00+00:00
publisher:
  v: Service Well AB
contact:
  name:
    v: Service Well AB
  telecom:
    system:
      v: url
    value:
      v: https://servicewell.se
  telecom:
    system:
      v: email
description:
  v: This CapabilityStatement defines the canonical domain model and API principles of **WOF Connect**, owned and operated by Service Well. **IHE Scheduling:** This server instantiates IHE.Scheduling.server (v1.0.0). **Layering principle:** - **WOF Connect** defines vendor-facing interoperability contracts. - **WOF Portal** builds on WOF Connect to provide a single, enriched, canonical API. **Domain separation principles:** - **ActivityDefinition** represents a shared service concept and SHALL be identified by code, not by resource id. - **HealthcareService** represents where care is performed. - **Organization (Economy/Billing)** represents financial responsibility and is independent of service location. - **PractitionerRole** represents a practitioner acting in a specific operational and financial context. **Many-to-many relationships are intentional:** - A HealthcareService MAY be associated with multiple Organizations. - An Organization MAY provide services at multiple HealthcareServices. - A Practitioner MAY have multiple PractitionerRoles across services and billing contexts. **Integration principle:** - External systems integrate with the platform by implementing **WOF Connect**. - WOF Portal APIs MAY return enriched and aggregated views not available in WOF Connect. This CapabilityStatement documents the canonical behavior of the WOF Connect API.
kind:
  v: capability
instantiates:
  v: https://profiles.ihe.net/ITI/Scheduling/CapabilityStatement/IHE.Scheduling.server|1.0.0
  l: https://profiles.ihe.net/ITI/Scheduling/CapabilityStatement/IHE.Scheduling.server
fhir version:
  v: 4.0.1
format:
  v: json
rest:
  mode:
    v: server
  resource:
    type:
      v: Patient
    profile:
      v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-patient
      l: wof-connect-patient
    supported profile:
      v: http://hl7.se/fhir/ig/base/StructureDefinition/SEBasePatient|1.1.0
      l: http://hl7.se/fhir/ig/base/StructureDefinition/SEBasePatient
    documentation:
      v: Patient resources returned by WOF Connect integrations. Supported interactions: search, read.
    interaction:
      extension:
        value: Code
      code:
        v: search-type
      documentation:
        v: Search Patients: GET [base]/Patient?identifier=system|value.
    interaction:
      extension:
        value: Code
      code:
        v: read
      documentation:
        v: Read a Patient by logical id: GET [base]/Patient/{id}.
    search param:
      name:
        v: identifier
      definition:
        v: http://hl7.org/fhir/SearchParameter/Patient-identifier
        l: Patient-identifier
      type:
        v: token
      documentation:
        v: Filter by personal identity number using system|value. Refer to the FHIR base profile defined by the national HL7 affiliate (e.g. HL7 Sweden). In Sweden, use system=http://electronichealth.se/identifier/personnummer. Example: GET [base]/Patient?identifier=http://electronichealth.se/identifier/personnummer|197601082394
  resource:
    type:
      v: Appointment
    profile:
      v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-appointment
      l: wof-connect-appointment
    documentation:
      v: Appointment supports: - Read/search interactions for retrieving booked appointments (patient-scoped). - IHE ITI Scheduling operations for finding availability and booking ($find, $hold, $book). Note: Some endpoints require patient context (e.g. personal identity number) for authorization and/or routing.
    interaction:
      extension:
        value: Code
      code:
        v: read
      documentation:
        v: Read Appointment: GET [base]/Appointment/{id} (may require patient context).
    interaction:
      extension:
        value: Code
      code:
        v: search-type
      documentation:
        v: Search Appointments (patient-scoped): GET [base]/Appointment?[params]
    operation:
      extension:
        value: Code
      name:
        v: find
      definition:
        v: http://canonical.fhir.link/servicewell/wof-connect/OperationDefinition/FindAppointments
        l: FindAppointments
      documentation:
        v: IHE $find to find available appointment opportunities within a time window.
    operation:
      extension:
        value: Code
      name:
        v: book
      definition:
        v: http://canonical.fhir.link/servicewell/wof-connect/OperationDefinition/BookAppointment
        l: BookAppointment
      documentation:
        v: IHE $book to create/modify/cancel an appointment.
    operation:
      extension:
        value: Code
      name:
        v: hold
      definition:
        v: https://profiles.ihe.net/ITI/Scheduling/OperationDefinition/appointment-hold
        l: appointment-hold
      documentation:
        v: IHE $hold to temporarily hold an appointment opportunity.
  resource:
    type:
      v: ActivityDefinition
    profile:
      v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-activitydefinition
      l: wof-connect-activitydefinition
    documentation:
      v: ActivityDefinition represents a shared service concept (treatment/visit type) identified by code.
    interaction:
      extension:
        value: Code
      code:
        v: read
    interaction:
      extension:
        value: Code
      code:
        v: search-type
    search param:
      name:
        v: code
      definition:
        v: http://hl7.org/fhir/SearchParameter/ActivityDefinition-code
        l: ActivityDefinition-code
      type:
        v: token
      documentation:
        v: Search by service concept code (e.g. WOF Connect service-type or service-type-id coding).
  resource:
    type:
      v: HealthcareService
    profile:
      v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-healthcareservice
      l: wof-connect-healthcareservice
    documentation:
      v: HealthcareService represents where care is performed. In WOF Connect, this typically corresponds to a clinic/location context used for scheduling and availability.
    interaction:
      extension:
        value: Code
      code:
        v: read
    interaction:
      extension:
        value: Code
      code:
        v: search-type
    search param:
      name:
        v: identifier
      definition:
        v: http://hl7.org/fhir/SearchParameter/HealthcareService-identifier
        l: HealthcareService-identifier
      type:
        v: token
      documentation:
        v: Search by HealthcareService identifier (e.g. clinic id or external system identifier).
  resource:
    type:
      v: PractitionerRole
    profile:
      v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-practitionerrole
      l: wof-connect-practitionerrole
    documentation:
      v: PractitionerRole represents a practitioner acting in a specific operational context, typically tied to a HealthcareService and used for scheduling and booking.

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

Code
v: SHOULD

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

Code
v: SHALL

extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
    l: capabilitystatement-expectation
  value: Code
    v: SHALL
code:
  v: read

extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
    l: capabilitystatement-expectation
  value: Code
    v: SHALL
code:
  v: search-type

name:
  v: service
definition:
  v: http://hl7.org/fhir/SearchParameter/PractitionerRole-service
  l: PractitionerRole-service
type:
  v: reference
documentation:
  v: Filter by PractitionerRole.healthcareService (service).

name:
  v: practitioner
definition:
  v: http://hl7.org/fhir/SearchParameter/PractitionerRole-practitioner
  l: PractitionerRole-practitioner
type:
  v: reference
documentation:
  v: Filter by PractitionerRole.practitioner.

type:
  v: Organization
profile:
  v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-billing-organization
  l: wof-connect-billing-organization
documentation:
  v: Organization represents an economic or billing entity in WOF Connect. Organizations are typically returned as part of Schedule and PractitionerRole context and MAY be retrieved directly when referenced.
interaction:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  code:
    v: read
interaction:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  code:
    v: search-type
search param:
  name:
    v: _id
  definition:
    v: http://hl7.org/fhir/SearchParameter/Resource-id
    l: Resource-id
  type:
    v: token
  documentation:
    v: Read or search Organization by logical id.
search param:
  name:
    v: identifier
  definition:
    v: http://hl7.org/fhir/SearchParameter/Organization-identifier
    l: Organization-identifier
  type:
    v: token
  documentation:
    v: Search Organization by business or billing identifier using system|value. The exact identifier system is vendor-specific but MUST be stable per endpoint.

type:
  v: Schedule
profile:
  v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule
  l: wof-connect-schedule
supported profile:
  v: https://profiles.ihe.net/ITI/Scheduling/StructureDefinition/IHE.Scheduling.Schedule|1.0.0
  l: https://profiles.ihe.net/ITI/Scheduling/StructureDefinition/IHE.Scheduling.Schedule
supported profile:
  v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule|1.0.0
  l: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule
documentation:
  v: Schedules represent planned working time and related scheduled context.
interaction:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  code:
    v: read
interaction:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  code:
    v: search-type
search param:
  name:
    v: actor
  definition:
    v: http://hl7.org/fhir/SearchParameter/Schedule-actor
    l: Schedule-actor
  type:
    v: reference
  documentation:
    v: Filter schedules by Schedule.actor (HealthcareService, Practitioner, PractitionerRole).
search param:
  name:
    v: service-type
  definition:
    v: http://hl7.org/fhir/SearchParameter/Schedule-service-type
    l: Schedule-service-type
  type:
    v: token
  documentation:
    v: Filter schedules by service type (Schedule.serviceType). Use token system|code where system is typically: - http://canonical.fhir.link/servicewell/wof-connect/identifiercodesystem/service-type-id|{serviceTypeId} Note: Schedules also carry endpoint-id as an additional coding for uniqueness, but endpoint-id alone is not a service type filter.
operation:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  name:
    v: get-schedule-context
  definition:
    v: http://canonical.fhir.link/servicewell/wof-connect/OperationDefinition/GetScheduleContext
    l: GetScheduleContext
  documentation:
    v: Returns a searchset Bundle conforming to WofConnectScheduleContextOperationResponse, containing: - Organization (WofConnectBillingOrganization) - HealthcareService (WofConnectHealthcareService) - ActivityDefinition (WofConnectActivityDefinition) - Schedule (WofConnectSchedule) - Practitioner (WofConnectPractitioner) - PractitionerRole (WofConnectPractitionerRole)

type:
  v: Practitioner
profile:
  v: http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-practitioner
  l: wof-connect-practitioner
documentation:
  v: Practitioner resources are returned as scheduling context (e.g., GetScheduleContext) and MAY be retrieved directly by reference.
interaction:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
      l: capabilitystatement-expectation
    value: Code
      v: SHALL
  code:
    v: read