Create a Potential Change Order (PCO)

Creating a potential change order (PCO) is the beginning of the change process in BIM 360 cost management. This tutorial demonstrates how to create a PCO for a project.

Before You Begin

• Register an app
• Acquire a 3-legged OAuth token with the data:write scope.
• Verify that you have access to the relevant BIM 360 account and BIM 360 project.
• Retrieve the project ID for your project. To obtain a project ID, use GET projects.

Step 1: Create a PCO

Use the container ID you retrieved in the first tutorial (be00f32e-c03c-4c7b-9ec4-d2614bf1980c in this example) to call POST change-orders/pco.

Request

curl "https://developer.api.autodesk.com/cost/v1/containers/be00f32e-c03c-4c7b-9ec4-d2614bf1980c/change-orders/pco" -d '{
  "name":"Revised Main Entrance Layout per ASI 002",
  "description": "Revised Main Entrance Layout per ASI 002",
  "scope":"out",
  "type":"Owner Change Order",
  "sourceType":"ASI",
  "sourceRef": "ASI 002"
}' -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer XZvCJNhdxESsBRIH28MfLf2hKL5O"

Response

{
  "id": "f5c7869f-faa1-4418-b8e6-e7c23c495560",
  "number": "(0001)",
  "name": "Revised Main Entrance Layout per ASI002",
  "scope": "out",
  "description": "Revised Main Entrance Layout per ASI 002",
  "estimated": 0,
  "proposed": 0,
  "submitted": 0,
  "approved": 0,
  "committed": 0,
  "properties": [{
    "name": "Source Type",
    "value": "ASI",
  }, {
    "name": "Source Ref",
    "value": "ASI 002",
  }, {
    "name": "Type",
    "value": "Owner Change Order",
  }]
}

This example returns the PCO ID f5c7869f-faa1-4418-b8e6-e7c23c495560. You can use a PCO ID later to get the latest status of the PCO. For example, for this ID you would call GET change-orders/pco/f5c7869f-faa1-4418-b8e6-e7c23c495560.

Step 2: Create a Cost Item

You can create cost items to break down change if necessary. Use the container ID you used before (be00f32e-c03c-4c7b-9ec4-d2614bf1980c) and the PCO ID you just retrieved (f5c7869f-faa1-4418-b8e6-e7c23c495560) to call POST cost-items.

Request

curl "https://developer.api.autodesk.com/cost/v1/containers/be00f32e-c03c-4c7b-9ec4-d2614bf1980c/cost-items" -d '{
  "name":"Revised Main Entrance Layout per ASI 002 - Labor",
  "description": "Labor",
  "changeOrderId": "f5c7869f-faa1-4418-b8e6-e7c23c495560"
}' -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer XZvCJNhdxESsBRIH28MfLf2hKL5O"

Response

{
  "id": "f5c7869f-faa1-4418-b8e6-e7c23c495560",
  "number": "0001",
  "name": "Revised Main Entrance Layout per ASI 002 - Labor",
  "scope": "out",
  "description": "Labor",
  "estimated": 0,
  "proposed": 0,
  "submitted": 0,
  "approved": 0,
  "committed": 0,
}

To create more cost items for this PCO, repeat step 2.

Congratulations! You have created a PCO with a cost item in BIM 360 cost management. A cost engineer can use this to start the change process in cost management. It allows you to estimate, quote and review the changes. Later you can call GET change-orders/pco/f5c7869f-faa1-4418-b8e6-e7c23c495560 to get the latest status and cost(estimated, proposed, submitted, approved, committed) of this change.

Imported from the Autodesk Platform Services documentation: https://aps.autodesk.com/en/docs/acc/v1/tutorials/cost/create-pco.