AppointmentSe

Introduction

AppointmentSe is a profile based on the FHIR resource Appointment.

Intended Use

AppointmentSe is used for appointments. The profile can be used either to request all appointments for a patient, or request information for a single appointment. AppointmentSe is profiled for the Swedish market.

The intended use for reading data with this API is in first hand that the API is applied for direct access and should not be used to transfer data between caregivers. If it should be used for "data copying" between care providers, patient consent must be handled outside the API.

Specific Rules and Limitations

Type Description
Rule The consumer of the API is responsible for making sure data retrieved is filtered in compliance with laws and regulations prior to presenting it to any end-users.
Rule For reading appointments, the external system needs to be able to evaluate PDL. This means whether the information can be displayed for a healthcare professional with a specific assignment. PDL data needed (HSA care unit and HSA care provider) is retrieved by including the organization referenced from Appointment.participant.healthcareService.actor.HealthcareServiceLiteSe. The OrganizationSEVendorLite profile is referenced from HealthcareServiceLiteSe.providedBy.

Profile Overview

AppointmentSe

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
permittedPatientActionsI0..*Extension(Coding)
serviceProviderI0..1Extension(Reference())
urlI0..1Extension(url)
urlLabelI0..1Extension(string)
urlNotAvailableMessageI0..1Extension(string)
classI0..1Extension(Coding)
navigationInstructionI0..1Extension(string)
modifierExtension?! I0..*Extension
statusΣ ?!1..1codeBinding
cancelationReasonΣ0..0CodeableConcept
serviceCategoryΣ0..0CodeableConcept
serviceTypeΣ0..0CodeableConcept
specialtyΣ0..0CodeableConceptBinding
appointmentTypeΣ0..0CodeableConceptBinding
reasonCodeΣ0..0CodeableConceptBinding
reasonReferenceI0..0Reference(Condition | Procedure | Observation | ImmunizationRecommendation)
priority0..0unsignedInt
description0..1string
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ1..1uriBindingFixed Value
identifierΣ0..1Identifier
displayΣ0..1string
startΣ0..1instant
endΣ0..1instant
minutesDuration0..0positiveInt
created0..0dateTime
comment0..1string
patientInstruction0..1string
basedOnI0..0Reference(ServiceRequest)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
actorΣ I0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Device | HealthcareService | Location)
requiredΣ0..1codeBinding
statusΣ1..1codeBinding
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ1..1uriBindingFixed Value
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
requiredΣ0..1codeBinding
statusΣ1..1codeBinding
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ1..1uriBindingFixed Value
id0..1string
extensionI0..*Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..0Period
assignerΣ I0..0Reference(Organization)
displayΣ0..1string
requiredΣ0..1codeBinding
statusΣ1..1codeBinding
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uri
versionΣ0..1string
codeΣ0..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uri
versionΣ0..1string
codeΣ0..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ1..1uriBindingFixed Value
id0..1string
extensionI0..*Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..0Period
assignerΣ I0..0Reference(Organization)
displayΣ0..1string
requiredΣ0..1codeBinding
statusΣ1..1codeBinding
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ1..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
requiredΣ0..1codeBinding
statusΣ1..1codeBindingFixed Value
periodI0..1Period
requestedPeriodI0..0Period

Versions

COS version Profile version Required COSMIC version Date Description
3.0.0 1.0.0 R8.3.05 May 2022 Initial version, support for GET and Search.

Extensions

Extension Data type Description
ServiceProvider Reference Service provider
PermittedPatientActions Coding Describes what actions the patient has permission for
url url Meeting URL
urlLabel String Label of the URL for the meeting
urlNotAvailableMessage String Message explaining why the URL is not available
class coding If e.g. the appointment is a video meeting, the class will have the code VIDEOCONF.
navigationInstruction String Instructions for navigation.

Statuses

FHIR status Status in COSMIC
Proposed Open, New
Fulfilled Performed
Booked Booked
Arrived Arrived
Cancelled Cancelled
Noshow Missed

Supported Operations

HTTP Methods

Method Description
GET Search for all available appointments by patient.

Query Operations

Search Parameters

Parameter Format Mandatory Comment
Patient Token Yes Patient identifier

Supported Queries

GET [baseURL]/Appointment/_search?patient=urn:oid:1.2.752.129.2.1.3.1|191212121212

Supported SearchInclude Operations

The following searchInclude parameters are supported:

  1. Appointment:participant:HealthCareService.providedBy

PS: There can be a significant impact for the response time when include parameters are used in the search operation

Supported RevInclude Operations

N/A

Error Codes

No specific error codes for Appointment. For common codes, refer to Error handling section.