Job Codes

Job code records are general job categories that can be used to classify employees. Each job code can have a generic cost for estimation and billing.

Available methods

• POST /job-codes/ — Insert a Job Code

• GET /job-codes/ — Get the List of Job Codes

• GET /job-codes/{id} — Get a Job Code

• PUT /job-codes/{id} — Update a Job Code

• DELETE /job-codes/{id} — Delete a Job Code

• OPTIONS /job-codes/ — Discover Available Methods and Fetch the Endpoint Reference for Job Codes

JobCode object properties

A job code is a general job category with a generic cost that can be used for estimation and billing.

The JobCode object has the following properties:

Property	Description	Type	Read-only	Query allowed	Sorting allowed
accountingCode	Optional accounting code that can be used for integration with external accounting systems.	string	—	Yes	—
created	The date the job code was created.	string($date-time)	Yes	Yes	—
currency	The currency for monetary values in the job code record. Three-letter currency code.	string	—	Yes	—
externalId	The unique external record ID, if the record was imported from an external system.	string	—	Yes	Yes
genericResourceId	The internal ID of the generic resource used in full-time equivalent (FTE) forecasting.	integer($int64)	—	Yes	Yes
id	The unique internal identifier of the job code.	integer($int64)	Yes	Yes	Yes
isActive	A 1/0 field indicating if the job code is active.	Boolean	—	Yes	Yes
loadedCost	The cost per hour.	number($float)	—	Yes	—
name	[REQUIRED] The display name of the job code.	string	—	Yes	Yes
notes	Notes about the job code.	Boolean	—	Yes	—
updated	The date the job code was last updated or modified.	string($date-time)	Yes	Yes	—

Note:

Access to certain object types and object attributes depend on the business logic configured for the OpenAir account. It may vary depending on the role and access privileges associated with the access token and with the user who authorized the application.

Required and read-only attributes also depend on the business logic configured for each specific OpenAir account. Some fields such as id, created, and updated are system-generated and always read-only.