Skip to main content

Managing Production Orders

How to edit, start, complete, and cancel production orders after creation.

Editing a Production Order​

All fields are editable while the order is in draft or in progress status.

Completed and cancelled orders are fully read-only.

Status Progression​

Draft → In Progress (Start)​

Click Start order on the detail page. The backend requires the order to be in draft status — any other status throws an error.

What happens on start:

  • Order status changes to in_progress
  • If syncProductionOrderToShopify is not explicitly set on the order, the shop-level default is read and applied at this point

In Progress → Completed (Complete)​

Click Mark complete on the detail page. The backend requires the order to be in in_progress status — any other status throws an error.

What happens on completion:

  1. Order status is set to completed
  2. completedAt timestamp is recorded
  3. For every component: quantityPlanned is overwritten with quantityProduced — the planned quantity is reconciled to what was actually produced
  4. Completed orders are fully read-only

Cancelling a Production Order​

Available from draft or in progress status only. Attempting to cancel a completed or already-cancelled order throws an error.

What happens on cancellation:

Previous statusComponent behaviour
DraftAll components are deleted
In progressComponents are preserved for reference
In both cases the order status is set to cancelled.

Status Reference​

StatusEditableAvailable actions
Draft✅ All fieldsStart, Cancel
In progress✅ All fieldsMark complete, Cancel
Completed❌ Read-onlyNone
Cancelled❌ Read-onlyNone

Component Quantities​

Each component row on a production order tracks two quantities:

FieldMeaning
Planned qtyHow many units are planned for this component
Produced qtyHow many units were actually produced (editable while in progress)
When the order is completed, quantityPlanned is set equal to
quantityProduced on every component, so the final record reflects
actuals only.