CareplanCordinatedCareSe

Introduction

The CareplanCordinatedCareSe profile is used for retrieving data about Link care plans in COSMIC. This profile is based on the FHIR resource CarePlan. It includes information like referral date, requester, receiver and also references a QuestionaireResponse resource with care note data.

COSMIC Link supports processes and routines in terms of coordination between actors which provides healthcare and social services to ensure an uninterrupted chain of care.

Intended Use

The intended use for this API is to get information about a patient's coordinated careplans, both active and completed. The coordination plan may contain multiple care notes. List of literal IDs will be returned under the Supporting info so that consumers can fetch each note using the GET API for QuestionnaireResponse. Additionally the API consumer has the possibility to contain these care notes by specifying it in the include parameters.

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
Limitation This API is bound to provide only the coordinated care plans created through the LINK module in COSMIC
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 coordinated careplans, 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 Careplan.contributer.PractitionerRoleLiteSe(PractitionerRoleLiteSe.OrganizationSEVendorLite).

Profile Overview

CareplanCordinatedCareSe

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..0Identifier
instantiatesCanonicalΣ0..0canonical(PlanDefinition | Questionnaire | Measure | ActivityDefinition | OperationDefinition)
instantiatesUriΣ0..0uri
basedOnΣ I0..0Reference(CarePlan)
replacesΣ I0..0Reference(CarePlan)
partOfΣ I0..0Reference(CarePlan)
statusΣ ?!1..1codeBinding
intentΣ ?!1..1codeBindingFixed Value
categoryΣ0..*CodeableConceptBinding
titleΣ0..1string
descriptionΣ0..1string
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBindingFixed Value
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
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
encounterΣ I0..0Reference(Encounter)
periodΣ I0..0Period
createdΣ0..1dateTime
authorΣ I0..0Reference(Patient | Practitioner | PractitionerRole | Device | RelatedPerson | Organization | CareTeam)
contributorI0..*Reference(PractitionerRoleLiteSe)
careTeamI0..0Reference(CareTeam)
addressesΣ I0..0Reference(Condition)
supportingInfoI0..*Reference(QuestionnaireResponseSe)
goalI0..*Reference(Goal)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
outcomeCodeableConcept0..*CodeableConcept
outcomeReferenceI0..*Reference(Resource)
progress0..*Annotation
referenceI0..1Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | Task | ServiceRequest | VisionPrescription | RequestGroup | https://www.hl7.org/fhir/questionnaire.html)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
kind0..1codeBindingFixed Value
instantiatesCanonical0..0canonical(PlanDefinition | ActivityDefinition | Questionnaire | Measure | OperationDefinition)
instantiatesUri0..0uri
code0..1CodeableConcept
reasonCode0..0CodeableConcept
reasonReferenceI0..0Reference(Condition | Observation | DiagnosticReport | DocumentReference)
goalI0..*Reference(Goal)
status?!1..1codeBinding
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
locationI0..0Reference(Location)
performerI0..0Reference(Practitioner | PractitionerRole | Organization | RelatedPerson | Patient | CareTeam | HealthcareService | Device)
dailyAmountI0..0SimpleQuantity
quantityI0..0SimpleQuantity
description0..1string
note0..*Annotation

Versions

COS version Profile version Required COSMIC version Date Description
3.2.0 1.0.0 R8.3.05 Apr 2022 Initial version, Support for GET and search.

ValueSet

The profile includes bindings to the following Cambio defined value set: CarePlanCategories

Code Display
SIP Samordnad individuell plan
SPLPTLRV LPT and LRV
SPU Samordnad plan vid utskrivning
VP Vårdplan
RP Rehabiliteringsplan
GP Genomförandeplan
SVP Standardiserad vårdplan

Supported Operations

HTTP Methods

Method Description
GET Support for GET Coordination plan by specific patient ID, and also to search by period and Type.

Query Operations

Search Parameters

Parameter Format Mandatory Comment
_profile string Yes
Subject reference Yes The subject that the coordination plan is about.
category string No supported types :SPLPTLRV, SIP, SPU

Supported Queries

  1. GET [baseURL]/CarePlan/?subject=[id]&_profile=[] (Search)
  2. GET [baseURL]/CarePlan/?subject=[id]&_profile=[]&category=[](Search)
  3. GET [baseURL]/CarePlan/?subject=[id]&_profile=[]&category=[]&_include=supportingInfo (Search)
  4. GET [baseURL]/CarePlan/?subject=[id]&_profile=[]&category=[]&_include=supportingInfo&_include=contributor (Search)
  5. GET [baseURL]/CarePlan/?subject=[id]&_profile=[]&category=[]&_include=contributor (Search)
  6. GET [baseURL]/CarePlan/?subject=[id]&_profile=[]&_include=contributor (Search)

Supported SearchInclude Operations

The following searchInclude parameters are supported:

  1. supportingInfo
  2. contributor

Supported RevInclude Operations

N/A

Error Codes

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