Newer Version Available

This content describes an older version of this product. View Latest

TimeSheetEntry

Represents a span of time that a service resource spends on a field service task. This object is available in API version 47.0 and later.

Time sheets are composed of time sheet entries. Time sheet entries typically track individual tasks like travel or asset repair.

Supported Calls

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

Special Access Rules

Field Service must be enabled.

Fields

Field Name Details
CurrencyIsoCode
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Available only if the multicurrency feature is enabled. Contains the ISO code for any currency allowed by the organization. The label in the user interface is Currency ISO Code.

Time sheet entries inherit their time sheet’s currency code. Updates to a time sheet’s currency code aren’t reflected in existing time sheet entries’ currency code.

Description
Type
textarea
Properties
Create, Nillable, Update
Description
Notes on how the time was spent. For example, “This service took longer than normal because the machine was jammed.”
DurationInMinutes
Type
int
Properties
Filter, Group, Nillable, Sort
Description
Minutes recorded on the time sheet entry.
EndTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time the activity finished.
LastReferencedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last interacted with this record, directly or indirectly. Some sample scenarios are:
LastViewedDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The timestamp when the current user last viewed this record or list view. If this value is null, it’s possible that the user only accessed this record or list view (LastReferencedDate), but not viewed it.
LocationTimeZone
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Time zone of the location where the activity occurred.
This field is available in API version 50.0 and later.
StartTime
Type
dateTime
Properties
Create, Filter, Nillable, Sort, Update
Description
The date and time the activity began.
Status
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
Description
The status of the time sheet entry. The picklist includes the following values, which can be customized:
  • New
  • Submitted
  • Approved
Subject
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Activity performed; for example, repair, lunch, or travel.
TimeSheetEntryNumber
Type
string
Properties
Autonumber, Defaulted on create, Filter, Sort
Description
An auto-generated number identifying the time sheet entry.
TimeSheetId
Type
reference
Properties
Create, Filter, Group, Sort
Description
The time sheet associated with the time sheet entry.
Type
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
Description
The type of work performed. The picklist includes the following values, which can be customized:
  • Direct
  • Indirect
WorkOrderId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The work order related to the time sheet entry. Work orders are searchable by their content.
WorkOrderLineItemId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The work order line item related to the time sheet entry. Work order line items are searchable by their content.

Associated Objects

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

TimeSheetEntryChangeEvent (API version 48.0)
Change events are available for the object.
TimeSheetEntryFeed
Feed tracking is available for the object.
TimeSheetEntryHistory
History is available for tracked fields of the object.