Closeout

Accubid Anywhere Closeout API

Closeout

The Anywhere Closeout API is used to retrieve the details for the Anywhere Closeout screens.

Pre-requisites

In order to use the API the user:

  • Must be permissioned in the Accubid Anywhere Manager for “API Data Access” (“Full” permission).

  • Must be successfully authenticated via Trimble ID.

  • Retrieve a database token from the Anywhere Database API.

Use Cases

Retrieve List of Bid Breakdown Views

This API allows you to get the list of Bid Breakdown Views of a specific estimate that the user has access to.

Retrieve Bid Breakdown Details

This API allows you to get the Bid Breakdown details of specific Bid Summary and Bid Breakdown View that the user has access to.

Retrieve Final Price Details

This API allows you to get the final price details of a specific bidsummary that the user has access to.

Concepts

  • Database - The user requires a database token in order to use the closeout API
  • Project - The user requires a project ID in order to retrieve a list of estimates (for that project)
  • Estimate - The user requires an estimate ID in order to retrieve a list of bidsummaries (for that estimate)

Dependencies

  • Anywhere Database API - In order to use the Closeout API you will require database tokens from the Anywhere Database API.
  • Anywhere Project API - In order to use the Closeout API you will require Project IDs from the Anywhere Project API.
  • Anywhere Estimate API - In order to use the Closeout API you will require Bidsummary IDs from the Anywhere Estimate API.

Getting Started

  • Follow the below instructions regarding authorization
  • Follow the instructions regarding authenticating with Trimble Identity.
  • Call the database list API to return a list of database names and tokens. Note - database tokens do not change, so they can be saved for future use.
  • Call the project list API to return a list of project names and IDs. Note - Project IDs do not change, so they can be saved for future use.
  • Call the estimate list API to return a list of estimate names and IDs. Note - Estimate IDs do not change, so they can be saved for future use.
  • Call the estimate info API to return a list of Bid Summary IDs. Note - Bid Summaries IDs do not change, so they can be saved for future use.
  • Call the Bid Breakdown Views list API to return a list of Bid Breakdown View names and IDs. Note - Bid Breakdown View IDs do not change, so they can be saved for future use.

Example Error message table

Please see below table containing the list of currently used error codes

CodeDescription
200The request was successful
400Parameter(s) are invalid
401Request could not be authorized
403Request was explicitly forbidden, user does not have access to database
404A required reference was not found
409Conflict. Database is locked please try again later