--- id: MOD-COM-FUL title: 'Fulfillment, Shipping and Inventory' product_area: commerce module: fulfillment revision: 2 status: draft source_sha: services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b react-console: baf6dae382d6f41dce976c7f848667ccc37e076f repositories: - name: services-commerce paths: &ref_0 - modules/fulfillment - modules/shipping - modules/inventory - modules/operations - modules/data-operations - aws/commerce.service.ts - aws/cdk/commerce.function-environment.ts - docs/milestones/README.md - docs/milestones/COMM-M2-take-a-staff-order.md - docs/milestones/plans/COMM-M2-plan.md - docs/milestones/plans/COMM-realignment-2026-10-22.md - docs/milestones/COMM-M1-repairs-6-report.md - docs/milestones/COMM-M1-repairs-7-report.md - docs/migrations/obligation-register - docs/migrations/operations - docs/migrations/shipping - docs/migrations/inventory - docs/migrations/data-operations - name: react-console paths: &ref_1 - 'app/(console)/console/[tenantId]/orders/operations' - >- app/(console)/console/[tenantId]/orders/[orderId] (hosted for MOD-COM-ORD; Fulfilment and Shipments cards) - components/commerce/operations - lib/commerce/operations - lib/commerce/order-flows (obligation and shipment adapters) - components/commerce/order-flows/create-shipment-dialog.tsx - lib/authz/backend-aliases.ts - lib/authz/permissions.ts owns: - 'Delivery obligations, frozen gates, authorizations, attempts and dispatch records' - Delivery-policy configuration - Reversal enforcement and post-sale financial execution records - 'Operations findings, staff interventions and scheduled detection' - Financial-event receipt identity - 'Shipping coverage, charging strategies and carrier-account references' - 'Shipment, parcel, picking, label and physical departure records' - 'Return receiving, inspection, disposition and incoming-label work' - >- Warehouse places, stock balances, movement and allocation ledgers, transfer pairs, counts and stock findings - Collection data-job adoption and migration crosswalks pending Product ownership decision does_not_own: - record: >- Orders, checkout, placement, cancellations, amendments, returns and their documents, participants and their contract, entitlements, the checkout sweeper owner: MOD-COM-ORD - record: Purchasing owner: MOD-COM-ORD as registered (OQ-COM-FUL-002) - record: >- Catalog, merchandise extensions and variants, the merchandise participant, ordering profiles, stores, pricing and promotions owner: MOD-COM-CAT - record: 'Invoices, payments, credits, refunds, credit memos and the receivable events' owner: MOD-ACC-TRX - record: Products and their accounting setup owner: MOD-ACC-PRD - record: The Data Job Engine itself owner: MOD-PFM-DJE - record: 'Carrier connections, credentials and the UPS adapter' owner: MOD-PFM-INT - record: 'Roles, permission evaluation and application access' owner: MOD-PFM-SEC - record: The audit store of intervention events owner: MOD-PFM-OPS - record: 'Workspace lifecycle, including the loading state data jobs run in' owner: MOD-PFM-TNL - record: Memberships delivered by obligations owner: MOD-MBR-MEM hosted_screens: - route: '/console/{tenantId}/orders/operations' purpose: Review grouped order findings and authorized interventions. - route: '/console/{tenantId}/orders/{orderId}' purpose: Inspect delivery and shipment cards within the Orders-owned detail screen. supersedes: - >- react-console acceptance inventory area REG, in part (branch product-acceptance-commerce: CAP-COM-REG-001 to 028, 030 to 035, 039, 044, 045, 047, 048) - react-console acceptance inventory area SHP (CAP-COM-SHP-001 to 032) - >- react-console acceptance inventory area INV, in part (CAP-COM-INV-005 to 007, 009 to 018, 026 to 028, 030) - >- react-console acceptance journeys COM-ACC-0370 to 0397 (register), 0450 to 0493 (inventory) and 0530 to 0563 (shipping) on branch product-acceptance-commerce, as seeds; not bound (FND-COM-FUL-003) evidence: - repository: services-commerce paths: *ref_0 - repository: react-console paths: *ref_1 testing: capability_specifications: - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-001-decide-when-each-sold-line-may-be-delivered.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-002-open-delivery-as-soon-as-its-conditions-are-met.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-003-hold-a-line-priced-by-a-same-order-membership-until-the.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-004-deliver-each-authorized-obligation-through-the-application.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-005-follow-an-order-s-obligations-and-step-in-by-hand.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-006-respond-to-reversed-money-on-delivered-lines.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-007-finish-the-money-side-of-a-post-sale-change-step-by-step.md - specs/commerce/fulfillment/design/tests/ATS-COM-FUL-008-work-the-operations-queue.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-009-find-stuck-missing-and-inconsistent-work-automatically.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-010-set-up-where-the-workspace-ships-how-it-charges-and-which.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-011-offer-shipping-options-and-charges-for-a-cart.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-012-turn-paid-orders-into-shipments-and-work-them-through-the.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-013-buy-void-and-track-carrier-labels-without-buying-twice.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-014-hand-shipments-to-the-carrier-or-the-buyer-and-record-what.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-015-receive-inspect-and-disposition-returned-goods.md - specs/commerce/fulfillment/design/tests/ATS-COM-FUL-016-keep-warehouses-and-stock-locations.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-017-record-stock-that-comes-in-moves-and-goes-out.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-018-reserve-and-commit-stock-for-buyers-and-say-what-is.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-019-count-shelves-and-investigate-stock-findings.md - >- specs/commerce/fulfillment/design/tests/ATS-COM-FUL-020-load-a-workspace-s-rhythm-1-0-commerce-records-and-check.md feature_suites: - FAS-COM-FUL-01 - FAS-COM-FUL-02 - FAS-COM-FUL-03 - FAS-COM-FUL-04 - FAS-COM-FUL-05 executable_suites: - TST-COM-FUL-001 - TST-COM-FUL-002 - TST-COM-FUL-003 - TST-COM-FUL-004 - TST-COM-FUL-005 - TST-COM-FUL-006 - TST-COM-FUL-007 - TST-COM-FUL-008 - TST-COM-FUL-009 - TST-COM-FUL-010 - TST-COM-FUL-011 - TST-COM-FUL-012 - TST-COM-FUL-013 - TST-COM-FUL-014 - TST-COM-FUL-015 - TST-COM-FUL-016 - TST-COM-FUL-017 - TST-COM-FUL-018 - TST-COM-FUL-019 - TST-COM-FUL-020 - TST-COM-FUL-021 - TST-COM-FUL-022 - TST-COM-FUL-023 - TST-COM-FUL-024 - TST-COM-FUL-025 - TST-COM-FUL-026 - TST-COM-FUL-027 - TST-COM-FUL-028 - TST-COM-FUL-029 - TST-COM-FUL-030 - TST-COM-FUL-031 - TST-COM-FUL-032 - TST-COM-FUL-033 - TST-COM-FUL-034 - TST-COM-FUL-035 - TST-COM-FUL-036 - TST-COM-FUL-037 - TST-COM-FUL-038 - TST-COM-FUL-039 - TST-COM-FUL-040 - TST-COM-FUL-041 - TST-COM-FUL-042 - TST-COM-FUL-043 - TST-COM-FUL-044 - TST-COM-FUL-045 - TST-COM-FUL-046 - TST-COM-FUL-047 - TST-COM-FUL-048 - TST-COM-FUL-049 - TST-COM-FUL-050 - TST-COM-FUL-051 - TST-COM-FUL-052 - TST-COM-FUL-053 - TST-COM-FUL-054 - TST-COM-FUL-055 - TST-COM-FUL-056 - TST-COM-FUL-057 - TST-COM-FUL-058 - TST-COM-FUL-059 - TST-COM-FUL-060 - TST-COM-FUL-061 - TST-COM-FUL-062 - TST-COM-FUL-063 - TST-COM-FUL-064 - TST-COM-FUL-065 - TST-COM-FUL-066 - TST-COM-FUL-067 - TST-COM-FUL-068 - TST-COM-FUL-069 - TST-COM-FUL-070 - TST-COM-FUL-071 - TST-COM-FUL-072 - TST-COM-FUL-073 - TST-COM-FUL-074 - TST-COM-FUL-075 - TST-COM-FUL-076 - TST-COM-FUL-077 - TST-COM-FUL-078 - TST-COM-FUL-079 - TST-COM-FUL-080 - TST-COM-FUL-081 - TST-COM-FUL-082 - TST-COM-FUL-083 - TST-COM-FUL-084 - TST-COM-FUL-085 report: specs/commerce/fulfillment/reports/TESTING-BACKFILL-2026-10-23.md --- # Fulfillment, Shipping and Inventory ## Purpose Commerce follows the delivery work arising from a sale and the physical handling of stocked goods. Staff can investigate outstanding obligations, organize shipping and returns, and account for stock through retained records. This planning layer describes the pinned implementation while keeping unresolved product authority visible. ## Boundary This module owns delivery coordination, warehouse handling and physical-stock records. Orders owns the sale and post-sale documents, Catalog supplies products and selling configuration, and Accounting owns financial documents and payment execution. Platform supplies shared security, integrations and data-job infrastructure. Purchasing, costing and collection-specific migration ownership remain Product questions. ## Features | Feature | Name | Concepts | Capabilities | Journeys | |---|---|---|---|---| | `FEAT-COM-FUL-01` | Delivery Conditions and Coordination | 2 | 5 | 1 | | `FEAT-COM-FUL-02` | Order Problems and Financial Follow-Up | 1 | 4 | 2 | | `FEAT-COM-FUL-03` | Physical Delivery and Returns | 1 | 6 | 2 | | `FEAT-COM-FUL-04` | Stock Records and Reconciliation | 1 | 4 | 0 | | `FEAT-COM-FUL-05` | Historical Commerce Imports | 0 | 1 | 1 | ## Capabilities | Id | Feature | Outcome | Intent | |---|---|---|---| | `CAP-COM-FUL-001` | `FEAT-COM-FUL-01` | Choose delivery conditions for sold items | proposed | | `CAP-COM-FUL-002` | `FEAT-COM-FUL-01` | Authorize delivery from current order facts | proposed | | `CAP-COM-FUL-003` | `FEAT-COM-FUL-01` | Protect a member-priced purchase until its membership arrives | confirmed | | `CAP-COM-FUL-004` | `FEAT-COM-FUL-01` | Carry authorized work to its delivering application | proposed | | `CAP-COM-FUL-005` | `FEAT-COM-FUL-01` | Understand and intervene in an order's delivery | proposed | | `CAP-COM-FUL-006` | `FEAT-COM-FUL-02` | Handle financial reversals after delivery | proposed | | `CAP-COM-FUL-007` | `FEAT-COM-FUL-02` | Complete the financial work requested by a post-sale document | proposed | | `CAP-COM-FUL-008` | `FEAT-COM-FUL-02` | Review and resolve operations findings | proposed | | `CAP-COM-FUL-009` | `FEAT-COM-FUL-02` | Detect stalled and inconsistent order work | proposed | | `CAP-COM-FUL-010` | `FEAT-COM-FUL-03` | Configure shipping coverage and collection options | proposed | | `CAP-COM-FUL-011` | `FEAT-COM-FUL-03` | Quote shipping and pickup choices for a cart | proposed | | `CAP-COM-FUL-012` | `FEAT-COM-FUL-03` | Prepare an order's goods for dispatch | proposed | | `CAP-COM-FUL-013` | `FEAT-COM-FUL-03` | Purchase and follow carrier labels safely | proposed | | `CAP-COM-FUL-014` | `FEAT-COM-FUL-03` | Record goods leaving with a carrier or collector | proposed | | `CAP-COM-FUL-015` | `FEAT-COM-FUL-03` | Process returned goods through inspection and disposition | proposed | | `CAP-COM-FUL-016` | `FEAT-COM-FUL-04` | Organize warehouses and stock locations | proposed | | `CAP-COM-FUL-017` | `FEAT-COM-FUL-04` | Keep stock movements and transfers accountable | proposed | | `CAP-COM-FUL-018` | `FEAT-COM-FUL-04` | Allocate stock and explain what buyers can obtain | proposed | | `CAP-COM-FUL-019` | `FEAT-COM-FUL-04` | Reconcile shelf counts and stock findings | proposed | | `CAP-COM-FUL-020` | `FEAT-COM-FUL-05` | Import Commerce history and reconcile source records | proposed | ## Journeys | Id | Outcome | E2E Policy | |---|---|---| | `JNY-COM-FUL-001` | Staff follow a paid order through application delivery | required | | `JNY-COM-FUL-002` | Operations staff recover and close a failed delivery | required | | `JNY-COM-FUL-003` | Warehouse staff dispatch an order in successive waves | required | | `JNY-COM-FUL-004` | Warehouse staff return goods to stock and complete the refund | required | | `JNY-COM-FUL-005` | Staff follow reversal enforcement and restored funds | optional | | `JNY-COM-FUL-006` | Implementation staff load and reconcile Commerce history | none | ## Testing Artifacts The testing tree follows the capability and feature hierarchy. Detailed specifications retain proposed cases and named gaps, feature suites check joined outcomes, and executable records identify the existing source suites without claiming a run result. ```text design/tests/ ATS-COM-FUL-001-decide-when-each-sold-line-may-be-delivered.md ATS-COM-FUL-002-open-delivery-as-soon-as-its-conditions-are-met.md ATS-COM-FUL-003-hold-a-line-priced-by-a-same-order-membership-until-the.md ATS-COM-FUL-004-deliver-each-authorized-obligation-through-the-application.md ATS-COM-FUL-005-follow-an-order-s-obligations-and-step-in-by-hand.md ATS-COM-FUL-006-respond-to-reversed-money-on-delivered-lines.md ATS-COM-FUL-007-finish-the-money-side-of-a-post-sale-change-step-by-step.md ATS-COM-FUL-008-work-the-operations-queue.md ATS-COM-FUL-009-find-stuck-missing-and-inconsistent-work-automatically.md ATS-COM-FUL-010-set-up-where-the-workspace-ships-how-it-charges-and-which.md ATS-COM-FUL-011-offer-shipping-options-and-charges-for-a-cart.md ATS-COM-FUL-012-turn-paid-orders-into-shipments-and-work-them-through-the.md ATS-COM-FUL-013-buy-void-and-track-carrier-labels-without-buying-twice.md ATS-COM-FUL-014-hand-shipments-to-the-carrier-or-the-buyer-and-record-what.md ATS-COM-FUL-015-receive-inspect-and-disposition-returned-goods.md ATS-COM-FUL-016-keep-warehouses-and-stock-locations.md ATS-COM-FUL-017-record-stock-that-comes-in-moves-and-goes-out.md ATS-COM-FUL-018-reserve-and-commit-stock-for-buyers-and-say-what-is.md ATS-COM-FUL-019-count-shelves-and-investigate-stock-findings.md ATS-COM-FUL-020-load-a-workspace-s-rhythm-1-0-commerce-records-and-check.md planning/acceptance/ FAS-COM-FUL-01-delivery-rules-and-the-obligation-register.md FAS-COM-FUL-02-operations-queue-and-post-sale-follow-up.md FAS-COM-FUL-03-shipping-and-warehouse-fulfilment.md FAS-COM-FUL-04-stock-and-warehouses.md FAS-COM-FUL-05-rhythm-1-0-commerce-migration.md implementation/tests/ TST-COM-FUL-001-live.md TST-COM-FUL-002-rules.md TST-COM-FUL-003-data-jobs.md TST-COM-FUL-004-data-jobs.md TST-COM-FUL-005-catalog-import.md TST-COM-FUL-006-configuration-imports.md TST-COM-FUL-007-inventory-import.md TST-COM-FUL-008-merchandise-import.md TST-COM-FUL-009-order-import.md TST-COM-FUL-010-promotion-import.md TST-COM-FUL-011-data-job-worker.md TST-COM-FUL-012-data-job-submission-idempotency.md TST-COM-FUL-013-data-jobs-schemas.md TST-COM-FUL-014-data-operations.md TST-COM-FUL-015-error-classification.md TST-COM-FUL-016-import-values.md TST-COM-FUL-017-data-job-queue.md TST-COM-FUL-018-enforcement.md TST-COM-FUL-019-fulfillment-paid-amount.md TST-COM-FUL-020-fulfillment-policies.md TST-COM-FUL-021-obligation-holds.md TST-COM-FUL-022-obligation-register.md TST-COM-FUL-023-same-cart-grants.md TST-COM-FUL-024-obligations-table.md TST-COM-FUL-025-register-tables-table.md TST-COM-FUL-026-adjustment-worker.md TST-COM-FUL-027-enforcement-handler.md TST-COM-FUL-028-financial-facts-handler.md TST-COM-FUL-029-position-view-gate.md TST-COM-FUL-030-enforcements-queries.md TST-COM-FUL-031-financial-adjustments-queries.md TST-COM-FUL-032-financial-fact-receipts-queries.md TST-COM-FUL-033-fulfillment-policies.md TST-COM-FUL-034-fulfillment-policies-queries.md TST-COM-FUL-035-intervention-logs-queries.md TST-COM-FUL-036-obligation-attempts-queries.md TST-COM-FUL-037-obligation-authorizations-queries.md TST-COM-FUL-038-obligation-dispatches-queries.md TST-COM-FUL-039-obligation-holds.md TST-COM-FUL-040-obligation-register.md TST-COM-FUL-041-obligations.md TST-COM-FUL-042-obligations-queries.md TST-COM-FUL-043-operational-exceptions-queries.md TST-COM-FUL-044-obligation-dispatcher.md TST-COM-FUL-045-obligation-worker.md TST-COM-FUL-046-prerequisite-settlement.md TST-COM-FUL-047-register-sweeper.md TST-COM-FUL-048-accounting-adjustment-commands.md TST-COM-FUL-049-adjustment-pending-at-processor.md TST-COM-FUL-050-adjustment-planning.md TST-COM-FUL-051-change-events-contract.md TST-COM-FUL-052-evaluate-gate.md TST-COM-FUL-053-policy-resolution.md TST-COM-FUL-054-obligation-approval.md TST-COM-FUL-055-obligation-queue.md TST-COM-FUL-056-order-billed-on-terms.md TST-COM-FUL-057-inventory.md TST-COM-FUL-058-merchandise-placement.md TST-COM-FUL-059-inventory-tables-table.md TST-COM-FUL-060-inventory-configuration.md TST-COM-FUL-061-inventory-transfers-queries.md TST-COM-FUL-062-nightly-inventory-paging.md TST-COM-FUL-063-nightly-inventory.md TST-COM-FUL-064-inventory-transfers.md TST-COM-FUL-065-merchandise-claims.md TST-COM-FUL-066-staff-movements.md TST-COM-FUL-067-staff-movement-keys.md TST-COM-FUL-068-health.md TST-COM-FUL-069-operations.md TST-COM-FUL-070-operations-interventions.md TST-COM-FUL-071-reconciler-candidates-queries.md TST-COM-FUL-072-reconciler.md TST-COM-FUL-073-reconciler-catalogue.md TST-COM-FUL-074-post-purchase-shipping.md TST-COM-FUL-075-shipping.md TST-COM-FUL-076-return-receiving-tables-table.md TST-COM-FUL-077-shipping-tables-table.md TST-COM-FUL-078-shipping-flow.md TST-COM-FUL-079-return-receipts-queries.md TST-COM-FUL-080-shipment-events-queries.md TST-COM-FUL-081-shipping-configuration.md TST-COM-FUL-082-return-receiving.md TST-COM-FUL-083-blank-shipping-configuration-values.md TST-COM-FUL-084-carrier-adapters.md TST-COM-FUL-085-zone-strategy-rating.md reports/ TESTING-BACKFILL-2026-10-23.md ```