The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | previewCheckout (Orders module) | Preview shipping for five shirts addressed to Texas. | CAP-COM-FUL-011 | The zone's shipping choices appear with an initial selection. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#answers shipping_required true with the Texas zone’s two options, the flat one selected, the charge in the totals |
| 2 | placeCheckout (Orders module) | Place and pay the order with three units available and two backordered. | CAP-COM-FUL-018 | Delivery instructions pick available units while the shortage waits. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#dispatches the five unit obligations once paid; the participant picks the three on the shelf and leaves two waiting |
| 3 | createShipment | Create shipment work for the first three units. | CAP-COM-FUL-012 | The first wave contains the initial unit range and saved shipping charge. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#makes the first wave of the three picked units (0..2), charged what the order paid, and walks it to the handoff |
| 4 | releaseShipment, createPickList, pickPickListLine, packShipment | Pick the released work and pack its parcels. | CAP-COM-FUL-012 | Recorded picks and packed quantities retain parcel weight information. | test services-commerce:modules/shipping/tests/integration/services/fulfillment/shipping-flow.integration.spec.js#packs the three units into two parcels, the second weighed from nothing (the shirt has no weight), the line packed, the shipment packed with two packages |
| 5 | purchasePackageLabel | Purchase the parcel labels. | CAP-COM-FUL-013 | Each successful purchase stores tracking and cost. | test services-commerce:modules/shipping/tests/integration/services/fulfillment/shipping-flow.integration.spec.js#buys the first label through UPS under package:<id>:1 (the intent then the outcome), the tracking number and the cost on the label, the package labelled |
| 6 | manifestShipment, handoffShipment | Manifest the shipment and confirm carrier departure. | CAP-COM-FUL-014 | Three units leave, their obligations complete and the order remains partly shipped. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#leaves the order partially shipped after the first wave: three obligations completed, two still in progress, three units shipped on the line |
| 7 | recordInventoryMovement | Receive replenishment stock. | CAP-COM-FUL-017 | The receipt commits the waiting backorders. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#fills the two backorders at the receipt, and the second wave picks the filled units at its creation (3..4) and ships them |
| 8 | createShipment … handoffShipment | Prepare and hand off the replenished units. | CAP-COM-FUL-014 | All five units have shipped and their obligations are complete. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#completes the order’s shipping: every unit shipped, every obligation completed, the shelf down five, the cost facts emitted per wave |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 1 | The buyer selects pickup. | Create collection work and record the collecting person at counter handover. | The pickup completes without shipping charge. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#hands the pick-up over through the route: collected by the buyer, the line shipped, the order’s shipping complete |
| alternate | 5 | The carrier accepts a purchase but loses its answer. | Recover the retained attempt by querying the carrier before resending. | The same purchased label is retained without a second sale. | test services-commerce:modules/shipping/tests/integration/services/fulfillment/shipping-flow.integration.spec.js#settles the purchase in flight by the lookup: the label the carrier holds recorded on attempt 1, the package labelled, never bought twice |
| failure | 6 | A shipment unit lacks delivery authorization. | Reject handoff and record its finding. | No unit moves from stock. | test services-commerce:modules/shipping/tests/integration/services/fulfillment/shipping-flow.integration.spec.js#refuses units_not_authorized, naming the obligation still pending, and moves nothing: the unit committed, nothing shipped, the shipment still manifested |
| failure | 6 | Cancellation has fenced a shipment line. | Reject departure while the parcel requires removal. | Retained goods need separate shipment work. | test services-commerce:modules/shipping/tests/integration/services/fulfillment/shipping-flow.integration.spec.js#refuses the handoff shipment_cancelled_pull_package, naming the fenced line, and moves nothing |
| Id | Statement | Provenance |
|---|---|---|
01 | Completing both waves ships all five units and completes their delivery obligations. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#completes the order’s shipping: every unit shipped, every obligation completed, the shelf down five, the cost facts emitted per wave |
02 | After every unit ships, another wave is rejected as empty. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#refuses a third wave: nothing is left to ship (409 nothing_to_ship) |
03 | Each departure invokes the configured cost-relief path for its outgoing goods. | test services-commerce:modules/shipping/tests/e2e/shipping.e2e.spec.js#completes the order’s shipping: every unit shipped, every obligation completed, the shelf down five, the cost facts emitted per wave |
End-to-end policy: required: The service evidence crosses checkout, stock, delivery and carrier fixtures; warehouse browser coverage awaits usable floor screens.