---
id: SCR-COM-ORD-006
title: Cancel lines
route: '/console/{tenantId}/orders/{orderId} (Cancel Lines dialog)'
surface: console
product_area: commerce
module: orders
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
purpose: >-
  Choose cancellation quantities, review the resulting charges and settlement, then confirm and follow the
  request.
supports:
  - JNY-COM-ORD-005
  - CAP-COM-ORD-014
permission: commerce.cancellations.create
entry_from:
  - Order 360 header or Changes tab (Cancel Lines)
exits_to:
  - Order 360 Changes tab (the cancellation's card)
displays:
  - field: Cancellable lines with quantities left
    source: Order 360 lines
  - field: 'The plan (per-line outcome, fees, what the customer gets, approval needed, overridable)'
    source: requestCancellation answer (a document evaluated without execution)
  - field: Run steps and exceptions
    source: requestCancellation with execution
actions:
  - label: Calculate the cancellation proposal
    operation_id: requestCancellation
    permission: commerce.cancellations.create
    confirm: false
  - label: Administrators can bypass a deadline
    operation_id: requestCancellation
    permission: commerce.cancellations.override
    confirm: false
  - label: Confirm the proposed cancellation with an explanation
    operation_id: requestCancellation
    permission: commerce.cancellations.create
    confirm: true
  - label: Withdraw the earlier proposal
    operation_id: withdrawCancellation
    permission: commerce.cancellations.update
    confirm: false
states:
  - loading
  - error
  - inactive
validation:
  - BR-CAP-COM-ORD-014-01
  - BR-CAP-COM-ORD-014-07
  - BR-CAP-COM-ORD-014-08
  - BR-CAP-COM-ORD-014-09
  - BR-CAP-COM-ORD-014-15
patterns:
  - >-
    design-system Dialog with stages (choose, plan, running, outcome), Checkbox, Input, Switch, Progress and
    Alert
  - plan lines and facts parts shared with the Order 360 cards
component: components/commerce/order-flows/cancel-lines-dialog.tsx
evidence:
  - >-
    react-console at baf6dae3: components/commerce/order-flows/cancel-lines-dialog.tsx;
    lib/commerce/order-flows/live.ts (cancellationPlan, cancel, withdrawPreview).
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-PI-005, TC-PRV-001, TC-PRV-002]
---

# Cancel lines

## What the Screen Is For

Staff review the consequences of cancelling selected quantities before committing the change.

## What It Shows and Lets People Do

Selection leads to a service-evaluated plan with line outcomes, charges, return value, approval requirements and possible administrator override. Reasoned confirmation follows execution and displays progress or the resulting approval wait.

## States and Errors

All-denied plans cannot be confirmed and carrier-handed goods require return. Stale facts trigger refresh. Preview creates a real cancellation document; dismissing the dialog does not withdraw it, and only a later preview in the retained session replaces it.

## Patterns It Must Respect

The staged dialog shares plan facts and card presentation. Monetary values come from the service evaluation rather than screen arithmetic.