ACC Cost Management: new APIs to get Taxes and batch create Cost Items

We are pleased to announce 2 new enhancements for ACC Cost Management APIs. 

Taxes

Taxes within Cost Management is a high requested API feature, we are happy to inform that you can now READ the taxes information for specific cost objects, including contracts, main contracts, change orders, cost items, expenses, and payments.

Here is the endpoint: GET https://developer.api.autodesk.com/cost/v1/containers/:containerId/taxes, and some tips when you are using this API.

1. You can get taxes for multiple cost objects by specifying multiple IDs of associationId in query parameters. for example, you can input 2 contract ids separated by comma like: GET https://developer.api.autodesk.com/cost/v1/containers/2f38ddca-0bb2-4907-9047-85add2ba658a/taxes?associationId=9f6e02f8-4145-496b-a501-38d8559aa0f2,42cba220-dc87-11ec-bcfa-796c9a2f5036&associationType=Contract
2. The results in response body is an array of tax formulas for all the given cost objects specified by associationId as mentioned above. But if the cost object does not have any tax formula associated with, there will be NO tax formula in the array of results. In other words, you can simply check if there is a tax formula object for the cost object in the response body results, if you don't find it, it means this cost object does not have any tax formula associated with.
3. There is taxFormulaId in the response body which is marked as "Not relevant". This is because tax formula definition is currently not supported by Cost Management API yet, you can not get the details of tax formula definition by the taxFormulaId.

BATCH Create Cost Items

Based on the request, Cost Management provided a new POST endpoint as follow to support creating multiple cost items to a project within a single request, it can support up to 200 cost items per one request.

Here is the endpoint: POST https://developer.api.autodesk.com/cost/v1/containers/:containerId/cost-items:batch-create.

For the detail of the above enhancements, please take a look at the change log.