The Shipment Workflow — Screen by Screen
The parcel journey from order to doorstep, every tab in the Shipment screen, and what your customer sees along the way.
Here's what happens from the moment a customer places an order to the moment it arrives at their door — and where to look in your dashboard at every step.
The parcel journey, step by step
A customer places an order
Before checkout completes, the platform silently checks that the delivery pincode is actually serviceable by your connected courier(s) — if the address genuinely can't be reached, the customer is told before payment, not after.
At checkout, the customer sees available shipping options with real rates — a line like "Blue Dart Surface — ₹86.10 — 3–5 days — COD available". The cheapest option is pre-selected. The order lands in your Orders screen ready for action.
You (or the system) book a shipment
Manual booking. Open the order detail screen and click + Create Shipment. A dialog shows the package weight and dimensions (pre-filled from the product or store defaults, editable) and your shipping provider. Click Create Shipment — the platform queries available couriers and shows a rate comparison.
Auto-fulfillment. If enabled on the Shiprocket plugin page, the platform books the shipment automatically as soon as a paid order is confirmed — no action from you. For COD orders, the trigger fires when the order status moves to confirmed.
Rate shopping picks the best courier
The platform queries every available courier on your Shiprocket account simultaneously and returns a list sorted cheapest-first, each showing courier name, price, estimated transit days, and COD availability for that specific courier and destination. The cheapest is marked Recommended, but you can choose any option — for example, Blue Dart Air if the customer needs it in two days.
A label and tracking number are generated
Once you confirm the courier, the platform books the shipment and returns an AWB number (the unique tracking identifier) and a printable shipping label PDF with barcode, addresses, weight, and courier branding. Both appear immediately on the order detail screen and later in All Shipments.
Print the label
Click Download Label on the order detail screen, or from the All Shipments action menu. Print it and stick it securely on the parcel — the barcode must stay visible, not covered by tape.
Lost or damaged a label? Download it again any time from All Shipments → action menu → Download Label — labels can be reprinted as many times as needed.
Bulk label printing. Tick the checkboxes on multiple rows in All Shipments, then click Print Labels in the bulk action toolbar — the platform combines every selected label into a single PDF.
Schedule a pickup
With the label printed and the parcel sealed, go to Shipment → Pickup Management: select the warehouse, choose a date, a time slot (10:00, 12:00, 14:00, 16:00, or 18:00), and the number of packages, then click Schedule Pickup. If auto-fulfillment is on, the system schedules the pickup automatically for the next working day.
Tracking updates flow back automatically
Once collected, status updates come back automatically: Pending → Confirmed → Picked Up → In Transit → Out for Delivery → Delivered. All Shipments shows the live status at all times — no manual refreshing.
The customer tracks their order
On the customer portal, customers see the current delivery status — carrier name, AWB, estimated delivery date, a full event timeline, and a "Track on carrier site" link that opens the courier's public tracking page with the AWB pre-filled.
The parcel is delivered
When the courier confirms delivery, both the shipment and order status update to Delivered. If paid online, the money was already captured in Razorpay. If COD, Shiprocket collects the cash and adds it to your COD remittance queue.
The Shipment screen, tab by tab
Your Shipment section is your logistics command centre. Tab order follows a deliberate priority:
the tabs you need daily and the ones flagging a problem come first (Overview, All Shipments, Failed
Bookings, then the returns/NDR/COD group); routine day-to-day tools (Rate Calculator, Pickup
Management, Pickup Calendar) come next; setup/configuration tabs you touch rarely (Weight Disputes,
Shipping Rules, Insurance Claims, Warehouses) are last. Every tab is reachable by a stable
?tab=<key> link regardless of its position, so bookmarks and deep-links from alerts/emails keep
working even if the order changes again later.
Overview
At a glance: total shipments (all time), shipments currently in transit, deliveries completed today, and pickups scheduled for today — plus a recent-activity table so you can spot anything that needs attention without drilling in.
Action Required cards. When you have unresolved shipment booking failures, this tab opens with one card per distinct problem — grouped by order and error cause, so five retries of the same underlying issue on one order show as a single card with a "5×" badge, not five separate rows. Each card shows:
- A severity chip (critical / warning / info) and, if the merchant already tried a fix that didn't work, a Still failing chip.
- The plain-language cause and a fix-it button that deep-links straight to where the fix needs to happen (e.g. the Warehouses tab, or a plugin settings page).
- Snooze — hides the card in your browser for 24 hours. It reappears automatically after that, or immediately if the underlying failure's status actually changes.
- Acknowledge — hides the card in your browser indefinitely (until you clear your browser storage). Acknowledging does not resolve the failure — it's a "stop reminding me, I've seen this" affordance, not a fix. The card comes back the moment BillionBiz detects the failure is still there after you'd expect it to be fixed, or on another device/browser where it was never acknowledged.
Acknowledging the last card doesn't make the section vanish
Acknowledge and Snooze only hide a card from this widget — they never touch the underlying failure, so it's still counted everywhere else (the banner, the bell). If you acknowledge or snooze every card currently shown, the Action Required section stays on screen with a caption instead of disappearing: "N unresolved (M acknowledged/snoozed — hidden from this view, still open elsewhere)." Only when there are genuinely zero unresolved failures — none at all, not just ones you've hidden — does the whole section go away.
Same underlying data as the site-wide banner
Action Required cards read the exact same unresolved-failure list as the site-wide failure banner — acknowledging or snoozing a card here only affects this tab's display, it doesn't dismiss the banner or the notification-bell entry, since those all reflect whether the failure is genuinely still unresolved.
All Shipments
The complete list of every shipment ever created for your store.
Filters and search. Filter by status (Pending, Confirmed, In Transit, Out for Delivery, Delivered, Failed, Returned, Cancelled) and by shipping provider. Search by order number or tracking number (AWB).
Single-shipment actions (three-dot menu on any row):
| Action | What it does |
|---|---|
| View tracking | Opens the courier's public tracking page for that AWB |
| Download label | Retrieves the printable PDF shipping label |
| Cancel shipment | Cancels with the courier before pickup — shows the human-readable order number |
| Schedule pickup | Opens the same pickup dialog described under Pickup Management below, pre-filled for this shipment — pick a date and time slot without leaving the All Shipments list |
Bulk operations — tick two or more rows to reveal the bulk toolbar:
| Bulk action | What it does |
|---|---|
| Print labels | Combines all selected labels into one PDF download |
| Generate manifest | Creates a handover manifest for the selected shipments |
| Cancel shipments | Cancels all selected in one go — a summary shows how many succeeded and how many failed |
Bulk cancel — partial failure
If some shipments can't be cancelled (already picked up or in transit), those fail while the rest succeed. The results screen lists each outcome with a reason — handle failures individually.
Shipment Detail Drawer. Click any row to open a slide-out panel with customer info, courier details (provider, carrier, AWB, manifest ID), items in the shipment, a P&L breakdown (charged vs. actual shipping cost), and a full status timeline.
Failed Bookings
Sometimes a shipment fails to book in the first place — a wallet balance that's too low, a courier API timeout, or a destination pincode that turned out not to be serviceable. This is different from an NDR (which is a failed delivery of an already-booked shipment). The Failed Bookings tab lists every booking failure with the order number, provider, the error, how many attempts have been made so far, and the last attempt time.
Click Retry on any row to attempt the booking again — useful once you've fixed the underlying cause, such as topping up your Shiprocket wallet. Click Refresh to reload the list. Filter by Unresolved, Resolved, or All.
Why Retry sometimes isn't offered
Retry only appears when it could plausibly succeed — either the failure is a known-transient cause, or you've already applied the suggested fix and BillionBiz is waiting to confirm it worked. Retrying an un-fixed, non-transient failure (e.g. a warehouse that's still failing carrier registration) would just reproduce the identical error, so instead you'll see a short note pointing you to the fix. See Retry booking button is missing / replaced with a note for the full explanation and what to do.
Site-wide failure banner. Whenever there's at least one unresolved booking failure anywhere in the store, a red banner appears across the top of the admin panel (visible from any page) showing the count and a Review shipments link straight to this tab. If every unresolved failure shares the same cause, the banner also offers a one-click Retry all — this is likewise hidden (with an explanatory note) if none of the unresolved failures are currently retryable, for the same reason as the per-row Retry button above.
Retry all always tells you what happened
Clicking Retry all is never silent — once it finishes, a toast summarizes the outcome, e.g. "4 shipped, 1 failed, 2 skipped — no provider configured." Any order that skipped (rather than succeeded or failed outright) still shows up as its own row on the Failed Bookings tab so you can see and act on it individually — the toast is a summary, not the whole story.
Returns, Return Requests, NDR Center, COD Remittance
These sit next to Failed Bookings because they're the other tabs you'll check for anything needing action — they get their own detailed guides: see Payments & COD, Zones, Rules & Advanced Features, and Returns & Cancellations.
Rate Calculator
A quick-check tool before you commit to a shipment. Enter origin pincode, destination pincode, parcel weight, payment mode (Prepaid or COD), and provider. The platform queries in real time and shows serviceability, available couriers, cost, and transit days for each. No shipment is booked — this is purely a lookup tool.
Weight unit and Reset. Toggle the weight field between grams and kg with the unit switch next to it — the platform converts to grams internally before calling the rate API either way. Click Reset to clear every field (pincodes, weight, payment mode, provider) and start a fresh lookup.
“No carrier connected” result
If no carrier actually answered the query — you have no active shipping provider, or the connected one couldn't verify the pincode right now — the result card doesn't pretend otherwise. It shows an explicit "No carrier connected — manual fulfilment required" warning instead of a green quote card. Below it, a Default shipping rate figure still appears if your store has one configured (useful as a rough number), clearly labelled as your fallback, not a carrier-verified price. When the cause is "no provider configured," a Connect a provider link takes you straight to the Shiprocket plugin page; when the cause is a failed provider check, there's no link — try again shortly instead, since a provider is already connected.
Pickup Management
Schedule pickups (warehouse, date, time slot, package count), reschedule an existing pickup (pre-filled dialog — note that not all couriers allow rescheduling after a pickup is confirmed), or schedule bulk pickups across multiple warehouses in the same session.
If the warehouse dropdown is empty
With no warehouses added yet, the schedule-pickup form's warehouse dropdown has nothing to select and the form can't be submitted. Rather than leaving that unexplained, a hint appears under the dropdown pointing you to add one, with a link straight to the Warehouses tab. See Adding a warehouse.
Sync Pickup Locations. Click Sync Pickup Locations to pull any pickup addresses you've registered directly on Shiprocket's own dashboard into your Warehouses list, so they're available to pick from the schedule-pickup form here. Use this after adding or editing a pickup location on Shiprocket itself rather than inside BillionBiz — otherwise the two lists can drift apart. A success message reports how many locations were synced; if Shiprocket has nothing new, you're told there was nothing to sync.
Manifests. A manifest is a printed handover document listing every parcel in a batch — many courier agents require a signed one before accepting packages.
Generate
Click Generate Manifest, enter the AWB numbers to include (type or paste a comma-separated list), then click Generate.
Download
Click Download to save the PDF — it contains your store name and warehouse address, pickup date and time slot, a numbered list of every parcel (AWB, customer, destination, weight, order value), and a signature box for the courier agent.
Reprint anytime
Click the download icon next to any manifest entry in the Manifests list. You can also generate a fresh PDF with the same AWBs — new timestamp, same Shiprocket manifest ID.
Pickup Calendar
A week-at-a-glance view of every scheduled pickup, as an alternative to the list-based Pickup Management tab. A Today's Queue card at the top surfaces every pickup scheduled for today, grouped with the warehouse name, order count, and time. Below it, a seven-day grid (Monday to Sunday) shows each day's pickups grouped by warehouse; use the ‹ / › arrows to move a week at a time, or click Today to jump back to the current week.
Weight Disputes
Couriers sometimes charge based on a measured weight that differs from what you declared. This tab shows your declared weight vs. the courier's invoiced weight — review and contest if the courier's measurement looks wrong.
Shipping Rules
Setup for free-shipping, weight-tier, zone-restriction, and provider-preference rules — see Zones, Rules & Advanced Features for the full walkthrough.
Insurance Claims
If a shipment is lost or damaged in transit, click + New Claim, select the shipment by order number or AWB, describe the issue, attach photos or documents, and click Create Claim.
Filing is two steps
Clicking Create Claim doesn't send it to your insurer yet — it saves the claim in Draft status so you can review it. Find the claim in the list and click Submit on that row (only draft rows show this button) when you're ready to actually file it. Claims are tracked through to resolution once submitted.
Warehouses
Your full list of pickup addresses — last in the tab order since you set these up once and rarely revisit them. See Warehouses & Product Shipping Setup for adding one, reading the registration status, and setting the default.
Deleting a warehouse. Click Delete on any warehouse row. A confirmation dialog names the warehouse and asks you to confirm — deletion is immediate and cannot be undone, so make sure no active pickups are still scheduled from that address first. BillionBiz also deactivates the pickup location on Shiprocket's side as part of the delete, so re-adding a warehouse under the same name later gets automatically linked back to it (see the "This name already exists" note in Adding a warehouse) rather than hitting a conflict.
How your customer sees it
At checkout — courier name, price, estimated delivery time, a COD availability badge, and the "shipping from" pincode. The cheapest option is pre-selected. If no delivery address has been entered yet, the shipping line shows "Calculated at checkout" — normal, and it resolves as soon as a pincode is entered.
On the order page — an order status timeline (Placed → Processing → Shipped → Delivered), payment method, order items, shipping address, and an order summary.
Shipment tracking — once a shipment exists, the order detail page shows tracking number (AWB), carrier name, a colour-coded status badge, estimated delivery date, a "Track on carrier site" link, and a full chronological tracking timeline.