Batch Create Change Order SOVs
post
/primeapi/restapi/changeOrderSOV/batch
Send a request to this endpoint to create one or more change order SOVs. An application object will be created for each JSON object provided in the request body.
Request
Supported Media Types
- application/json
One or more schedule of values objects.
Root Schema : List<ApiEntityChangeOrderSOV>
Type:
array
Title:
Show Source
List<ApiEntityChangeOrderSOV>
Nested Schema : ApiEntityChangeOrderSOV
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
Read Only:
true
The user-specified identifier of a CBS. -
changeOrderCode(optional):
string
The user-specified identifier of a change order
-
changeOrderId(optional):
integer(int64)
The system-generated identifier of a change order.
-
changeOrderLineItemCode(optional):
string
The user-specified identifier of a line item.
-
changeOrderLineItemId:
integer(int64)
The system-generated identifier of a line item.
-
changeOrderSovCost:
object ApiEntityChangeOrderSOVCost
-
changeOrderType(optional):
string
Allowed Values:
[ "CONTRACT", "COMMITMENT" ]
The type of a change order. -
costCategoryId(optional):
integer(int64)
The type of expense described by the line item. Typical categories include Material, Other, Equipment, and Labor.
-
costCategoryName(optional):
string
The name of a cost category.
-
costSheetItemId(optional):
integer(int64)
The CBS code assigned to the schedule of values line item.
-
description(optional):
string
A brief explanation of the line item.
-
isSummarySOV(optional):
boolean
Indicates whether the schedule of values is a summary schedule of values.
-
itemCode(optional):
string
A unique identifier for the line item.
-
itemSuffix(optional):
integer(int64)
The suffix of a schedule of values code.
-
link(optional):
string(url)
Read Only:
true
-
name:
string
The name of the line item.
-
parentChangeOrderSovCode(optional):
string
The user-specified identifier of the parent object.
-
parentChangeOrderSovId(optional):
integer(int64)
The system-generated identifier of a schedule of values.
-
percentComplete(optional):
object Percent
-
periodAppliedDate(optional):
string(date-time)
The billing period of the payment application to which the change order schedule of values is applied.
-
projectCode(optional):
string
The user-specified identifier of a project.
-
quantity(optional):
object Quantity
-
sovId(optional):
integer(int64)
The system-generated identifier of a schedule of values. This value should not be provided in create operation request data, however, it is required for update requests.
-
sovType:
string
Allowed Values:
[ "LUMP_SUM", "UNIT_PRICE" ]
Describes how the line item is billed, either as a Lump Sum or Unit Price. -
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 : ApiEntityChangeOrderSOVCost
Type:
Show Source
object
-
balanceRemaining(optional):
object Cost
-
balanceRemainingAssociatedAgreement(optional):
object Cost
-
balanceRemainingCommitment(optional):
object Cost
-
balanceRemainingContract(optional):
object Cost
-
balanceRemainingLineItem(optional):
object Cost
-
balanceRemainingProject(optional):
object Cost
-
balanceRemainingWorkspace1(optional):
object Cost
-
balanceRemainingWorkspace2(optional):
object Cost
-
balanceRemainingWorkspace3(optional):
object Cost
-
changeOrderSovId(optional):
integer(int64)
The system-generated identifier of a schedule of values. This value should not be provided in create operation request data, however, it is required for update requests.
-
link(optional):
string(url)
Read Only:
true
-
retainage(optional):
object Cost
-
retainageAssociatedAgreement(optional):
object Cost
-
retainageCommitment(optional):
object Cost
-
retainageContract(optional):
object Cost
-
retainageLineItem(optional):
object Cost
-
retainageProject(optional):
object Cost
-
retainageWorkspace1(optional):
object Cost
-
retainageWorkspace2(optional):
object Cost
-
retainageWorkspace3(optional):
object Cost
-
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
201 Response
The object was successfully created.
Nested Schema : ApiEntityChangeOrderSOV
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
Read Only:
true
The user-specified identifier of a CBS. -
changeOrderCode(optional):
string
The user-specified identifier of a change order
-
changeOrderId(optional):
integer(int64)
The system-generated identifier of a change order.
-
changeOrderLineItemCode(optional):
string
The user-specified identifier of a line item.
-
changeOrderLineItemId:
integer(int64)
The system-generated identifier of a line item.
-
changeOrderSovCost:
object ApiEntityChangeOrderSOVCost
-
changeOrderType(optional):
string
Allowed Values:
[ "CONTRACT", "COMMITMENT" ]
The type of a change order. -
costCategoryId(optional):
integer(int64)
The type of expense described by the line item. Typical categories include Material, Other, Equipment, and Labor.
-
costCategoryName(optional):
string
The name of a cost category.
-
costSheetItemId(optional):
integer(int64)
The CBS code assigned to the schedule of values line item.
-
description(optional):
string
A brief explanation of the line item.
-
isSummarySOV(optional):
boolean
Indicates whether the schedule of values is a summary schedule of values.
-
itemCode(optional):
string
A unique identifier for the line item.
-
itemSuffix(optional):
integer(int64)
The suffix of a schedule of values code.
-
link(optional):
string(url)
Read Only:
true
-
name:
string
The name of the line item.
-
parentChangeOrderSovCode(optional):
string
The user-specified identifier of the parent object.
-
parentChangeOrderSovId(optional):
integer(int64)
The system-generated identifier of a schedule of values.
-
percentComplete(optional):
object Percent
-
periodAppliedDate(optional):
string(date-time)
The billing period of the payment application to which the change order schedule of values is applied.
-
projectCode(optional):
string
The user-specified identifier of a project.
-
quantity(optional):
object Quantity
-
sovId(optional):
integer(int64)
The system-generated identifier of a schedule of values. This value should not be provided in create operation request data, however, it is required for update requests.
-
sovType:
string
Allowed Values:
[ "LUMP_SUM", "UNIT_PRICE" ]
Describes how the line item is billed, either as a Lump Sum or Unit Price. -
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 : ApiEntityChangeOrderSOVCost
Type:
Show Source
object
-
balanceRemaining(optional):
object Cost
-
balanceRemainingAssociatedAgreement(optional):
object Cost
-
balanceRemainingCommitment(optional):
object Cost
-
balanceRemainingContract(optional):
object Cost
-
balanceRemainingLineItem(optional):
object Cost
-
balanceRemainingProject(optional):
object Cost
-
balanceRemainingWorkspace1(optional):
object Cost
-
balanceRemainingWorkspace2(optional):
object Cost
-
balanceRemainingWorkspace3(optional):
object Cost
-
changeOrderSovId(optional):
integer(int64)
The system-generated identifier of a schedule of values. This value should not be provided in create operation request data, however, it is required for update requests.
-
link(optional):
string(url)
Read Only:
true
-
retainage(optional):
object Cost
-
retainageAssociatedAgreement(optional):
object Cost
-
retainageCommitment(optional):
object Cost
-
retainageContract(optional):
object Cost
-
retainageLineItem(optional):
object Cost
-
retainageProject(optional):
object Cost
-
retainageWorkspace1(optional):
object Cost
-
retainageWorkspace2(optional):
object Cost
-
retainageWorkspace3(optional):
object Cost
-
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
400 Response
Invalid input for the Change Order SOV service. Verify the request contains valid data, then resubmit the request.