View Collected Change Orders
get
/primeapi/restapi/changeOrder/collected/workspace/{worksaceCode}/project/{projectCode}/associatedContract/{associatedContractCode}/contractChangeOrder/{contractChangeOrderCode}
This endpoint returns change orders that have been collected.
Request
Path Parameters
-
associatedContractCode: string
The user-specified identifier of an agreement.
-
contractChangeOrderCode: string
The user-specified identifier of a change order
-
projectCode: string
The user-specified identifier of a project.
-
worksaceCode: string
The user-specified identifier of a workspace.
Response
Supported Media Types
- application/json
200 Response
successful operation
Nested Schema : ApiEntityChangeOrder
Type:
Show Source
object
-
approveByUserName(optional):
string
Read Only:
true
The name of the user that approved the change order. -
associatedAgreementCode(optional):
string
The code of the aggrement associated with the change order.
-
associatedAgreementLinkId:
integer(int64)
The contract associated with the change order.
-
cancelByUser(optional):
string
Read Only:
true
The name of the user that canceled the change order. -
changeEstimateCode(optional):
string
The user-specified identifier of a change estimate.
-
changeEstimateId(optional):
integer(int64)
The change estimate of the change order.
-
changeEventCode(optional):
string
The user-specified identifier of a change event.
-
changeEventId(optional):
integer(int64)
Read Only:
true
The change event of the change order. -
changeOrderConfiguredFields(optional):
object ApiEntityChangeOrderConfiguredFields
-
changeOrderCost(optional):
object ApiEntityChangeOrderCost
-
changeOrderId(optional):
integer(int64)
The system-generated identifier of the change order. This value should not be provided in create operation request data, however, it is required for update requests.
-
closeByUserName(optional):
string
Read Only:
true
The name of the user that closed the change order. -
collectedToChangeOrderCode(optional):
string
The user-specified identifier of a change order
-
collectedToChangeOrderId(optional):
integer(int64)
Read Only:
true
The name and ID of the change order into which the commitment change order was collected. -
currencyCode(optional):
string
Read Only:
true
The user-specified identifier of a currency. -
currencyId(optional):
integer(int64)
Read Only:
true
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. -
fromCompanyId(optional):
integer(int64)
Read Only:
true
The company that awarded the change order. -
fromCompanyName(optional):
string
Read Only:
true
The name of the company the change order is sent by. -
fromCompanySourceId(optional):
string
The unique identifier of company data in an external source.
-
fromContactId(optional):
integer(int64)
The person in the Awarded From company who is officially responsible for communications about the associated agreement.
-
fromContactUserName(optional):
string
The name of the user associated with the change order's from company.
-
itemCode:
string
The unique identifier for the change order.
-
itemPrefix(optional):
string
The prefix of a change order code.
-
itemSuffix(optional):
integer(int64)
The suffix of a change order code.
-
link(optional):
string(url)
Read Only:
true
-
name:
string
The change event of the change order.
-
periodAppliedDate(optional):
string(date-time)
Read Only:
true
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.
-
projectId:
integer(int64)
The project that corresponds to the change order.
-
projectSourceId(optional):
string
The unique identifier of project data in an external source.
-
rejectByUserName(optional):
string
Read Only:
true
The name of the user that rejected the change order. -
reopenByUserName(optional):
string
Read Only:
true
The name of the user that reopened the change order. -
sourceId(optional):
string
Change order data from an external source.
-
status(optional):
string
Read Only:
true
Allowed Values:[ "DRAFT", "PENDING", "APPROVED", "REJECTED", "CLOSED" ]
The status of the change order. -
statusTransitionData(optional):
object ApiEntityCmStatusTransitionData
-
submitByUserName(optional):
string
Read Only:
true
The name of the user that submitted the change order. -
timeChange(optional):
integer(int32)
The amount of time added to or subtracted from the commitment as a result of the change order.
-
toCompanyId(optional):
integer(int64)
Read Only:
true
The company to which the change order was awarded. -
toCompanyName(optional):
string
Read Only:
true
The name of the company the change order is addressed to. -
toCompanySourceId(optional):
string
The unique identifier of company data in an external source.
-
toContactId(optional):
integer(int64)
The person in the Awarded To company who is officially responsible for communications about the change order.
-
toContactUserName(optional):
string
The name of the user associated with the change order's to company.
-
type(optional):
string
Allowed Values:
[ "CONTRACT", "COMMITMENT" ]
Specifies the nature of the link. -
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. -
voidByUser(optional):
string
Read Only:
true
The name of the user that voided the change order. -
withdrawApprovalByUserName(optional):
string
Read Only:
true
The name of the user that withdrew approval of the change order. -
workspaceCode(optional):
string
The user-specified identifier of a workspace.
Nested Schema : ApiEntityChangeOrderConfiguredFields
Type:
Show Source
object
-
changeOrder(optional):
object ApiEntityChangeOrder
-
changeOrderId(optional):
integer(int64)
The system-generated identifier of the change order.
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing cost fields in the form of key-value pairs.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing non-cost and non-text fields in the form of key-value pairs.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesAn object containing text fields in the form of key-value pairs.
-
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 : ApiEntityChangeOrderCost
Type:
Show Source
object
-
changeOrderId(optional):
integer(int64)
Read Only:
true
The system-generated identifier of a change order. -
changeValue(optional):
object Cost
-
changeValueAssociatedAgreement(optional):
object Cost
-
changeValueCommitment(optional):
object Cost
-
changeValueContract(optional):
object Cost
-
changeValueProject(optional):
object Cost
-
changeValueWorkspace1(optional):
object Cost
-
changeValueWorkspace2(optional):
object Cost
-
changeValueWorkspace3(optional):
object Cost
-
link(optional):
string(url)
Read Only:
true
-
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 : ApiEntityCmStatusTransitionData
Type:
Show Source
object
-
approveByUserId(optional):
integer(int64)
The user who approved the agreement, change, or payment application.
-
approveDate(optional):
string(date-time)
The date the agreement, change, or payment application was approved.
-
cancelByUserId(optional):
integer(int64)
The user who cancelled the agreement, change, or payment application.
-
cancelDate(optional):
string(date-time)
The date the agreement, change, or payment application was cancelled.
-
closeByUserId(optional):
integer(int64)
The user who closed the agreement, change order, or payment application.
-
closeDate(optional):
string(date-time)
The date the agreement, change, or payment application was closed.
-
lastStatusTransitionType(optional):
string
Allowed Values:
[ "SUBMIT", "APPROVE", "WITHDRAW_APPROVAL", "CLOSE", "REOPEN", "REJECT", "VOID", "WITHDRAW", "ANSWERED", "NONE" ]
The last status of the agreement, change, or payment application. -
link(optional):
string(url)
Read Only:
true
-
rejectByUserId(optional):
integer(int64)
The user who rejected the agreement, change, or payment application.
-
rejectDate(optional):
string(date-time)
The date when the agreement, change, or payment application was rejected.
-
reopenDate(optional):
string(date-time)
The date when the agreement, change, or payment application was reopened.
-
rreopenByUserId(optional):
integer(int64)
The user who reopened the agreement.
-
statusTransitionId(optional):
integer(int64)
The system-generated identifier of a status transition. This value should not be provided in create operation request data, however, it is required for update requests.
-
submitByUserId(optional):
integer(int64)
The user who submitted the agreement, change, or payment application for approval.
-
submitDate(optional):
string(date-time)
The date the agreement, change, or payment application was submitted for approval.
-
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. -
voidByUserId(optional):
integer(int64)
The user who voided the agreement, change, or payment application.
-
voidDate(optional):
string(date-time)
The date the agreement, change, or payment application was voided.
-
withdrawApprovalByUserId(optional):
integer(int64)
The user who withdrew approval of the agreement, change, or payment application.
-
withdrawApprovalDate(optional):
string(date-time)
The date when approval for the agreement, change, or payment application was withdrawn.
-
withdrawByUserId(optional):
integer(int64)
The user who withdrew the agreement, change, or payment application.
-
withdrawDate(optional):
string(date-time)
The date the agreement, change, or payment application was withdrawn.
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing cost fields in the form of key-value pairs.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing non-cost and non-text fields in the form of key-value pairs.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
An object containing text fields in the form of key-value pairs.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : Cost
Type:
object
204 Response
Successful operation with no content.