Production Order

API: ProductionOrder

Main entity for manufacturing control.

Fields

Field	Type	Required	ReadOnly	Notes
referenceIdentifier	varchar			Auto-sequence VP-{YY}-{number} when empty.
name	varchar	✓		Order title.
status	enum			Lifecycle status (see below).
product	link			Manufactured product (Product entity).
productionModel	link		✓	Selected routing/BOM; locked after creation.
operations	linkMultiple			Execution operations derived from the model; ordered list.
billOfMaterials	linkMultiple			Material/components (ProductionModelItem).
productWarehouse	link	✓		Target warehouse for finished goods.
productWarehousePosition	link			Storage position.
quantityPlanned	floatWithUnit			Planned quantity (default 1).
quantitySparePart	floatWithUnit	✓		Planned spare-part quantity.
quantityNotSparePart	floatWithUnit	✓		Planned main quantity.
quantityProduced	floatWithUnit		✓	Auto-updated from receipts.
surface	floatWithUnit			Optional area value.
startDate, endDate	date			Planning dates.
materialReadinessDate	date			Required material availability date.
gateA, gateA1, gateB, gateB1, gateD1, gateE, gateE1, gateF, gateF1	date			Milestones (BASE/Detail design, material readiness, production, delivery).
gateModel	link			Gate template providing planned dates.
g030Ctrl	varchar			Material readiness control flag (On-hold/Open).
skipProductReceipt	bool			Skip automatic receipt of main product.
autoProcessStockPutOperation	bool			If enabled, completing operation code 999 auto-creates receipt and updates produced quantity.
isChildOrder	bool			Marks sub-orders spawned from a parent.
allOperationsCompleted	bool		✓	True when every operation is done.
totalProductionCost	currency		✓	Sum of material, labor and cooperation costs.
totalMaterialCost	currency		✓	From Goods Issues.
totalLaborCost	currency		✓	From Work Performed.
totalCooperationCost	currency		✓	From supplier invoices linked to cooperations.
cooperations	linkMultiple			Outsourced steps tied to the order.
productSerials	linkMultiple			Serials generated/assigned to produced pieces.
attachments, bomFiles, electroBomFiles	attachmentMultiple			Technical documents (mechanical/electrical BOM).
tree	base			Visual production tree.
qrCode	barcode			QR code for shop-floor scanning.
lastImportWarnings	wysiwyg		✓	BOM import warnings.
assignedUser	link	✓		Responsible planner.
teams	linkMultiple			ACL teams.
createdAt, createdBy, modifiedAt, modifiedBy	datetime/link		✓	Audit metadata.

Enum Values status

Value	Description	Color	Icon
Draft	Work in progress	default	fa-edit
Planned	Planned	info	fa-calendar-check
Ongoing	In progress	warning	fa-play-circle
Completed	Completed	success	fa-check-circle
Canceled	Canceled	danger	fa-times-circle
Open	Open	default	fa-folder-open
On-Hold	On hold	default	fa-pause-circle

Gate Fields

Field	Type	Description
gateA	date	BASE Design start.
gateA1	date	Calculated BASE Design finish.
gateB	date	Detail Design start.
gateB1	date	Calculated Detail Design finish.
gateD1	date	Calculated date when all material must be ready.
materialReadinessDate	date	Manually required material readiness date.
gateE	date	Production / internal acceptance start.
gateE1	date	Calculated production finish.
gateF	date	Adjustments / final acceptance start.
gateF1	date	Calculated final acceptance finish.
gateModel	link	Gate model providing planned dates.

Relationships

Relationship	Type	Target Entity
product	belongsTo	Product
productionModel	belongsTo	ProductionModel
productWarehouse	belongsTo	Warehouse
productWarehousePosition	belongsTo	WarehousePosition
operations	hasChildren	ProductionModelOperation
billOfMaterials	hasChildren	ProductionModelItem
worksPerformed	hasChildren	WorkPerformed
cooperations	hasMany	Cooperation
cooperationItems	hasChildren	CooperationItem
productSerials	hasMany	ProductSerial
goodsIssues	hasMany	GoodsIssue
goodsReceipts	hasMany	GoodsReceipt
goodsRestocks	hasMany	GoodsRestock
deliveryNoteItems	hasMany	DeliveryNoteItem
receivedDeliveryNotes	hasMany	ReceivedDeliveryNote
gateModel	belongsTo	GateModel
productionModelItem	belongsTo	ProductionModelItem
parentProductionOrder	belongsTo	ProductionOrder (parent)
assignedUser, createdBy, modifiedBy	belongsTo	User
teams	hasMany	Team
attachments, bomFiles, electroBomFiles	hasChildren	Attachment

---