Batch Integrate Change Order Line Items with an External Data Source
post
/primeapi/restapi/changeOrderLineItem/syncBatch
Send a request to this endpoint to create or update one or more integrated change order line 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
Supported Media Types
- application/json
The unique identifier of line item data in an external source.S
Root Schema : List<ApiEntityExternallySourcedChangeOrderLineItem>
Type:
array
Title:
Show Source
List<ApiEntityExternallySourcedChangeOrderLineItem>
Nested Schema : ApiEntityExternallySourcedChangeOrderLineItem
Type:
Show Source
object
-
abbreviation:
string
The abbreviated name of a cost category.
-
cbsCode:
string
The user-specified identifier of a CBS.
-
cbsSourceId:
string
The unique identifier of CBS data in an external source.
-
changeOrderCode:
string
The user-specified identifier of a change order
-
changeOrderId:
integer(int64)
The change order associated with the line item.
-
changeOrderLineItemCost:
object ApiEntityChangeOrderLineItemCost
-
changeOrderSourceId:
string
The unique identifier of change order data in an external source.
-
changeOrderType:
string
Allowed Values:
[ "CONTRACT", "COMMITMENT" ]
The type of a change order. -
costCategoryId:
integer(int64)
The type of cost represented by the line item.
-
costCategoryName:
string
The name of a cost category.
-
costSheetItemId:
integer(int64)
The cost breakdown structure associated with the line item.
-
currencyCode:
string
The user-specified identifier of a currency.
-
currencyId:
integer(int64)
The currency in which the change order line item is written.
-
description:
string
A brief explanation of the change order line item.
-
fixedExchangeRate:
number
The rate of exchange between the currency of the change order line item and the base currency, if the currencies are different. If the currencies are the same, this field is disabled.
-
itemCode:
string
The unique identifier for the change order line item.
-
itemSuffix:
integer(int64)
The suffix of a line item code.
-
lineItemId:
integer(int64)
The system-generated identifier of a change order line item.
-
lineItemType:
string
Allowed Values:
[ "LUMP_SUM", "UNIT_PRICE" ]
Specifies how the total cost of the line item is calculated. -
link:
string(uri)
Read Only:
true
-
name:
string
The name of the change order line item.
-
projectCode:
string
The user-specified identifier of a project.
-
quantity:
object Quantity
-
sourceId:
string
Change order data from an external source.
-
unitsOfMeasureCode:
string
The user-specified identifier of a project.
-
unitsOfMeasureId:
integer(int64)
The units in which the line item is measured.
-
updateDate:
string(date-time)
Read Only:
true
The date on which the object was last updated. This parameter is not included in POST request responses. Use this parameter filter objects returned from GET requests by a particular modification date. -
workspaceCode:
string
The user-specified identifier of a workspace.
Nested Schema : ApiEntityChangeOrderLineItemCost
Type:
Show Source
object
-
lineItemId:
integer(int64)
The system-generated identifier of a change order line item.
-
link:
string(uri)
Read Only:
true
-
total:
object Cost
-
totalAssociatedAgreement:
object Cost
-
totalCommitment:
object Cost
-
totalContract:
object Cost
-
totalLineItem:
object Cost
-
totalProject:
object Cost
-
totalWorkspace1:
object Cost
-
totalWorkspace2:
object Cost
-
totalWorkspace3:
object Cost
-
unitPrice:
object Cost
-
unitPriceAssociatedAgreement:
object Cost
-
unitPriceCommitment:
object Cost
-
unitPriceContract:
object Cost
-
unitPriceLineItem:
object Cost
-
unitPriceProject:
object Cost
-
unitPriceWorkspace1:
object Cost
-
unitPriceWorkspace2:
object Cost
-
unitPriceWorkspace3:
object Cost
-
updateDate:
string(date-time)
Read Only:
true
The date on which the object was last updated. This parameter is not included in POST request responses. Use this parameter filter objects returned from GET requests by a particular modification date.
Nested Schema : Quantity
Type:
object
Nested Schema : Cost
Type:
object
Response
Supported Media Types
- application/json
207 Response
Successful Sync Operation.
Nested Schema : ApiEntityERPSyncApiResponse
Type:
Show Source
object
-
link:
string(uri)
Read Only:
true
-
message:
string
-
primaryKey:
integer(int64)
-
primaryKeyName:
string
-
primaryKeyValue:
integer(int64)
-
sourceId:
string
-
statusCode:
integer(int32)
-
uniqueName:
string
-
updateDate:
string(date-time)
Read Only:
true
The date on which the object was last updated. This parameter is not included in POST request responses. Use this parameter filter objects returned from GET requests by a particular modification date.
400 Response
Invalid Input.