bidActuals

Requires permission biddesk:bid:read.

A handed-over bid's estimate against actual cost per cost line and per assembly, the purchase and receipt lines not yet linked, and candidate lines of other orders. Cost figures are null without permission to view costs. Requires Bid Desk and permission to read bids.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

query BidActuals($bidId: ID!) {
  bidActuals(bidId: $bidId) {
    bidId
    costSheetId
    coveragePct
    currency
    lineCount
    matchedLineCount
    assemblies {
      actualCost
      coveragePct
      errorPct
      estimateCost
      lineCount
      matchedLineCount
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidActuals($bidId: ID!) {\n  bidActuals(bidId: $bidId) {\n    bidId\n    costSheetId\n    coveragePct\n    currency\n    lineCount\n    matchedLineCount\n    assemblies {\n      actualCost\n      coveragePct\n      errorPct\n      estimateCost\n      lineCount\n      matchedLineCount\n    }\n  }\n}",
  "variables": {
    "bidId": "id"
  }
}
EOF

Variables:

{
  "bidId": "id"
}

Response:

{
  "data": {
    "bidActuals": {
      "bidId": "id",
      "costSheetId": "id",
      "coveragePct": 0,
      "currency": "string",
      "lineCount": 0,
      "matchedLineCount": 0,
      "assemblies": [
        {
          "actualCost": "string",
          "coveragePct": 0,
          "errorPct": 0,
          "estimateCost": "string",
          "lineCount": 0,
          "matchedLineCount": 0
        }
      ]
    }
  }
}

bidActuals(
  bidId: ID!
): BidActualsSummary!

Arguments

bidActuals.bidId ● ID! non-null scalar

The handed-over won bid.

Type

BidActualsSummary object

A won bid's estimate against actual cost, per line and per assembly.