Shipments
Browse shipments, flag orders over their postage threshold, leave one-off orders out of the stats, and analyze shipping zones.
The Shipments area shows what you shipped and what it cost. It helps finance and operations watch shipping spend and study delivery distance.
The sidebar splits it into two screens: Shipments and Zone Analysis.
Shipments are read-only
ShipHero ingests every shipment. You can browse and export the data, but you cannot edit it here. The one exception is the Exclude from metrics toggle, which NC staff use to leave an order out of the stats.
Shipments list
The list shows one row per shipping label. You can search, filter, and export the data for any date range.
Columns
Each row shows the shipment date, order number, store, and warehouse. It also shows label cost, total order label cost, total units, shipping name, tracking ID, and shipping zone.
Total units is a computed figure. It multiplies each SKU's quantity by its bundle count.
NC staff also see an Exclude from Metrics toggle on each row. See Exclude from metrics.
Filters
- Account, warehouse, store, and Product SKU.
- Threshold exceeded shows orders that ran over their postage threshold.
- Search by order number or tracking ID.
- Date range is required. The list needs a period to load.
Search caps at 1,000 matches
A broad search returns at most 1,000 shipments. When it hits the cap, the screen shows a note. Narrow your filters to see the rest.
Sorting has no such cap. Sort by any column and the list still covers every shipment in the date range, with the full total.
Shipment detail
Click a row to open its detail page. It has three tabs.
- Details: shipment info and order info. It shows the shipping zone, zone distance, label cost, and postage threshold. An order over its threshold shows a red badge.
- Line items: each product in the shipment, with quantity, bundle count, and total units.
- Audit log: who created and updated the record, and when.
Exports
Two CSV exports honor your current filters:
- Export Shipments: one row per shipment.
- Export Shipment Line Items: one row per product in each shipment.
The server streams both files. So an export can cover far more rows than the screen loads.
Postage thresholds
Each Product SKU has a postage threshold. It is the shipping cost you expect to pay for that SKU. You set it on the product's detail page under Inventory › Products.
Each order rolls its SKUs' thresholds into an order total. When the real label cost passes that total, the order flags as threshold exceeded. That flag drives the filter and red badge on the Shipments screens.
Price Alerts was removed
Thresholds used to have their own Price Alerts screen. It is gone, and its old link now opens the Shipments list.
Exclude from metrics
Some orders are not real sales. Pallets shipped back to a brand are one example. They still go through ShipHero, so they would count in units shipped, in shipping cost, and in the daily demand behind replenishment. NC staff can leave such an order out of the stats with the Exclude from Metrics toggle on the Shipments list. Exclude an order from metrics walks through the steps.
The toggle sits on each shipment row, but it belongs to the order:
- Switch it on and every shipment of that order is left out, including shipments ShipHero adds to the order later. The order's rows turn grey and show an Excluded badge next to the order number.
- Switch it off and the order counts again. Nothing is deleted, so you can switch it back and forth.
- A shipment with no order shows a dash instead of a toggle.
What it leaves out
A flagged order drops out of:
- Every number and chart on the Dashboard, and Product Analysis.
- Zone Analysis.
- The weekly reports and net revenue figures.
- Daily demand, and so everything built from it: the Replen Report, the Inventory Snapshot, the Inventory Forecast, and the lines of a new replenishment request or draft PO.
It does not change:
- Quantity on hand. It comes from ShipHero.
- The Shipments list and its exports. The order and its shipments stay listed, so you can find them and switch the toggle back.
- The order's own totals, such as its label cost.
- Requests and draft POs already made. They keep the numbers they were built with.
Switching the toggle never sends a shipping-cost alert.
Who sees it
Only NC staff see the toggle and the badge, and only on accounts they are assigned to. Client Users never see either, but their numbers leave flagged orders out too. A client preview hides the toggle as well.
Other screens pick up a change the next time you open them. On the Replen Report and the Inventory Snapshot, press Run Report again.
Zone Analysis
Zone Analysis groups shipments by shipping zone. It shows how far your packages travel and what each zone costs.
What a shipping zone means
The app derives a zone from the distance between the warehouse ZIP and the customer ZIP:
- Zones 1 to 8 cover growing distance bands, from 50 miles up to 1,800-plus miles.
- Zone 9 covers US territories and military addresses.
What the screen shows
Three cards summarize total shipments, average cost per shipment, and total shipping cost.
The main table lists all nine zones. Each row shows the shipment count, its share of the total, and the average cost. Expand a zone to see a per-state breakdown.
An Uncategorized row collects shipments the app could not place in a zone. Expand it to see why: a missing or invalid ZIP, for example.
Filters and export
- Filter by account, warehouse, Product SKU, store, pack size, and date range. The default range covers the last 7 days.
- Pack size is the number of units shipped: each SKU's quantity times its bundle count, the same as total units on the Shipments list. A 2-pack SKU shipped once counts as a 2-pack. The "10+ pack" option covers 10 or more units.
- Export to CSV runs on the server, which rebuilds the analysis and writes a sectioned file.
Zones also come from a shared calculator
An N8N workflow calls the same zone calculator through a protected endpoint. It stamps each shipment's zone as ShipHero ingests it. So the stored zone and this screen use one method.
Behind the scenes: reconcile reports
A scheduled job checks that the portal holds every shipment ShipHero shipped. It compares ShipHero against the portal and flags gaps: missing shipments, duplicates, and quantity drift. It only compares labels ShipHero marks as valid, so a label voided and replaced on a live shipment is left out. Labels without a tracking number, such as pallets, are told apart by their position in the shipment, so a 5-pallet line item is expected to have 5 portal rows.
It runs for every brand that has ShipHero credentials and a completed initial import. Each brand gets its own PDF, and all of a run's brand PDFs are posted to Slack as a single message with a per-brand summary.
There are two schedules:
- Daily at 12:00 UTC, covering the previous day.
- Weekly on Monday at 13:00 UTC, covering the previous Monday through Sunday. This runs on top of the daily job and posts its own separate message. It runs after the morning backup sync (07:00 to about 09:30 UTC) has removed voided labels and corrected Sunday's quantities, and after the daily job, so both see the same settled data.
The two are staggered so they never pull ShipHero at the same time, because brands share one ShipHero credit pool and overlapping runs would throttle each other.
One-off runs
The cron endpoint also accepts query parameters for manual runs: ?date=YYYY-MM-DD
to pick the day, ?range=week for a seven-day window ending on that day, and
?brandId= to reconcile a single brand.