API Name: put-health-plan


This API allows capture a new health plan for the resident.

Specification


Endpoint [baseurl]/CarePlan/$put-health-plan
Protocol HTTPS
HTTP Method POST
HTTP Header Content-Type: application/fhir+json
Pagination No
Target System Consumer / Provider Apps

API Spec

This operation changes content

Parameters (In)

NameCardinalityTypeDocumentation
resource1..1CarePlan

Input the Care Plan to be created with details

Return Values (Out)

NameCardinalityTypeDocumentation
return1..1OperationOutcome

Return the OperationOutcome

Request Body

Remarks:

  • (All Slices) is an automatically generated section and should be ignored. Do not pass this as an input parameter. It will also not be part of response.
idΣ0..0id
metaΣ0..1Meta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
GoalC0..*profile-HealthPlan-put-health-plan-goal
ConditionC0..*profile-HealthPlan-conditionBase
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
modifierExtension?! C0..0Extension
identifierΣ0..0Identifier
instantiatesCanonicalΣ0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUriΣ0..0uri
basedOnΣ C0..0Reference(CarePlan)
replacesΣ C0..0Reference(CarePlan)
partOfΣ C0..0Reference(CarePlan)
statusΣ ?!1..1codeBindingFixed Value
intentΣ ?!1..1codeBindingFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
titleΣ0..0string
descriptionΣ0..0string
id0..0id
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBindingFixed Value
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ0..0string
encounterΣ C0..0Reference(Encounter)
id0..0id
extensionC0..0Extension
startΣ C1..1dateTime
endΣ C0..1dateTime
createdΣ0..0dateTime
id0..0id
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBindingFixed Value
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ0..1string
contributorC0..0Reference(CareTeam | Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
careTeamC0..0Reference(CareTeam)
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
supportingInfoC0..0Reference(Resource)
id0..0id
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
id0..1id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
outcomeCodeableConcept0..*CodeableConcept
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..1id
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
kind0..1codeBinding
instantiatesCanonical0..*canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..*uri
code0..1CodeableConcept
reasonCode0..*CodeableConcept
reasonReferenceC0..*Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..*Reference(Goal)
status?!1..1codeBinding
statusReason0..1CodeableConcept
doNotPerform?!0..1boolean
scheduledPeriodPeriod
scheduledStringstring
scheduledTimingTiming
locationC0..1Reference(Location)
performerC0..*Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
productCodeableConceptCodeableConcept
productReferenceReference(Medication | Substance)
dailyAmountC0..1SimpleQuantity
quantityC0..1SimpleQuantity
description0..1string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
outcomeCodeableConcept0..0CodeableConcept
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
eventΣ C1..1dateTime
codeΣ0..0CodeableConceptBinding
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..0string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..1string
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
outcomeReferenceC0..0Reference(Resource)
progress0..0Annotation
referenceC0..0Reference(Appointment | CommunicationRequest | DeviceRequest | MedicationRequest | NutritionOrder | RequestGroup | ServiceRequest | Task | VisionPrescription)
id0..0id
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
valueDatedate
modifierExtensionΣ ?! C0..0Extension
kind1..1codeBindingFixed Value
instantiatesCanonical0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUri0..0uri
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
reasonCode0..0CodeableConcept
reasonReferenceC0..0Reference(Condition | DiagnosticReport | DocumentReference | Observation)
goalC0..0Reference(Goal)
status?!1..1codeBindingFixed Value
statusReason0..0CodeableConcept
doNotPerform?!0..0boolean
scheduledPeriodPeriod
scheduledStringstring
id0..0id
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
eventΣ0..0dateTime
id0..0id
extensionC0..0Extension
countΣ0..0positiveInt
countMaxΣ0..0positiveInt
durationΣ0..0decimal
durationMaxΣ0..0decimal
durationUnitΣ0..0codeBinding
frequencyΣ1..1positiveIntFixed Value
frequencyMaxΣ0..0positiveInt
periodΣ1..1decimalFixed Value
periodMaxΣ0..0decimal
periodUnitΣ1..1codeBindingFixed Value
dayOfWeekΣ0..0codeBinding
timeOfDayΣ0..0time
whenΣ0..0codeBinding
offsetΣ0..0unsignedInt
codeΣ0..0CodeableConceptBinding
locationC0..0Reference(Location)
performerC0..0Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
dailyAmountC0..0SimpleQuantity
quantityC0..0SimpleQuantity
description0..1string
id0..0id
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
timeΣ0..0dateTime
textΣ C1..1markdown


Note:

  • The "subject" element is a mandatory field in the FHIR Goal resource, and its cardinality (1..1) cannot be modified. This field will be populated automatically by the HSAR backend, so clients do not need to supply the "subject" value in the request.
  • Please include the id element under the Goal resource.
  • For the detailed structures of detailQuantity, detailRatio, dueDate, and dueDuration within the Goal resource, please refer to the profile link for full specifications.

idΣ1..1id
id0..0id
extensionC0..0Extension
versionIdΣ0..0id
lastUpdatedΣ0..0instant
sourceΣ0..0uri
profileΣ0..*canonical(StructureDefinition)
securityΣ0..0CodingBinding
tagΣ0..0Coding
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedC0..0Resource
extensionC0..0Extension
modifierExtension?! C0..0Extension
identifier0..0Identifier
lifecycleStatusΣ ?!1..1codeBinding
achievementStatusΣ0..0CodeableConceptBinding
categoryΣ0..0CodeableConcept
priorityΣ0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..0id
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
id0..0id
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ0..0string
id0..0id
id0..0id
extensionC0..0Extension
url1..1uriFixed Value
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
modifierExtensionΣ ?! C0..0Extension
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..1string
detailQuantityprofile-HealthPlan-health-plan-valueQuantity
detailRatioprofile-HealthPlan-health-plan-valueRatio
dueDateprofile-HealthPlan-health-plan-valueDate
dueDurationprofile-HealthPlan-health-plan-valueDuration
statusDateΣ0..0date
statusReason0..0string
expressedByΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
addressesC0..0Reference(Condition | MedicationStatement | NutritionOrder | Observation | RiskAssessment | ServiceRequest)
note0..0Annotation
outcomeCode0..0CodeableConcept
outcomeReferenceC0..0Reference(Observation)

idΣ1..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedC0..0Resource
extensionC0..0Extension
modifierExtension?! C0..0Extension
identifierΣ0..0Identifier
clinicalStatusΣ ?! C0..0CodeableConceptBinding
verificationStatusΣ ?! C0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
severity0..0CodeableConceptBinding
id0..0id
extensionC0..0Extension
id0..0id
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..0boolean
textΣ0..0string
bodySiteΣ0..0CodeableConcept
subjectΣ C1..1Reference(Group | Patient)
encounterΣ C0..0Reference(Encounter)
recordedDateΣ0..0dateTime
recorderΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
asserterΣ C0..0Reference(Patient | Practitioner | PractitionerRole | RelatedPerson)
note0..0Annotation

Successful Response

idΣ0..0id
metaΣ0..0Meta
implicitRulesΣ ?!0..0uri
language0..0codeBinding
text0..0Narrative
containedC0..0Resource
extensionC0..0Extension
modifierExtension?! C0..0Extension
id0..1id
extensionC0..*Extension
modifierExtensionΣ ?! C0..0Extension
severityΣ1..1codeBinding
codeΣ1..1codeBinding
detailsΣ0..1CodeableConcept
diagnosticsΣ0..0string
locationΣ0..0string
expressionΣ0..0string

Error Response

Click here for General API Error Handling

Custom Error Codes

Refer to Custom Error Codes for the list of custom error codes specific to this API.

HealthPlan Model Overview

Refer to HealthPlan Model Overview for the Health Plan model overview.

Business Requirement and Validation

Refer to HealthPlan Business Requirement and Validation for the business requirements and validation rules.