Purchase orders

Draft

A manager creates a PO from /dashboard/inventory/purchase-orders/new or from a reorder rule notification. Lines are added with material + quantity + unit price (auto-filled from material_suppliers.default_price_per_m2 if available).

Send

Click Send to supplier to:

• Transition status to sent
• Email the supplier the PO PDF (rendered server-side)
• Lock further line edits — corrections after this require cancel + redraft

Receive (full)

When the truck arrives and everything is on it, click Receive all. The system:

1. Sets quantity_received_m2 = quantity_ordered_m2 for every line
2. Creates one inventory.rolls row per line (or per sub-line for split shipments)
3. Sets status to received, populates received_at
4. Writes a row to inventory.price_history for each line
5. Generates barcode labels for the new rolls

Receive (partial)

If only part of the shipment arrived, click Receive partial, enter the received quantity per line, and confirm. The system:

1. Updates quantity_received_m2 to the new value
2. Creates inventory.rolls only for the received quantity
3. Sets status to partially_received
4. Leaves the line open for future receipts against the same PO

A PO can be partially received multiple times. The status flips to received only when every line is fully received.

Cancel

Drafts can be cancelled freely. Sent POs can be cancelled with a note (recorded in admin.admin_activity_log). Received POs cannot be cancelled — corrections require a new PO with negative quantities.