Visit

Track information related to a field rep’s visit to a retail store where they perform retail activities. This object is available in API version 47.0 and later.

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

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The account that is associated with a visit. This field is available in API versions 48.0 and later.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort
• Description: The date and time when the visit ended.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort
• Description: The date and time when the visit started.

• Type: reference

• Properties: Filter, Group, Nillable, Sort

• Description: The address of the retail store where the visit must be conducted. This field is available in API versions 52.0 and later. Not applicable for the enhanced model of Consumer Goods cloud.

  This is a relationship field.

• Relationship Name: Address

• Relationship Type: Lookup

• Refers To: Address

• Type: string
• Properties: Filter, Nillable, Sort
• Description: City of the related account. This is a calculated field.

• Type: string
• Properties: Filter, Nillable, Sort
• Description: Street name of the related account.

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The accountable user for this visit. System sets the initiator of the visit as the initial accountable user.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date the visit was completed.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Date and time the visit was created.

• Type: picklist
• Properties: Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
• Description: Specifies the way the visit was created. Possible values are manually or automatic.
• Default value: manually

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Help/Mock field to visualize calendar in visual force page. Value of this field won’t be saved in the database.

• Type: double
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Distribution rate of all products. The system calculates and stores the ‘Distribution Rate of All Products’ (DRallP) as percentage value.

• Type: double
• Properties: Create, Filter, Nillable, Sort, Update
• Description: This is a KPI Field calculated based on the distribution rate of all products. The system caluclates and stores the ‘Distribution Issues’ (DI) as boolean value.

• Type: double
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Effective visit duration captured via time tracking. Only implemented in mobile, will remain empty if visit is completed on desktop.

• Type: double
• Properties: Filter, Nillable, Sort
• Description: Planned duration of the visit (difference between planned start and end data). This is a calculated field.

• Type: date
• Properties: Filter, Group, Nillable, Sort
• Description: Planned end date of the visit.

• Type: picklist
• Properties: Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
• Description: Specifies that this visit was scheduled with the customer at a fixed date and time. Attribute can be used to implement a logic which will not allow to move the visit to a different date or time. Possible values are 0 (No) and 1 (Yes).
• Default value: 0

• Type: location
• Properties: Nillable
• Description: User’s geo coordinates (Latitude and Longitude) captured using their mobile device during the visit completion or cancellation.

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Visit is planned for the entire day. Weekly calendar visualizes such visits in the header of the day.
• Default value: false

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Indicates whether the visit completed outside the allowed distance between the GPS location and the store’s geolocation.
• Default value: false

• Type: boolean
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: Indicates whether the visit started outside the allowed distance between the GPS location and the store’s geolocation.
• Default value: false

• Type: textarea
• Properties: Create, Nillable, Update
• Description: Visit notes which can be captured to prepare the visit or during execution time.

• Type: picklist

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: Specifies the reason for visit cancellation.

• Possible values:

  • Unserviced—End of day reached
  • NoManager—Manager unavailable
  • StoreClosed—Store Closed
  • TimeWindow—Time window missed

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Responsible user for this visit.

• Type: date
• Properties: Filter, Group, Nillable, Sort
• Description: Planned start date of the visit.

• Type: Geolocation
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Customer’s location coordinates (latitude and longitude) at the start of a visit.

• Type: textarea
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Subject of the visit.

• Type: string
• Properties: Filter, Nillable, Sort
• Description: This field is required when subject needs to be displayed in a formula format. This is a calculated field.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Planned date for the visit.

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Template of the visit. This field is a relationship field.

• Type: reference

• Properties: Filter, Group, Nillable, Sort

• Description: The person to contact at the retail store during a visit. This field is available in API versions 52.0 and later. Not applicable for the enhanced model of Consumer Goods cloud.

  This is a relationship field.

• Relationship Name: Contact

• Relationship Type: Lookup

• Refers To: Contact

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: The purpose of a visit, such as claim, business license application, or work type. This field is available in API versions 48.0 and later. Not applicable for the enhanced model of Consumer Goods cloud.

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: User who created the visit.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date the visit was created.

• Type: textarea
• Properties: Create, Filter, Nillable, Sort, Update
• Description: Special instructions provided by a sales manager or an admin that a sales rep refers to during a visit. Not applicable for the enhanced model of Consumer Goods cloud.

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: User who last modified the visit.

• Type: date
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: Date and time of the last modification for this visit.

• Type: dateTime
• Properties: Filter, Nillable, Sort
• Description: The most recent date on which a user referenced this record.

• Type: dateTime
• Properties: Filter, Nillable, Sort
• Description: The most recent date on which a user viewed this record.

• Type: reference

• Properties: Filter, Group, Nillable, Sort

• Description: The location of the retail store where visit must be conducted. This field is available in API versions 52.0 and later.

  This is a relationship field.

• Relationship Name: Location

• Relationship Type: Lookup

• Refers To: Location

• Type: string
• Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
• Description: Unique identifier for the visit record.

• Type: reference
• Properties: Create, Defaulted on create, Filter, Group, Sort, Update
• Description: ID of the visit record owner.

• Type: reference
• Properties: Create, Filter, Group, Sort, Update
• Description: ID of the place that sales reps visit.

• Type: dateTime
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The date and time when the visit is expected to end.

• Type: dateTime
• Properties: Create, Filter, Sort, Update
• Description: The date and time when the visit is expected to start.

• Type: reference

• Properties: Filter, Group, Nillable, Sort

• Description: The retail store where the visit is conducted. This field is available in API versions 52.0 and later. Used in CG Cloud base model to assign a retail store. Not applicable for the enhanced model of Consumer Goods cloud.

  This is a relationship field.

• Relationship Name: RetailStore

• Relationship Type: Lookup

• Refers To: RetailStore

• Type: picklist

• Properties: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort

• Description: The status of the visit. Sales reps’ can’t edit this field.

  This is a static picklist. The values of the picklist aren’t displayed in the Object Manager.

  Note

• Default value: Planned

• Possible values:

  • Abandoned
  • Completed
  • InProgress
  • Planned
  • Unscheduled
  • None
  • Error

• Type: textarea
• Properties: Create, Filter, Nillable, Sort, Update
• Description: The reasons for abandoning or completing the visit as provided by the sales rep. Not applicable for the enhanced model of Consumer Goods cloud.

• Type: picklist

• Properties: Create, Filter, Group, Nillable, Sort, Update

• Description: The priority of the visit.

  Not applicable for the enhanced model of Consumer Goods cloud.

• Possible values:

  • High
  • Low
  • Medium

• Type: reference
• Properties: Create, Filter, Group, Nillable, Sort, Update
• Description: ID of the sales representative visiting the store. Not applicable for the enhanced model of Consumer Goods cloud.

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

• VisitShare: Sharing is available for the object.
• VisitFeed: Feed is available for the object.
• VisitHistory: History is available for the object.
• VisitOwnerSharingRule: Sharing rule is available for the object.

j

Get Started with Consumer Goods Cloud

Retail Execution

Standard Objects for Retail Execution

Account

Asset

AssessmentIndicatorDefinition

AssessmentIndDefinedValue

AssessmentIndValue

AssessmentTask

AssessmentTaskContentDocument

AssessmentTaskDefinition

AssessmentTaskIndDefinition

AssessmentTaskOrder

Assortment

AssortmentProduct

DeliveryTask

InStoreLocation

Operatinghours

OtherComponentTask

Product2

Promotion

PromotionChannel

PromotionProduct

PromotionProductCategory

RetailLocationGroup

RetailStore

RetailStoreGroupAssignment

RetailStoreKpi

RetailVisitKpi

SignatureTask

SignatureTaskLineItem

StoreActionPlanTemplate

StoreAssortment

StoreProduct

Task

User

VehicleUserAssignment

Visit

Visitor

VisitedParty

Associated Objects for Retail Execution

Custom Objects for Retail Execution

Standard DLO to DMO Mappings

Retail Execution Standard Metadata APIs

Retail Order Customization

Sync Management

Direct Store Delivery

Einstein Visit and Activity Recommendation

Trade Promotion Management

Custom Objects for Retail Execution and Trade Promotion Management

Standard and Custom Objects for Future Use

API End-of-Life Policy

Previous Versions