Batch Update Change Order Line Items
put
/primeapi/restapi/changeOrderLineItem/batch
Send a request to this endpoint to update one or more change order line items. For each JSON object provided in the request body, an application object with a matching ID value will be updated to reflect the JSON contents.
Request
Supported Media Types
- application/json
One or more line item objects.
Root Schema : List<ApiEntityChangeOrderLineItem>
Type:
array
Title:
Show Source
List<ApiEntityChangeOrderLineItem>
Nested Schema : ApiEntityChangeOrderLineItem
Type:
Show Source
object
-
abbreviation(optional):
string
The abbreviated name of a cost category.
-
associatedAgreementCode(optional):
string
The user-specified identifier of an agreement.
-
cbsCode(optional):
string
The user-specified identifier of a CBS.
-
cbsSourceId(optional):
string
The unique identifier of CBS data in an external source.
-
changeOrderCode(optional):
string
The user-specified identifier of a change order
-
changeOrderCollectedCode(optional):
string
Read Only:
true
The user-specified identifier of collected change order line items. -
changeOrderCollectedId(optional):
integer(int64)
Read Only:
true
The system-generated identifier of a change order. -
changeOrderId:
integer(int64)
The change order associated with the line item.
-
changeOrderLineItemCost(optional):
object ApiEntityChangeOrderLineItemCost
-
changeOrderSourceId(optional):
string
The unique identifier of change order data in an external source.
-
changeOrderType(optional):
string
Allowed Values:
[ "CONTRACT", "COMMITMENT" ]
The type of a change order. -
collectedFromLineItemCode(optional):
string
Read Only:
true
The user-specified identifier of a line item. -
collectedFromLineItemId(optional):
integer(int64)
The system-generated identifier of a change order line item.
-
costCategoryId(optional):
integer(int64)
The type of cost represented by the line item.
-
costCategoryName(optional):
string
The name of a cost category.
-
costSheetItemId(optional):
integer(int64)
The cost breakdown structure associated with the line item.
-
currencyCode(optional):
string
The user-specified identifier of a currency.
-
currencyId(optional):
integer(int64)
The currency in which the change order line item is written.
-
description(optional):
string
A brief explanation of the change order line item.
-
fixedExchangeRate(optional):
number
Read Only:
true
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(optional):
integer(int64)
The suffix of a line item code.
-
lineItemId(optional):
integer(int64)
The system-generated identifier of a change order line item. This value should not be provided in create operation request data, however, it is required for update requests.
-
lineItemType:
string
Allowed Values:
[ "LUMP_SUM", "UNIT_PRICE" ]
Specifies how the total cost of the line item is calculated. -
link(optional):
string(url)
Read Only:
true
-
name:
string
The name of the change order line item.
-
projectCode(optional):
string
The user-specified identifier of a project.
-
quantity(optional):
object Quantity
-
sourceId(optional):
string
Change order data from an external source.
-
unitsOfMeasureCode(optional):
string
The user-specified identifier of a project.
-
unitsOfMeasureId(optional):
integer(int64)
The units in which the line item is measured.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceCode(optional):
string
The user-specified identifier of a workspace.
Nested Schema : ApiEntityChangeOrderLineItemCost
Type:
Show Source
object
-
lineItemId(optional):
integer(int64)
The system-generated identifier of a change order line item.
-
link(optional):
string(url)
Read Only:
true
-
total(optional):
object Cost
-
totalAssociatedAgreement(optional):
object Cost
-
totalCommitment(optional):
object Cost
-
totalContract(optional):
object Cost
-
totalLineItem(optional):
object Cost
-
totalProject(optional):
object Cost
-
totalWorkspace1(optional):
object Cost
-
totalWorkspace2(optional):
object Cost
-
totalWorkspace3(optional):
object Cost
-
unitPrice(optional):
object Cost
-
unitPriceAssociatedAgreement(optional):
object Cost
-
unitPriceCommitment(optional):
object Cost
-
unitPriceContract(optional):
object Cost
-
unitPriceLineItem(optional):
object Cost
-
unitPriceProject(optional):
object Cost
-
unitPriceWorkspace1(optional):
object Cost
-
unitPriceWorkspace2(optional):
object Cost
-
unitPriceWorkspace3(optional):
object Cost
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : Quantity
Type:
object
Nested Schema : Cost
Type:
object
Response
Supported Media Types
- application/json
200 Response
A collection of object IDs mapped to a canonical link of the object. For example - {"links":{"1":"https://:/primeapi/restapi/
400 Response
Invalid input for the Change Order Line Item service. Verify the request contains valid data, then resubmit the request.