# purchase-order-edit-form

## Overview

Form for editing an existing DRAFT purchase order. Header fields (receiving site, order date, external reference) and line items are editable. Supplier is read-only (set at creation). Only accessible when the purchase order status is DRAFT.

Edits are submitted as a single bundled `updatePurchaseOrder` mutation.

## Screen Type

Form

### Form Details

#### Input Fields

| Field Name | Field Type | Required (Yes/No) | Options / Lookup |
| --- | --- | --- | --- |
| Supplier | text (read-only) | Yes | — |
| Currency *(pending — schema gap)* | select | Yes | — |
| Receiving Site | lookup | Yes | Site lookup (Site.name) |
| Order Date | date | No | — |
| External Supplier Order Reference | text | No | — |
| Line Items: Item | lookup | Yes | Item lookup (Item.name, Item.sku) |
| Line Items: Unit | select (disabled) | Yes | Fixed to "ea (Each)" — all items use the "ea" unit |
| Line Items: Quantity | number | Yes | — |
| Line Items: Unit Price | number | Yes | — |

## Access Control

- [purchaser](../actor/purchaser.md)
