Skip to main content

AddBidCostLineInput

Adds a sheet-level line (labour, freight, commissioning, an extra item, …) to a DRAFT cost sheet.

input AddBidCostLineInput {
  costCurrency: String
  costSheetId: ID!
  description: String
  evidence: JSON
  expectedVersion: Int!
  fxRate: String
  kind: BidCostLineKind!
  labourSkillKey: String
  manualReason: String
  productId: ID
  quantity: String!
  riskTags: [String!]
  source: BidCostSource
  sourceRef: String
  sourcedAt: DateTime
  unit: String
  unitCost: String
}

Fields​

AddBidCostLineInput.costCurrency ● String scalar​

ISO 4217 code of the unit cost; null means the sheet currency.

AddBidCostLineInput.costSheetId ● ID! non-null scalar​

The DRAFT cost sheet.

AddBidCostLineInput.description ● String scalar​

Free text.

AddBidCostLineInput.evidence ● JSON scalar​

What backs the cost, as an object. Needs permission to view costs.

AddBidCostLineInput.expectedVersion ● Int! non-null scalar​

The sheet's rowVersion you loaded.

AddBidCostLineInput.fxRate ● String scalar​

The exchange rate from costCurrency to the sheet currency: an exact decimal string, at most 8 decimal places. Required when costCurrency differs from the sheet currency, refused when it does not.

AddBidCostLineInput.kind ● BidCostLineKind! non-null enum​

What the line costs.

AddBidCostLineInput.labourSkillKey ● String scalar​

For a LABOUR line, a skill key of the cost model's labour rates.

AddBidCostLineInput.manualReason ● String scalar​

Why the cost was entered by hand; required when source is MANUAL. Needs permission to view costs.

AddBidCostLineInput.productId ● ID scalar​

A product of the organization the line costs.

AddBidCostLineInput.quantity ● String! non-null scalar​

The quantity: an exact decimal string, at most 6 decimal places, not negative.

AddBidCostLineInput.riskTags ● [String!] list scalar​

Risk tags on the line (replaces the list).

AddBidCostLineInput.source ● BidCostSource enum​

Where the unit cost came from.

AddBidCostLineInput.sourceRef ● String scalar​

What the source names (a purchase order, a vendor quote, …).

AddBidCostLineInput.sourcedAt ● DateTime scalar​

When the cost was sourced.

AddBidCostLineInput.unit ● String scalar​

A unit label.

AddBidCostLineInput.unitCost ● String scalar​

The cost of one unit in costCurrency: an exact decimal string, at most 4 decimal places, not negative. Null clears it (a missing cost). Needs permission to view costs.

Member Of​

addBidCostLine mutation