---
schema_version: "1"
id: 9e42c67d726ae9dbc64ed6f40f4cfc9d04a2c9b5da6bc3b6d063d8bd5afb5de8
title: CareServiceVisitPlan
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/sforce_api_objects_careservicevisitplan.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_careservicevisitplan.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1258d650d4a26c164fe58f4140e9801624addfd7cad9371adcb872d08352766e
description: Associates a service request with the series of visits that are planned as part of that visit. The series of visits is represented using MaintenancePlan. This object is available in API version 58.0 and later.
---
# CareServiceVisitPlan

Associates a service request with the series of visits that are planned as part of that visit. The series of visits is represented using MaintenancePlan. This object is available in API version 58.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### ApprovedVisitCount

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The number of approved visits in the planned care service.
    
    This field is available in API version 59.0 and later.

### AssignedVisitCount

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The number of visits assigned with resources in a planned service.

### AuthorizationReferenceId

- **Type**: Lookup
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The care request item that’s the record of authorization for the visit.
- **Relationship Name**: AuthorizationReference
- **Refers To**: CareRequestItem

### CanAutoscheduleVisits

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Indicates whether the next series of recurring home visits is automatically scheduled when the current set ends.
- **Default value**: false

### CarePlanContextId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The ID of the care plan, care plan detail, goal assignment, or action plan associated with the care service visit.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: CarePlanContext
- **Relationship Type**: Lookup
- **Refers To**: ActionPlan, CarePlan, CarePlanDetail, GoalAssignment, GoalAssignmentDetail
    
    This field is available in API version 59.0 and later.

### ClinicalServiceRequestId

- **Type**: Lookup
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The request for the service.
- **Relationship Name**: ClinicalServiceRequest
- **Refers To**: ClinicalServiceRequest

### CompletedVisitCount

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The number of visits that have been completed as part of the service.

### CreatedVisitCount

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The number of created visits in the planned care service.
    
    This field is available in API version 59.0 and later.

### FirstVisitStartDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The start date and time of the first visit in the set of recurring home visits.

### IsServiceAuthorizationRequired

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Indicates whether the service has to be authorized before it’s provided.
- **Default value**: false

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The date and time when the record was last referenced.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The date and time when the record was last viewed.

### LastVisitStartDate

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The start date and time of the last visit in the set of recurring home visits.

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: The name of the record.

### OwnerId

- **Type**: Polymorphic lookup
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: The owner of the record.
- **Relationship Name**: Owner
- **Refers To**:
    - Group
    - User

### SchedulingInputs

- **Type**: textarea
- **Properties**: Create, Nillable, Update
- **Description**: The inputs specified by the scheduler to schedule the home visits such as clinical service request, work type, and more.

### ServiceRequestId

- **Type**: Lookup
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The service request for the service.
- **Relationship Name**: ServiceRequest
- **Refers To**: ClinicalServiceRequest

### UnassignedVisitCount

- **Type**: int
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The number of unassigned visits in a planned service.

### VisitPlanId

- **Type**: Lookup
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The series of visits planned for a service.
- **Relationship Name**: VisitPlan
- **Refers To**: MaintenancePlan

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[CareServiceVisitPlanChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_change_event.htm "A StandardObjectNameChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 60.0)

Change events are available for the object.

[CareServiceVisitPlanFeed](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[CareServiceVisitPlanHistory](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.

[CareServiceVisitPlanShare](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")

Sharing is available for the object.