TimeEntry Object

Root Connection

All TimeEntry objects of an account are accessible by a query on the root connection timeEntries. Such a query will return a TimeEntryConnection!, which contains the TimeEntry objects in its nodes field.

timeEntries (TimeEntryConnection!)

Root connection for retrieving TimeEntry records.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

filter TimeEntryFilter

Filter to determine which TimeEntry records are returned.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

order [TimeEntryOrder!]

Order of the TimeEntry records returned.

view TimeEntryView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying TimeEntry records.

account (Account)

The account this record belongs to.

activityID (String)

The Activity ID is the unique identifier by which an activity that is performed in the context of a service offering is known in the billing system of the service provider. Some examples of activities are standard requests, a high impact incident or a request for information. The Activity ID can be used to support integrations between the billing system of the service provider and the 4me account in which the activities are performed.

agreementID (String)

The Agreement ID is the unique identifier by which all the activities that are performed through the coverage of the SLA are known in the billing system of the service provider. The agreement ID can be used to support integrations between the billing system of the service provider and the 4me account in which the activities are performed.

assignment (HasTimeEntries)

The record in which the Time spent field was filled out to cause the time entry to be generated.

charge (MonetaryAmount)

For a Time and Materials activity the charge is calculated by multiplying the time spent by the charge rate of the person’s who spent the time based on the selected effort class. For a Fixed Price activity the charge is the amount defined for the fixed price activity in the service offering (of the billable SLA related to the request).

chargeCurrency (Currency)

The currency of the charge field value of the time entry.

chargeRate (MonetaryAmount)

Shows the charging rate per hour and is defined by the effort class that was selected when the person registered the time entry.

chargeType (ServiceOfferingChargeType)

The charge type field defines how the activity must be charged: as a Fixed Price or in Time and Materials.

correction (Boolean)

Whether the time entry should be considered a correction for a time entry that was registered for a date that has already been locked.

cost (MonetaryAmount)

The cost of the time entry. It is calculated by multiplying the time spent by the cost per hour of the person who spent the time.

costCurrency (Currency)

The currency of the cost value of the time entry.

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customer (Organization)

The organization for which the time was spent.

date (ISO8601Date)

The date on which the time was spent.

deleted (Boolean)

Automatically checked after the time entry has been deleted. The data of a deleted time entry that is older than 3 months can no longer be retrieved.

description (String)

A short description of the time spent. This field is available and required only when the Description required box is checked in the selected time allocation.

effortClass (EffortClass)

The effort class that best reflects the type of effort for which time spent is being registered.

id (ID!)

Unique identifier of the record.

note (Note)

The note the time entry is linked to.

organization (Organization)

The organization to which the person was linked when the time entry was created.

person (Person)

The person who spent the time.

rateID (String)

The Rate ID is the unique identifier by which an effort class that is linked to a time entry when an activity was performed through the coverage of the SLA is known in the billing system of the service provider. The effort class represents the type of effort that was performed when working on an activity. Some examples of effort classes are 'Billable - Normal Hours', 'Billable overtime', 'Non Billable' or 'Senior System Engineer'. The Rate ID can be used to support integrations between the billing system of the service provider and the 4me account in which the activities are performed. In the billing system the Rate IDs will be linked to the rates that have been agreed on in the service contract.

service (Service)

The service for which the time was spent.

serviceInstance (ServiceInstance)

The service instance for which the time was spent. This field is automatically set when a time entry is created for a request.

serviceLevelAgreement (ServiceLevelAgreement)

The service level agreement for which the time was spent. This field is automatically set when a time entry is created for a request.

source (String)

An identifier for the client application submitting the resource or the name of an external system.

sourceID (String)

The unique identifier of the resource in an external system.

startedAt (ISO8601Timestamp)

The start time of the work.

team (Team)

Team the person of the time entry was a member of while the work was performed.

timeAllocation (TimeAllocation)

The time allocation on which the time was spent. Only the time allocations that are linked to the person’s organization can be selected.

timeSpent (Int)

The number of minutes that was spent on the selected time allocation. The number of minutes is allowed to be negative only when the correction field is set to true.

updatedAt (ISO8601Timestamp)

The date and time of the last update of the record. If the record has no updates it contains the createdAt value.

Implements

TimeEntry implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a TimeEntry.