Generated Narrative: CapabilityStatement WofConnectCapabilityStatement WOF Connect Capability Statement Implementation Guide Version: 0.1.1 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/StructureDefinition/wof-connect-practitionerrole Y Y service, practitioner Organization http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-billing-organization Y Y _id, identifier Schedule http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule Additional supported profiles: https://profiles.ihe.net/ITI/Scheduling/StructureDefinition/IHE.Scheduling.Schedule|1.0.0 http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule|1.0.0 Y Y actor, service-type $get-schedule-context Practitioner http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-practitioner Y Resource Conformance: SHALL Patient Base System Profile Wof Connect Patient Profile Conformance SHALL Reference Policy Supported Profiles http://hl7.se/fhir/ig/base/StructureDefinition/SEBasePatient|1.1.0 Interaction summary SHALL support search-type Search Patients: GET [base]/Patient?identifier=system|value. read Read a Patient by logical id: GET [base]/Patient/{id}. Documentation Patient resources returned by WOF Connect integrations. Supported interactions: search, read. Search Parameters Conformance Parameter Type Documentation SHALL identifier token 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 Conformance: SHALL Appointment Base System Profile Wof Connect Appointment Profile Conformance SHALL Reference Policy Interaction summary SHALL support read Read Appointment: GET [base]/Appointment/{id} (may require patient context). search-type Search Appointments (patient-scoped): GET [base]/Appointment?[params] Documentation 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. Extended Operations Conformance Operation Documentation SHALL $find IHE $find to find available appointment opportunities within a time window. SHALL $hold IHE $hold to temporarily hold an appointment opportunity. SHOULD $book IHE $book to create/modify/cancel an appointment. Resource Conformance: SHALL ActivityDefinition Base System Profile Wof Connect ActivityDefinition Profile Conformance SHALL Reference Policy Interaction summary SHALL support read, search-type. Documentation ActivityDefinition represents a shared service concept (treatment/visit type) identified by code. Search Parameters Conformance Parameter Type Documentation SHALL code token Search by service concept code (e.g. WOF Connect service-type or service-type-id coding). Resource Conformance: SHALL HealthcareService Base System Profile Wof Connect HealthcareService Profile Conformance SHALL Reference Policy Interaction summary SHALL support read, search-type. Documentation HealthcareService represents where care is performed. In WOF Connect, this typically corresponds to a clinic/location context used for scheduling and availability. Search Parameters Conformance Parameter Type Documentation SHALL identifier token Search by HealthcareService identifier (e.g. clinic id or external system identifier). Resource Conformance: SHALL PractitionerRole Base System Profile Wof Connect PractitionerRole Profile Conformance SHALL Reference Policy Interaction summary SHALL support read, search-type. Documentation PractitionerRole represents a practitioner acting in a specific operational context, typically tied to a HealthcareService and used for scheduling and booking. Search Parameters Conformance Parameter Type Documentation SHALL service reference Filter by PractitionerRole.healthcareService (service). SHALL practitioner reference Filter by PractitionerRole.practitioner. Resource Conformance: SHALL Organization Base System Profile Wof Connect Economy Organization Profile Conformance SHALL Reference Policy Interaction summary SHALL support read, search-type. Documentation 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. Search Parameters Conformance Parameter Type Documentation SHALL _id token Read or search Organization by logical id. SHALL identifier token Search Organization by business or billing identifier using system|value. The exact identifier system is vendor-specific but MUST be stable per endpoint. Resource Conformance: SHALL Schedule Base System Profile Wof Connect Schedule Profile Conformance SHALL Reference Policy Supported Profiles https://profiles.ihe.net/ITI/Scheduling/StructureDefinition/IHE.Scheduling.Schedule|1.0.0 http://canonical.fhir.link/servicewell/wof-connect/StructureDefinition/wof-connect-schedule|1.0.0 Interaction summary SHALL support read, search-type. Documentation Schedules represent planned working time and related scheduled context. Search Parameters Conformance Parameter Type Documentation SHALL actor reference Filter schedules by Schedule.actor (HealthcareService, Practitioner, PractitionerRole). SHALL service-type token 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. Extended Operations Conformance Operation Documentation SHALL $get-schedule-context Returns a searchset Bundle conforming to WofConnectScheduleContextOperationResponse, containing: Organization (WofConnectBillingOrganization) HealthcareService (WofConnectHealthcareService) ActivityDefinition (WofConnectActivityDefinition) Schedule (WofConnectSchedule) Practitioner (WofConnectPractitioner) PractitionerRole (WofConnectPractitionerRole) Resource Conformance: SHALL Practitioner Base System Profile Wof Connect Practitioner Profile Conformance SHALL Reference Policy Interaction summary SHALL support read. Documentation Practitioner resources are returned as scheduling context (e.g., GetScheduleContext) and MAY be retrieved directly by reference.
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.
Patient resources returned by WOF Connect integrations. Supported interactions: search, read.
Search Patients: GET [base]/Patient?identifier=system|value.
Read a Patient by logical id: GET [base]/Patient/{id}.
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
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.
Read Appointment: GET [base]/Appointment/{id} (may require patient context).
Search Appointments (patient-scoped): GET [base]/Appointment?[params]
IHE $find to find available appointment opportunities within a time window.
IHE $book to create/modify/cancel an appointment.
IHE $hold to temporarily hold an appointment opportunity.
ActivityDefinition represents a shared service concept (treatment/visit type) identified by code.
Search by service concept code (e.g. WOF Connect service-type or service-type-id coding).
HealthcareService represents where care is performed. In WOF Connect, this typically corresponds to a clinic/location context used for scheduling and availability.
Search by HealthcareService identifier (e.g. clinic id or external system identifier).
PractitionerRole represents a practitioner acting in a specific operational context, typically tied to a HealthcareService and used for scheduling and booking.
Filter by PractitionerRole.healthcareService (service).
Filter by PractitionerRole.practitioner.
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.
Read or search Organization by logical id.
Search Organization by business or billing identifier using system|value. The exact identifier system is vendor-specific but MUST be stable per endpoint.
Schedules represent planned working time and related scheduled context.
Filter schedules by Schedule.actor (HealthcareService, Practitioner, PractitionerRole).
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.
Returns a searchset Bundle conforming to WofConnectScheduleContextOperationResponse, containing: - Organization (WofConnectBillingOrganization) - HealthcareService (WofConnectHealthcareService) - ActivityDefinition (WofConnectActivityDefinition) - Schedule (WofConnectSchedule) - Practitioner (WofConnectPractitioner) - PractitionerRole (WofConnectPractitionerRole)
Practitioner resources are returned as scheduling context (e.g., GetScheduleContext) and MAY be retrieved directly by reference.