---
id: SCR-COM-ORD-008
title: Amend a purchase
route: '/console/{tenantId}/orders/{orderId} (Amend dialog)'
surface: console
product_area: commerce
module: orders
revision: 1
status: draft
design_intent: proposed
implementation_evidence: partially-observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
purpose: Compare an available replacement with the original purchase and submit its financial difference.
supports:
  - CAP-COM-ORD-015
permission: commerce.amendments.create
entry_from:
  - 'Order 360 header or Changes tab (Amend), shown only when the adapter declares amendment options'
exits_to:
  - Order 360 Changes tab (the amendment's card)
displays:
  - field: The options a line can change to
    source: none in live mode (the live adapter declares no amendment options)
  - field: 'Current against proposed with the unused credit, new value, fee and net'
    source: requestAmendment answer
actions:
  - label: Calculate the proposed amendment
    operation_id: requestAmendment
    permission: commerce.amendments.create
    confirm: false
  - label: Submit the proposed amendment
    operation_id: executeAmendment
    permission: commerce.amendments.create
    confirm: true
states:
  - loading
  - error
  - inactive
validation:
  - BR-CAP-COM-ORD-015-05
  - BR-CAP-COM-ORD-015-06
patterns:
  - 'design-system Dialog, RadioGroup and Alert'
component: components/commerce/order-flows/amend-dialog.tsx
evidence:
  - >-
    react-console at baf6dae3: components/commerce/order-flows/amend-dialog.tsx;
    lib/commerce/order-flows/live.ts (capabilities.amendLine false);
    components/record-views/cards/order/order-actions.tsx.
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-CRY-001, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-003, TC-PRV-001, TC-PRV-002]
---

# Amend a purchase

## What the Screen Is For

The existing amendment dialog compares a permitted replacement and submits a purchase change.

## What It Shows and Lets People Do

The baseline obtains options through its adapter, compares original and proposed value and shows credit, replacement value, fee and net. Live mode has no options provider, so the action is hidden. The adapter includes preview and submit logic, but that does not make the staff flow reachable.

## States and Errors

Seller refusals and approval needs follow adapter results, with loading, request failure and stale-state feedback.

## Patterns It Must Respect

The existing dialog is retained. Live enablement requires a supported source of replacement options.