Skip to content

JNY-COM-FUL-004Warehouse staff return goods to stock and complete the refund

Markdown

JNY-COM-FUL-004

Warehouse staff return goods to stock and complete the refund

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindJourneyProduct areaCommerceModuleFulfillment, Shipping and InventoryRevision1End-to-endRequired

Read atservices-commerce c8b66a98react-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Goal
Account for returned units, apply their dispositions and finish the return's financial work.

Steps

#SurfaceActionCapabilityExpectedProvenance
1requestCancellation (Orders module)Request cancellation of shirts that have already left.CAP-COM-FUL-014The shipped units require return rather than cancellation.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#refuses the cancellation of the shipped shirts: rejected, must_return with shipment_handed_off (B9)
2requestReturn (Orders module)Authorize return with a packed manual-carrier incoming shipment.CAP-COM-FUL-015Its two-unit parcel is addressed to the warehouse.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#authorizes the return with an RMA carrying a return_label shipment packed at the counter: the two shipped units in one parcel, to the warehouse, the label the clerk’s (B14)
3receiveReturnRecord arrival of both authorized units.CAP-COM-FUL-015The return becomes received without adding stock.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#records the receipt of both units against the RMA (the retry under the key answers it again): the document received, nothing on the shelf yet
4inspectReturnReceiptInspect the received line.CAP-COM-FUL-015Condition is retained and inspection states advance.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#inspects the line and moves the receipt to inspected and the return to inspecting
5dispositionReturnReceiptRestock one unit and scrap the other.CAP-COM-FUL-015One unit returns to the shelf and the receipt becomes dispositioned.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#dispositions one unit restocked and one scrapped in one transaction: the shelf up one, the receipt dispositioned, the document completed with the memo and the refund for the two (B15, B11)
6financial adjustment (Accounting commands)Execute the return's credit memo and refund.CAP-COM-FUL-007The document retains financial references and completes.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#dispositions one unit restocked and one scrapped in one transaction: the shelf up one, the receipt dispositioned, the document completed with the memo and the refund for the two (B15, B11)

Alternate and Failure Paths

PathFrom stepConditionPath takenOutcomeProvenance
alternate2The return is withdrawn before receipt.Cancel incoming shipment work and pull its parcel.The workflow records no received goods.test
services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#cancels the return label shipment (packed at the counter, no label bought yet) and pulls its parcel when the return is withdrawn
alternate5A returned unit needs quarantine.Record its restricted stock treatment without restoring cost.The unit is unavailable for sale.test
services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#quarantines the damaged unit: return_restock then quarantine_in at the quarantine shelf, no cost restored, and the document completes with every unit back on the line
failure6The processor declines refund execution.Retain adjustment failure for operations review.Authorized retry resumes the refund step alone.test
services-commerce:modules/fulfillment/tests/integration/services/adjustments/adjustment-worker.integration.spec.js#resumes from the failed step alone on the retry: only the refund is sent again, and completes
failure3Receipt quantity exceeds return authority.Reject receiving before creating the receipt.No excess arrival record is stored.test
services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#refuses more than the line has left authorized (receipt_exceeds_authorized), writing no receipt

Assertions

IdStatementProvenance
01Arrival alone adds no stock; disposition supplies the stock treatment.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#records the receipt of both units against the RMA (the retry under the key answers it again): the document received, nothing on the shelf yet
02Restocking restores the returned unit's original cost.test
services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#restocks the two units at the bin they shipped from: the return_restock movement naming the disposition, on hand up two, the two reliefs reversed at 1500 with the restore_cogs fact of 3000
03Completed return work retains its credit memo and refund references.test
services-commerce:modules/shipping/tests/e2e/post-purchase-shipping.e2e.spec.js#dispositions one unit restocked and one scrapped in one transaction: the shelf up one, the receipt dispositioned, the document completed with the memo and the refund for the two (B15, B11)

End-to-end policy: required: Service end-to-end evidence connects return documents, physical handling and financial execution; the absence of receiving screens leaves browser proof open.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.