BizKitHub
DocsAPI ReferenceWarehouse Production/bff/warehouse/production/bom/save

/bff/warehouse/production/bom/save

Whole-list replace. Duplicate components / labour types are merged. Existing production orders are not affected.

Warehouse productionpostBffWarehouseProductionBomSave

Parameters

JSON body

Request body

application/json
productCodestringRequired
productVariantCodestring | nullOptional

Save a variant-specific BOM; omit for the product BOM.

One of 2:
Variant 1
string
Variant 2
null
productionYieldnumber | nullOptional

Units one run produces (stored on the product). Null = 1. Omit to keep.

One of 2:
Variant 1
number
Variant 2
null
linesobject[]Required
Each array item:
kind"material" | "labour"Required
componentProductCodestring | nullOptional

Material: component product code.

One of 2:
Variant 1
string
Variant 2
null
componentVariantCodestring | nullOptional

Material: component variant code.

One of 2:
Variant 1
string
Variant 2
null
labourTypeIdnumber | nullOptional

Labour: labour type id.

One of 2:
Variant 1
number
Variant 2
null
quantitynumberRequired

Per run: units of the component (≤ 3 decimals) or hours.

notestring | nullOptional
One of 2:
Variant 1
string
Variant 2
null

Response schema

1 status code documented

200Success
productobjectRequired
productIdnumberRequired
productVariantIdnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
productCodestringRequired
variantCodestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
labelstringRequired
stockUnitstring | nullRequired

Stock unit ("m", "ks", …). NULL = pieces.

One of 2:
Variant 1
string
Variant 2
null
trackLotsbooleanRequired
costnumber | nullRequired

Catalogue cost (variant.cost ?? product.cost).

One of 2:
Variant 1
number
Variant 2
null
productionYieldnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
yieldPerRunnumberRequired

Units one BOM run produces.

linesobject[]Required
Each array item:
idnumberRequired
kind"material" | "labour"Required
positionnumberRequired
quantitynumberRequired

Per run: units of the component, or labour hours.

notestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
componentobject | nullRequired
One of 2:
Variant 1
productIdnumberRequired
productVariantIdnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
productCodestringRequired
variantCodestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
labelstringRequired
stockUnitstring | nullRequired

Stock unit ("m", "ks", …). NULL = pieces.

One of 2:
Variant 1
string
Variant 2
null
trackLotsbooleanRequired
costnumber | nullRequired

Catalogue cost (variant.cost ?? product.cost).

One of 2:
Variant 1
number
Variant 2
null
productionYieldnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
Variant 2
null
labourTypeobject | nullRequired
One of 2:
Variant 1
idnumberRequired
codestringRequired
namestringRequired
hourlyRatenumberRequired

Per hour, organisation default currency.

notestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
Variant 2
null
estimatedUnitCostnumberRequired

Estimate per produced unit from catalogue costs + labour rates.

estimateIncompletebooleanRequired

Some material has no catalogue cost; the estimate is too low.

Response example

application/json
{
  "product": {
    "productId": 0,
    "productCode": "example_productCode",
    "label": "example_label",
    "trackLots": false
  },
  "yieldPerRun": 0,
  "lines": [
    {
      "id": 0,
      "position": 0,
      "quantity": 0
    }
  ],
  "estimatedUnitCost": 0,
  "estimateIncomplete": false
}

Request example

POST /bff/warehouse/production/bom/save

post
curl -X POST "https://api.bizkithub.com/bff/warehouse/production/bom/save" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "productCode": "example_productCode",
  "lines": [
    {
      "quantity": 0
    }
  ]
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key