# purchase-order-amend-form

## Overview

Form for amending an ORDERED purchase order. The purchaser selects per-line actions (MODIFY, REMOVE, or KEEP for existing lines), adds new lines (ADD), and optionally provides an amendment reason. Submitting the form calls `amendOrderedPurchaseOrder`, which increments the PO's revisionNumber and creates PurchaseOrderLineRevision records for audit history. Only accessible when the purchase order status is ORDERED.

## Screen Type

Form

### Form Details

#### Input Fields

| Field Name | Field Type | Required (Yes/No) | Options / Lookup |
| --- | --- | --- | --- |
| Amendment Reason | text (multiline) | No | — |
| Line Items: Action | select (MODIFY / REMOVE / KEEP) | Yes | MODIFY, REMOVE, KEEP |
| Line Items: Item | text (read-only for existing) / lookup (ADD) | Yes | Item lookup (Item.name, Item.sku) |
| Line Items: Unit | text (read-only for existing) / select (disabled for ADD) | Yes | Fixed to "ea (Each)" — all items use the "ea" unit |
| Line Items: Quantity | number | Yes | — |
| Line Items: Unit Price | number | Yes | — |
| Line Items: Receiving Site | lookup | No | Site lookup (Site.name) |

## Access Control

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