SSR lifecycle
A supplier stock release moves through up to 7 statuses. This page is the reference.
On this page
Section titled “On this page”- The 7 statuses
- Status flow
- Actions by status
- Mutability — what you can edit at each status
- Reverts and reopens
- See also
The 7 statuses
Section titled “The 7 statuses”| Status | UI label | What it means | Typical entry |
|---|---|---|---|
draft | Draft | You’re composing the release. No supplier-held stock is consumed yet. | New release created. |
requested | Sent to Supplier | The release request has been sent. Lines are allocated against open supplier-held positions. | You click Send to Supplier. |
shipped | Shipped | The supplier has shipped against the request. Shipped quantities are equal to requested by default. | You click Mark as Shipped. |
partially_received | Partially Received | Some quantity has been received into the destination warehouse; some is still in transit. | First Receive Quantities call that doesn’t cover everything. |
received | Received | All requested quantity has been received into the warehouse. | Last receipt that closes every line. |
completed | Completed | The release is closed. | You click Complete Release from Received. |
cancelled | Cancelled | The release was cancelled. Any open allocated supplier-held stock is returned to the available pool. | You click Cancel Release. |
Note that the status enum value requested displays in the UI as “Sent to Supplier” — the underlying state name is requested.
Status flow
Section titled “Status flow”Draft → Sent to Supplier → Shipped → Partially Received → Received → Completed ↕ (Revert to Draft) ↕ (Revert to Sent) ↑ ↑ └ (Unreceive ─┘ → reverses) └─────────────── Cancelled ←──────────────────┘ ↓ Reopen → previous status- Revert to Draft is available from Sent to Supplier or Shipped; preserves the line items and zeros shipped quantity.
- Revert to Sent is available from Shipped; clears shipped quantities back to zero.
- Unreceive Quantities is available from Partially Received, Received, or Completed; reverses the warehouse receipt and re-reserves the supplier-held stock.
- Reopen Release is available from Cancelled (re-reserves still-open supplier-held stock) or from Completed (moves it back to Received for review).
Actions by status
Section titled “Actions by status”| Status | Available primary actions | Also in “More actions” |
|---|---|---|
| Draft | Send to Supplier | Cancel Release |
| Sent to Supplier | Receive Quantities, Mark as Shipped | Revert to Draft, Cancel Release |
| Shipped | Receive Quantities | Revert to Sent, Revert to Draft, Cancel Release |
| Partially Received | Receive Quantities, Sync to Shopify (if unsynced) | Unreceive Quantities |
| Received | Complete Release, Sync to Shopify (if unsynced) | Unreceive Quantities |
| Completed | Sync to Shopify (if unsynced) | Unreceive Quantities, Reopen Release |
| Cancelled | Reopen Release | — |
Send to Supplier is gated: the release must have a destination location, at least one open line item with quantity > 0, and every line’s destination must be available at the chosen location.
Mutability — what you can edit at each status
Section titled “Mutability — what you can edit at each status”| Status | Add lines | Delete lines | Edit requested qty | Edit shipped qty | Edit received qty |
|---|---|---|---|---|---|
| Draft | yes | yes | yes | n/a | n/a |
| Sent to Supplier / Shipped / Partially Received / Received | no (only existing lines) | individual lines only | no | yes | yes |
| Completed / Cancelled | no | no | no | no | no |
The bulk-edit panel only opens for non-terminal releases.
Reverts and reopens
Section titled “Reverts and reopens”The detail page exposes step-back actions for cases where you need to undo a forward move:
- Revert to Draft clears shipped quantities and resets statuses on lines and schedules, but keeps the line items themselves. Useful if the release was sent prematurely.
- Revert to Sent moves a Shipped release back to Sent to Supplier and clears shipped quantities.
- Unreceive Quantities rolls back warehouse receipts and re-reserves the supplier-held stock. The allocated supplier-held stock position is increased again accordingly.
- Reopen Release from Cancelled re-reserves any supplier-held stock that’s still available; from Completed it moves back to Received.
See also
Section titled “See also”- Receiving & Shopify sync — what happens to supplier-held stock and Shopify on-hand on receive.
- Overview — what an SSR is and where supplier-held stock comes from.