Replenishment
Track each brand's reorder cycle from due through to complete, with the purchase orders for that cycle attached to it.
Replenishment turns each brand's weekly reorder into a tracked cycle instead of a spreadsheet. You see which brands are due, work each cycle through its status pipeline, and keep every purchase order for that cycle attached to it.
Internal only
These screens are for the National Commerce team. They are not shown to
brand-side client users. Access is the Super Admin allowlist, set through the
SUPER_ADMIN_EMAILS environment variable, so widening access is a config
change rather than a code change.
Accounts
The Accounts screen lists every account with the figures that tell you whether it needs a cycle started.
| Column | What it means |
|---|---|
| Reorder Cadence (Days) | The reorder interval you set for this account. Edit it in place. |
| SKU-Derived Cadence | The shortest non-zero order interval across the account's SKUs. Reference only. |
| Days Since Last Cycle | Days since the account's most recent cycle. Blank if it has never had one. |
| Current Cycle Status | The status of the account's current open cycle, if one is running. |
Reorder Cadence is the one that matters. Type a number of days and it saves when you click away or press Enter. Clear it and the account stops being tracked for due dates.
SKU-Derived Cadence is shown next to it for reference and nothing runs off it. It is the shortest non-zero interval across the account's SKUs, so a single fast-moving item pulls it down and it rarely reflects how the account is actually ordered.
Due / Overdue
The Due / Overdue button filters to accounts where Days Since Last Cycle has reached the Reorder Cadence you set.
An account with no Reorder Cadence entered never appears here, and neither does one that has never had a cycle. Set a cadence to start tracking it.
Filters
Filter by current cycle status, reorder cadence, and a minimum number of days since the last cycle, or search by account name. Clear resets everything.
Starting a cycle
Start Cycle on a row, or New Cycle at the top, opens the create form. Pick the account and the period start date. The period end date fills in automatically from the account's cadence and you can change it. Cycles are created one at a time.
Cycles
The Cycles screen lists cycles across every account, with the status each one sits at and how long it has been there.
The Draft PO Status and ShipHero PO Status columns are read from the purchase orders attached to the cycle rather than stored on the cycle itself, so they always match what the POs actually say.
Awaiting Client To Process Order
The Awaiting Client To Process Order button filters to cycles that have sat at "Followed Up For Client To Process Order" for more than three days. These are the cycles the client has gone quiet on.
Filters
Filter by account, cycle status, draft PO status, ShipHero PO status, and a period date range, or search by account name.
Cycle detail
Opening a cycle shows where it stands and everything attached to it.
Status pipeline
A cycle moves through this pipeline:
| Status | Meaning |
|---|---|
| New | The cycle has been created. |
| Replen Review In Progress | The team is preparing the order. |
| Order Submitted to Client | The order has gone to the client. |
| Client Confirmed Order | The client has confirmed it. |
| Followed Up For Client To Process Order | The client has gone quiet and been chased. |
| Client Processed Order | The client has processed the order. |
| POs Confirmed Created | The purchase orders are placed. |
| Cycle Completed | Everything has arrived and been scanned in. |
| Cancelled / Archived | The cycle was abandoned. |
Use Advance to for the next step, or the dropdown to jump to any status. Nothing advances on its own. Moving to POs Confirmed Created and to Cycle Completed are both deliberate steps you take once the work is actually done.
Every move records its timestamp, which is what drives Days in Status and Days Since Last Cycle. The Status Timeline tab shows when the cycle entered each stage.
Purchase Orders
The Purchase Orders tab lists every PO on the cycle with its status, warehouse, tracking number, and the inbound and received quantities read from the synced ShipHero PO.
Add Purchase Order gives you two ways to attach one:
- Create Draft builds a draft PO already attached to this cycle. Pick the vendor and warehouse. Add line items and submit it to ShipHero from the Purchase Orders screen.
- Link Existing PO attaches a ShipHero PO that has already synced, for when the PO was placed without going through the draft flow.
A draft moves through Draft, then PO In Progress once you have started placing it, then ShipHero PO Created. Submitting a draft to ShipHero sets the last one for you.
Tracking numbers
A tracking number lives on the draft purchase order. A PO linked directly to a cycle, with no draft behind it, has no tracking number to show because the synced ShipHero PO record does not carry one.
Unlink removes a PO from the cycle without deleting the purchase order.
How a draft and its real PO stay paired
When you submit a draft to ShipHero, the app records the id of the purchase order ShipHero created. The real PO syncs back into the portal later against that same id, which is how the cycle pairs a draft with its synced PO. No matching on PO name is involved, so a renamed or duplicated PO name cannot break the link.