useBidPriceRequestAnswer
Requires permission biddesk:cost_sheet:edit.
Uses a vendor's answer as its cost line's vendor quote: the line takes the answer's unit price and currency (at the recorded exchange rate when it differs from the sheet's), source VENDOR_QUOTE and the answer as evidence; then the price request closes on that vendor. Refused with PRICE_ANSWER_NOT_ANSWERED, PRICE_ANSWER_EXPIRED, PRICE_ANSWER_REQUEST_NOT_OPEN, PRICE_ANSWER_LINE_MISMATCH, PRICE_ANSWER_UNIT_MISMATCH, NO_RATE, COST_SHEET_LOCKED or VERSION_CONFLICT. Requires Bid Desk, permission to edit cost sheets and permission to view costs.
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
- cURL
mutation UseBidPriceRequestAnswer($input: UseBidPriceRequestAnswerInput!) {
useBidPriceRequestAnswer(input: $input) {
id
costCurrency
description
evidence
fxRate
kind
}
}
curl -X POST "https://<api-host>/graphql" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data @- <<'EOF'
{
"query": "mutation UseBidPriceRequestAnswer($input: UseBidPriceRequestAnswerInput!) {\n useBidPriceRequestAnswer(input: $input) {\n id\n costCurrency\n description\n evidence\n fxRate\n kind\n }\n}",
"variables": {
"input": {
"costLineExpectedVersion": 0,
"costLineId": "id",
"requestExpectedVersion": 0,
"vendorId": "id"
}
}
}
EOF
Variables:
{
"input": {
"costLineExpectedVersion": 0,
"costLineId": "id",
"requestExpectedVersion": 0,
"vendorId": "id"
}
}
Response:
{
"data": {
"useBidPriceRequestAnswer": {
"id": "id",
"costCurrency": "string",
"description": "string",
"evidence": {},
"fxRate": "string",
"kind": "COMMISSIONING"
}
}
}
useBidPriceRequestAnswer(
input: UseBidPriceRequestAnswerInput!
): BidCostLine!
Arguments
useBidPriceRequestAnswer.input ● UseBidPriceRequestAnswerInput! non-null input
The answer, the line and both versions.
Type
BidCostLine object
One line of a bid cost sheet: an item of the frozen configuration, or a sheet-level line (labour, freight, …). Its unit cost, evidence and manual reason are null for a caller without permission to view costs. Totals are not computed here.