Batch Integrate Budget Items with an External Data Source
post
/api/restapi/budgetItem/syncBatch
Send a request to this endpoint to create or update one or more integrated budget items. If an object provided in the request body does not exist in the application, an object is created using the request data. Integrated objects can only be modified using the API.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : List<ApiEntityExternallySourcedBudgetItemInput>
Type:
arrayTitle:
Show Source
List<ApiEntityExternallySourcedBudgetItemInput>-
Array of:
object ApiEntityExternallySourcedBudgetItemInput
Title:
ApiEntityExternallySourcedBudgetItemInputThis entity represents a ExternallySourcedBudgetItem object, a unique ExternallySourcedBudgetItem object can be identified by the following combinations of the fields.- budgetItemId
- budgetItemCode,projectId
- budgetItemCode,projectCode,workspaceCode
Nested Schema : ApiEntityExternallySourcedBudgetItemInput
Type:
objectTitle:
ApiEntityExternallySourcedBudgetItemInputThis entity represents a ExternallySourcedBudgetItem object, a unique ExternallySourcedBudgetItem object can be identified by the following combinations of the fields.
Show Source
- budgetItemId
- budgetItemCode,projectId
- budgetItemCode,projectCode,workspaceCode
-
abbreviation: string
Minimum Length:
1Maximum Length:10The abbreviated name of a cost category. -
budgetItemCode: string
Minimum Length:
0Maximum Length:60The unique identifier of the project budget item. -
budgetItemCost:
budgetItemCost
Contains Budget Item cost related fields.
-
budgetItemId: integer
(int64)
The system-generated identifier of a budget item.
-
cbsCodes: array
cbsCodes
List of cbs codes in hierarchy for the CBS which needs to be associated with the item. This field is not populated as part of the API response since it is a write-only field, used only for the create or update APIs.
-
cbsSheetCodeId(required): integer
(int64)
The unique identifier of the CBS Code.
-
configuredFields: array
configuredFields
The list of configured fields for a budget item.
-
costCategoryId: integer
(int64)
The type of cost associated with the budget item.
-
costCategoryName: string
Minimum Length:
1Maximum Length:255The cost category assigned to this budget item. -
itemName(required): string
Minimum Length:
0Maximum Length:255The name of the budget item. -
productionRate: number
(double)
Minimum Value:
0.000010The number of hours per unit of measure needed to complete the budget item. -
projectBudgetId: integer
(int64)
The system-generated identifier of a project budget.
-
projectCode: string
Minimum Length:
1Maximum Length:60The project associated with this budget item. -
projectId(required): integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
quantity: number
(double)
The number of each budget item needed to complete the work.
-
sourceId: string
Maximum Length:
255The unique identifier of budget item data in an external source. -
unitsOfMeasureId: integer
(int64)
The Unit of Measure used for the budget item.
-
workspaceCode: string
Minimum Length:
0Maximum Length:60The user-specified identifier of a workspace.
Nested Schema : budgetItemCost
Contains Budget Item cost related fields.
Match All
Contains Budget Item cost related fields.
Show Source
-
object
ApiEntityBudgetItemCostInput
Title:
ApiEntityBudgetItemCostInput
Nested Schema : cbsCodes
Type:
arrayList of cbs codes in hierarchy for the CBS which needs to be associated with the item. This field is not populated as part of the API response since it is a write-only field, used only for the create or update APIs.
Show Source
Nested Schema : configuredFields
Type:
arrayThe list of configured fields for a budget item.
Show Source
-
Array of:
object ApiEntityBudgetItemConfiguredFieldValueInput
Title:
ApiEntityBudgetItemConfiguredFieldValueInputThis entity represents a BudgetItemConfiguredFieldValue object, a unique BudgetItemConfiguredFieldValue object can be identified by the following combinations of the fields.- budgetItemConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
Nested Schema : ApiEntityBudgetItemCostInput
Type:
objectTitle:
Show Source
ApiEntityBudgetItemCostInput-
budgetItemId(required): integer
(int64)
The system-generated identifier of a budget item.
-
laborRateProject: number
(double)
The cost per labor hour of the budget line item. This value is based on the project currency.
-
originalCostProject: number
(double)
The original cost of the budget line item. This value is based on the project currency.
-
unitRateProject: number
(double)
The cost per Unit of Measure for the budget line item. This value is based on the project currency.
Nested Schema : ApiEntityBudgetItemConfiguredFieldValueInput
Type:
objectTitle:
ApiEntityBudgetItemConfiguredFieldValueInputThis entity represents a BudgetItemConfiguredFieldValue object, a unique BudgetItemConfiguredFieldValue object can be identified by the following combinations of the fields.
Show Source
- budgetItemConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
-
action: string
Allowed Values:
[ "DELETE" ]Provide value for this field during object update to delete the assigned configured field value. -
budgetItemConfiguredFieldValueId: integer
(int64)
The unique identifier for the Budget Item Configured Field.
-
budgetItemId: integer
(int64)
The system-generated identifier for an Budget.
-
columnDefinitionId: integer
(int64)
Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
-
columnLabel: string
Minimum Length:
1Maximum Length:100The user-specified UDF column label. -
columnName: string
Minimum Length:
1Maximum Length:100The user-specified UDF column name. -
dateValue: string
(date-time)
This holds values for Date type configured fields.
-
numberValue: number
This holds values for Number, Integer and Cost type configured fields. Input for the cost configured field should be provided in the currency of record. For example project level currency in case of Activity, base currency for Company, workspace currency for Funds and record level currency for Project Actuals etc. configured fields.
-
textValue: string
Maximum Length:
4000This holds values for Boolean, List and Text type configured fields.
Examples
Back to Top
Response
Supported Media Types
- application/json
207 Response
The object was successfully integrated.
Root Schema : List<ApiEntityERPSyncApiResponse>
Type:
arrayTitle:
Show Source
List<ApiEntityERPSyncApiResponse>-
Array of:
object ApiEntityERPSyncApiResponse
Title:
ApiEntityERPSyncApiResponse
Nested Schema : ApiEntityERPSyncApiResponse
Type:
objectTitle:
Show Source
ApiEntityERPSyncApiResponse-
identifier: object
identifier
The unique identifier of the supported object returned based on the user input.
This field can return any of the following entities determined based on the object for which the API call is invoked.
Example : ProjectIdentifier is returned when Batch Integrate Projects with an External Data Source API is invoked. -
link: string
(url)
Read Only:
trueThe self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
message: string
Message is populated based on result of the operation.
Success - Message will not be populated. Please refer the statusCode.
Failure - Error message or reason for operation failure is populated.
Warning - warning message is populated.
The field is non-persistable and thus maximum length is not applicable. -
primaryKeyName: string
The primary key field name associated with the integrated object.
The field is non-persistable and thus maximum length is not applicable. -
primaryKeyValue: integer
(int64)
The unique identifier for the integrated object.
-
sourceId: string
Maximum Length:
255The unique identifier of the object in an external source. -
statusCode: integer
(int32)
The response code representing the state of the API operation.
-
updateDate: string
(date-time)
Read Only:
trueDate when the record was last updated.
Nested Schema : identifier
Type:
objectThe unique identifier of the supported object returned based on the user input.
This field can return any of the following entities determined based on the object for which the API call is invoked.
Example : ProjectIdentifier is returned when Batch Integrate Projects with an External Data Source API is invoked.
This field can return any of the following entities determined based on the object for which the API call is invoked.
Example : ProjectIdentifier is returned when Batch Integrate Projects with an External Data Source API is invoked.
Match One Schema
Show Source
-
object
ProjectIdentifier
Title:
ProjectIdentifier -
object
CBSSheetCodeIdentifier
Title:
CBSSheetCodeIdentifier -
object
ResourceIdentifier
Title:
ResourceIdentifier
Nested Schema : ProjectIdentifier
Type:
objectTitle:
Show Source
ProjectIdentifier-
projectCode: string
Maximum Length:
60The unique identifier for a project set by the user who created the project. -
projectId: integer
(int64)
The unique identifier for the project.
-
workspaceCode: string
The user-specified identifier of a workspace.
-
workspaceId: integer
(int64)
The unique identifier of a workspace.
Nested Schema : CBSSheetCodeIdentifier
Type:
objectTitle:
Show Source
CBSSheetCodeIdentifier-
cbsCode: string
Maximum Length:
60The cost breakdown structure code is a code that is concatenated with its parent and child according to the segment definition. -
cbsSheetCodeId: integer
(int64)
The ID of the cost breakdown structure code. The CBS code is a code that is concatenated with its parent and child according to the segment definition.
-
costSheetId: integer
(int64)
The unique identifier of a cost sheet.
-
parentId: integer
(int64)
The system-generated identifier of a parent cost item in a cost sheet.
-
projectCode: string
Maximum Length:
60The unique identifier for a project set by the user who created the project. -
projectId: integer
(int64)
The unique identifier for the project.
-
workspaceCode: string
The user-specified identifier of a workspace.
-
workspaceId: integer
(int64)
The unique identifier of a workspace.
Nested Schema : ResourceIdentifier
Type:
objectTitle:
Show Source
ResourceIdentifier-
projectCode: string
Maximum Length:
60The unique identifier for a project set by the user who created the project. -
projectId: integer
(int64)
The unique identifier for the project.
-
resourceClass: string
Allowed Values:
[ "RESOURCE", "ROLE" ]The class identifies the item as a resource or a role. -
resourceCode: string
Maximum Length:
60The unique identifier for the resource or role. -
resourceId: integer
(int64)
The unique identifier for the resource or role.
-
workspaceCode: string
The user-specified identifier of a workspace.
-
workspaceId: integer
(int64)
The unique identifier of a workspace.
400 Response
Invalid Input.