2
0
mirror of https://github.com/inventree/InvenTree.git synced 2025-12-16 09:18:10 +00:00
Files
InvenTree/docs/docs/manufacturing/output.md
Oliver 5743e22501 Partial build output complete (#10499)
* Handle partial completion of build output

* Add 'quantity' field to BuildOutputComplete API endpoint

* Allow partial scrapping of build outputs

* Adjust column text

* Adjust "complete build output" form

* Change order of operations when completing build output

- Run validation checks *before* potentially splitting stock item

* Extract quantity from serializer

* Documentation

- Update screenshots
- Add note on partial completion
- Add note on partial scrapping

* Update CHANGELOG.md

* Update API version

* Add unit test for partial scrapping

* Tweak text

* Unit test for partial output completion

* Fix validation check for quantity field

* Adjust playwright tests
2025-10-06 14:30:07 +11:00

6.1 KiB

title
title
Build Outputs

Build Outputs

With reference to a build order, a Build Output is a finished product which is expected to be produced by completing the order.

  • A single build order may have multiple build outputs which are produced at different times or by different operators.
  • An individual build output may be a single unit, or a batch of units
  • Serial numbers and batch codes can be associated with a build output

Incomplete Outputs

The Incomplete Outputs tab displays any outstanding / in-progress build outputs for the current build order.

{{ image("build/build_outputs_incomplete.png", "Incomplete build outputs") }}

Completed Outputs

The Completed Outputs tab displays any completed or scrapped outputs for the current build order.

{{ image("build/build_outputs_complete.png", "Completed build outputs") }}

Create Build Output

Create a new build output by pressing the {{ icon("plus-circle") }} New Build Output button under the incomplete outputs tab:

{{ image("build/build_output_create.png", "Create build output") }}

Create Options

The following options are available when creating a new build output:

Option Description
Quantity The number of items to create as part of this build output
Serial Numbers If this is a tracked build output, the serial numbers for each of the generated outputs
Batch Code Batch code identifier for the generated output(s)
Auto Allocate Serial Numbers If selected, any available tracked subcomponents which already have serial numbers assigned, will be automatically assigned to matching build outputs

Specifying Serial Numbers

Refer to the serial number generation guide for further information on serial number input.

Complete Build Output

Completing a build output marks that output as finished, in the context of the given build order.

An individual build output is completed by selecting the "Complete build output" button associated with that build output:

{{ image("build/build_output_complete.png", "Complete build output") }}

Here the user can select the destination location for the build output, as well as the stock item status.

Marking the build output(s) as complete performs the following actions:

  • The completed build quantity is increased by the quantity of the selected build output(s)
  • The build output(s) are marked as "completed", and available for stock actions
  • Any tracked BOM items which are allocated to the build output are installed into that build output.

Complete Options

The following options are available when completing a build output:

Option Description
Status The stock status for the completed outputs
Location The stock location where the outputs will be located
Notes Any additional notes associated with the completion of these outputs
Accept Incomplete Allocation If selected, this option allows tracked build outputs to be completed in the case where required BOM items have not been fully allocated

Partial Completion

A build output may be partially completed by specifying a quantity less than the total quantity of that build output. In such a case, the following actions are performed:

  • The incomplete build output is "split" into two separate build outputs
  • The specified quantity is marked as completed, and the completed build quantity is increased accordingly
  • The remaining quantity is left as an incomplete build output, available for future completion

!!! note "Serialized Outputs" Serialized build outputs cannot be partially completed.

Scrap Build Output

Scrapping a build output marks the particular output as rejected, in the context of the given build order.

An individual build output is completed by selecting the Scrap build output button associated with that build output:

{{ image("build/build_output_scrap.png", "Scrap build output") }}

Marking the build output(s) as scrapped performs the following actions:

  • The build outputs are marked as "rejected" and removed from the build
  • The completed build quantity does not increase
  • The build outputs are not available for any further stock actions
  • Optionally, any tracked BOM items which are allocated to the build output are installed into the rejected build output

Scrap Options

The following options are available when scrapping a build order:

Option Description
Location The stock location where the scrapped build output(s) will be located
Notes Any additional notes associated with the scrapping of these outputs
Discard Allocations If selected, any installed BOM items will be removed first, before marking the build output as scrapped. Use this option if the installed items are recoverable and can be used elsewhere

Partial Scrapping

A build output may be partially scrapped by specifying a quantity less than the total quantity of that build output. In such a case, the following actions are performed:

  • The incomplete build output is "split" into two separate build outputs
  • The specified quantity is marked as scrapped, and the completed build quantity is not increased
  • The remaining quantity is left as an incomplete build output, available for future completion

!!! note "Serialized Outputs" Serialized build outputs cannot be partially scrapped.

Cancel Build Output

Cancelling a build output causes the build output to be deleted, and removed from the database entirely. Use this option when the build output does not physically exist (or was never built) and should not be tracked in the database.

{{ image("build/build_output_delete.png", "Cancel build output") }}

Marking the build output(s) as cancelled performs the following actions:

  • Any allocated stock items are returned to stock
  • The build output is removed from the database