POST
/
timmi-project
/
api
/
v4
/
projects
/
{projectId}
/
project-services

Path Parameters

projectId
string
required

Id of the project

Body

application/json

Work item of a project.

name
string
required
code
string
description
string | null

Optional description of the expected work to be done.

jobQualificationRateId
integer
Required range: x > 1
initialTimeEstimate
object

Also serves as maximum billable time on not-to-exceed time and materials contracts.

billRate
object | null

Required for time and materials contracts. Automatically calculated for fixed price contracts.

price
object | null

Required for fixed price contracts.

subContractingRelationship
enum<string>
default: none
Available options:
none,
external,
internal
subcontractType
enum<string> | null
Available options:
fixedPrice,
timeAndMaterials
subcontractingFixedCost
object | null

Fixed price of the bought service from the provider.

subcontractingCostRate
object | null

Daily or hourly rate billed from the service provider.

subcontractingProjectId
integer | null

In case of "internal sub-contracting", i.e. this project-service was sub-contracted to another organization in Timmi Project. Identifier of the project that represents the externalized services in the other organization.

Required range: x > 1

Response

201 - application/json

Work item of a project.

name
string
required
id
integer
Required range: x > 1
code
string
description
string | null

Optional description of the expected work to be done.

jobQualificationRate
object

The expected job qualification rate for assigned users.

status
enum<string>
default: ongoing

Time submission is disabled whenever a service is suspended or done. Once done, the service revised budget is brought to the actual amount spent.

Available options:
ongoing,
suspended,
completed
initialTimeEstimate
object

Also serves as maximum billable time on not-to-exceed time and materials contracts.

revisedTimeEstimate
object | null

Can only be modified through the estimate-to-complete ressource.

initialBudget
object | null

Equal to initialTimeEstimate multiplied by the standardRate.

revisedBudget
object | null

Equal to revisedTimeEstimate multiplied by the standardRate.

estimatedOverrun
object | null

Difference between revised and initial budgets.

billRate
object | null

Required for time and materials contracts. Automatically calculated for fixed price contracts.

price
object | null

Required for fixed price contracts.

discount
object | null

Equal to the plannedRevenue minus the initialBudget.

discountRate
number | null
Must be a multiple of 0.1
subContractingRelationship
enum<string>
default: none
Available options:
none,
external,
internal
subcontractType
enum<string> | null
Available options:
fixedPrice,
timeAndMaterials
subcontractingFixedCost
object | null

Fixed price of the bought service from the provider.

subcontractingCostRate
object | null

Daily or hourly rate billed from the service provider.

subcontractingProjectId
integer | null

In case of "internal sub-contracting", i.e. this project-service was sub-contracted to another organization in Timmi Project. Identifier of the project that represents the externalized services in the other organization.

Required range: x > 1
createdAt
string

Timestamp of the service creation.

lastModifiedAt
string

Timestamp of the service last update.