Working with Timecard Entries
Project managers rely on Procore's Budget tool to manage change orders, commitments, and direct costs, as well as leverage built-in forecasting features to track the estimated cost of completion and savings and loss over the course of the project lifecycle. In addition, Procore's Timecard tool can be used to track labor hours and manage field productivity. For companies using third-party labor tracking systems, the Procore API provides a Timecard Entry resource that can be used to integrate labor hours managed in external systems with budget views in Procore.
In preparation for working with timecard entries using the Procore API, we recommend reviewing the related instructional content available on the Procore Support site.
- Set up a Budget
- Interactive Budget Workflow Diagram
- Company Timecard Tool
- Create a Timecard Entry
- Edit a Timecard Entry
Working with the Timecard Entry API endpoints to integrate with external systems requires the following:
- Company level Timecard tool must be enabled in the Procore account.
- 'Admin' level permissions on the Company level Timecard tool required to create/update timecard entries in Procore.
Timecard Entry API Endpoints
The Procore API provides the following endpoints for working with timecard entries.
|List Timecard Entries (Project)||Return a list of all timecard entries for the specified project.|
|Create Timecard Entry (Project)||Create a new timecard entry in the specified project.|
|Show Timecard Entry (Project)||Return detailed information about the specific timecard entry.|
|Update Timecard Entry (Project)||Update the specified timecard entry.|
|Delete Timecard Entry (Project)||Delete the specified timecard entry.|
|Update Timecard Entry Signature (Project)||Update a timecard entry signature with the specified signature ID.|
|Remove Timecard Entry Signature (Project)||Remove the signature ID from the specified timecard entry.|
Basic Timecard Entry Integration Workflow
Here is a high-level view of a basic integration between an external time tracking system and the Procore Company Timecard and Project Budget tools.
In this example, a Timecard Integration App retrieves timecard data from an external third-party system and uses the Timecard Entry API to create new timecard entries in the Procore Company Timecard tool. A Procore Project Manager uses the Procore Project Budget tool to leverage the timecard entry data created though the API. A custom budget view with the Timecard Entry Hours column enables the Project Manager to see the impacts of labor hours on the project budget in real time.
Create Timecard Entries Using the API
Determining Cost Code ID and Line Item Type ID Values
Using the Procore API to create a timecard entry suitable for incorporating into budget views requires that
the correct values for the
parameters are included in the Create Timecard Entry request body. The specific cost code a new timecard entry is associated with must
have at least one line item type with a
base_type value of 'labor'. You can retrieve possible
values for these parameters by calling the List Cost Codes endpoint.
This excerpt from the List Cost Codes JSON response body shows where these values are found.
This example for the 'Project Manager' cost code shows a
cost_code_id value of
78261175. In the
line_item_types array we find an ID of
line_item_type with a corresponding
base_type of 'labor'.
Adding a Timecard Entry
Now, let's use those values as parameters to create a new timecard entry for labor hours attributed to
the 'Project Manager' cost code. In the request body for the Create Timecard Entry
endpoint we use the values for
line_item_type_id that we retrieved in the previous step,
so that the labor hours included in the timecard entry can be accessible from the Project Budget tool.
Including Timecard Entry Hours in Project Budget Views
After timecard entries are added to a project, labor hours can be accessed and included in project budget
views using the Timecard Entry Hours source column. In order to make Timecard Entry Hours available as a source column,
we first need to create a Timesheet to Budget Configuration. We include the
line_item_type_id in the
With the Timesheet to Budget Configuration successfully created, we can now use Timecard Entry Hours as a source column in a budget view.
See the following Procore Support Site articles to learn more about creating and working with budget views.