The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | /console/{tenantId}/crm/contacts/{id}/orders/new | Choose Create Order on the customer’s contact record. | CAP-COM-ORD-001 | The composer uses that contact and the CRM address, and identifies the policy governing the new cart. | test react-console:components/order-composer/__tests__/new-order-screen.test.tsx#renders the workspace with the contact as the bill-to customer and the address CRM holds |
| 2 | addCheckoutItem | Select one Style Guide from the store. | CAP-COM-ORD-001 | Item validation completes and the cart contains the selected product. | test services-commerce:modules/checkout/tests/e2e/checkouts.e2e.spec.js#adds after the last, changes the intent and clears what was advised, removes, each bumping the version |
| 3 | previewCheckout | Review the purchase preview. | CAP-COM-ORD-003 | The displayed price, tax and total match Commerce’s response. | test react-console:components/order-composer/__tests__/live-composer.test.tsx#shows exactly the figures Commerce's preview answered |
| 4 | applyCheckoutPromotionCode | Submit the customer’s promotion code. | CAP-COM-ORD-004 | An accepted code displays its discount and promotion name; a refused code explains the refusal without changing the total. | test react-console:components/order-composer/__tests__/live-composer.test.tsx#applies a code Commerce accepts and shows what it took off |
| 5 | placeCheckout | Submit the cart for placement. | CAP-COM-ORD-005 | The sale receives an order number and a pay-now deadline while billing remains pending. | test services-commerce:modules/checkout/tests/e2e/placement.e2e.spec.js#answers 200 with the order: numbered 10000, placed, pending billing, pay now with a thirty-minute tender window, created |
| 6 | tenderOrder | Enter the first card through Accounting’s payment window. | CAP-COM-ORD-007 | A decline leaves the placed purchase available for another payment attempt. | test services-commerce:modules/orders/tests/e2e/billing-and-tender.e2e.spec.js#answers 200 declined with the processor’s code, the order still placed with its pro forma, the attempt declined |
| 7 | tenderOrder | Submit the replacement card. | CAP-COM-ORD-007 | The successful attempt pays the purchase in full and acceptance follows, with a single charge for that attempt. | test services-commerce:modules/orders/tests/e2e/billing-and-tender.e2e.spec.js#accepts the order on the next attempt, under the next sequence and key |
| 8 | /console/{tenantId}/orders/{orderId} | Inspect the order detail. | CAP-COM-ORD-010 | The tender panel lists the successful payment and the struck-through decline, with the payment linked to Accounting. | test react-console:components/console/order/__tests__/order-360-live-cards.test.tsx#lists each tender with its status, the declined one struck through and a payment linked to Accounting |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 6 | The payment window is dismissed before payment | Keep the existing placed purchase in the composer | Staff can resume payment from the order during its tender window | test react-console:components/order-composer/__tests__/live-composer.test.tsx#keeps the placed order, awaiting payment, when the card pop-up is closed unpaid |
| alternate | 6 | The customer chooses a check | Enter the check reference against the placed purchase | The recorded check accepts the purchase | test react-console:components/order-composer/__tests__/live-composer.test.tsx#records a check against the placed order with its number |
| failure | 5 | The reviewed price is no longer current | Stop placement and return the old and current prices | Staff review a new preview before trying placement again | test services-commerce:modules/checkout/tests/e2e/placement.e2e.spec.js#refuses PRICE_CHANGED with both prices when the price rose since a preview of a moment ago, the checkout left open |
| failure | 7 | The processor response is unavailable | Retain an uncertain result and resume the existing attempt on retry | Acceptance follows the resolved response without an additional charge | test services-commerce:modules/orders/tests/e2e/billing-and-tender.e2e.spec.js#resumes the same attempt on a retry, whatever card the retry names, and moves nothing while the intent is processing |
| Id | Statement | Provenance |
|---|---|---|
01 | The successful retry accepts the existing order and records one charge for that attempt. | test services-commerce:modules/orders/tests/e2e/billing-and-tender.e2e.spec.js#accepts the order on the next attempt, under the next sequence and key |
02 | The first payment converts the pro forma and the mirrored financial position shows full payment. | test services-commerce:modules/orders/tests/e2e/billing-and-tender.e2e.spec.js#answers 200: the attempt succeeded with Accounting’s payment, the order accepted, the pro forma converted by that first money |
03 | The detail view retains the decline and success, with the successful payment linked to Accounting. | test react-console:components/console/order/__tests__/order-360-live-cards.test.tsx#lists each tender with its status, the declined one struck through and a payment linked to Accounting |
End-to-end policy: required: A browser scenario must connect the composer, card window and order detail to prove the staff can recover from a decline without initiating an unintended additional charge.