manufacturingOrdersUpdate
Updates a manufacturing order.
Business Rules
- Omitted fields remain unchanged; null clears a nullable field.
- The building and outputs can change only in Draft. A Draft can remove its last output.
- A Draft output can have a planned quantity of 0. Every output needs a quantity before the order is allocated.
- An added output, one changed to another product, or one whose planned quantity changes from 0 to a positive quantity gets the product’s latest per-unit labor and packaging costs times the planned quantity. Other outputs keep their costs.
- Each output has its own location for finished goods. An added output starts at the order’s destination. The order’s destination applies to every output not yet complete; output locations set individual outputs and take precedence.
- Locations can change in Draft, Allocated, and In Production. They must be active locations in the order’s building. A completed output’s location cannot change.
- A location that is cleared, or left out when the building changes, becomes the building’s Default Available location.
- Actual Start can change only in In Production and Completed, cannot be cleared, and cannot be after the earliest line completion date. Saving its current value is always accepted.
- The lot number is trimmed, and a blank one is stored as null. It can be up to 100 characters, and instructions up to 20,000.
- Expected Completion cannot be before Expected Start.
- Both manufacturing and supply chain entitlements are required.
Error Scenarios
- “Manufacturing orders are not enabled for this company”
- “Manufacturing order not found.”
- “This manufacturing order cannot be edited.” when it is Closed or Canceled.
- “Outputs and building can only change in Draft.”
- “SKU: the planned quantity cannot be negative.”
- “This manufacturing order changed. Reload and try again.”
- “Undo the completion to change where finished goods went.”
- “Choose an active location in Building to put finished goods into.”
- “Actual Start can be edited only while the order is In Production or Completed.”
- “Actual Start can’t be after Actual Completion.”
- “Enter the date production started.”
- “Lot number must be 100 characters or fewer.”
- “Instructions must be 20,000 characters or fewer.”
- “Expected Completion can’t be before Expected Start.”
- “parsec” isn’t a unit we recognize. (Units are matched by name, label, or symbol, ignoring case.)
- “The last undo of SKU did not finish. Undo it again to finish it.”
Permissions Required
manufacturing:update_orders
manufacturingOrdersUpdate(
input: ManufacturingOrdersUpdateInput!
): ManufacturingOrder!
Arguments
manufacturingOrdersUpdate.input ● ManufacturingOrdersUpdateInput! non-null input common
Parameters for ManufacturingOrdersUpdate
Type
ManufacturingOrder object manufacturing
An order to make finished products at a building.